前言¶

用 Command Code 跑模型时，很多人会反复打开官网，确认本月剩余额度、5 小时窗口用了多少、本周窗口还剩多少。人在 DSH 里写 agent、调插件，却要把注意力切到浏览器另一页，既打断节奏，也不容易和本地会话状态对照。

DeepSeek Harness（DSH）支持用插件扩展界面与后台能力。@yumiku/dsh-commandcode-quota（仓库 miko-cn/dsh-commandcode-quota）把 Command Code 的用量信息搬进 DSH：设置页里集中展示，桌面还可挂一个可拖动的浮窗胶囊。维护者为 miko-cn，分类为客户端插件，依赖 DSH ≥0.2.0，MIT 许可。

下面介绍插件做什么、如何安装，以及面板里各数字的含义。

这是什么¶

插件全称在 npm 上为 @yumiku/dsh-commandcode-quota（当前 package 版本 1.1.1）。它不改变 Command Code 的计费规则，只做数据看板：通过 DSH 后台用 API key 调用 Command Code 内部接口（与 cmd CLI 的 /usage 同源），把额度、两道限速窗口、本期请求汇总整理后展示在 Web UI。

核心入口有两处：

• 设置 → Command Code：额度、窗口、本期请求、套餐档位、API key 编辑；
• 浮窗胶囊：双行进度条与倒计时，点击展开完整面板，可拖到屏幕任意位置。

未配置 key 时，若你已 cmd login、或 DSH 本身以 Command Code 为模型供应商，插件会尝试自动复用凭据，多数情况不必再填一次 key。

核心功能¶

套餐额度¶

面板显示「剩余 / 总额度 credits」、已用百分比，以及本期起止时间与距离续费剩余时间（例如「本期 11/3 – 12/3 · 还剩 25 天 1 小时」）。月额度按计费周期重置、不结转；额外购买或赠送额度会单独列出。

5 小时与每周窗口¶

除月额度外，Command Code 还有两道限速：任意连续 5 小时内、任意连续 7 天内可消耗的 credits 上限。窗口从第一笔请求开始滚动计时，而非按自然日重置。浮窗与面板上的两行进度条对应这两道窗口，右侧为实时倒计时（例如 3h 12m 45s、2d 3h 12m）。

本期请求¶

按计费周期统计请求数、成功率、花费、输入与输出 token。打开面板时强制刷新一次，之后约每分钟自动更新；底部会显示「更新于 X 秒前」。

套餐档位¶

插件会识别 Go / GOAT / Pro / Max / Ultra / Teams Pro 等档位，窗口上限以 Command Code 返回为准。设置页可手动切换档位，仅影响显示与换算，不会改动订阅。

浮窗行为¶

位置可拖动并会记住；启动时先显示骨架再加载数据；从其他窗口切回 DSH 时会自动刷新。可在设置中关闭「显示桌面浮窗」。界面文案跟随 DSH 语言设置（中 / 英）。

安装与启用¶

DSH 要求本机已安装可用 profile。安装命令以 README 为准：

dsh plugin --profile <profile> add @yumiku/dsh-commandcode-quota

也可以在 DSH 会话里让 agent 通过 plugin_manager 的 install_bundle 安装同名包 @yumiku/dsh-commandcode-quota。

其他方式（可选）：

• GitHub Release 预构建包：https://github.com/miko-cn/dsh-commandcode-quota/releases/latest/download/dsh-commandcode-quota.tgz
• 若启用自定义插件索引，可将 https://raw.githubusercontent.com/miko-cn/dsh-commandcode-quota/main/market/index.json 加入 Plugins → Discover → Manage index sources，再在 Discover 中搜索安装。

安装后刷新 DSH 页面。设置中会出现「Command Code」；默认会在桌面右下角出现浮窗胶囊。

API key¶

若无法自动找到凭据：设置 → Command Code → API key，粘贴 Command Code API key 并保存。key 只写入 DSH 凭据库，不写配置文件，也不会把 key 本身发给浏览器页面。

查找顺序（摘要）：设置页保存的 key（优先于环境变量）→ 环境变量 COMMAND_CODE_API_KEY（可在配置里用 apiKeyEnv 改名）→ COMMANDCODE_API_KEY、COMMAND_API_KEY → ~/.commandcode/auth.json → ~/.dsh/.credentials.yaml。

典型用法与配置¶

日常无需改配置。需要调整刷新间隔、超时或 API 基址时，可在 profile 的 cordis.patch.yml 中增加：

- id: commandcode-quota
  name: '@yumiku/dsh-commandcode-quota'
  config:
    apiKey: ''                 # 留空则自动查找；推荐用设置页写入凭据库
    apiKeyEnv: COMMAND_CODE_API_KEY
    apiBase: https://api.commandcode.ai
    planOverride: ''           # 默认档位，页面上的手动选择优先生效
    cacheMs: 45000             # 后台缓存时长（打开面板时会强制刷新）
    timeoutMs: 12000

浮窗后台默认约每 5 分钟拉取一次（设置里可调 1–10 分钟）；页面不可见时不请求。每轮会调用 Command Code 的 4 个接口。同源路由包括：

适用场景与注意¶

适合谁：长期在 DSH 里用 Command Code 作模型或工具链，希望在本机一眼看到 credits 与两道窗口，而不反复登录官网的用户。

运行方式：插件以当前 DSH 进程权限运行，安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认与自身环境一致。插件与 Command Code 官方无隶属关系；/alpha/* 为 CLI 内部接口，字段缺失时面板会降级显示而非直接报错。逐条请求明细仅存在于需要网页 cookie 的 Studio 会话接口，API key 无法获取，故面板只做本期汇总。

常见问题：数字与官网可能有几分钟偏差，可点击刷新或重开面板；浮窗消失时在设置中重新打开「显示桌面浮窗」。1.0.2 曾出现 Failed to load plugins（客户端未声明 inject），1.0.4 起已修复，宜保持 npm 最新版。

结尾¶

经过上面的步骤，你可以在 DSH 内完成 Command Code 额度与窗口的日常盯盘，并把 API key 留在后台凭据库。社区目录页：skillhub.cn/plugins/miko-cn/dsh-commandcode-quota；源码与说明：github.com/miko-cn/dsh-commandcode-quota。