前言¶

用 DeepSeek Harness（DSH）跑对话或智能体时，余额和当日消耗往往要切到网页或控制台才能看清；未登录平台账号时，官方用量接口也不完整。下面介绍的 dsh-usage-sidebar 把余额、Token 与费用汇总进 DSH 侧栏与设置页：已登录 DeepSeek 时走平台官方统计，未登录时从本地 session 日志汇总 Token，并在界面上区分两种数据来源。

这是什么¶

dsh-usage-sidebar 由社区维护者 wnk-ke 发布，归类为 DSH 客户端插件（当前 package 版本 0.4.2，许可证 MIT）。它在 DSH 侧边栏展示 DeepSeek 余额与用量 chip，点击可展开近 7 日明细；同时在 Settings → DeepSeek balance and usage 提供余额明细、可选 API Key 配置与用量统计。界面支持 8 种语言：简体中文、繁體中文、English、日本語、Français、Русский、Deutsch、Español。

核心功能¶

侧栏 chip¶

左侧显示余额：余额 ≥ ¥5 时为绿色，低于 ¥5 时为红色。右侧显示当日用量，格式类似 Today: 119.72M @ ¥6.44（具体数值随账号与数据来源变化）。

弹出层（Popover）¶

展示近 7 日 Token 与费用；当日行高亮，用量最高的一天加粗。支持自动刷新开关与刷新间隔（默认 5 分钟），以及语言切换。

设置页¶

在 DSH 设置中进入 DeepSeek balance and usage，可查看余额构成、可选填写 API Key，并查看用量统计。

数字从哪里来¶

插件在不同登录状态下数据来源不同，README 中的对照如下：

要点如下：

• 余额：通过官方接口 GET https://api.deepseek.com/user/balance，使用环境或配置中的 DEEPSEEK_API_KEY。
• 已登录用量：复用 DSH 账号会话（deepseekAccount.getPlatformSession()），无需用户自行提供 userToken。
• 未登录 Token：读取 $DSH_HOME/sessions 下的多帧 zstd 日志，按本地日历日汇总 assistant/message 的 usage。
• 日界：平台按 UTC 日聚合，网站按本地日展示；插件按本地小时分布把每个 UTC 日拆到本地日，以保证合计一致。

安装与启用¶

插件在 Host 进程中运行，安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认与当前 DSH 版本兼容（见下文「兼容性与注意」）。

命令行安装¶

将 <profile> 换成你实际使用的 DSH profile 名称：

# 固定 commit（与市场索引安装一致）
dsh plugin --profile <profile> add "git+https://github.com/wnk-ke/dsh-usage-sidebar.git#70fe100190762eddc5fa91bd2b8336a126354550"

# 跟踪 main 分支（开发用）
dsh plugin --profile <profile> add git+https://github.com/wnk-ke/dsh-usage-sidebar.git

从插件市场索引添加¶

市场索引地址：

https://raw.githubusercontent.com/wnk-ke/dsh-usage-sidebar/main/market-index.json

在 DSH 中：Settings → Plugins → Discover → Add index source，填入上述 URL 后从发现页安装。社区目录站点 SkillHub 插件页 提供介绍与链接，与 DeepSeek / 幻方无官方从属关系，仅作生态索引参考。

典型用法¶

1. 按上一节命令或市场索引完成安装并重启/刷新 DSH 客户端 Web 界面。
2. 在侧栏查看余额与「Today」一行；需要近 7 日明细时打开 Popover，按需开启自动刷新并调整间隔。
3. 若需稳定余额或官方 Token/费用：在设置页配置 DEEPSEEK_API_KEY（可选），并尽量保持 已登录 DeepSeek；未登录时仍可看本地 Token 汇总，费用列会隐藏并提示。
4. 在 Popover 或设置相关 UI 中切换 8 种界面语言之一。

隐私与安全¶

README 说明的设计要点：

• API Key 与账号会话保留在 Host 进程；浏览器侧只收到数值，没有路由返回密钥。
• 本地路由仅接受 loopback、校验同源、写操作需要 x-dsh-spend 头并限流。
• 解析 session 日志时只统计用量，不读取或外传消息正文。
• 对外请求仅指向 api.deepseek.com 与 platform.deepseek.com。

适用场景与注意¶

适合：长期在 DSH 里开发或调试、需要侧栏一眼看余额与当日消耗、并希望近 7 日趋势与多语言 UI 的开发者。

注意：

• 依赖 DSH 版本 >=0.2.1-rc.5 且 <0.4.0（见 package.json 的 engines.dsh）。
• 账号模式依赖 DSH 内部 deepseekAccount 服务，属 best-effort；不可用时回退到本地日志。
• 插件以 当前 dsh 进程权限 运行，安装前请自行审查源码与许可证；勿在不可信环境盲目添加索引或跟踪 main 分支。

结尾¶

dsh-usage-sidebar 把 DeepSeek 余额、Token 与（登录后的）费用收进 DSH 侧栏与设置，并在未登录时用本地 session 补 Token 统计。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。