前言¶
在 DeepSeek Harness（DSH）里写代码、调智能体时，若同时订阅了 Kimi Code 会员，5 小时与 7 天两档额度往往要单独打开 Kimi Code 控制台或查邮件才能对齐。DSH 本身不提供 Kimi 侧用量展示；社区插件 dsh-kimi-code-usage 把额度拉到对话输入框下方，本地轮询、点开可看明细，并在同一界面管理 API Key 与区域，减少切站核对。
这是什么¶
dsh-kimi-code-usage 是由维护者 ancientbag 发布的 DeepSeek Harness 插件（分类：客户端）。它在 Web UI 中展示 Kimi Code 订阅配额，而不是按量计费的开发者平台 api.moonshot.ai。密钥形态为 sk-kimi-…，需在 Kimi Code Console 创建；插件面向会员 API：api.kimi.ai/coding 或 api.kimi.com/coding。
核心功能¶
下面能力是 README 中写明的行为，安装后可在界面上直接验证。
- 输入框下方徽章：紧凑展示类似
Kimi 5h 28% · 7d 12%的用量摘要；随占用升高由绿经黄至红。 - 点击弹出详情：进度条、已用/剩余、重置时间（24 小时制）、账户等级。
- API Key 管理：在弹层中粘贴并保存；密钥存入 Harness 凭据仓库，而非明文写在配置里。
- 区域切换：Oversea（
https://api.kimi.ai/coding）或 CN（https://api.kimi.com/coding），弹层中可改，配置文件也可设baseUrl。
实现上，宿主侧 index.js 注册经认证的 /api/kimi.balance，代理 GET {baseUrl}/v1/usages 与 /v1/me 并对上游请求防抖；客户端 client.js 将徽章挂到 conversation.composer.dock，弹层挂到 shell.overlay，约每分钟及每次点击徽章时轮询本地路由。
安装与启用¶
在 DeepSeek Harness 中可通过 Settings → Plugins → Install bundle 安装，或对智能体说出安装意图。官方 README 给出的命令如下。
通过 bundle 名称安装：
Install the bundle dsh-kimi-code-usage
不经 npm、直接从 GitHub 安装：
Install the bundle github:ancientbag/dsh-kimi-code-usage
若安装后未出现 Kimi 用量徽章，README 建议 重新启动 DeepSeek Harness 后再试。出现徽章后，点击输入框下方的徽章，粘贴 API Key 并保存即可开始拉取用量。
配置说明¶
可选行配置写在 cordis.patch.yml 中，字段含义如下。
| 字段 | 默认值 | 含义 |
|---|---|---|
apiKey |
"" |
Kimi Code API Key；更推荐在弹层中配置，并以 MOONSHOT_API_KEY 凭据形式存储。 |
baseUrl |
https://api.kimi.ai/coding |
国内账号可用 https://api.kimi.com/coding；亦可在弹层切换。 |
cacheSeconds |
60 |
硬防抖：该间隔内至多一次上游请求；最小 30。 |
密钥优先级：config.apiKey → 凭据仓库 / 启动环境 / .env 中的 MOONSHOT_API_KEY。
典型用法¶
- 按上一节任一方式安装 bundle，必要时重启 DSH。
- 点击 composer 下方 Kimi 徽章，在弹层中粘贴
sk-kimi-…并选择 Oversea 或 CN，保存。 - 平时看徽章颜色与百分比；需要重置时间与等级时点开弹层；若需改区域或 Key，仍在同一弹层操作。
无需额外 CLI；用量经本地 /api/kimi.balance 聚合，避免浏览器直连 Kimi API 时暴露 Key 到前端配置。
适用场景与注意¶
适合：在 DSH Web 端长期使用 Kimi Code 会员、希望边写边瞄 5 小时/周额度、且希望 Key 走 Harness 凭据链路的开发者。
注意：
- 插件针对 Kimi Code 会员 API，与 Moonshot 按量开发者 API 不是同一条线；Key 须在 Kimi Code Console 创建。
- 插件与当前 DSH 进程同权限运行；安装前应阅读 GitHub 仓库 源码并确认 MIT 许可证是否满足你的合规要求。
- 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；「一切皆插件」是 DSH 生态理念，本文介绍的是社区维护的客户端 bundle。
结尾¶
dsh-kimi-code-usage 把 Kimi Code 订阅用量嵌进 DSH 对话界面，用徽章、弹层与凭据化 Key 管理减少反复登录控制台。进一步了解可访问目录页 SkillHub 与源码仓库 github.com/ancientbag/dsh-kimi-code-usage。
