phillarmonic/dsh-llm-kimi

@phillarmonic/dsh-llm-kimi

一个用于 DeepSeek Harness llm 能力接缝的 Kimi K3 连接器插件。

它为 kimi-code 提供方路由注册一个直接抓取的 LlmAdapter，将 Kimi Code 聊天补全（一种 OpenAI 兼容方言）作为 harness 的 StreamChunk 进行流式传输。连接信息按请求解析，因此更改后的 base URL、目录或密钥无需重启即可在下一个请求中生效。

安装

作为 DeepSeek Harness 捆绑包安装，以便 dsh plugin 自动注册它：

dsh plugin --profile  add @phillarmonic/dsh-llm-kimi
dsh --profile

或者在你直接编写 cordis.yml 时手动添加：

pnpm add @phillarmonic/dsh-llm-kimi

harness 包是 peer 依赖；如果尚未安装，请将它们与插件一起安装：

pnpm add @deepseek-ai/cordis @deepseek-ai/dsh-llm @deepseek-ai/dsh-credentials \
@deepseek-ai/dsh-settings @deepseek-ai/dsh-launch-environment @deepseek-ai/dsh-timeout \
@deepseek-ai/dsh-attachment @deepseek-ai/schemastery

配置

将插件添加到你的 cordis.yml。每个字段都是可选的；默认值指向公共 Kimi Code 端点。

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

然后导出你的密钥（来自 api.kimi.com 的 Kimi Code 控制台），或通过 harness 凭据服务存储它：

export KIMI_CODE_API_KEY=sk-...

在运行任务时选择提供方和模型，例如提供方 kimi-code 搭配模型 k3。

配置项

| 字段 | 默认值 | 描述 |
| --- | --- | --- |
| apiKeyEnv | KIMI_CODE_API_KEY | 按请求解析的凭据引用（环境变量名）。 |
| baseURL | https://api.kimi.com/coding/v1 | 端点基础地址；会追加 /chat/completions。回退到来自受信任环境层的 $KIMI_BASE_URL。 |
| reasoningEffort | low | K3 系列的默认思考强度（low、high、max）。 |
| sendTemperature | false | 是否转发显式的采样温度。Kimi 强制执行固定采样，因此默认保持关闭。 |
| firstToolChoice | 未设置 | 在对话的首次工具调用时强制使用此工具（线上 tool_choice），仅当历史记录中没有更早的工具调用且请求的工具列表包含该名称时应用。 |
| maxTokens | 131072 | 默认的每请求输出上限；模型自身的上限和显式请求值优先。 |
| defaultContextWindow | 1048576 | 当所选模型没有精确值时使用的上下文容量。 |
| imagePixelBudget | 8294400 | 拒绝固有像素数超过此预算的请求图像。默认值为 Kimi 的 4K 上限（3840x2160）。 |
| imageMaxBytes | 1048576 | 拒绝编码字节长度超过此预算的请求图像。使内联 base64 保持在 Kimi 的每条消息大小限制内。 |
| models | 四个 Kimi Code 模型 | 供发现消费者查看的咨询目录。 |
| streamIdleTimeoutMs | 300000 | 在一次流读取未完成时，提供方允许的最大空闲时间。 |
| retryPolicy | 正常，五次重试 | 提供方拥有的模型请求重试策略。 |

模型

| 模型 ID | 上下文 | 推理强度 | 图像输入 |
| --- | --- | --- | --- |
| k3 | 1,048,576 | low / high / max | 是 |
| k3-256k | 262,144 | low / high / max | 是 |
| kimi-for-coding | 262,144 | 始终开启（无强度级别） | 是 |
| kimi-for-coding-highspeed | 262,144 | 始终开启（无强度级别） | 是 |

图像输入

所有四个 Kimi Code 模型都接受图像。当请求携带图像内容时，适配器通过 harness 附件服务（ctx.attachments）读取每张图像，并将其以内联 base64 image_url 数据 URL 的形式嵌入。附件服务是可选的：当未挂载时，携带图像的请求会显式失败，而纯文本请求永远不会触及它。

预算控制在此插件内部根据持久化附件元数据执行，且在任何字节被读取之前完成。像素数超过 imagePixelBudget，或编码字节长度超过 imageMaxBytes 的图像会被拒绝，而不是让请求超出 Kimi 的每条消息大小限制。将图像内容发送到未配置图像支持的模型也会被拒绝。

行为说明

- 所有四个 Kimi Code 模型都接受图像输入；有关图像如何解析和预算控制，请参见图像输入。
- Kimi 强制执行固定采样。除非启用 sendTemperature，否则适配器不会发送 temperature、top_p 或 n。
- 在思考启用时，带有工具调用的助手消息必须携带其 reasoning_content。适配器会将 harness 推理块重放到该字段上，以便多轮工具会话保持有效。
- Kimi 无法在不路由到较弱模型的情况下禁用思考，因此适配器永远不会发送 off 或 none 强度。K3 系列提供 low、high 和 max；编码模型保持思考开启，且没有强度选择器。

开发

pnpm install
pnpm run typecheck
pnpm run test
pnpm run build

许可证

MIT。参见 LICENSE。