前言¶

DSH（DeepSeek Harness）使用 Command Code 计费，套餐限制为固定时长（如每周 5 小时、每月 50 小时）。超时后无法继续发起对话，但当前剩余额度、重置倒计时、计费周期内用量等关键信息散落在多处：要么在 CLI 的输出里，要么在网页控制台，要么在官方后台。需要在会话头部随时看到这些数据，才能在额度耗尽前及时调整或升级。

是什么¶

dsh-commandcode-quota 是一个 DSH 插件，在会话头部右侧工具栏添加一个图标按钮，点击展开一张卡片，显示当前 Command Code 套餐的剩余额度。卡片展示三个时间窗口的进度与重置倒计时，以及计费周期内的 token 用量与套餐状态。

维护者：TianzeLuo。分类：admin-security。

核心功能¶

• 会话头部按钮：在 conversation.session.header.utilities 原生位置显示，仅当会话已开始（发过至少一条消息）后出现。
• 额度卡片：点击按钮展开，再点击卡片外或按 Esc 收起。卡片包含：
• 5 小时 / 每周 / 每月三个窗口的进度条与剩余额度。
• 各窗口的重置倒计时。
• 计费周期内的 token 总量与套餐状态。
• 数据刷新：页面加载、点开卡片、每 10 分钟各拉一次；标签页切回前台时若数据已过期再补一次。
• 降级处理：四个数据端点各自独立失败，单个失败只在卡片底部提示，其余照常显示。
• 纯 GET 请求：查额度不消耗任何 Command Code 额度。

安装与启用¶

插件版本要求 DSH 0.1.7 或更高（README 提到在 0.1.7-rc.2 上验过）。

在 DSH web profile 下执行：

dsh plugin --profile web add github:s11phere/dsh-commandcode-quota

安装完成后重启 dsh web。卸载时把 add 换成 remove，同样要重启。

注意：不要用 git@github.com:... 这种 scp 风格的写法，pnpm 会把它误解析成「包名 git + 版本」，装出一个叫 git 的空依赖，插件不会生效。

配置¶

全部可选。在 profile 的 cordis.patch.yml 里按 id 覆盖：

- id: dsh-commandcode-quota
  config:
    timeoutMs: 15000   # 单端点超时
    cacheMs: 3000      # 宿主侧结果缓存
    debug: true        # 打印凭据来源与注册结果

凭据与地址不需要配置：自动从 DSH profile 的 commandcode provider 路由、~/.dsh/.credentials.yaml、环境变量依次发现。

适用场景与注意¶

适合需要持续监控 Command Code 套餐使用情况、在额度窗口重置前规划对话的 DSH 用户。插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证（MIT）。

已知限制：
- 按钮只在会话已开始后出现。
- token 进出与请求数来自 2–3 分钟一批的聚合，可能略滞后；额度窗口和花费是实时的。
- 账户级 API 不提供缓存命中 / 未命中的拆分，只有毛输入 token 总量。
- 数据来自官方 CLI 自用的内部接口（路径带 alpha），字段名有变更风险。

短结尾¶

dsh-commandcode-quota 将 Command Code 套餐的额度与用量信息聚合在会话头部，减少切换页面与查看后台的次数。若需查看详细文档，可访问插件目录页或 GitHub 仓库。

• 插件目录页：https://www.skillhub.cn/plugins/TianzeLuo/dsh-commandcode-quota
• GitHub：https://github.com/TianzeLuo/dsh-commandcode-quota