dsh-api-usage-meter
DSH Harness 桌面插件：在窗口状态栏中显示 DeepSeek API 余额和令牌使用量。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yunshu-iii/dsh-api-usage-meter#eadc29e6cb633e7679914d2186ea4bbc2fbd26b3Api Usage Meter 以 dsh-api-usage-meter 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH Harness 桌面端插件：在窗口底部常驻一条状态栏，显示 DeepSeek API 的剩余余额和 token 用量，点击展开明细卡片。
配套插件：dsh-wallpaper-theme —— 整窗壁纸与分级磨砂玻璃外观。
给 DSH Harness 的窗口底部加一条 30px 常驻状态栏：
● 余额 ¥12.38 │ 今日 1555.26万 tokens │ 本会话 1191.38万 tokens 更新于 22:16:21
点一下展开明细卡片，按 输入 / 输出 / 缓存命中 / 合计 四列，分别看 今日 / 本会话 / 累计 三行，外加总余额、充值余额、赠送余额、今日消耗（估算）和「刷新」按钮。
余额偏低时状态栏会变色（可配阈值），余额接口失败时其余统计照常显示并给出错误提示。
# 桌面端
dsh plugin --profile desktop add github:yunshu-iii/dsh-api-usage-meter
# Web 端
dsh plugin --profile web add github:yunshu-iii/dsh-api-usage-meter
装完重启 Harness 生效。profile 名以本机 ~/.dsh/profiles 下的目录为准。
侧栏 插件 → 添加插件 → 安装第三方插件，选择本仓库（或先用 git clone 到本地，再用「本地目录」安装）。
也可以先安装 dsh-plugin-market，在市场里搜「usage」一键装。
GET https://api.deepseek.com/user/balance，取 balance_infos。
API Key 由 credentials 服务解析（默认引用 DEEPSEEK_API_KEY），只在 Host 进程内使用；浏览器只拿到聚合后的数字，任何响应里都不含密钥。$DSH_HOME/sessions）里的 assistant/message 用量，分输入 / 输出 / 缓存命中 / 缓存写入四项。
首次安装会一次性回填历史会话（约几秒），之后只扫描新增或有变化的日志，并按每条会话的事件序号去重。在 profile 的 cordis.patch.yml 里覆盖本行配置即可（所有键都可省略）：
- id: api-usage-meter
name: dsh-api-usage-meter
config:
refreshIntervalMs: 60000 # 余额刷新间隔
lowBalanceThreshold: 5 # 低于该值状态栏变黄
lowBalanceCritical: 1 # 低于该值状态栏变红
currency: CNY # 多币种账户时选择显示哪一种
apiKeyRef: DEEPSEEK_API_KEY
balanceUrl: https://api.deepseek.com/user/balance
sessionRoot: null # 默认 $DSH_HOME/sessions
backfill: true # 是否回填历史会话
$DSH_HOME/api-usage-meter/state.json（按天、按会话、按序号水位），刷新页面或重启应用都不会重复计数。GET，拒绝非回环 Host 与跨源 Origin，响应带 cache-control: no-store。| 文件 | 作用 |
|---|---|
index.js | Host 半区：读取凭据、查询余额、聚合 token 用量、注册 GET /api-usage-meter/snapshot |
lib/logs.js | 读取会话日志（独立 Zstandard 帧拼接格式，按帧头扫描边界） |
client.js | Client 半区：注册 shell.bottom 槽位，每 3 秒轮询快照并渲染状态栏与详情卡片 |
cordis.patch.yml | 向当前 profile 插入本插件行 |
MIT © yunshu-iii