BaronCyrus/dsh-kimi-subscription

DSH Kimi 订阅

在 DeepSeek Harness 中直接使用 Kimi Code 会员订阅

无需 Kimi Open Platform 按量计费密钥；订阅模型、登录与额度都留在 DSH 内。

CI
npm
npm 总下载量
MIT
Star

快速开始 · 功能 · 本地开发 · 安全边界

快速开始

当前版本对 DeepSeek Harness 的 @deepseek-ai/dsh-* peer 声明为范围 >=0.1.1-rc.2

登录时请使用 Kimi Code 会员订阅 API Key 或设备登录；Kimi Open Platform 的按量计费 API Key 不适用于本插件。

功能

| 能力 | 说明 |
| --- | --- |
| 订阅模型 | 独立注册 kimi-subscription 路由，不覆盖现有 kimi-coding 或 Open Platform 配置 |
| 两种登录方式 | Kimi Code 订阅 API Key（推荐）与 Kimi OAuth 设备代码登录 |
| 安全凭据 | OAuth 自动刷新，API Key、access token、refresh token 仅保存在 DSH Host 凭据服务中 |
| 完整额度 | 读取 Kimi Code 官方 /coding/v1/usages，显示已用量、剩余比例、重置时间与加量包余额 |
| 输入框额度 | 选择 Kimi 模型时紧凑显示 5h 82%　7d 64%，每 60 秒刷新 |
| 版本检查 | 设置页显示当前与最新插件版本；npm 安装出现新版本时可一键更新，并提示重启 DSH 或刷新界面 |
| 订阅网页搜索 | 注册 kimi-subscription / kimi-subscription-auto 两个 DSH 搜索提供方，走 Kimi Code 官方 /coding/v1/search；设置页可选择「不接管（默认）/ 按模型自动路由 / 始终使用 Kimi 搜索」 |
| 无付费回退 | 不会静默切换到 Kimi Open Platform 或其他付费提供方 |

网页搜索路由说明

DSH 全局只有一个生效的搜索提供方槽位。本插件默认不接管该槽位。
同时安装了 dsh-codex-subscription 时：Codex 插件的切换器会在 web 运行时每次重启后重写自己的槽位选择，与之争夺会导致 web 运行时反复重启，因此本插件改为自动维护 profile 补丁：在设置页选择「自动 / 始终」后，插件会把带标记的 - id: web 补丁块写入本 profile 的 cordis.patch.yml（DSH 会热加载，无需重启），效果为：Codex 模型 → Codex 订阅搜索；Kimi 模型 → Kimi 订阅搜索；其他模型 → DSH 默认搜索（deepseek-official）。切回「不接管」会自动移除该补丁块。补丁块只设置 web 行的 searchProvider，其他键（如 fetchProvider）与其他补丁条目原样保留。卸载本插件后，删除 cordis.patch.yml 中 # >>> dsh-kimi-subscription 标记的块即可彻底还原。

仅安装本插件时：在设置页选择「自动」后，Kimi 模型走 Kimi 订阅搜索，其他模型走 DSH 默认搜索；选择「始终使用 Kimi 搜索」则所有模型都走 Kimi 订阅搜索；切回「不接管」会恢复接管前的搜索来源。

当前模型目录来自 @earendil-works/pi-ai 0.85.1：

- k3
- k3-256k
- kimi-for-coding
- kimi-for-coding-highspeed

kimi-for-coding 已由 Kimi Code 原地升级为 K2.8 Preview（Model ID 不变，支持 1M 上下文与 low / high / max 思考档位，默认 max）。pi-ai 内置目录尚未跟进，插件会在本地修正该模型的名称、上下文窗口与思考档位映射；上游目录更新后该补丁可移除。

档位限制：选到用不了的模型会报「API 密钥无效」

Kimi Code 按会员档位放行模型（见模型配置）。模型 ID 写对、但档位不够时，服务端返回 401，而 DSH 客户端把所有 401 显示为「API 密钥无效」—— 这句提示具有误导性，密钥其实是好的。

