KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #desktop-app #typescript #rust #ai-agent #cli

panda-video-generator

★ 277 Open GitHub ↗

熊猫视频自动化引擎: 用程序员的方式帮你自动化视频创作与发布

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <img src="./public/logo/logo.png" width="200" alt="Panda Video Generator Logo">
  
  # Panda Video Generator
  
  **熊猫视频自动化引擎**

*"Developer-first video automation engine."*

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/szhshp/panda-video-generator/main/LICENSE)
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
  [![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)
  [![Remotion](https://img.shields.io/badge/Remotion-4.0-FF0000)](https://www.remotion.dev/)
</div>

---

## ✨ 核心特性

<table cellspacing="20" cellpadding="0" border="0">
  <tr valign="top">
    <td width="34%" valign="top">
      <h3>🕷️ <mark>一键</mark>网页转文本</h3>
      <p>一键抓取正文与标题（如知乎），输出结构化文件，少手工整理。</p>
    </td>
    <td width="33%" valign="top">
      <h3>🎬 <mark>一键</mark>文本转视频</h3>
      <p>一键跑通口播链路：Edge TTS + VTT 字幕，Remotion 模板渲染成片。</p>
    </td>
    <td width="33%" valign="top">
      <h3>🚀 <mark>一键</mark>多平台发布</h3>
      <p>一键驱动浏览器自动化上传；B 站、抖音、视频号、YouTube、快手等共用相近流程。</p>
    </td>
  </tr>
</table>

## 接入方式

<table cellspacing="20" cellpadding="0" border="0">
  <tr valign="top">
    <td width="34%" valign="top">
      <h3>🤖 1. Agent Skills 方式</h3>
      <ul>
        <li>使用 AI Agent 编排视频生成与发布流程。</li>
        <li>支持口播流水线、爬虫、TTS、渲染与发布等技能。</li>
        <li>支持 Cursor、Claude Code、Copilot 等常用 AI Agent。</li>
      </ul>
      <p><a href="#demo-agent">演示视频</a> / <a href="#agent-skills">查看更多</a></p>
    </td>
    <td width="33%" valign="top">
      <h3>🧭 2. 网页端自动化向导方式</h3>
      <ul>
        <li>通过傻瓜式 <a href="#wizard-automation">自动化向导</a>，无需手写命令。</li>
        <li>在浏览器中按步骤完成文稿、TTS 与成片渲染。</li>
        <li>多平台发布为可选步骤，可按需执行。</li>
      </ul>
      <p><a href="#demo-wizard">演示视频</a> / <a href="#wizard-automation">查看更多</a></p>
    </td>
    <td width="33%" valign="top">
      <h3>💻 3. CLI 命令行</h3>
      <ul>
        <li>与向导共用同一套 <code>pnpm</code> 脚本：爬虫、TTS、Remotion 渲染与发布。</li>
        <li>适合终端操作、自有 CI 或与 shell / cron 等自动化对接。</li>
        <li>命令与输出目录见 <a href="./docs/cli-usage-guide.md">CLI 使用指南</a>。</li>
      </ul>
      <p><a href="#cli-usage-guide">查看更多</a></p>
    </td>
  </tr>
</table>

---

## 📖 简介

**Panda Video Generator**（熊猫视频自动化引擎）

一站式全自动化的视频内容生成与发布引擎，支持从网页内容提取、文本转视频到多平台发布的完整工作流。通过 AI 驱动的文本转语音（TTS）技术和视频渲染引擎，帮助内容创作者快速生成高质量视频并一键发布到多个平台。

<a id="demo-agent"></a>
## ❇️ 功能演示1 - Agent 使用演示

> 《用 AI 的方式一人运营十个自媒体账号》

<a id="demo-wizard"></a>
## ❇️ 功能演示2 - 网页自动化向导

> 《用程序员的方式一人运营十个自媒体账号》

## ~~❇️ 功能演示3 - GitHub Actions 云端成片~~

~~> 《用自动化的方式一人运营十个自媒体账号》~~

[为什么移除了这个功能?](#changelog-github-actions)

## 🎉 成品展示

<a id="changelog"></a>
## 📅 更新日志

- **V1.5.1** · 2026-05-25
  - 修复 Windows 下自动化向导运行脚本时 `spawn EINVAL` 错误
- **V1.5.0** · 2026-05-24
  - 浏览器自动化底层切换为 [`@panda-video-automation/pva`](https://github.com/szhshp/panda-video-automations-publisher)，统一登录/上传命令为 `pva` CLI
  - 移除项目对 `playwright` / `@playwright/test` 的直接依赖
  - 移除对小红书的支持 (小红书 ~~这平台逼事特别多 TMD 威胁我用自动化就封号, 封号就封号赶紧倒闭吧~~ 上传流程过于严格, 可能导致账号功能限制) 
- **V1.4.1** · 2026-04-12
  <a id="changelog-github-actions"></a>
  - 经过网友提醒, Github Actions 云端渲染视频可能存在违反 Action 服务条款的风险, 所以移除了 Github Actions 的示例, 但是你依然可以从 [4953884](https://github.com/szhshp/panda-video-generator/commit/4953884e978ccc96f8d1a7cebb1b7f88754d2de7) 这个 commit 中找到 Github Actions 的示例, 其中包含除了`自动化发布`之外的完整功能.
- **V1.4.0** · 2026-04-10
  - 支持 GitHub Actions 测试视频生成
- **V1.3.1** · 2026-04-05
  - 支持 KIMI
- **V1.3** · 2026-04-03
  - YES, SKILLS! 
  - Why not try it in your OpenClaw? 🦞
- **V1.2** · 2026-04-01
  - 添加了自动化向导功能，通过鼠标傻瓜式点击就能帮忙完成文稿、TTS、渲染、发布全流程。
  - 统一了环境变量名称，全部环境变量放在 `.env`。

## 📷 平台示例

> 看看开发者上传的几百个视频成品吧~

---

<a id="quick-start"></a>
## 🚀 快速开始

1. **环境配置**
   - Node 20+、ffmpeg、克隆仓库、安装依赖；复制 `.env.example` 为 `.env` 并填写。
   - 详细步骤见 [环境配置](#env-setup)。
2. **任选以下一种方式**
   1. **[方式1: 自动化向导](#wizard-automation)**
      - 根目录执行 `pnpm automation`，浏览器内按步骤操作。
   2. **[方式2: Agent Skills](#agent-skills)**
      - 技能定义：**[`.agent/skills`](./.agent/skills)**（各包 `SKILL.md`）。
      - 直接和 AI Agent 对话，让 Agent 调脚本。
   3. **[方式3: CLI 命令行](#cli-usage-guide)**
      - 与向导相同底层命令，适合终端与自动化脚本。
      - 需配置根目录 **`.env`**（口播、TTS、发布等）；说明见 **[CLI 使用指南](./docs/cli-usage-guide.md)**。
3. **[完整工作流示例](./docs/full-workflow.md)**
   - 知乎链路到成片、多平台发布的命令示例合集。

<a id="env-setup"></a>
## 📦 环境配置

### 1. 环境要求

- 安装 **[Node.js 20+](https://nodejs.org/)**（≥ 20.9）。
- **ffmpeg**：须为系统安装并在终端 `PATH` 中（TTS 合并音频等依赖）。
  - macOS：`brew install ffmpeg`
  - Ubuntu：`sudo apt install ffmpeg`
  - Windows：
    - `choco install ffmpeg`（需要管理员权限）
    - 或 [ffmpeg 官网](https://ffmpeg.org/download.html) 下载并配置环境变量

### 2. 获取代码

```bash
git clone https://github.com/szhshp/panda-video-generator.git
cd panda-video-generator
```

### 3. 一键安装

- **推荐：** `pnpm install:project`
- **手动运行：**
  - macOS / Linux：`bash scripts/install.sh`
  - Windows：`powershell -ExecutionPolicy Bypass -File scripts/install.ps1`

### 4. 验证与配置

- 自检：`pnpm check:setup`
- 复制 `.env.example` 为 `.env`，并按分组填写环境变量。

---

<a id="wizard-automation"></a>
## 🧭 自动化向导

用浏览器完成 **文稿 → TTS → 成片渲染 → 发布（可选）**，无需手写命令。

### 怎么用来着?

1. 完成 [环境配置](#env-setup)
2. 在**项目根目录**执行 **`pnpm automation`**。
3. 浏览器自动打开向导。
4. 按步骤完成：**文稿 → TTS → 成片渲染 → 发布（可选）**。
5. 问题反馈：[Issue](https://github.com/szhshp/panda-video-generator/issues)。

---

<a id="agent-skills"></a>
## 🤖 Agent Skills 方式

在已完成 [环境配置](#env-setup) 的前提下，让使用的 AI 工具加载 **[`.agent/skills`](./.agent/skills)** 中的技能说明（例如口播流水线、爬虫、TTS、渲染与发布）。技能文件描述输入输出、命令与环境变量，可与根 README、[CLI 使用指南](./docs/cli-usage-guide.md)、[分步文档](./docs/step-by-step.md) 对照使用。

---

<a id="cli-usage-guide"></a>
## 📚 CLI 使用指南

- 命令行（CLI）示例与输出目录见 **[CLI 使用指南](./docs/cli-usage-guide.md)**；
- 其它分册见 **[文档索引](./docs/README.md)**。

---

<a id="development"></a>
## 🔧 开发

### 启动 Remotion Studio

```bash
pnpm remotion
```

---

<a id="qa"></a>
## ❓ 常见问题

### 渲染时卡在 Downloading Chrome Headless Shell 怎么办？

Remotion 渲染视频时需要 Chrome Headless Shell（约 100 MB），首次运行会自动下载。如果下载慢或被代理工具拦截，可以按需选择以下命令：

```bash
# 无代理
npx remotion browser ensure

# Windows PowerShell（走代理）
$env:HTTPS_PROXY="http://127.0.0.1:10902"; $env:HTTP_PROXY="http://127.0.0.1:10902"; npx remotion browser ensure

# Windows CMD（走代理）
set HTTPS_PROXY=http://127.0.0.1:10902&&set HTTP_PROXY=http://127.0.0.1:10902&&npx remotion browser ensure

# macOS / Linux（走代理）
HTTPS_PROXY=http://127.0.0.1:10902 HTTP_PROXY=http://127.0.0.1:10902 npx remotion browser ensure
```

完成后重新执行渲染命令即可。

---

<a id="feature-status"></a>
## 📋 功能状态

```
功能模块
├── ✅ 自动化向导
├── 🕷️ 网页内容提取
│   ├── ✅ 理论上支持所有公共网页内容提取
│   ├── ✅ 知乎内容 + 问答特殊处理
│   ├── 🚧 HackerNews 总结+处理
│   ├── 🚧 Quora 内容提取
│   ├── 🚧 Reddit 内容提取
│   └── 🚧 And More...
├── 🤖 总结与优化（LLM）
│   ├── ✅ DeepSeek
│   ├── ✅ Kimi / Moonshot
│   ├── 🚧 Doubao
│   ├── 🚧 Qwen
│   ├── 🚧 Hunyuan
│   ├── 🚧 ChatGLM / GLM
│   ├── 🚧 MiniMax
│   └── 🚧 And More...
├── 🎬 文本转视频
│   ├── ✅ 自动生成语音和字幕（TTS）
│   ├── ✅ 自动渲染视频
│   └── ✅ 视频模板系统 
│       ├── ✅ 横屏模板
│       ├── ✅ 竖屏模板
│       ├── ✅ 你可以自由修改视频模板的任何细节
│       └── 🚧 更多模板...
├── 🎞️ 视频素材
│   ├── ✅ 自定义音乐
│   ├── 🚧 AI 生成音乐
│   ├── ✅ 自定义背景
│   └── 🚧 AI 生成背景
├── 🚀 多平台发布
│   ├── ✅ Bilibili 自动发布
│   ├── ✅ 抖音自动发布
│   ├── ✅ 微信视频号自动发布
│   ├── ✅ YouTube 自动发布
│   ├── ✅ 快手自动发布
│   └── 🚧 And More...
├── 🔧 开发工具
│   ├── ✅ 开发服务器
│   └── ✅ CLI 命令行
├── 🧩 AI Integration
│   └── ✅ Agent Skills
├── 🦞 OpenClaw Integration
│   └── 🚧 更多适配
└── ✨ And More...

```

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

## 📄 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

## 👤 作者

**szhshp**

- Email: 24031shp@sina.com
- GitHub: [@szhshp](https://github.com/szhshp)

---

## ⚠️ 免责声明

本项目按「原样」提供，作者不对因使用本软件而产生的任何直接、间接或附带损失承担责任。你在使用爬虫、文本转语音、视频生成、浏览器自动化上传等功能时，须**自行确保**符合适用法律法规、各内容/社交平台的服务条款、robots 规则及版权与隐私要求；请勿将本工具用于未经授权的抓取、侵权转载或垃圾信息传播。本仓库与第三方平台**无任何隶属或合作关系**；相关商标与产品名称归各自权利人所有。以上说明不构成法律意见；如有合规疑虑，请咨询专业人士。
---

<div align="center">
  Made with ❤️ by szhshp x 熊猫智研社
</div>

panda-video-generator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README