dsh-commandcode-usage
CommandCode 用量与余额面板 — 在 DSH（DeepSeek Harness）侧边栏底部显示 CommandCode API 用量、信用额度、5小时/每周窗口。
A CommandCode usage & balance panel for DeepSeek Harness — shows API usage, credit balance, and 5-hour/weekly windows from the sidebar footer.
Features · 功能
- CommandCode 用量：请求次数、成功率、Token 消耗、总花费
- 信用额度：月额度、5小时窗口、每周窗口，进度条可视化
- ⏱ 重置时间显示：每个周期下方标明截止/重置时刻（「重置 今天/明天/N天后 HH:mm」），一眼知道额度何时刷新
- 余额与订阅：套餐信息、订阅状态、计费周期
- 精致卡片 UI：渐变 header + 套餐徽章、统计三卡、图标渐变动画进度条、彩色百分比胶囊（≥85% 红 / ≥60% 黄 / 其余绿）
- 主题自适应：跟随 DSH 的浅色/深色主题自动切换
- 月额度按计费周期：只统计当前计费周期、到期自动重置、不结转；分母是套餐月额度（GOAT $70），与 CommandCode 官网显示一致
- 侧边栏入口：通过官方槽位
sidebar.footer.action挂在 DSH 侧边栏底部（设置按钮旁）的「⚡ 用量」按钮，点击弹出面板；侧栏收起时自动只留图标
Install · 安装
方式一：插件市场（推荐）
打开 DSH 设置 → 插件市场，搜索 dsh-commandcode-usage，一键安装。
方式二：npm
dsh plugin --profile web add dsh-commandcode-usage
方式三：手动（双半包）
# 1. 安装 npm 包
npm install dsh-commandcode-usage
# 2. 在 cordis.patch.yml 注册
# - id: dsh-commandcode-usage
# name: 'dsh-commandcode-usage'
Configuration · 配置
插件通过 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 解析顺序
- 插件
config.apiKey - 环境变量
COMMANDCODE_API_KEY ~/.dsh/.credentials.yaml中的COMMANDCODE_API_KEYlaunchctl getenv COMMANDCODE_API_KEY- 其他常见配置文件（
~/.config/commandcode/等）
Usage · 使用
安装并重启后，在侧边栏底部、设置按钮左边点击 "⚡ 用量" 按钮即可查看：
- 请求次数 / 成功率 / 本计费周期花费（概览卡片）
- 5小时窗口 / 每周窗口用量（进度条 + 重置时刻）
- 月额度（计费周期）：本期已用 / 套餐额度（进度条 + 重置日期）与剩余额度
- 账号、套餐、更新时间（页脚）
同时注册了 commandcode_usage 工具，agent 可在对话中查询：
查询我的 CommandCode 用量
Development · 开发
git clone https://github.com/zouxiaoyang/dsh-commandcode-usage.git
cd dsh-commandcode-usage
npm install
# 本地开发：软链到 profile
ln -sfn $PWD ~/.dsh/profiles/web/node_modules/dsh-commandcode-usage
License
MIT
