前言¶
在 DeepSeek Harness（DSH）里长时间跑对话或子代理时，峰谷价切换、本机会话累计花了多少、账号里还剩多少，往往要切到文档或控制台才能对齐。下面介绍社区插件 dsh-deepseek-status：在 composer 旁常驻三个徽标，数据自动刷新，页面侧不接触 API 密钥。
这是什么¶
dsh-deepseek-status 由维护者 XG221B 发布，分类为客户端插件，面向 DeepSeek Harness。它在输入框旁边展示：
- 计费时段（峰价 / 谷价、距下次切换、当前各模型价格）
- 本对话花费（含子代理会话合计，可展开按会话、模型、峰谷拆分）
- 账户余额（充值 + 赠送）
官方简介强调：峰谷指示与余额徽标均自动更新，且无需在插件里配置凭证（余额仍依赖 Harness 账号登录，见下文）。
当前 package 版本为 2.1.1，许可证 MIT，Node >=18。在 DSH 0.2.0-rc.2 上开发验证；2.1.0 契约检查在 0.2.1-rc.2 上通过。
界面长什么样¶
一行示例（来自 README）：
● 谷价 · 距峰价 5天15小时 ● 花费 ¥44.09* ● 余额 ¥110.00
交互要点：
- 点计费徽标：当前时段与下次切换、价格表、规则说明与数据核对时间。
- 点花费徽标：总额（含子代理合计）、按模型与 token 的金额、未计价提示、核对时间。
- 点余额徽标：充值余额、赠送余额、合计，以及去充值、查看用量入口。
详情卡只有几行，展开不会把对话顶高；更细的数字（精确 token、节假日与调休等）在 hover 提示里。带 * 表示有调用落在价格表之外的模型（例如第三方路由），那部分 token 只列出、不并进总额。颜色跟随 Harness 主题，中英文跟随界面语言。
核心功能¶
峰谷计费指示¶
Host 侧定时抓取 DeepSeek 官方定价文档 与节假日数据（holiday-cn、chinese-days，两者一致才采用），交叉校验后缓存到插件目录 cache/dataset.json，并在本机回环提供只读路由 /dsh-deepseek-status/data.json 供页面读取。计费数据约 每 6 小时刷新一次；只有计费相关功能会联网。
本对话花费¶
花费由 Host 从本地会话日志（~/.dsh/sessions）计价，路由 /dsh-deepseek-status/cost.json 仅接受回环地址（127.0.0.1 / ::1），不写盘、不联网、拿不到密钥。徽标约 每 20 秒刷新。
计价规则（README 摘要）：
- 逐条
assistant/message按 provider 上报的 usage，以该次调用发生时刻的峰谷价计费。 - 从当前会话日志递归读取子代理目录，子代理花费计入总额，详情中有「子代理合计」。
- 价格表外模型单独列 token，标为未计价、不并入总额。
- 官方价目无「缓存写入」项时标为不计费；无 usage 的内部调用（如标题生成、自动压缩摘要）不计入。
- 金额为按官方价表的本机估价，与账单口径一致，但不替代官方账单。
账户余额¶
余额向 Harness 自带账号服务读取；令牌留在 Host 进程，页面只拿到金额。余额不写磁盘、不打印、不外发。读取最快 每分钟一次，页面切到后台时暂停。
需要登录 DeepSeek 账号：仅 API key、未登录时 Harness 账号服务里没有钱包，余额徽标不显示；计费徽标不受影响。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议浏览 GitHub 仓库 源码与 MIT 许可证。DSH 社区目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系。
桌面版（desktop profile）¶
命令行 dsh plugin 对 desktop profile 会直接拒绝：
error: profile "desktop" is managed exclusively by the Electron application
任选其一：
- 侧边栏 Plugins → Add plugin，填写
github:XG221B/dsh-deepseek-status。 - 使用仓库安装器（等价于在 profile 目录
pnpm add并写入dsh.profile.bundles，但绕过上述拒绝）。需先克隆本仓库，在仓库根目录执行：
node tools/install.mjs --profile desktop
无法访问 github.com 时，可用同一提交的 tarball：
node tools/install.mjs --profile desktop \
--spec https://codeload.github.com/XG221B/dsh-deepseek-status/tar.gz/refs/heads/main
卸载：UI 侧将 add 改为 remove；安装器加 --remove。
其它 profile（web / tui / headless 等）¶
dsh plugin --profile <你的 profile> add github:XG221B/dsh-deepseek-status
卸载将 add 改为 remove。
装完刷新一次页面。覆盖安装旧版本需重启一次 Harness（Host 代码缓存在进程里）。花费徽标首次出现也需要重启 Harness；启动后点徽标展开明细。若 Host 尚无价格数据或会话持久化，徽标会先隐藏，而不是显示猜测数字。
使用前要知道的几件事¶
- 局域网暴露：若 Harness 绑定
0.0.0.0，同网段可读/dsh-deepseek-status/data.json（仅公开定价与节假日缓存）；花费路由仍只限回环。 - 子代理与第三方模型：子代理花费会合计；路由到价目表外模型时，花费总额带
*且未计价部分不进合计。 - 故障恢复：真出问题时，从
~/.dsh/profiles/<profile>/package.json的dsh.profile.bundles里删掉dsh-deepseek-status再启动即可。 - DSH 升级后：可先跑契约检查再决定是否重启：
node tools/preflight.mjs --live
适用场景¶
- 在 DSH 桌面或 web 界面里写 prompt、跑多轮子代理，希望不用切页就能看到峰谷切换与当前价目。
- 需要本对话实时估价（含子代理），且接受金额来自本地日志、非官方账单。
- 已登录 DeepSeek 账号，希望在 composer 旁看充值 + 赠送余额。
不适合把插件当成唯一计费依据的场景：官方账单仍以 DeepSeek 控制台为准；仅 API key、无账号登录时看不到余额徽标。
结尾¶
dsh-deepseek-status 把峰谷价、会话花费（含子代理）和账号余额收到 composer 旁三个徽标里，自动刷新，页面侧不碰密钥。安装方式因 profile 而异：desktop 用 UI 或 tools/install.mjs，其它 profile 用 dsh plugin add。
