前言¶
DeepSeek Harness (DSH) 采用插件化架构。在使用 Kimi Code 模型时，监控剩余配额通常需要切换标签页或进入设置菜单。dsh-kimicode-usage 插件将配额状态直接嵌入工作区，减少上下文切换。
插件简介¶
这是一个 DSH 插件，由 Number444 维护，旨在显示 Kimi Code 额度。它通过工具栏徽章和设置面板提供直观的视觉反馈。
核心功能¶
- 输入框徽章：在输入框工具栏中显示一个紧凑的药丸徽章（
● 5h:xx%），位于模型选择器左侧。 - 额度窗口：显示 5 小时滚动窗口和每周窗口的进度。
- 状态指示：徽章上的点根据剩余配额改变颜色（绿/黄/红）。
- 交互式弹出框：点击徽章会打开一个弹出框，显示进度条、重置倒计时和刷新按钮。点击外部或按
Esc关闭。 - 设置面板：DSH 的“设置”部分包含一个“Kimi Code 额度”卡片，提供完整显示、进度条和 60 秒自动刷新。
安装与启用¶
安装插件使用以下命令：
dsh plugin --profile web add github:Number444/dsh-kimicode-usage
如果使用桌面构建而不是 dsh web，请使用 --profile desktop。安装后刷新页面。
使用说明¶
安装后，刷新页面。徽章将出现在输入框工具栏中。点击徽章以查看详细统计信息。在 DSH 设置中，找到“Kimi Code 额度”卡片以获取完整视图和手动刷新。
注意事项与安全¶
- 安全性：API 密钥从不离开主机进程。浏览器仅与本地代理路由（
/dsh-kimi-quota/api/usages）通信。该路由仅接受 loopback 请求；LAN 客户端将收到 403。远程控制 UI 通过隧道重新发布请求，因此保持工作状态。上游调用是只读的，不消耗配额。 - 缓存：响应在内存中缓存 2 分钟。
- 兼容性：在较旧的 DSH 构建中，设置部分工作，但徽章不会出现。
- 源码：请检查仓库以了解实现细节和许可证（MIT）。
总结¶
该插件为 DSH 用户提供了本地、安全的 Kimi Code 配额监控。它通过工具栏徽章和设置面板集成，便于跟踪使用情况。
