yu-wenchao/dsh-tool-lipsync

dsh-tool-lipsync

DSH Plugin
License
DSH Version

免 Key、免登录的 AI 对口型口播视频生成插件，为 DeepSeek Harness (DSH) 注册 5 个工具，使用免费开放 API 生成对口型视频。

3000+ 声音 · 500+ 语言 · 最长 20 秒 · 无水印 · 1-3 分钟出片

功能一览

| 工具 | 作用 |
|---|---|
| lipsync_list_voices | 列出预设声音（按语言/关键词筛选） |
| lipsync_list_samples | 列出示例人脸/宠物/卡通素材 |
| lipsync_generate | 提交对口型口播视频生成任务 |
| lipsync_status | 轮询生成状态（5-6 秒/次） |
| lipsync_download | 下载成片 MP4 到本地 |

免费层特性

- 无需 API Key、无需登录账号
- 最长 20 秒视频，无水印
- 大多数 1-3 分钟内生成完成
- 支持中文、英文、日文等 500+ 语言预设声音
- 支持自定义人脸图片

安装

方式一：CLI 安装（推荐）

在 DSH Web profile 中安装
dsh plugin --profile web add github:yu-wenchao/dsh-tool-lipsync

安装后重启 DSH 即可生效。

方式二：一键安装包

1. 下载本仓库 Release 中的安装包
2. 解压到任意目录
3. 双击 安装.bat
4. 按提示选择安装目录，等待安装完成
5. 双击 重启.bat 重启 DSH

方式三：手动安装

克隆仓库
git clone https://github.com/yu-wenchao/dsh-tool-lipsync.git

安装到 DSH web profile
dsh plugin --profile web add ./dsh-tool-lipsync

卸载

dsh plugin --profile web remove dsh-tool-lipsync

或使用安装包中的 卸载.bat。

使用示例

在 DSH 对话中输入：

帮我用 FreeLipSync 做一段口播视频，让这个人说"大家好，欢迎收看今天的节目"。先列出中文声音和示例人脸素材，然后生成，完成后下载到工作区。

模型会自动调用：
1. lipsync_list_voices — 获取中文声音列表
2. lipsync_list_samples — 获取示例人脸素材
3. lipsync_generate — 提交生成任务
4. lipsync_status — 轮询进度
5. lipsync_download — 下载成片

高级用法

指定声音和人脸生成
请用日语女声，配合示例人脸素材，生成一段 15 秒的口播视频，内容是"こんにちは、世界"

使用自定义人脸
用这张图片作为人脸 https://example.com/face.jpg，配上英文男声说"This is a test"

批量生成
分别用中文、英文、日文生成三段口播视频，内容都是"欢迎订阅我的频道"

工作原理

DSH 对话 → lipsync_generate 工具调用
↓
提交生成任务到后端 API
↓
轮询查询生成状态
↓
下载成片 MP4
↓
保存到本地工作区

- 首次请求自动建立匿名会话
- 所有 API 调用完全开放、无 Key、无登录
- 插件通过 HTTP 代理绕过浏览器限制

技术细节

插件结构

dsh-tool-lipsync/
├── package.json          # DSH bundle manifest
├── cordis.patch.yml      # 向 profile 组合插入本插件
├── lib/
│   ├── index.js          # 插件入口（注册 5 个工具）
│   ├── index.d.ts        # TypeScript 类型定义
│   └── client.js         # Web UI 面板（可选）
└── README.md

API 接口

| 接口 | 方法 | 说明 |
|---|---|---|
| /api/catalog/voices | GET | 获取声音列表 |
| /api/samples | GET | 获取示例素材 |
| /api/generate | POST | 提交生成任务 |
| /api/status/batch | POST | 批量查询状态 |
| /api/download/{id} | GET | 下载成片 |

依赖

- DeepSeek Harness >= 0.1.0-rc.6
- Node.js >= 18
- 网络连接

注意事项

- 免费层输出为低清 preview 版；高清无水印原片需登录/付费
- 本插件依赖第三方免费服务，其免费额度与接口随时可能调整
- 请注意素材/肖像版权
- 后端接口未来可能变动

常见问题

Q: 安装后 DSH 报错 "Failed to load plugins"

A: 重启 DSH 即可。如果仍然报错，检查 DSH 版本是否 >= 0.1.0-rc.6。

Q: 生成的视频在哪里？

A: 默认保存在 DSH 工作区目录下。使用 lipsync_download 工具时可以指定保存路径。

Q: 支持自定义人脸吗？

A: 支持。在 lipsync_generate 工具中传入 faceUrl 参数即可，支持任何公开可访问的图片 URL。

Q: 生成速度慢怎么办？

A: 免费层生成速度取决于服务器负载，通常 1-3 分钟。可以使用 lipsync_status 工具轮询进度。

许可证

MIT License

相关链接

- DeepSeek Harness
- Awesome DSH Plugin