ds-deepseek-usage
DeepSeek 账户使用情况监视器（HP/MP）——侧边栏模块，显示余额和 token 使用量进度条；通过捆绑的 CLI（login-cli.mjs）使用微信扫码登录，仅在可见时每小时同步，并实时增加本地 token 使用量。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add ds-deepseek-usage@1.1.1Ds Deepseek Usage 以 ds-deepseek-usage 发布，当前版本为 1.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek 账号用量监视插件 —— 为 DeepSeek Harness (DSH) Web/桌面端提供仿游戏风格的 HP/MP 侧边栏模块。
login-cli.mjs(微信扫码登录 CLI)完成登录,二维码直接显示在插件里llm/stream 事件,实时累加本次进程内产生的 Token 用量(今日/本月/分模型),平台尚未同步前即可看到增量$DSH_HOME/ds-deepseek-usage.json,重启不丢| 文件 | 职责 |
|---|---|
index.js | Host 半区(服务端):同步引擎、CLI 扫码登录(调内置 login-cli.mjs)、token 文件读取/重载、llm/stream 计数、HTTP API /api/ds-usage、文件持久化 |
login-cli.mjs | 内置微信扫码登录 CLI(随包分发,非独立工具;支持 --json-lines/--token-file 等) |
登录方式:侧边栏 ⚡ 扫码登录 → host 调用包内
login-cli.mjs(--json-lines --token-file <DSH_HOME>/ds-deepseek-usage.token)→ 二维码回传显示 → 扫码确认后 token 自动生效。 CLI 随插件包分发,不作为独立工具;如需自定义可用环境变量DS_WECHAT_LOGIN_BIN覆盖。host 每 10 秒也会检查 token 文件兜底。 |client.js| Client 半区(浏览器):通过window.__ModuleLoader__加载,注入sidebar.footer.action槽位渲染 HP/MP 模块 | |package.json| 插件元数据(exports["./client"]声明客户端半区) | |dsh.plugin.json| 展示性插件元数据(可选,随包分发,DSH 无硬性读取) |
DeepSeek Platform API ──sync──▶ index.js (host) ──state──▶ client.js (浏览器 HP/MP 模块)
▲ ▲
└── 微信扫码登录(auth API) ◀──┘ └── llm/stream 实时计数(本地增量)
GET https://platform.deepseek.com/api/v0/users/get_user_summary —— 余额、累计消费GET https://platform.deepseek.com/api/v0/usage/amount?month=M&year=Y —— Token 用量GET https://platform.deepseek.com/api/v0/usage/cost?month=M&year=Y —— 费用均为平台私有面板接口,可能随时变动;认证失败码
40002/40003视为登录失效。
插件已声明 dsh.bundle.patch(随包附带 cordis.patch.yml),dsh plugin 装完会自动把它加入 profile 的 bundles 层并激活,无需手改任何配置文件:
# 前置:DSH 已安装(dsh 命令可用)、Node >= 22、pnpm 在 PATH 上(dsh plugin 内部转发给 pnpm)
# 安装到 web profile(最常用)
dsh plugin --profile web add ds-deepseek-usage
# 桌面端:用桌面端 App 自建的 profile 名替换 web 即可
# 本版 dsh CLI 内置的 profile 模板为 web / headless
dsh plugin --profile <你的profile> add ds-deepseek-usage
⚠️ 安装后必须重启 dsh 才生效:
dsh plugin add写入 profile 的 bundles 层,该层只在启动时合成(运行中不监听)。重启前POST /api/ds-usage返回 404 属正常现象。
验证安装与版本:
dsh plugin --profile web ls # 应看到 ds-deepseek-usage@最新版
dsh --profile web --dump-config | grep ds-deepseek-usage # 合成树里应有该插件行
# 重启 dsh web 后:POST /api/ds-usage 请求体 {"method":"state"} 应返回状态而非 404
把本目录放入 DSH 用户目录的共享插件目录:
# Windows 示例;$DSH_HOME 默认是 ~/.dsh
Copy-Item -Recurse ds-deepseek-usage "$env:USERPROFILE\.dsh\profiles\node_modules\"
在目标 profile(如 web、headless 或桌面端自建 profile)的 cordis.patch.yml 中挂载:
# $DSH_HOME/profiles/<profile>/cordis.patch.yml
- insert:
- id: ds-deepseek-usage
name: ds-deepseek-usage
重启 dsh web / 桌面端(客户端 bundle 在启动时烘焙,刷新页面不生效)。
桌面端(dsh-desktop)会自动把
profiles/node_modules里的用户包 junction 进应用内,无需额外操作。
# 更新到最新版本(依赖范围 ^1.x 会自动拉到最新 1.x)
dsh plugin --profile web update ds-deepseek-usage
# 发布了大版本(2.x)时,需显式重装以更新依赖范围
dsh plugin --profile web remove ds-deepseek-usage
dsh plugin --profile web add ds-deepseek-usage
# 更新后同样必须重启 dsh 生效
dsh web
与安装一致:更新写入的是 bundle 层,重启后才生效。运行中会话的 client 端改动(
client.js)可经 client-hmr 免刷新热替换;host 端(index.js)需重启。
node login-cli.mjs --token-file ~/.dsh/ds-deepseek-usage.token 写 token 文件,插件 10 秒内自动生效POST /api/ds-usage,请求体 { "method": "..." }:
| method | 作用 |
|---|---|
state | 取当前状态(客户端轮询用,不触发同步) |
tick | 标记页面可见并尝试同步,返回状态 |
hidden | 标记页面隐藏(暂停按需同步) |
syncNow | 立即同步一次 |
loginStart / loginCancel | 开始/取消浏览器登录 |
logout | 清除登录态 |
node --check index.js # 语法检查
node --check client.js
修改后需要重启 DSH 生效:client 端(client.js)在已运行的会话中可经 client-hmr 免刷新热替换;host 端(index.js)需重启。
| 现象 | 处理 |
|---|---|
| 侧边栏看不到模块 / API 返回 404 | 安装/更新后未重启(bundle 层只在启动时合成);或手动安装时 cordis.patch.yml 未挂载 |
| 点击 MP 条只换名称、进度不变 | 已修复:今日/本月共用同一刻度(取两者较大者为单位),切换时进度可见变化 |
| 启用插件后对话报错/无法对话 | 已修复:计数逻辑位于 try/catch 中,观察者错误不会破坏主对话流 |
| 登录失败/二维码过期 | 点击 刷新二维码 重新获取;若提示微信回调失败,稍后重试 |
# 1. 在 package.json 中递增 version(如 1.1.0 -> 1.2.0)
# 2. 发布到 npm(使用带发布权限的 .npmrc)
cd ds-deepseek-usage
npm publish --userconfig /path/to/.npmrc-publish
# 3. 提交并推送,与 GitHub 对齐
git add -A && git commit -m "chore: v1.2.0" && git push
终端用户执行
dsh plugin --profile web update ds-deepseek-usage+ 重启即可获得新版本。
MIT