← 返回列表
未验证
在侧边栏实时查看 API 余额与今日花费明细
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/14 · 已提供中文文档
综合分
27.4
GitHub 分
27.4
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add 1690834643/dsh-usage-dashboard该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
数据截至 2026/9/16（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/dsh-home-paths@deepseek-ai/dsh-credentials@deepseek-ai/dsh-client-ui-primitives用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-usage-dashboard
DeepSeek Harness（dsh）的 Web 插件：在侧边栏底部显示 API 余额 和 今日花费。
- 余额：通过 DeepSeek API GET /user/balance 实时获取（带缓存，默认 60s）
- 今日花费：扫描 $DSH_HOME/sessions 的会话日志（zstd 多帧解码），汇总今日 token 用量 × 官方定价估算
- 支持 DeepSeek 2026-08-17 起的峰谷定价（高峰 9-12 / 14-18 点，空闲半价），按每条请求的发生时间自动选用费率
界面
侧边栏底部小部件：
- 展开时显示 余额 ¥xx.xx 与 今日花费 ¥xx.xx，点击展开详情卡（余额构成、调用次数、Token 用量、按模型明细、计价方式）
- 收起时显示 ¥ 图标按钮，悬停提示
- 每 60 秒自动刷新，可手动点击刷新
安装
前提：已安装 dsh（dsh web 可正常运行）。
方式一：npm 安装
dsh plugin add dsh-usage-dashboard --profile web
方式二：本地目录
把本仓库克隆/复制到 profile 的 node_modules 下
mkdir -p ~/.dsh/profiles/web/node_modules/dsh-usage-dashboard
cp -r lib package.json ~/.dsh/profiles/web/node_modules/dsh-usage-dashboard/
然后在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: usage-dashboard
name: 'dsh-usage-dashboard'
config:
apiKeyRef: DEEPSEEK_API_KEY
重启 dsh web 生效。
配置
| 字段 | 说明 | 默认 |
|---|---|---|
| apiKeyRef | DeepSeek API Key 的凭证引用 | DEEPSEEK_API_KEY |
| baseURL | 余额接口地址；留空则用 $DEEPSEEK_BASE_URL，再回退 https://api.deepseek.com | "" |
| prices | 按模型单价覆盖（元 / 百万 tokens：{ input, cacheRead, output }） | 官方现行价 |
| priceSchedule | 日期生效的峰谷定价表 { from, peak, idle } | 2026-08-17 起峰谷定价 |
| balanceCacheMs | 余额缓存毫秒数 | 60000 |
| sessionsRoot | 会话日志目录覆盖 | /sessions |
| scanWindowMs | 只扫描此时间窗口内修改的日志 | 48h |
默认价格（官方现行价，2026-08-17 前）
| 模型 | 缓存命中 | 缓存未命中 | 输出 |
|---|---|---|---|
| deepseek-v4-flash | ¥0.02/M | ¥1/M | ¥2/M |
| deepseek-v4-pro | ¥0.025/M | ¥3/M | ¥6/M |
2026-08-17 起峰谷定价（已内置，无需配置）
| 模型 | 时段 | 缓存命中 | 未命中 | 输出 |
|---|---|---|---|---|
| flash | 高峰 | ¥0.10 | ¥3.0 | ¥9.0 |
| flash | 空闲 | ¥0.05 | ¥1.5 | ¥4.5 |
| pro | 高峰 | ¥0.30 | ¥9.0 | ¥27.0 |
| pro | 空闲 | ¥0.15 | ¥4.5 | ¥13.5 |
价格有变动时在 cordis.patch.yml 的 prices / priceSchedule 里覆盖即可。
说明
- 花费为估算：按 token 用量 × 官方单价计算；不含联网搜索、标题生成等日志中未记录 token 用量的调用
- 余额数字来自官方接口，为准确值
- 接口 GET /api/dsh-usage 只在本机 127.0.0.1 上服务，API Key 不离开服务端
开发与测试
npm test # 运行 host 逻辑 + 客户端 bundle 物化 + SSR 渲染测试
License
MIT扫码进群