dsh-h3-kit-cam —— 摄像机按钮 · ComfyUI 视频生成插件

在 DeepSeek Harness（DSH）Web 聊天框工具栏新增摄像机按钮，引导用户选择 ComfyUI 启动器路径与工作流 JSON 文件，并在配置完备后动态注册 h3-video-gen 技能， 让模型在后台执行「启动 ComfyUI → 按需求修改工作流参数 → 转换提交 → 监控 → 验证输出」 的完整视频生成流程。

• 插件本体：packages/h3-kit-cam/（client 半区 = 摄像机按钮与弹窗交互；host 半区 = 设置命名空间 + 技能注册）
• 宿主补丁清单：patches/host-patches.json（8 处，DSH 升级后需重新应用）
• CLI 安装助手：bin/cli.js

安装

cd profiles/web        # 或任意 DSH profile 目录
npm i dsh-h3-kit-cam
npx dsh-h3-kit-cam install   # 追加 file: 依赖与 bundles 条目
pnpm install
npx dsh-h3-kit-cam patch apply

然后重启 DeepSeek Harness 桌面应用。

使用

1. 点聊天框工具栏的摄像机按钮（+ 与盾牌右侧，金色圆圈）。
2. 第一步选择本地 ComfyUI 启动器路径（目录对话框）；第二步选择工作流文件 （原生文件选择对话框，直接选 .json 工作流，路径自动回填）。
3. 确认后弹出「请编写本次视频的全部参数、参考图、剧情」，确定后聚焦聊天输入框。
4. 发送视频需求，模型按 h3-video-gen 技能在后台执行完整流程，完成后汇报视频路径与规格。

宿主补丁（必须）

DSH 的核心包（apiproxy / directory-picker-native / client-connection）没有插件级 RPC 扩展点，host.pickFile（原生文件选择）需要补丁以下 8 处才能工作。 DSH 升级或重装会覆盖这些文件，届时重新运行 dsh-h3-kit-cam patch apply 即可。

| # | 补丁 id | 文件 | 作用 | | --- | --- | --- | --- | | 1 | apiproxy-settings-ns | @deepseek-ai/dsh-host-apiproxy/lib/index.js | h3-cam 设置命名空间白名单 | | 2 | apiproxy-pickfile-schemas | 同上 | host.pickFile 请求/响应 schema | | 3 | apiproxy-pickfile-handler | 同上 | api.host.pickFile handler | | 4 | apiproxy-pickfile-rpc | 同上 | RPC 方法表注册 host.pickFile | | 5 | native-picker-pickfile | @deepseek-ai/dsh-host-directory-picker-native/lib/index.js | native capability 增加 pickFile | | 6 | worker-file-mode | .../lib/worker.cjs | Win32 对话框文件模式（0x4C，去掉 PICKFOLDERS） | | 7 | client-connection-pickfile | @deepseek-ai/dsh-client-connection/lib/client.js | 客户端 RPC 面 host.pickFile + value schema | | 8 | client-connection-privileged | .../lib/index.js | PRIVILEGED_METHODS 增加 host.pickFile |

CLI 操作：

npx dsh-h3-kit-cam patch status            # 检测 8 处补丁状态（✓/✗）
npx dsh-h3-kit-cam patch apply             # 应用缺失补丁（幂等；首次自动备份 <file>.bak）
npx dsh-h3-kit-cam patch restore           # 从 .bak 恢复所有受影响文件
npx dsh-h3-kit-cam patch apply --host <dir> # 宿主根目录不是默认位置时指定

宿主根目录探测顺序：--host <dir> > 环境变量 DSH_HOST_PATH > %LOCALAPPDATA%\Programs\@deepseek-aidsh-desktop\resources\host。 patch restore 不会删除 .bak；再次 patch apply 会重新打补丁。 注意：dsh-client-connection 在 host 与 profile 侧可能是硬链接，patch apply 一次即两边生效。

常见问题

• 选中文件后输入框不更新：旧版插件解析 RPC 响应形状错误（取不到 response.result.value.path）。 0.1.0 已修复；刷新页面（F5）后重试。
• 弹窗打开是「选择文件夹」：宿主补丁未应用或 DSH 已升级。运行 dsh-h3-kit-cam patch status， 未应用则 patch apply 后重启应用。
• 设置页看不到 h3-cam 配置：补丁 1（apiproxy 白名单）未生效。

修改技能模板

直接编辑 packages/h3-kit-cam/skills/SKILL.md（保留 YAML frontmatter 的 name/description/whenToUse），重启应用即可生效，无需重新构建。

发布

npm publish   # 需已登录 npm（npm whoami）

许可

MIT