前言¶

在 DSH（DeepSeek Harness）环境中开发智能体时，管理 API 调用成本和配额是日常运维的关键。手动刷新网页或检查 CLI 输出效率低下，且容易遗漏关键状态。此插件通过在 DSH Host 端抓取官方接口数据，并在浏览器端提供可视化挂件，解决了实时监控与用量控制的问题。

插件简介¶

这是由 XingPeng-Pixel 维护的 DSH 客户端插件。它在 DSH Host 端运行，通过同源调用 Command Code 的 /alpha/* 接口获取数据，并将状态暴露给前端。插件不涉及任何明文 API Key 的传输，所有敏感操作均在 Host 端完成。

核心功能¶

• 实时用量快照：抓取 /alpha/whoami、/alpha/usage/summary 等接口数据，支持 5 小时与每周滚动窗口的余量监测。
• 多账户支持：支持配置多个账户，Host 端独立抓取并隔离错误。
• 可视化展示：提供侧边栏小挂件（自适应宽度）和设置页仪表盘（圆环图与进度条），颜色随使用率变化。
• 零密钥接触：API Key 在 Host 端解析（支持环境变量、CLI 凭据等），浏览器端仅通过同源 HTTP JSON 接口消费数据。
• 交互接口：提供同源 JSON 查询接口及聊天斜杠命令 /commandcode-usage，支持每轮对话消耗的实时推送。

安装与启用¶

插件已发布至 npm，可通过 DSH 官方插件命令一键安装：

dsh plugin --profile web add dsh-commandcode-usage-monitor

安装后，需在 DSH 设置页的 CMDAI 监控 或环境变量中配置 API Key。

典型用法¶

1. 配置环境变量：

    export COMMANDCODE_API_KEY=user_xxx

也可以在 DSH 设置页中填写。

2. 验证接口：
   安装插件后，Host 会启动同源 HTTP 服务，可通过 curl 验证：

    curl http://127.0.0.1:3099/commandcode-usage/status.json
    curl http://127.0.0.1:3099/commandcode-usage/turn-cost.json
    curl http://127.0.0.1:3099/commandcode-usage/health

3. 使用斜杠命令：
   在聊天窗口输入 /commandcode-usage 即可查看当前用量仪表盘。

适用场景与注意¶

• 适用场景：需要精细化管理 Command Code 配额与成本的 DSH 开发者。
• 安全说明：插件以 DSH 进程权限运行，浏览器端永远不会接触明文 API Key。
• 当前限制：
  • turn-cost.json 的 amount 字段目前为 null（尚未内置价格表）。
  • 配置项 storagePath 与 activeAccount 为预留字段，尚未参与运行时行为。
  • 插件依赖于官方 /alpha/* 接口，若上游接口变更需同步更新。

结语¶

该插件通过 Host 端抓取与浏览器端展示的解耦设计，提供了安全、实时的用量监控方案。对于需要严格控制 Token 消耗或管理多账户的开发者而言，这是一个实用的辅助工具。

项目目录 | GitHub 仓库