phillarmonic/dsh-llm-kimi: DeepSeek Harness 的 Kimi K3 連接器

前言¶

DeepSeek Harness 的 llm 能力 seam 提供了統一的接口，但在對接第三方模型（如 Kimi K3）時需要額外的適配層。phillarmonic/dsh-llm-kimi 是一個直接-fetch LlmAdapter 插件，它將 Kimi Code 的聊天補全（OpenAI 兼容協議）轉換爲 DSH 的 StreamChunk，無需重啓即可在請求間切換 base URL、catalog 或 key。

插件介紹¶

該插件由 phillarmonic 維護，旨在解決 DeepSeek Harness 中接入 Kimi K3 系列模型的需求。它支持流式輸出、圖像輸入及推理努力配置，直接掛載到 DSH 的模型推理路由上。

核心功能¶

模型支持：支持 Kimi K3 系列模型，包括 k3、k3-256k、kimi-for-coding 和 kimi-for-coding-highspeed。
流式傳輸：提供 OpenAI 兼容的流式傳輸協議。
圖像輸入：支持圖像輸入，並內置預算限制以防止超出模型單消息大小限制。
推理控制：支持推理努力設置（reasoningEffort）。
直接-fetch：直接實現 LlmAdapter，處理底層請求邏輯。

安裝與啓用¶

使用 DeepSeek Harness 的插件管理命令安裝，插件會自動註冊到 llm 路由。

dsh plugin --profile <name> add @phillarmonic/dsh-llm-kimi
dsh --profile <name>

如果直接組合 cordis.yml，也可以手動添加依賴：

pnpm add @phillarmonic/dsh-llm-kimi

配置¶

在 cordis.yml 中配置插件。所有字段均爲可選，默認配置指向公共 Kimi Code 端點。

plugins:
  llm: {}
  '@phillarmonic/dsh-llm-kimi':
    apiKeyEnv: KIMI_CODE_API_KEY
    reasoningEffort: low

隨後在環境變量中導出 Key（Key 可從 api.kimi.com 控制台獲取）：

export KIMI_CODE_API_KEY=sk-...

典型用法¶

在使用任務或查詢時，選擇 kimi-code 作爲 provider，並指定具體模型（例如 k3）。插件會根據配置讀取環境變量並處理請求。

注意事項¶

固定採樣：Kimi 強制執行固定採樣，默認不發送 temperature 等參數，除非顯式開啓 sendTemperature。
工具調用：思考內容必須包含在工具調用中，插件會自動將 reasoning block 複用爲 reasoning_content 字段。
圖像限制：插件在讀取附件前會進行預算檢查。像素預算上限爲 8294400（默認 4K），字節限制爲 1048576。超出限制的請求會被拒絕。

生態背景¶

DeepSeek Harness 生態強調「一切皆插件」。本插件目錄與 GitHub 倉庫僅爲社區資源索引，與 DeepSeek 或幻方官方無從屬關係。如需自行開發或審查源碼，請訪問下方鏈接。