Overview

dsh-kimi-subscription

Use a Kimi Code membership in DeepSeek Harness through a dedicated Kimi subscription model route

README / EN

Package documentation

DSH Kimi Subscription

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

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

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

快速开始

当前版本兼容 DeepSeek Harness 0.1.1-rc.2 与 0.1.2-alpha.2 / 0.1.2-alpha.3 / 0.1.2-alpha.5（compatibility.json 记录实测版本）。通过 npm 安装到目标 profile：

dsh plugin --profile web add dsh-kimi-subscription
dsh plugin --profile web list dsh-kimi-subscription --depth 0

也可以从 GitHub Releases 下载对应版本的 .tgz 后安装：

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

手动重启 DSH 后：

打开 设置 → Kimi 订阅；
推荐粘贴 Kimi Code 控制台生成的订阅 API Key，或使用 Kimi 账号设备登录；
在模型选择器中选择 Kimi subscription 分组的模型；
设置页会显示完整额度，输入框右侧会显示 5h 82%　7d 64%。

登录时请使用 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.82.1：

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

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-<version>.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。

技术依据与致谢

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

License

MIT

dsh-kimi-subscription