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 或幻方官方无从属关系。如需自行开发或审查源码，请访问下方链接。