DeepSeek Harness (DSH) 插件：集成 Kimi Code 賬戶與自動刷新

前言¶

DeepSeek Harness (DSH) 採用插件化架構，旨在讓模型推理能力通過插件形式靈活接入。集成第三方模型通常需要手動配置 Provider 路由。myk5010/dsh-kimi 是一個插件包，它將 Kimi (Kimi Code 賬戶) 作爲第一類模型提供商集成到 DSH 中，提供路由、模型、設備碼登錄和自動 Token 刷新。

核心功能¶

該插件包含以下核心能力：

• Provider Route：配置 kimi provider，覆蓋 https://api.kimi.com/coding/v1，使用 OpenAI Responses protocol (pi-ai adapter)。
• 模型列表：提供四個模型選項：kimi-for-coding (K2.7 Coding)、kimi-for-coding-highspeed、k3 (1M context) 和 k3-256k。
• 登錄方式：使用 Kimi Code 的 device-code OAuth 流程。DSH 擁有獨立的 OAuth 會話，其 refresh-token 家族與 Kimi Code CLI 的 Token 隔離，因此刷新不會導致 CLI 登出。
• 自動刷新：Token 每 5 分鐘檢查一次，在過期前自動刷新。Access Token 存儲在 KIMI_CODE_ACCESS_TOKEN 憑證引用中。
• Agent 工具：提供三個命令行工具供 Agent 調用：kimi_login_begin、kimi_login_status、kimi_login_refresh。
• 兼容性設計：如果 DSH Host 提供了 authorization 服務，該插件會將設備碼流程註冊爲 llm-pi-ai/kimi 的授權流程。

安裝與啓用¶

1. 從 GitHub Releases 下載對應的 tarball 包。
2. 使用 dsh plugin 命令安裝，指定 profile（如 web）。

dsh plugin --profile web add ./dsh-kimi-provider-<version>.tgz

安裝後需重啓 DSH Web 進程。

典型用法¶

初次使用需要在 DSH 中完成 Kimi 賬戶授權：

1. 啓動授權：讓 Agent 運行 kimi_login_begin 命令。這會返回一個 Kimi 授權 URL 和設備碼。
2. 確認授權：在瀏覽器中打開返回的 URL 並完成確認。
3. 完成：重啓 DSH Web 進程後，模型選擇器中即可看到四個 Kimi 模型。Token 將在後臺自動維護。

對於 Headless 環境或其他 Profile，安裝命令如下：

dsh plugin --profile headless add ./dsh-kimi-provider-<version>.tgz

適用場景與注意事項¶

該插件適合需要在 DSH 環境中使用 Kimi Code 模型的用戶，它減少了手動配置 Provider 和管理 Token 的開銷。

運行環境要求：

• DSH Host：需 0.1.2-alpha.4 版本（或任何包含 pi-ai LLM 適配器、dsh plugin bundles 和 credentials 服務的版本）。
• Node.js：需 >= 22.19。
• 依賴：系統需安裝 curl，用於 OAuth HTTP 調用。

安全與存儲：

• Token 存儲在 DSH 的憑證存儲中，路徑爲 ~/.dsh/.credentials.yaml，文件權限爲 0600。
• Refresh Token 僅存儲在 KIMI_CODE_REFRESH 憑證引用中（JSON 字符串），不會出現在源碼或日誌中。
• DSH 的 OAuth 會話與 Kimi Code CLI 獨立，互不干擾。

總結¶

myk5010/dsh-kimi 通過插件形式將 Kimi Code 的能力無縫接入 DSH 生態，提供了自動化的 Token 管理和模型路由，降低了第三方模型集成的門檻。

• 目錄頁：[catalog_url]
• 源碼：[github_url]