ChatCut 视频剪辑nigedazhima/dsh-plugin-chatcut

dsh-plugin-chatcut

在 DeepSeek Harness 里用 AI 剪视频。

把 ChatCut（Agent 原生视频编辑器）接入 DSH (DeepSeek Harness)：50 个剪辑工具 + 15 个官方 craft skills，OAuth 只配一次，token 全自动续期。

English · 快速开始 · 工作原理

#dsh-plugin #mcp #video-editing #chatcut

演示：agent 删口水词，时间线自动闭合

能做什么

对你的 DSH agent 说人话即可：

- 🎙️ 口播清理 — 「删掉所有口水词和尴尬停顿」（转录驱动剪辑：agent 改文字，时间线跟着变）
- ✂️ 高光切片 — 「剪一个 30 秒讲定价的版本」「保留最好的一条」
- 💬 字幕 — 样式化、双语、逐词卡拉 OK 高亮
- 🎨 MG 动画 — JSX 代码生成，或直接用 ChatCut 模板库
- 🔍 Zoom、转场、LUT、音效 — 内置素材库直接调用
- 🖼️ AI 生成 — 图片（GPT Image）、视频（Seedance）、音乐、TTS、声音克隆
- 📤 导出 — mp4 / 音频 / SRT / NLE XML（Premiere · 达芬奇 · FCP）/ MG 透明底 ProRes

所有操作落在真正的多轨 NLE 时间线上，你随时可以在 chatcut.io 手动接管——agent 和你实时共享同一个项目。

为什么需要这个插件

ChatCut 官方只提供 Claude Code 和 Codex 插件。本项目把它适配到 DSH：

| 官方插件 | 本适配 |
|---|---|
| MCP 服务器（streamable-http + OAuth） | 经 @deepseek-ai/dsh-mcp-client 桥接（stdio 桥） |
| claude mcp login 管 OAuth | chatcut-login.mjs — 标准 PKCE + 动态注册 |
| 宿主负责 token 保鲜 | chatcut-bridge.mjs 401 时自动刷新并落盘 |
| 15 个 craft skills | 原样装入 $DSH_HOME/skills/，外加一层 DSH 宿主适配 skill |

token 配置一次，之后永远不用管。

快速开始

前提：ChatCut 账号（免费档即可）、DSH Desktop、能访问 api.chatcut.io 的网络（国内一般需要代理）。

git clone https://github.com/nigedazhima/dsh-plugin-chatcut.git
cd dsh-plugin-chatcut

1. 登录（仅一次） — 会打开浏览器完成 ChatCut 授权：

macOS 用 DSH Desktop 内置 Node（无需安装 Node）：
ELECTRON_RUN_AS_NODE=1 "/Applications/DSH Desktop.app/Contents/MacOS/DSH Desktop" scripts/chatcut-login.mjs
或已有 Node >= 18：
node scripts/chatcut-login.mjs

token 写入 scripts/.tokens.json（已 git-ignore，权限 0600）。网络受限时前面加 HTTPS_PROXY=http://127.0.0.1:。

2. 安装 skills：

cp -R skills/chatcut "$HOME/Library/Application Support/dsh-desktop/harness/skills/"

3. 挂载 MCP — 把 cordis-patch-example.yml 内容追加进你的 $DSH_HOME/cordis.patch.yml，两处  替换为本仓库绝对路径。

4. 重启 DSH Desktop。 新会话里问：「列出你的 mcp__chatcut__ 工具」——应出现约 50 个。

工作原理

DSH agent ──(stdio MCP)── chatcut-bridge.mjs ──(streamable-http + Bearer)── api.chatcut.io
│
├─ 401? → refresh_token 换新 → 落盘
└─ .tokens.json（0600，git-ignore）

- 桥复用 DSH 自带的官方 @modelcontextprotocol/sdk——macOS 上零 npm 安装。
- skills 是 ChatCut 官方 craft skills 原样再分发（口播指南、MG、字幕、导出……），外加一层薄适配把 Claude Code 专属机制（工具前缀、登录命令、浏览器面板）映射到 DSH。
- 杀手级工作流是转录驱动剪辑：read_script → 在 markdown 里用 删除线 编辑 → apply_script。在文本里删一句话，时间线上就删了这一段。

常见问题

| 现象 | 原因 / 处理 |
|---|---|
| 会话里没有 mcp__chatcut__ 工具 | 桥启动失败——查 harness 日志；多半是缺 .tokens.json（跑一次登录） |
| 桥提示 refresh_token 失效 | 重跑 chatcut-login.mjs（一轮浏览器授权） |
| api.chatcut.io 超时 | 网络问题；登录脚本加 HTTPS_PROXY，桥则在 cordis 段 env 里加 |
| 工具在但调用失败 | 确认浏览器编辑器登录的是同一个 ChatCut 账号 |

安全说明

- 仓库不含任何凭据。.tokens.json 由你本地生成且被 git-ignore。
- OAuth 客户端动态注册（RFC 7591），无共享 client secret。
- token 文件 0600；refresh token 每次刷新自动轮换。

许可

GPL-3.0-only —— 与上游 ChatCut agent-plugin 一致，skills/chatcut/resources/ 为其原样再分发。

致谢

- ChatCut —— 编辑器与官方 agent 插件
- DeepSeek Harness —— 可插拔 agent 运行时

如果它帮你省下了一个剪辑下午，点个 ⭐ 能让更多人找到它。*