快速开始

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

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

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

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

1.2.6 修复 DSH 0.1.5-alpha.2 模型目录中的 Cannot read properties of undefined (reading 'get')：插件为真实 PiAiAdapter 补齐 modelErrors 映射，并逐一验证所有 Kimi 模型的元数据解析与调用准备。验证不读取真实凭据或发起模型请求。该修复仅覆盖 Kimi 插件；其他订阅插件的同类错误需要各自更新。

1.2.5 修复 DSH 0.1.5-alpha.1 启动时的 webServer / webRuntime 注入错误：插件 bundle 为官方 connection 配置行同时声明 webRuntime 和 webServer，保留动态 trustedHosts 配置所需的依赖。无需修改全局 dsh 文件，也无需为标准 web profile 手动添加补丁；已经添加同样本地补丁的用户可继续保留。

此补丁以 connection 为行 ID，并校验官方包名。自定义 profile 若改过此行 ID，需在对应行补充 inject: [webRuntime, webServer]，并保留自定义配置使用的其他依赖。1.2.4 用户建议升级到 1.2.6，以修复原补丁覆盖 webRuntime 导致的后续启动错误。

兼容验证覆盖完整插件在新旧 Connection 下的隔离加载、动态配置求值、RPC 注册/鉴权/卸载和单元测试；用户已确认应用相同修正后能够成功进入 DSH。未执行真实模型调用或完整账号功能验收。

手动重启 DSH 后：

1. 打开 设置 → Kimi 订阅；
2. 推荐粘贴 Kimi Code 控制台生成的订阅 API Key，或使用 Kimi 账号设备登录；
3. 在模型选择器中选择 Kimi subscription 分组的模型；
4. 设置页会显示完整额度，输入框右侧会显示 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.85.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。

技术依据与致谢

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

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

License

MIT