用 DeepSeek 操作 KwaFlux：透過 MCP 連接 DeepSeek Harness（DSH）

重點速覽

• DeepSeek Harness（DSH）只要在 cordis.patch.yml 檔案裡加一筆 insert 列，就能連上 KwaFlux。這一列 KwaFlux 會替你產生。
• 要放在你實際執行的 DSH 會讀取的地方：家目錄層的 ~/.dsh/cordis.patch.yml 對所有設定檔都有效；設定檔自己的檔案只對該設定檔有效。
• DSH 會熱重載 patch 檔，所以工具通常不必重新啟動就會出現。
• 調高單次呼叫的工具逾時，DeepSeek 等待長時間的影片任務時，才不會被中途切斷。

DeepSeek 的 Agent 可以透過隨 KwaFlux 一起安裝的本機 MCP 伺服器來操作 KwaFlux。DeepSeek Harness（DSH）會把 MCP 伺服器當成外掛列，從一個名為 cordis.patch.yml 的分層設定檔載入。在 KwaFlux 的 MCP 宿主裡選擇 DeepSeek，複製這一列，附加到你的 DSH 設定檔所讀取的 patch 檔即可。

本文會說明：這一列該放在哪裡、為什麼設定檔很重要、要調高哪個逾時，以及一開始可以先請 DeepSeek 做什麼。

目錄

1. DSH 如何載入 MCP 伺服器
2. 開始之前
3. 第 1 步：從 KwaFlux 複製設定列
4. 第 2 步：選對 patch 檔
5. 第 3 步：附加設定列
6. 第 4 步：確認已經載入
7. 先試這幾個指令
8. 問題排解
9. 常見問題

DSH 如何載入 MCP 伺服器

DeepSeek Harness 的設定由好幾層 patch 檔疊加而成。每個設定檔（profile）都有自己的 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.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 步：選對 patch 檔

KwaFlux 的提示只寫了一個檔案：「以 insert 外掛列寫入 ~/.dsh/profiles/web/cordis.patch.yml，然後重啟 DSH 工作階段。」如果你用的是 DSH 的 web 設定檔，也就是 dsh web，照做就對了。如果你用的是別的方式，請依下表選擇：

在 Windows 上，~ 指的是 C:\Users\<you>。如果你設定過 DSH_HOME，請用那個資料夾取代 ~/.dsh。

KwaFlux 在 DSH 裡「沒有出現」，最常見的原因是設定列放進了你沒有在執行的設定檔。

第 3 步：附加設定列

1. 先備份這個檔案。
2. patch 檔是一份 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 會監看 patch 檔，並透過熱重載套用有效的修改，所以存檔後幾秒內，伺服器通常就會啟動。如果沒有任何變化，就照 KwaFlux 提示說的，重新啟動 DSH 工作階段。

接著問：

用 KwaFlux 的工具確認 KwaFlux 有沒有在執行。

在 DSH 裡，KwaFlux 的工具名稱是 mcp__kwaflux__<tool>，例如 mcp__kwaflux__kwaflux_get_app_status。如果 KwaFlux 沒有開啟，工具會回傳以 app_not_running 開頭的錯誤。

先試這幾個指令

補幀，以及去背和替換類工具，都留在應用程式裡；遇到這些需求時，AI 助理會被告知請你回到應用程式操作。Agent 發起下載預設保持關閉，除非你在 Agent 授權 底下把 允許 Agent 發起下載 設為 每次確認。之後每次下載，KwaFlux 都會跳出視窗，AI 助理也會在對話裡請你確認自己有權下載該內容。

問題排解

各個宿主都可能遇到的問題，請見 KwaFlux MCP 問題排解指南。

結語

從 KwaFlux 複製設定列，放進你實際執行的 DSH 會讀取的 patch 檔，再為影片任務加上較長的工具逾時。DSH 存檔就會重新載入。接著讓 KwaFlux 保持開啟，在第一個正式任務之前，先請 DeepSeek 查詢應用程式的狀態。

用 DeepSeek 操作 KwaFlux

KwaFlux 內建本機 MCP 伺服器，支援 DeepSeek Harness 和其他 MCP 應用程式。AI 處理在你自己的 GPU 上執行，媒體檔案不會為了處理而上傳。可在 Windows 10（64 位元，1809 或更新版本）、Windows 11，以及搭載 Apple Silicon 的 macOS 12 或更新版本上執行。匯入檔案和瀏覽應用程式都不需要帳號。僅在匯出、轉換、檔案修復和從連結下載檔案時需要登入並購買付費方案。

下載 KwaFlux · 查看方案