前言¶

DSH 的理念是「一切皆插件」。dsh-frostfin 是其中一個 loop 插件：它把 DSH 會話的驅動者交給 Kimi Code 的 kimi acp 子進程，讓 Kimi Code 的 agent loop 運行在 DSH 的界面與審批體系內。

這是什麼¶

dsh-frostfin 的定位是：Kimi Code as the agent loop of DeepSeek Harness — ACP bridge loop plugin。

它以 MIT 許可發佈，當前包版本爲 0.2.0，倉庫地址爲 https://github.com/pzc2004/dsh-frostfin。使用它需要已有登錄態的 Kimi Code；DSH 安裝需要 Node.js ≥ 22.19。

核心功能¶

下面介紹已覈實的主要能力。

• loop 橋：DSH 會話由 kimi acp 子進程驅動，流式回話、思考塊、工具調用、計劃塊均爲 DSH 原生渲染。
• 審批橋：Kimi 的工具審批請求落到 DSH 原生審批彈窗，命令預覽與工具卡片 callId 對齊。
• 提問通道：Kimi 的 AskUserQuestion 通過 DSH 插件自建的多選模態框處理；跳過/取消按用戶未作答處理。
• 圖片輸入：輸入區粘貼的圖片經 DSH 附件存儲轉爲 base64 後發送到 Kimi，Kimi 側做格式門控與壓縮。
• 會話生命週期：支持 DSH 重啓恢復、Kimi 進程崩潰自愈、接入既有 Kimi 會話並回放歷史。
• 模式分發：新增「月芒霜鰭鯨」模式並設爲默認，標準模式走原生 loop；會話創建後驅動方鎖定。
• 模型層打通：顯示 Kimi 真實模型列表，DSH 中配置的模型可同步進 Kimi 配置。
• 狀態條與斜槓命令：顯示 Kimi 模型、thinking 檔位、權限模式、上下文佔用、工作目錄與 git 分支，並支持插件與 Kimi 命令切換。
• goal 與 plan：DSH 的 /goal 可驅動 Kimi 會話；Kimi 的 plan 模式經 /frostfin-mode plan 生效，爲引擎級只讀。
• 可逆性：卸載時撤銷註冊並恢復 kimi config.toml 託管塊，但保留 ~/.frostfin 下的會話綁定與模型緩存。

安裝與啓用¶

先安裝 Kimi Code 並登錄¶

macOS / Linux：

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows：

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Windows 首次啓動前需要安裝 Git for Windows。

安裝完成後，先運行 kimi，並在 TUI 中用 /login 登錄。frostfin 通過 kimi acp 子進程驅動，會複用該登錄態。

再安裝 DSH¶

啓動 DSH Web：

npx @deepseek-ai/dsh web

資料中提到 DSH 版本鎖爲 @deepseek-ai/dsh@0.1.0-rc.x。

安裝 dsh-frostfin¶

Web profile：

npx @deepseek-ai/dsh plugin --profile web add dsh-frostfin

安裝後重啓 DSH Web：

npx @deepseek-ai/dsh web

Headless profile：

npx @deepseek-ai/dsh plugin --profile headless add dsh-frostfin

Headless 場景下只有宿主半身生效，面板端點與輸入區按鈕不出現。

源碼安裝：

git clone https://github.com/pzc2004/dsh-frostfin.git
cd dsh-frostfin && pnpm install && pnpm build
npx @deepseek-ai/dsh plugin --profile web add .

升級：

npx @deepseek-ai/dsh plugin --profile web update dsh-frostfin

升級後重啓 dsh web。

卸載：

npx @deepseek-ai/dsh plugin --profile web remove dsh-frostfin

卸載會撤銷註冊並恢復 kimi config.toml 託管塊，但保留 ~/.frostfin 下的會話綁定與模型緩存。若要徹底清除本地狀態：

rm -rf ~/.frostfin

典型用法¶

接入既有 Kimi 會話：

/frostfin-attach

也可以在「月芒霜鰭鯨」tab 中一鍵接入。

權限模式選擇：

• 日常：/yolo
• 逐步審閱：default
• 只讀方案：/frostfin-plan
• 無人值守：/auto

常用斜槓命令：

/frostfin-mode
/frostfin-thinking
/frostfin-plan
/yolo
/auto

Kimi 內建命令可透傳：

/compact
/status
/usage
/mcp
/tasks
/help

DSH 的 /goal 可以驅動 Kimi 會話。Kimi 會話的 plan 模式使用 /frostfin-plan，也可通過 /frostfin-mode plan 生效；該模式是引擎級只讀。

適用場景與注意¶

適合已經使用 DSH Web 或 headless 宿主，並且希望把 Kimi Code 的 agent loop 接到 DSH 會話中的場景。安裝前請檢查源碼與 MIT 許可證；插件隨 DSH 宿主運行，會使用當前 dsh 進程的權限。

需要注意：

• frostfin 會話主要管理 Kimi 權限模式；DSH 的 Workspace Write 沙箱管不到 Kimi 進程內工具。
• 建議保留 DSH 默認 workspace-write，避免 danger-full-access。danger-full-access 會把 approval policy 改成 never，並在插件配置 permission: 'ask' 時讓後續所有審批被自動拒絕。
• yolo 模式對 .env、SSH 密鑰、憑據和 .git 控制目錄仍會發問。
• auto 模式全部自批，連提問工具都會被拒，不適合暴露敏感目錄。
• DSH 的 /plan 只對原生 loop 會話有效；Kimi 會話的 plan 模式用 /frostfin-plan。
• 需要已有 Kimi Code 登錄態。
• Windows 首次啓動前需安裝 Git for Windows。

結尾¶

dsh-frostfin 的價值在於保留 DSH 的插件宿主與審批界面，同時讓 Kimi Code 作爲會話驅動方。倉庫地址：

https://github.com/pzc2004/dsh-frostfin