用量信息 xyidong/deepseek-usage-info-check

deepseek-usage-info

语言 / Language：English

DeepSeek Harness 内置扩展：在设置界面新增「用量信息」页，实时展示本 Harness 的 DeepSeek API 用量与余额，并在侧边栏「设置」上方提供余额预警条。

能力说明

- 中英双语：界面文案跟随 Harness「通用设置」的语言自动切换（中文 / English）
- 账户余额：实时查询 DeepSeek API 余额（赠送余额 / 充值余额 / 更新时间），每 30 秒自动同步；「去充值」一键跳转 platform.deepseek.com/top_up，充值后自动刷新；币种以 API 返回为准（不同国家/地区账号币种不同，如 CNY/USD，无法识别时默认 CNY），消费金额按对应币种官方价格折算
- 余额预警：
- 本地预警阈值可调（余额 ≤ 阈值时触发），默认 10，用户调整后持久化、以用户调整值为准
- 云端阈值一键跳转平台网页设置（官方未开放 API 修改接口）
- 侧边栏「设置」上方预警条：触发时展开 10 秒后自动最小化为红色圆叹号图标，点击图标展开/收起（带缩放动画），可在设置页开关
- 用量统计（平台同款风格）：
- 按小时归档本 Harness 经 DeepSeek API 发起的模型调用（输入/输出/缓存读写/推理 token）
- Tokens 堆叠柱状图（配色与 platform.deepseek.com/usage 一致：输出 #0C70F3、输入 #60B3FE、缓存命中 #A0DCFD）与消费金额柱状图
- 横纵坐标轴、参考刻度线、今日（0–24 时）/近 7 天/近 30 天维度切换（0.15s 衔接动画）、柱形悬停数值小窗
- 消费金额按官方 v4 系列空闲时段单价估算（仅供参考）
- 升级自愈守护（可选组件，见 guard/）：Harness 升级后自动检测官方是否内置类似功能——已内置则提示以官方为准；未内置则自动恢复插件文件与启动行

安装

前置条件：已在 Harness「模型」设置中配置 DEEPSEEK_API_KEY（或通过环境变量提供）。

方式一（推荐）：profile 工作区安装

1. 把仓库放入 Harness profile 工作区并安装依赖：

cd $env:USERPROFILE\.dsh\profiles\web
pnpm add github:xyidong/deepseek-usage-info-check

2. 在 $env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml 中追加启动行：

- insert:
- id: deepseek-usage-info
name: deepseek-usage-info
config:
bannerEnabled: true
alertThreshold: 10

3. 重启 DeepSeek Harness，打开 设置 → 用量信息。

方式二：手动嵌入 Harness 安装树

1. 把 index.js、client.js、package.json 复制到 <Harness安装目录>\node_modules\deepseek-usage-info\
2. 在 <Harness安装目录>\node_modules\@deepseek-ai\dsh-base\cordis.patch.yml 末尾追加上述启动行
3. 建立客户端解析链接（Windows junction）：

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\node_modules\deepseek-usage-info"
-Target "<Harness安装目录>\node_modules\deepseek-usage-info"

4. 重启 Harness。

🤖 使用 AI 工具安装：一句话命令

把下面这一行直接发给 AI 工具（Claude Code / Codex / Harness 等）即可完成安装（按方式二自动执行；完成后重启 Harness）：

$p="$env:APPDATA\npm\node_modules\@deepseek-ai\dsh\node_modules\deepseek-usage-info"; New-Item -ItemType Directory -Force -Path $p | Out-Null; foreach($f in 'package.json','index.js','client.js'){ Invoke-WebRequest "https://raw.githubusercontent.com/xyidong/deepseek-usage-info-check/main/$f" -OutFile (Join-Path $p $f) }; New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\node_modules\deepseek-usage-info" -Target $p -Force -ErrorAction SilentlyContinue | Out-Null; $pt="$env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml"; if(-not (Test-Path $pt)){ Set-Content -Path $pt -Value "" }; if(-not (Select-String -Path $pt -Pattern 'id: deepseek-usage-info' -Quiet)){ Add-Content -Path $pt -Value "n- insert:n - id: deepseek-usage-infon name: deepseek-usage-infon config:n bannerEnabled: truen alertThreshold: 10n" }

