前言¶

在 DeepSeek Harness 里跑智能体或长对话时，Token 和消费会悄悄累加。默认做法是要进 设置 → 账号与余额 → 查询用量 才能看到本月花了多少、余额还剩多少。窗口底部没有常驻信息，切换主面板时也看不到同一套数字。

下面介绍社区插件 dsh-sidebar-usage（维护者 YQzhangsan）：在 Harness 窗口底部挂一条紧凑的用量与余额条，横跨三栏底部，切换主面板时仍保持显示；未登录 DeepSeek 账号时整条不渲染，也不占高度。

这是什么¶

dsh-sidebar-usage 是 DeepSeek Harness 的只读展示插件，当前版本 0.1.0（MIT 许可）。它占用框架级 shell.bottom 槽位，把今日/本月消费、本月 Token 总量、充值与赠金余额，以及跳转「查询用量」的入口，集中在一行里。数据来自 Host 侧的账号服务与平台控制台用量接口，插件不改账号、不上报遥测、不保留历史。

社区目录页：skillhub.cn/plugins/YQzhangsan/dsh-sidebar-usage
源码与说明：github.com/YQzhangsan/dsh-sidebar-usage

DSH 生态主张「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。

核心功能¶

安装并登录账号后，底部条大致呈现如下布局（数字随账号变化）：

今日消费 ¥0.42 · 本月消费 ¥14.19 · 本月 Tokens 104,751,630      充值余额 ¥2.80 · 赠金余额 ¥3.03   查询用量 ↗

右侧有刷新按钮，可立即重读汇总；平时约每分钟自动刷新一次。

数据来源与兜底¶

• 余额：来自 Host 的 deepseekAccount 服务，与「账号与余额」设置页同一组官方平台接口；插件只读。
• 消费与 Tokens：来自平台控制台用量接口（platform.deepseek.com/api/v0/usage/cost 与 …/usage/amount），使用 DSH 已保存的账号授权。这些是控制台接口而非公开 API，可能随时调整。
• 用量接口不可达或拒绝授权时，余额仍正常显示；今日消费改用「当日初始余额 − 当前余额」估算，并标注 估算，不会把估算值伪装成官方数字。

隐私与权限边界¶

• 浏览器侧只访问本机 Host 路由 /api/dsh-usage-bar/summary。
• 只有 Host 会以 DSH 已保存的账号授权访问 platform.deepseek.com；token 不会进入页面、不会写日志、不会落盘到插件自己的任何位置。

前置条件¶

1. DeepSeek Harness 0.2.1 及以上（依赖 shell.bottom 槽位与账号服务）。插件在 0.2.1-rc.3 上开发并验证。
2. 已登录 DeepSeek 账号。未登录时不渲染、不占位。

安装与启用¶

仓库地址：https://github.com/YQzhangsan/dsh-sidebar-usage

CLI 安装（需替换成你的 profile 名）：

dsh plugin --profile <profile> add github:YQzhangsan/dsh-sidebar-usage

安装后刷新页面。若使用 DSH Desktop，请在 设置 → 插件 或插件市场中安装，避免 CLI 指错 profile。

插件无构建步骤：index.js 与 client.js 即为发布用源码，由 cordis.patch.yml 插入 sidebar-usage 加载行。

典型用法¶

经过上面的安装与刷新，登录账号即可在窗口底部看到用量条，无需额外配置项。

日常使用中：

1. 扫一眼底部行的「今日消费 / 本月消费 / 本月 Tokens」控制预算与调试强度。
2. 需要明细时点击 查询用量 ↗，跳转平台用量页。
3. 若感觉数字滞后，点右侧刷新；Host 对同一份汇总有数秒缓存。

适用场景与注意¶

适合谁：长期在 DSH 里开发或跑 Agent、希望少点菜单、随时看到本月 Token 与余额的开发者。

安装前建议：插件以当前 DSH 进程权限运行，会代 Host 用已保存授权访问平台接口。安装前应浏览 源码仓库 与 MIT LICENSE，确认符合你的安全与合规要求。

常见问题（摘自官方 README）：

结尾¶

dsh-sidebar-usage 把用量与余额从设置页里「拎」到窗口底部，只读、轻量，并与 DSH 账号服务对齐。需要安装或 issue 时，可访问 SkillHub 目录页 与 GitHub 仓库。