前言¶

在 DeepSeek Harness（DSH）里长时间对话时，余额和计价时段往往要切到别处才能看到。社区插件 dsh-balance-strip（余额胶囊）把「余额、今日已用估算、峰/谷」直接贴在会话页顶部标签行右侧，不点、不悬停、不额外开面板。下面介绍它做什么、怎么装、使用时要注意什么。

这是什么¶

dsh-balance-strip 由社区维护者 CPHW 发布，分类为客户端插件；README 标明其为非官方社区插件，与 DeepSeek 官方无隶属关系。当前 npm 包版本为 0.1.5，许可证 MIT。

它在 DSH Web 界面会话页标签行右侧渲染一枚小胶囊，层级低于系统弹窗；整枚胶囊 pointer-events: none，不挡底下输入与点击。界面语言为中文时显示汉字，其它语言自动换成英文（如 Balance / Today ≈ / Peak / Off-peak）。

核心功能¶

常驻显示的三类读数¶

布局与交互¶

• 垂直对齐「对话」标签文字中线，字号取标签的 computed font-size，随界面缩放与窗口变化。
• 右边缘贴会话栏右边界，不随窗口外缘漂移。
• 每 20 秒向本机 data.json 拉一次数据更新；失败时约 6 秒重试。余额采样约每 60 秒一次，用于估算「今日已用」。

余额数据来源¶

宿主侧按顺序尝试：

1. profile 中的 DEEPSEEK_API_KEY → GET https://api.deepseek.com/user/balance
2. deepseekAccount 服务（登录态）

二者皆无时显示 余额 —，其它读数仍可按规则展示。须已登录 DeepSeek 账户，或在 profile 中配置 API Key 凭据。

与同类型插件¶

README 说明与 dsh-whale-widget（小鲸鱼）位置不同但都会显示余额；同一块区域不要装两份，关掉其中一个即可。

安装与启用¶

环境要求 DeepSeek Harness >=0.2.1-rc.2 且 <0.3.0（写在包的 engines.dsh 中，不兼容版本会拒绝加载）。包为纯 JavaScript，无需 allowBuilds。

先做 npm 安装（CLI Web 应用常用 web profile）：

dsh plugin --profile web add dsh-balance-strip

npm 不可用时的备选（跟 GitHub 主干）：

dsh plugin --profile web add github:CPHWQ/dsh-balance-strip

本地开发可用 link: 指向目录绝对路径。桌面版 profile 通常名为 desktop，由 Electron 应用独占；可在应用内插件页安装，或由助手用内置插件工具安装，而不是用 CLI 改桌面 profile。

装完后必须重启客户端（含系统托盘退出）：注入脚本的通道只在宿主启动时收集一次，当次热装不会出现胶囊。之后仅改 assets/strip.js 样式可通过热替换生效，见下文。

卸载：

dsh plugin --profile web remove dsh-balance-strip

插件唯一落盘文件为 $DSH_HOME/.dsh-strip.json（今日累计与上一次余额），卸载后可自行删除。

典型用法¶

安装并重启后，打开 DSH 会话页即可在标签行右侧看到胶囊，无需额外配置项。预览形态大致如下（ASCII 示意自 README）：

  对话   上下文   …            ┌───────────────────────────────────┐
  ─────                            │ 今日 ¥0.40 估 │ 余额 ¥89.24   峰 │
                                   └───────────────────────────────────┘

若要调间距、轮询间隔或找不到「对话」标签时的兜底位置，编辑插件内 assets/strip.js 顶部常量（如 GAP、EDGE、RIGHT / BOTTOM、POLL_OK / POLL_ERR），保存后约 20 秒内前端热替换生效，无需刷新页面。

工作原理（简况）¶

一半在宿主 lib/index.js（注册 GET /dsh-strip/data.json 与 GET /dsh-strip/strip.js，注入页面脚本），一半在页面 assets/strip.js（定位、配色、轮询）。data.json 无认证但仅服务本机：非回环或跨站请求返回 403；公开部署到局域网/公网时远端页面会显示 余额 —，属有意设计。

「今日已用」不是账单：无账单接口，只能按余额采样间隔累计下降额，小额请求可能被合并，插件未运行时段不计入。

适用场景与注意¶

适合谁： 经常在 DSH 会话页工作、希望一眼看到余额与峰谷计价时段的开发者；已配置 API Key 或账号登录态的用户。

务必注意：

• 插件以当前 DSH 进程权限运行，安装前请阅读 GitHub 源码 与 MIT 许可证。
• 同机其它进程理论上仍可读到本机 data.json 中的金额数字；路由不返回账户 ID、令牌或流水。
• 完全没有胶囊时，多数是装完未重启；长期 余额 — 需检查凭据或 deepseekAccount 服务。
• 社区目录 SkillHub 插件页 与 GitHub 为同一项目的公开入口，非 DeepSeek / 幻方官方应用商店。

结尾¶

dsh-balance-strip 把余额、今日消耗估算和峰谷时段收进标签行右侧一枚胶囊，减少切页查账。安装用 dsh plugin --profile web add dsh-balance-strip，装完重启客户端即可使用。

• 社区目录：https://www.skillhub.cn/plugins/CPHWQ/dsh-balance-strip
• 源码与问题反馈：https://github.com/CPHWQ/dsh-balance-strip
• npm：https://www.npmjs.com/package/dsh-balance-strip