注意：以上命令假设 Harness 安装在 npm 全局目录（$env:APPDATA\npm\node_modules\@deepseek-ai\dsh）。若安装位置不同，请先让 AI 工具用 where dsh / Get-Command dsh 定位安装目录并替换 $p。

可选：升级自愈守护

把 guard/deepseek-usage-guard.mjs 复制到 $env:USERPROFILE\.dsh\plugins\，并在 $env:USERPROFILE\.dsh\cordis.patch.yml 中追加：

- insert:
- id: deepseek-usage-guard
name: "file:///<你的路径>/.dsh/plugins/deepseek-usage-guard.mjs"

再把插件三个文件备份到 $env:USERPROFILE\.dsh\plugins\deepseek-usage-info-backup\。升级后守护会在首次启动时自动检测并自愈。

使用

- 查看余额：设置 → 用量信息 →「账户余额」卡片；点击「立即刷新」手动更新，「去充值」跳转充值页
- 查看用量：「用量统计」卡片，切换 今日 / 近 7 天 / 近 30 天；鼠标悬停柱形查看该时段明细
- 余额预警：「余额预警」卡片修改本地阈值与提醒开关；云端阈值点链接到平台网页设置
- 预警条：触发后出现在侧边栏「设置」上方，10 秒后自动缩成红色圆叹号图标；点击图标展开/收起，点击文字跳转充值页

常见问题

Q：显示“余额获取失败 / 未知错误”？ A：先确认已在「模型」设置中配置 DEEPSEEK_API_KEY；若仍失败，把 ~/.dsh/deepseek-usage-info-debug.log 内容附在 issue 里。

Q：设置里没有「用量信息」入口？ A：补丁层在启动时读取，修改后需要重启 Harness；方式二还需确认 junction 已建立且指向正确。

Q：消费金额和官方账单不一致？ A：官方只开放余额接口、没有历史账单 API。本插件按本机记录的 token 用量 × 官方 v4 空闲时段单价估算，仅供趋势参考。

Q：升级 Harness 后插件消失了？ A：升级会覆盖 dsh-base/cordis.patch.yml 并可能清空嵌入的包文件。安装「升级自愈守护」后会自动恢复；也可重新运行上面的一句话命令。

Q：官方未来内置了同类功能怎么办？ A：守护会在升级后的首次启动自动检测并提示「以官方功能为准」，同时停用本插件的界面与预警条（数据统计保留）。

Q：数据会泄露吗？ A：不会。用量数据只存在本机 ~/.dsh/dyn-deepseek-usage.json；余额查询是直连 DeepSeek 开放接口的普通 HTTPS 请求，不经过大模型、不消耗 token；API Key 经 Harness 凭据服务解析，不落盘。

Q：界面语言如何切换？ A：插件界面跟随 Harness「通用设置」的语言自动切换（中文 / English），无需单独配置。

Q：余额币种显示得不对？ A：币种以 DeepSeek 余额接口返回的 currency 字段为准（不同国家/地区账号币种不同，如 CNY/USD）；接口未返回币种时默认 CNY。

Q：启动报 duplicate loader entry id 打不开？ A：说明 ~/.dsh/cordis.patch.yml 里残留了 deepseek-usage-info 的 insert 块，与 dsh-base/cordis.patch.yml 中同 id 的行重复。删除用户补丁层里的该块即可（当前版本的守护已不会再写入它）。

Q：如何卸载？ A：删除 patch 文件中的 deepseek-usage-info（及可选 deepseek-usage-guard）行 → 删除包目录与 junction →（可选）删除 ~/.dsh/dyn-deepseek-usage.json 与 ~/.dsh/deepseek-usage-info-state.json → 重启。

License

MIT