用 DeepSeek 驱动 KwaFlux：通过 MCP 接入 DeepSeek Harness（DSH）

要点速览

• DeepSeek Harness（DSH）只要在 cordis.patch.yml 里加一条 insert 插件行，就能连上 KwaFlux。这一行 KwaFlux 会帮你生成。
• 写在你实际运行的 DSH 会读取的位置：主目录级的 ~/.dsh/cordis.patch.yml 对所有配置档生效；某个配置档自己的文件只对它生效。
• DSH 会热重载补丁文件，所以通常不用重启，工具就会出现。
• 把单次工具调用的超时调高，免得 DeepSeek 等长视频任务时被半路掐断。

DeepSeek 的 Agent 可以通过随 KwaFlux 一起安装的本地 MCP 服务来操作 KwaFlux。DeepSeek Harness（DSH）通过一个分层的配置文件 cordis.patch.yml 加载 MCP 服务，每个服务是一条插件行。在 KwaFlux 里把 MCP 宿主选为 DeepSeek，复制这一行，追加到你的 DSH 配置档会读取的补丁文件里就行。

本文会讲这一行该写在哪儿、为什么配置档很重要、要调哪个超时，以及先让 DeepSeek 做什么。

目录

1. DSH 怎么加载 MCP 服务
2. 开始之前
3. 第 1 步：从 KwaFlux 复制这一行
4. 第 2 步：选对补丁文件
5. 第 3 步：追加这一行
6. 第 4 步：确认已加载
7. 第一批指令
8. 问题排查
9. 常见问题

DSH 怎么加载 MCP 服务

DeepSeek Harness 由多层补丁文件拼出最终配置。每个配置档有自己的 cordis.patch.yml；主目录级的 $DSH_HOME/cordis.patch.yml，按 CLI 参考文档的说法，是“本机的偏好设置，所有配置档共享，因此优先级高于各配置档自己的那一层”。

MCP 服务是用 DSH 的 MCP 客户端插件 @deepseek-ai/dsh-mcp-client 写成的插件行。DSH 默认一个都不开：参考文档解释说，“每个服务命令都是在 Agent 沙箱之外运行的可信可执行代码”。所以，加上 KwaFlux，就是你明确选择信任 KwaFlux 的服务。

开始之前

• KwaFlux 1.0.14 或更新版本，并且开着。
• Node.js 18 或更新版本，且在 PATH 中。 用 node --version 确认。KwaFlux 设置卡片也会查找 Node.js，并把它的完整路径写进配置，下面的示例就是这样；如果找不到，卡片会提示你，并改写成 node。
• 已安装 DeepSeek Harness。 DSH 的文档标着 Preview（预览版），路径和命令可能随版本变化。

第 1 步：从 KwaFlux 复制这一行

在 KwaFlux 里打开 设置 › Agent（MCP），在 MCP 宿主 里选 DeepSeek，点 复制配置。Windows 默认安装位置对应的内容是：

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']

补充： 路径放在单引号里。在 YAML 里，单引号字符串会原样保留反斜杠，所以 Windows 路径不用转义。

第 2 步：选对补丁文件

KwaFlux 的提示写的是一个文件：“作为 insert 插件行写入 ~/.dsh/profiles/web/cordis.patch.yml，然后重启 DSH 会话。”如果你用的是 DSH 的 web 配置档（dsh web），这样就对了。用别的方式的话，按下表选：

在 Windows 上，~ 指的是 C:\Users\<你>。如果你设置过 DSH_HOME，就用那个文件夹代替 ~/.dsh。

KwaFlux 在 DSH 里“不出现”，最常见的原因就是这一行写进了一个你没在用的配置档。

第 3 步：追加这一行

1. 先备份这个文件。
2. 补丁文件是一个 YAML 列表。把 KwaFlux 这一行加在末尾，缩进和其他顶层的 - insert: 或 - replace: 项保持一致。
3. 如果文件还不存在，就新建一个，里面只放 KwaFlux 这一行。
4. 可选：在 config: 里调高工具超时：

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
        toolCallTimeoutMs: 330000

一篇第三方配置指南提到，DSH 单次调用的默认超时是 60 秒。KwaFlux 的等待工具一次最多等 300 秒，设成 330,000 毫秒能留出余量。如果你的 DSH 版本不认这个字段，删掉它就行，被掐断之后 DeepSeek 照样可以再等一次。

第 4 步：确认已加载

DSH 会监视补丁文件，通过热重载应用有效的修改，所以通常保存后几秒，服务就启动了。如果没反应，就照 KwaFlux 的提示重启 DSH 会话。

然后问：

用 KwaFlux 的工具查一下 KwaFlux 开着没有。

在 DSH 里，KwaFlux 的工具名是 mcp__kwaflux__<工具名>，比如 mcp__kwaflux__kwaflux_get_app_status。如果 KwaFlux 没开，工具会返回一个以 app_not_running 开头的错误。

第一批指令

智能补帧，以及抠像和替换类工具，仍要在应用里做，助手会被告知把你引导过去。AI 发起下载默认关闭，要在 Agent 授权 里把 允许 Agent 发起下载 设为 每次确认。之后每次下载 KwaFlux 都会弹窗问你，助手也会在对话里请你确认有权下载那些内容。

问题排查

各个宿主都会遇到的问题，见 KwaFlux MCP 排障指南。

结语

从 KwaFlux 复制这一行，写进你实际运行的 DSH 会读取的补丁文件，再为视频任务加一个更长的工具超时。DSH 保存即生效。然后保持 KwaFlux 开着，在第一个正式任务之前，先让 DeepSeek 查一下应用状态。

用 DeepSeek 驱动 KwaFlux

KwaFlux 自带本地 MCP 服务，支持 DeepSeek Harness 等 MCP 应用。AI 处理在你自己的 GPU 上运行，媒体文件不会为了处理而上传。可在 Windows 10（64 位，1809 或更新版本）、Windows 11，以及搭载 Apple Silicon 的 macOS 12 或更新版本上运行。导入文件和浏览应用都不需要账号。仅在导出、转换、文件修复和从链接下载文件时需要登录并购买付费方案。

下载 KwaFlux · 查看方案