dsh-tool-lipsync
免 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 即可生效。
方式二：一键安装包
- 下载本仓库 Release 中的安装包
- 解压到任意目录
- 双击
安装.bat - 按提示选择安装目录，等待安装完成
- 双击
重启.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
