前言¶
用 DSH 跑 Command Code 时，额度分散在 5 小时窗口、每周窗口、月度窗口和计费周期用量里；要确认「还剩多少、何时重置」，往往得离开会话去查 CLI 或控制台。DeepSeek Harness 社区插件 dsh-commandcode-quota（维护者 s11phere，分类 admin-security）把上述信息收进会话头部：一个图标按钮点开卡片即可查看，查额度走纯 GET，不消耗 Command Code 额度。
这是什么¶
dsh-commandcode-quota 是面向 web profile 的 DSH 插件（当前包版本 0.1.2，MIT）。它在会话头部右侧工具行注入额度入口，展示 Command Code 套餐在 5 小时 / 每周 / 月度 三个窗口的进度、重置倒计时，以及计费周期内的 token 用量与套餐状态。凭据与 API 地址无需手写配置，由 DSH profile 的 commandcode provider 路由、~/.dsh/.credentials.yaml 与环境变量按顺序自动发现。
核心功能¶
下面介绍插件在界面上提供的已核实能力。
额度卡片¶
点击会话头右侧工具行中的图标按钮，弹出一张卡片；再点一次按钮、点击卡片外区域或按 Esc 可收起。卡片内包含：
- 三个额度窗口（5 小时、每周、月度）的使用进度与重置倒计时；
- 计费周期内的用量相关展示（与 README 及 package 描述一致）。
截图与说明见 GitHub 仓库 README。
按钮出现条件¶
按钮挂在 DSH 原生位置：conversation.session.header.utilities，位于右侧面板开关左侧。仅在会话已开始（至少发过一条消息）后出现；空白会话与欢迎页不渲染该行，因此看不到按钮。
数据刷新与降级¶
- 页面加载、点开卡片、每 10 分钟各拉取一次；
- 标签页切回前台时，若缓存已过期会再补一次请求。
四个数据端点彼此独立：单个失败只在卡片底部提示，其余数据照常显示。宿主侧默认缓存 3 秒（可配置 cacheMs）。
平台支持¶
| 平台 | 状态 |
|---|---|
Windows 10 / 11（原生 dsh web） |
已实测 |
| WSL2 / Linux | 已实测 |
两份环境共用同一份代码；维护者在 DSH 0.1.7-rc.2 上验证（文档以 DSH 0.1.7 为基准）。Windows 若改用本地路径安装且源码与 $DSH_HOME 跨盘，需阅读仓库 Windows 注意事项。
安装与启用¶
先做安装，再重启 web 进程，按钮才会生效。
- 在目标机器上执行官方安装命令（web profile）：
dsh plugin --profile web add github:s11phere/dsh-commandcode-quota
- 安装完成后重启
dsh web。卸载时将add改为remove，同样需重启。
注意：不要使用 git@github.com:... 这种 scp 风格地址，pnpm 可能误解析导致插件不生效。Windows 走 GitHub 安装可直接用上面命令；本地路径安装见上文跨盘说明。
插件以当前 dsh 进程权限运行，安装前建议浏览 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。
可选配置¶
全部可选。在 profile 的 cordis.patch.yml 中按插件 id 覆盖：
- id: dsh-commandcode-quota
config:
timeoutMs: 15000 # 单端点超时
cacheMs: 3000 # 宿主侧结果缓存
debug: true # 打印凭据来源与注册结果
timeoutMs 控制单次端点请求超时；cacheMs 控制宿主侧结果缓存时长；debug: true 便于排查凭据来源与注册结果。
典型用法¶
经过上面的安装与重启步骤后：
- 启动或刷新
dsh web，进入已有消息的 Command Code 会话； - 在会话头右侧工具行找到额度图标（右侧面板开关左侧）；
- 点击打开卡片，查看各窗口进度、重置倒计时与计费周期用量；
- 需要最新数据时再次点开卡片，或等待自动刷新（含每 10 分钟与切回前台时的补拉）。
更细的 API 契约、凭据发现顺序与月度上限计算见仓库 docs/api.md。
适用场景与注意¶
适合谁： 长期在 DSH web 里用 Command Code、需要随时对照 5 小时 / 周 / 月窗口与计费周期用量的开发者或运维角色；分类落在 admin-security，侧重用量可见性与会话内自检。
已知限制（来自 README）：
- 按钮仅在会话开始后显示；
- token 进出与请求数来自约 2–3 分钟一批的聚合，可能略滞后；额度窗口与花费为实时；
- 账户级 API 不提供缓存命中 / 未命中拆分，仅有毛输入 token 总量；
- 数据来自官方 CLI 自用的内部接口（路径含
alpha），字段名存在变更风险。
结尾¶
dsh-commandcode-quota 把 Command Code 套餐额度收进 DSH 会话头，减少切出会话查额度的次数；安装命令与行为以仓库 README 为准。
