前言¶
在 DeepSeek Harness（DSH）里日常对话或开发时，若要确认 Platform 账户里还剩多少充值与赠金，通常需要打开 Settings → Account。对经常切换会话、盯用量的使用者来说，多一步设置页既打断节奏，也容易在侧边栏已展开的情况下忘记去看。
Sidebar Balance（仓库名 dsh-sidebar-balance）是社区维护者 Qliphoth11 发布的 客户端 Web 插件：把与 Account 页相同来源的余额读数，放到侧边栏底部操作区，并随主题与中英文界面切换展示格式。它不自行发网络请求、不上报遥测，数据经 Host 自带的 account Remote 命名空间取得。
这是什么¶
- 定位：DeepSeek Harness Web 插件（Cordis bundle），在浏览器或 Desktop 的 Web UI 中运行。
- 维护者：Qliphoth11（MIT 许可证，
package.json版本1.0.0）。 - 解决的问题：登录 DeepSeek 账户后，无需进入 Account 设置页即可在侧边栏 foot 看到余额摘要；点击可刷新，悬停可看各币种钱包与正数赠金明细。
插件与 DeepSeek / 幻方无隶属或背书关系；社区目录见 SkillHub 条目，源码在 GitHub。
核心功能¶
下面介绍 README 中已说明、且与 Harness 内置能力对齐的行为。
展示位置¶
- 在插槽
sidebar.footer.action注册一枚余额「药丸」，位于账户/设置行上方（示意：Plugins 行与头像行之间）。 - 未登录时隐藏。侧边栏收折为 56 px 窄条时，同一读数会改到 composer 状态行，以紧凑 pill 形式出现在 turn / token 统计旁；两处共用一份状态，任一处刷新会同步另一处。
数据来源与刷新¶
- 通过 Host 提供的
accountRemote（getBalance与watch快照流），与 Settings → Account 页面一致；不复制、缓存或持久化凭据。 - 在挂载时、登录/登出变化时、点击 pill 时、以及窗口重新可见时刷新（可见性路径带 30 秒节流）；不做轮询。
- 金额按 Platform 账户钱包（充值与各赠金钱包）汇总，以整分相加后再格式化；不是第三方提供商或纯 API Key 场景的消耗计数。
界面与文案¶
- 样式仅使用
--dsw-*主题 token，随浅色/深色与宿主调色板变化。 - 可见文案走 Client locale（
sidebar.balance命名空间，en/zh）；货币格式随当前 UI 语言（两位小数、千分位、窄符号¥/$）。 - Tooltip 列出各币种钱包与正数 bonus，并提示可点击刷新。
环境与限制¶
- 需要带 Web UI 的 DeepSeek Harness（Desktop 或浏览器）；README 写明在
0.2.1-rc.5上构建并验证。 - 须已登录 DeepSeek 账户（Settings → Account）；仅 API Key、无 Platform 余额的配置下无内容可显示。
- 依赖当前发行版中的
sidebar.footer.action与accountRemote API；若 Harness 更名或移除这些接口，需插件跟进更新。
安装与启用¶
本仓库是 Cordis bundle：cordis.patch.yml 插入一条 Host Loader 行；package.json 里 dsh.client 将 client.js 发布到浏览器。安装前建议浏览仓库源码与 MIT 许可证；插件在 当前 DSH 进程权限 下运行，与任何社区插件一样，应自行评估信任边界。
从本地 bundle 目录（README 推荐路径）¶
先在本地取得仓库内容后，让 Harness 智能体安装 bundle 目录的绝对路径（智能体调用插件管理器的 install_bundle，安装会链接到该目录，改 client.js 后重载页面即可生效）：
Install the bundle at
/absolute/path/to/sidebar-balance
资料中的克隆地址为：
git clone https://github.com/Qliphoth11/sidebar-balance.git
克隆完成后，将上句中的路径替换为你的 checkout 绝对路径即可。
从 GitHub 直接安装¶
若你的 Harness 支持对 bundle 使用 pnpm spec，可让智能体安装：
github:Qliphoth11/sidebar-balance
不支持时，改用上面的本地 bundle 路径方式。
卸载¶
让智能体移除 dsh-sidebar-balance bundle，或在 Settings → Plugins 中关闭 Sidebar Balance。
典型用法¶
安装并启用后，登录 DeepSeek 账户即可在侧边栏底部看到余额 pill（例如界面中可能出现「余额 ¥12.34」一类摘要，具体数值以账户为准）。
- 日常查看：展开侧边栏时在 foot 操作区直接读数，无需打开 Account 页。
- 刷新：单击 pill；或切换窗口回到前台（受 30 秒节流约束）；登录状态变化时会自动更新。
- 明细：鼠标悬停查看各钱包与赠金条目。
- 窄侧边栏：收折侧边栏后，到输入区状态行查看同一余额 pill。
开发侧可在仓库根目录执行语法检查：
npm run check
在 Harness 源码 checkout 中跑 Web 开发监视（pnpm run dev:web）时，客户端插件可热更新；已安装的应用里修改 client.js 后需重载页面。
适用场景与注意¶
适合：长期在 DSH Web UI 中使用、已绑定 DeepSeek Platform 账户、希望在侧边栏或 composer 状态行快速确认充值/赠金余额的用户。
不太适合：仅 API Key、无 Platform 钱包数据的部署；需要第三方模型提供商用量统计的场景（本插件只反映 DeepSeek Platform 账户钱包）。
安全与隐私（README 明确）：插件不自带遥测、不发起独立网络请求；读取均经 Host account 服务。仍建议在安装前阅读 client.js 与 bundle 补丁，确认行为符合预期。
结尾¶
Sidebar Balance 把 Account 页同源的余额读数嵌进侧边栏 foot（及窄栏下的 composer 状态行），减少进设置页的次数，并跟随主题与中英文界面。若要在目录中查看元信息或跟踪 issue，可访问 SkillHub 插件页 与 GitHub 仓库。
