dsh-commandcode-usage：CommandCode 用量与余额面板

DSH（DeepSeek Harness）通过插件机制扩展功能。在开发或使用过程中，第三方 API 资源（如 CommandCode）的用量与余额管理往往需要打开网页或单独的仪表盘。dsh-commandcode-usage 插件解决了这一痛点，将 CommandCode 的 API 用量、信用额度及周期性统计直接集成到 DSH 的侧边栏中。

该插件由 zouxiaoyang 开发，开源协议为 MIT。它提供了一个精致的卡片式面板，用于实时监控 API 消耗情况。

核心功能¶

插件在侧边栏底部提供统一的入口，主要包含以下数据展示与交互能力：

• 侧边栏入口：在侧边栏底部、设置按钮左侧显示「⚡ 用量」按钮。点击即可弹出面板，收起侧栏时自动显示图标。
• 用量概览：显示请求次数、成功率、Token 消耗及总花费。
• 额度周期：可视化展示月额度、5小时窗口和每周窗口。进度条直观显示剩余空间。
• 重置时刻：每个周期下方标明重置时间（如「重置 今天 23:59」），便于规划使用。
• 账户信息：显示套餐信息、订阅状态及计费周期。
• 界面适配：精致卡片 UI（渐变 header、套餐徽章、彩色百分比胶囊），并跟随 DSH 的浅色/深色主题自动切换。
• 计费逻辑：月额度按当前计费周期统计，不结转至下个周期。

安装与启用¶

通过 DSH 的命令行工具进行安装。确保你的环境已安装 DSH 并配置好对应 Profile。

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

安装完成后，重启 DSH 或刷新页面即可生效。

配置¶

插件通过 cordis.patch.yml 的 config 字段进行配置。默认情况下，它会尝试自动读取配置。

- id: dsh-commandcode-usage
  name: 'dsh-commandcode-usage'
  config:
    # API key（可选，默认自动从环境变量/配置文件读取）
    apiKey: 'your-commandcode-api-key'
    # API 基础地址（可选，默认官方）
    apiBase: 'https://api.commandcode.ai'
    # 环境变量名（可选，默认 COMMANDCODE_API_KEY）
    apiKeyEnv: 'COMMANDCODE_API_KEY'

API Key 解析优先级¶

插件按以下顺序查找 API Key：

1. 插件 config.apiKey
2. 环境变量（默认 COMMANDCODE_API_KEY）
3. ~/.dsh/.credentials.yaml 中的 COMMANDCODE_API_KEY
4. launchctl getenv COMMANDCODE_API_KEY
5. 其他常见配置文件

使用方式¶

启用后，主要有两种方式查看数据：

1. 侧边栏面板：在侧边栏底部、设置按钮左边点击「⚡ 用量」按钮。
2. 对话指令：注册了 commandcode_usage 工具，可在对话中直接输入指令：

    查询我的 CommandCode 用量

注意事项¶

• 权限运行：插件以当前 DSH 进程的权限运行，请确保 DSH 进程拥有访问 CommandCode API 的必要权限。
• 源码审查：在安装未知来源的插件前，建议查看源码与许可证（MIT）。
• 版本要求：需要 Node.js 环境版本 >= 18。

目录与源码¶

• 插件目录
• GitHub 仓库