| 模型 | 新套餐 | 老套餐 |
| --- | --- | --- |
| kimi-for-coding（K2.8 Preview） | Plus 及以上 | Andante 及以上 |
| k3 / k3-256k | Plus 及以上 | Moderato 及以上 |
| k3 的 1M 上下文 | Pro 及以上 | Allegretto 及以上 |
| kimi-for-coding-highspeed | Pro 及以上 | Allegretto 及以上 |

插件的模型列表直接来自 pi-ai 目录，不按你的档位过滤（Kimi 的 /v1/models 也不过滤），所以档位不够的模型也会出现在选择器里。/v1/models 与 /v1/usages 这类只读接口不做档位校验，因此它们会正常返回。

自 1.2.14 起，插件会把这种拒绝改写成一句明确的说明再交给界面：

当前 Kimi Code 订阅档位不包含模型「k3」，请改用 kimi-for-coding（K2.8 Preview），
或升级 Kimi Code 档位。这不是密钥或登录问题。 / Your Kimi Code plan does not include "k3"; …

改写后的文本刻意不含任何状态码与限额、超时、传输类关键词，因此宿主不会再把它归类成认证失败 —— 既不会显示成「API 密钥无效」，也不会对这种无法靠重试解决的失败重试两次。若你仍看到「API 密钥无效」，那才是真的凭据问题（可先在设置页确认登录状态）。

Kimi Code 与 Open Platform

本插件连接 https://api.kimi.com/coding，使用 Kimi Code 会员额度。它不同于 api.moonshot.ai / api.moonshot.cn 的按量计费开放平台，账号额度、密钥与模型 ID 不能混用。

根据 Kimi Code Community Guidelines，会员订阅仅适用于交互式使用。批处理、转售或重新包装服务应使用 Kimi Open Platform。

本地开发

git clone https://github.com/BaronCyrus/dsh-kimi-subscription.git
cd dsh-kimi-subscription
pnpm install
pnpm run check

迭代时可让 DSH profile 直接链接本地仓库：

dsh plugin --profile web add /absolute/path/to/dsh-kimi-subscription

修改后运行 pnpm run test 和 pnpm run build，再手动重启 DSH。发布包由 pnpm run check 生成到 .artifacts/。使用 Agent 迭代或发布时请遵循 AGENTS.md。

更新与卸载

设置 → Kimi 订阅页面会显示当前版本与 npm 最新版本；出现新版本时可直接点击「更新插件」，更新完成后按提示重启 DSH 服务（或先刷新界面）。

也可以在终端更新到 npm 最新版：

dsh plugin --profile web add dsh-kimi-subscription@latest

也可以安装指定的 GitHub Release：

dsh plugin --profile web add ./dsh-kimi-subscription-.tgz

卸载：

dsh plugin --profile web remove dsh-kimi-subscription

安装、更新或卸载后均需手动重启目标 DSH；插件不会自行重启正在运行的会话。

安全边界

- RPC 仅允许 loopback 浏览器调用；浏览器只接收裁剪后的登录状态和额度 JSON。
- OAuth 登录 URL 仅允许 Kimi 官方 HTTPS origin。
- 额度请求在 Host 发出，带超时、拒绝重定向且不会向浏览器返回凭据或原始响应。
- 版本检查仅请求 npm registry 的公开元数据（带超时、拒绝重定向）；一键更新在 Host 调用 dsh plugin CLI，进程输出不会返回浏览器。
- 本项目不会读取、记录或上传会话提示词与模型回复。
- 安全问题请通过 GitHub Private Vulnerability Reporting 私下报告，不要在公开 Issue 中粘贴凭据。

更多信息见 SECURITY.md。

技术依据与致谢

- DeepSeek Harness
- Kimi Code 模型文档
- Kimi Code 会员说明
- Kimi Code 第三方工具接入
- MoonshotAI/kimi-code
- dsh-codex-subscription

第三方许可与实现参考见 THIRD_PARTY_NOTICES.md。

License

MIT