功能
| 能力 | 使用体验 |
|---|
| 独立订阅模型 | 在 Kimi subscription 分组中选模型，不覆盖已有的 kimi-coding 或 Open Platform 配置 |
| 两种连接方式 | 使用 Kimi Code 订阅 API Key，或在设置页发起设备登录；OAuth 支持自动刷新 |
| 国内站与国际站 | 连接时选会员所在的站点：国内站 kimi.com 或国际站 kimi.ai；模型、搜索、额度和登录都走这个站点 |
| 订阅网页搜索 | 默认保持原有搜索设置，可选择按模型自动路由或使用 Kimi 搜索 |
| 额度一眼可见 | 设置页查看用量、重置时间与服务端返回的加量包余额；输入框显示紧凑余量 |
| 设置内检查更新 | 查看当前与最新版本；支持的 npm 安装可直接更新，本地开发安装另行提示 |
| 清晰的凭据边界 | 凭据由 DSH Host 管理，不通过浏览器 RPC 返回；订阅失败不会偷偷切换到其他付费模型路由 |
安装
先准备好 DeepSeek Harness 和可用的 Kimi Code 订阅。尚未安装 DSH，可查看 DSH 官方说明。兼容范围与验证记录见 使用指南。
1. 安装插件
打开桌面应用的插件页，点击添加插件，在包名或地址中填入：
dsh-kimi-subscription
在安装源中选择官方源，然后点击安装。同一个输入框也接受 GitHub 仓库地址和本机插件目录的绝对路径；需要固定版本时填入 dsh-kimi-subscription@1.5.0。
完成后手动重启桌面应用 —— 应用自身会提示「更改将在下次启动生效」，仅刷新页面不会重新加载 Host 中的插件。
2. 连接订阅
打开 设置 → Kimi 订阅，先在服务站点选开通会员的站点（国内站 kimi.com 或国际站 kimi.ai），再填入 Kimi Code 控制台生成的订阅 API Key，或按页面提示完成设备登录。连接后要换站点，先断开再重新连接。
订阅 API Key 与 Kimi Open Platform 的按量计费密钥不是同一种凭据。请勿混用，也不要把密钥、设备码或登录回调粘贴到公开 Issue 中。
3. 选择模型
在模型选择器中选择 Kimi subscription 分组下、你的订阅有权使用的模型，即可开始对话或编程。能在列表中看到模型，不代表账号一定具备调用权限。
检查安装 / 固定版本 / .tgz 安装
在桌面应用的插件页可以看到已安装状态与版本，也可以在那里启用、停用或卸载。
安装完成后在安装源旁可以切换镜像源；需要固定版本时把 dsh-kimi-subscription@<version> 直接填进包名或地址。离线或需要审计时，从 GitHub Releases 下载 dsh-kimi-subscription-1.5.0.tgz，改用该文件的绝对路径安装。
仅用于其它 profile： dsh plugin --profile <name> add dsh-kimi-subscription@latest 可用于自建 profile。不要对 desktop 使用它 —— CLI 会直接拒绝（profile "desktop" is managed exclusively by the Electron application），桌面版请走插件页。
细节见 安装与兼容性。
日常使用
选模型。 在 Kimi subscription 分组中切换模型；遇到档位提示时，选择当前账号有权限的模型。模型说明与常见认证问题见 模型与订阅权限。
看额度。 输入框可紧凑显示 5h 82% 7d 64%，这里的数字仅为格式示例。完整用量、剩余比例、重置时间及加量包信息在设置页查看，以账号实际返回的数据为准。
用搜索。 打开 设置 → Kimi 订阅 → 网页搜索。默认「不接管」原有搜索；需要时再启用「按模型自动路由」或「始终使用 Kimi 搜索」。同时安装 Codex 订阅插件时，先看 搜索共存说明。
界面预览
DSH 中的 Kimi 订阅设置界面
DSH 输入框中的 Kimi 订阅余量显示
截图用于展示界面位置；模型、额度和按钮以所安装的版本与当前账号为准。
使用指南
完整使用指南 包含安装与兼容性、模型权限、额度说明、搜索路由、故障排查和卸载清理。
常用入口：登录与凭据 · 网页搜索与 Codex 共存 · 故障排查 · 更新记录。
更新与卸载
从 1.3.9 或更早版本升级： 请在插件页填写 dsh-kimi-subscription@1.5.0 安装，不要点旧版设置页里的「更新插件」。旧按钮安装时会绕过 pnpm 的发布冷却期：装到的版本如果发布还不满 24 小时，这个 profile 在它满 24 小时之前就装不了其他插件。装好并重启后，按钮就换成了修好的版本，以后直接点即可。
更新： 打开 设置 → Kimi 订阅 → 更新插件。它会在 desktop profile 目录中用 DSH 自带的 pnpm 安装精确版本，并读回 package.json 确认版本真的落地。安装遵守 pnpm 的发布冷却策略，不会绕过它：默认情况下 pnpm 会直接装上新版本，并把它记进 profile 的 minimumReleaseAgeExclude；如果给 pnpm 配了更严格的策略，按钮会提示什么时候可以更新。失败时的手动步骤见更新与清理。
本地 link: 开发安装不适用该按钮，应在对应仓库拉取代码、测试并重新构建，不要用安装命令替换开发链接。desktop profile 由桌面应用独占，dsh plugin --profile desktop … 会被 CLI 拒绝（profile "desktop" is managed exclusively by the Electron application）；dsh plugin --profile <name> … 仅适用于非桌面 profile。
卸载： 若启用过 Kimi 搜索，先在设置页切回「不接管」，再在桌面应用的插件页对本插件执行卸载。
安装、更新或卸载后，均请手动重启桌面应用。已经卸载、但还残留搜索补丁时，只清理本插件的标记块，具体见 更新与清理；不要删除整个 profile。
常见问题
登录正常，但某个模型不可用？ 模型目录不按订阅档位过滤。明确的模型权限拒绝与失效凭据应分开排查，详见 故障排查。
额度没有显示？ 先确认选择的是 Kimi 订阅模型，再到设置页刷新余量；没有返回可用数据时，不应把缺失显示理解为额度为零。
更新后还是旧界面？ 完全退出并重新打开桌面应用。仅刷新前端不会重载 Host 适配器。
安全边界
本项目是社区插件，与 DeepSeek、Moonshot AI 无隶属或背书关系。项目面向本人交互式使用；订阅适用范围请参阅 Kimi Code Community Guidelines。
凭据保存在 Host 侧，浏览器仅接收必要的状态与用量信息。模型请求会发送到相应的 Kimi 服务，不应将「凭据不返回浏览器」理解为离线推理。更多说明见 SECURITY.md。
普通问题请提交 Issue；安全问题请通过 私密漏洞报告 提交，不要公开凭据或原始账号响应。
本地开发
git clone https://github.com/BaronCyrus/dsh-kimi-subscription.git
cd dsh-kimi-subscription
pnpm install --frozen-lockfile
pnpm run check
本地链接、构建与验证步骤见 开发说明。使用 Agent 修改或发布项目时，请先阅读 AGENTS.md；不要手动编辑生成的 lib/。
技术依据与致谢
DeepSeek Harness · Kimi Code · Kimi Code 模型文档 · 会员说明 · 第三方工具接入 · DSH Codex Subscription
第三方实现参考与许可见 THIRD_PARTY_NOTICES.md。
License
MIT
支持作者
本插件免费开源，赞赏全凭心意。如果它让你在 DSH 里用 Kimi Code 订阅省了不少折腾，欢迎扫码支持，让插件持续跟上新模型和新版 DSH。
