dsh-usage-skill

为 DeepSeek Harness 网页端提供多供应商账户监测、Token 用量分析与技能（Skill）包管理。

Provider balances, subscription quotas, token-usage analytics, and skill bundle management for the DeepSeek Harness Web GUI (dsh web).

展示图使用脱敏演示数据；插件不会把 API Key、Cookie、管理 PAT 或上游原始响应发送到浏览器。

一眼看懂 / At a glance

	能力	说明
💳	统一账户卡片	API 供应商显示余额，Token Plan 显示分窗口额度；面板一次只呈现当前供应商
📊	Token 用量分析	今日、本月、累计、缓存命中率、月历热图，以及按日期/供应商/模型下钻
🧩	技能包管理	侧边栏“技能”入口：新建/重命名/删除技能包（Bundle）、拖拽安装 Skill、散装技能列表
🔄	后台监测	服务端启动即刷新，之后每五分钟更新全部已配置账户与本地 Token 聚合
🔒	本机安全边界	账户与技能端点仅接受回环请求；凭据只在服务端解析并发往校验后的供应商地址

界面支持中文和英文。浏览器只请求当前选择的 provider；后台刷新与面板是否打开无关。手动刷新会更新用量、供应商列表，并强制刷新当前账户，不会批量强制请求其他供应商。

快速安装 / Quick start

需要 DeepSeek Harness web profile（@deepseek-ai/dsh >= 0.1.0-rc.6）。

dsh plugin add github:statem-li/dsh-usage-skill

然后重启已经运行的 dsh web，并在浏览器中硬刷新。侧边栏底部会出现“用量”和“技能”两个入口。

升级或卸载：

dsh plugin --profile web update dsh-usage-skill
dsh plugin --profile web remove dsh-usage-skill

兼容安装器：无法使用 dsh plugin 时展开

PowerShell、命令提示符和 macOS/Linux 终端使用同一条命令：

npx --yes github:statem-li/dsh-usage-skill

安装器会把运行文件复制到 ~/.dsh/profiles/node_modules/dsh-usage-skill，并在 profiles/web/cordis.patch.yml 中幂等启用插件。重复运行即可更新，不会重复追加配置。设置了 DSH_HOME 时使用该目录。

dsh plugin 与 npx 是两条独立安装路径，请选择其中一种；不要同时保留手工 Cordis entry 和 bundle 注册，否则会重复挂载。

## 凭据与供应商配置 / Configuration

凭据由 Harness 从 `~/.dsh/.credentials.yaml` 解析。安装器不会读取、创建或修改该文件。不要把真实 Key、Cookie 或管理令牌提交到 Git、公开 issue，或粘贴给编码 Agent。

### 余额型供应商

DeepSeek、Moonshot 等默认复用对应 provider profile 的 `apiKeyEnv`。例如：

```yaml

## 使用 / Usage

1. 点击侧边栏“用量/余额”。
2. 用“当前供应商”切换账户卡片；一次只显示一个 provider。
3. 使用 `‹` / `›` 切换月份，点击热图日期查看当天的 provider/model 明细。
4. 标题栏刷新会更新 Token、provider 列表，并强制刷新当前账户。

“最近 14 天”按本地日历计算，只显示窗口内存在用量的日期；未来时间戳不会计入。同一模型来自不同 provider 时会分别统计，例如 `deepseek-official · deepseek-chat` 与 `ark · deepseek-chat`。