前言¶

在 DSH（DeepSeek Harness）上跑 agent 时，DeepSeek 按峰谷时段定价，「今天花了多少、余额还剩多少」往往要切到别处查。社区里显示余额、推算今日消耗的客户端插件不少，多数依赖控制台或固定展示逻辑；数字一旦算错，常见做法是手工清零或重启。下面介绍的 dsh-peak-chip（维护者 sunsun320）把 本日消耗 与 当前余额 放在会话头部一个圆点里，点开即面板；其设计重点之一是 自修复——插件故障时可由当前会话里的 agent 按本地维修手册修，计费侧则通过滤波、日界重锚与显式误差行，尽量让错数自己退回，而不必你反复清零。

这是什么¶

dsh-peak-chip 是 DSH 生态下的 客户端 插件（DSHA / Android WebView mobile 变体为主，README 写明 Windows 电脑端未适配）。在会话头部注入一个 圆点指示灯，点击后展开面板，核心两个数：本日消耗、当前余额；详单还包括本日首次观测余额、今日充值识别、本地 token 审计值、「无法审计」差额，以及误差三档告警。

记账口径一句话：本地按本机 token 折算的 L，与按余额变化推算的 S = max(0, V + T) 各算一遍；差额拆成「无法审计」（同账号其它客户端消耗，属正常）与「误差」（本机多算才可疑）。充值识别由宿主侧做余额台阶检测（中位数 3 窗滤波 + 连续窗确认）。完整公式见仓库内 计费算法说明.md。

插件为 第三方作品，非 DeepSeek 官方产品；GitHub 仓库 sunsun320/dsh-peak-chip 当前约 1 star，许可证 MIT（© 2026 deepseekV4.1Flash），package 版本 4.1.8。

核心功能¶

会话内的指示灯与面板¶

1. 圆点：挂在会话头部，作为峰谷/消耗状态的视觉入口。
2. 面板两数：本日消耗、当前余额。
3. 详单：本日首次观测余额、当前余额、今日充值识别、本地审计、「无法审计」、「误差」及对应告警档位。

DeepSeek 定价随峰谷变化；插件把「今日花了多少、还剩多少」放在当前对话上下文中，减少切页查账。

自修复：坏了由 agent 读本地手册修¶

面板详单 最底部 有 「一键维修」 按钮。点击后会在 当前会话输入框 填入一段「维修契约」（只填、不自动发送）。你需要自行发送，并由 正在使用的 agent 读取插件目录内的 维修手册.md，按手册完成流程，大致为：

1. 先问清「发生了什么」（现象、时间、是否充值/换模型/改设置、期望行为），不先跑测试或翻代码；
2. 再诊断：证据、根因、拟改动，经你确认后再改代码；
3. 改代码、同步价目表、必要时升 RULE_VERSION；
4. 按手册 §〇 更新文档与测试、写 开发日志.md、写 故障记录/，测试通过后再封包；
5. 修不动则如实收口为「已知不可修」，而非假装修好。

Release 包（.tgz）内已含完整源码（宿主与客户端）、维修手册、六套测试及 package.json、cordis.patch.yml，维修不依赖登录 GitHub 或另行 clone 源码。若整块客户端插件挂掉、按钮不可用，可把本地 维修手册.md 路径直接发给 agent。

诚实边界：客户端半边整体失效时，该按钮也会消失（同类客户端插件往往一并受影响）。

数字侧的自纠正（不必手工清零）¶

README 强调与「只显示、错了靠人清」的同类插件不同，本插件在算法与状态机层做了多层回退：

• 误判充值会撤销：临时充值参与显示但不落库；后续窗口余额证据不支持则自行消失（文档举例：幻影充值行可从数字变回 —）。
• 黄灯滞回：进告警 ≥0.6、出 <0.4，均要求连续 3 窗；水位回落后黄灯自动恢复。
• 日界零携带：零点重锚，昨日错误不带入今天。
• 灰态有出口：连续 3 天红才转灰（语义为计费口径已不成立）；唯一常规出口为规则版本变更，避免静默永久锁死。
• 凭据现取：换 API key 不必重启插件；缺 DSHA 3090 桥时仅 「充值」按钮 降级，面板与记账照常。

精度取舍：只用 API key，不读控制台¶

作者说明：部分计费插件直接读官网控制台，口径更贴近官方明细；本插件 不 走该路径——实测该账号下 12 个端点仅 /user/balance 与 /models 返回 200，/user/usage 为 404，控制台数据不在开放平台 API 内。读控制台通常需要 网页登录态（Cookie/Token），权限面与可吊销的 API key 不同。

本插件选择：官方余额差分 + 本地 token 审计，仅使用你在 dsh 设置里配置的 DeepSeek API key（插件不存 key），不碰登录态。面板上用「无法审计」「误差」两行把不确定摊开，而不是给出看似精确却无法核对的数字。

安装与启用¶

从 GitHub Release 附件安装（安装器不执行构建脚本，插件为零构建、lib/client.js 为预构建单文件）：

dsha-plugin import dsh-peak-chip-4.1.8.tgz

发布包直链：

https://github.com/sunsun320/dsh-peak-chip/releases/download/v4.1.8/dsh-peak-chip-4.1.8.tgz

装完后 重启 dsh web，并在浏览器中 刷新页面。

peer 依赖包括 @deepseek-ai/dsh-credentials、@deepseek-ai/dsh-settings（^0.1.5-rc.2）等；README 验证环境为 DSHA 0.1.5-rc2 / dsh 0.1.5-rc.2，arm64，Android 手机 WebView（mobile 变体）。

典型用法¶

1. 在 DSH 中配置好 DeepSeek API key（插件通过 dsh 凭据读取，不自存）。
2. 按上文命令导入 dsh-peak-chip-4.1.8.tgz 并重启、刷新 Web 界面。
3. 打开任意会话：看头部 圆点 颜色/状态；点击圆点查看 本日消耗、余额 及详单。
4. 若需通过 DSHA 桥发起充值，需本机 127.0.0.1:3090 桥可用；无桥时充值按钮降级，其余功能仍可用。
5. 出现显示异常或插件行为异常：优先用面板底部 一键维修（或手动把 维修手册.md 交给 agent）；日常只需关注面板上的误差与「无法审计」行判断是否正常。

记账与告警逻辑的细节、阈值参数，以仓库内 计费算法说明.md、声明.md、依赖.md 为准。

接触面、边界与适用场景¶

权限与数据（安装前宜自行核对源码）¶

• 读：$DSH_HOME/.bridge_token（仅用于 DSHA 桥）。
• 连：api.deepseek.com（余额；凭据来自 dsh 设置）、127.0.0.1:3090（仅「充值」按钮）。
• 写：settings 命名空间 dsh-peak-chip（余额、今日消耗、充值识别、调试窗口、自身路径等）。
• 无遥测：不向第三方上传对话或设备标识。

插件以 当前 dsh 进程权限 运行；安装前应阅读仓库源码与 MIT 许可证，确认接触面可接受。

明确不做的事¶

• 不代替官方计费；数字均为本地审计与余额推算，误差会显式展示。
• 不改模型路由、不改定价参数、不自动充值。
• Windows 电脑端未适配（无 3090 桥、休眠/唤醒行为未覆盖）。

适合谁¶

• 主要在 DSHA / Android WebView 上用 DSH 对话、希望 会话内 看到今日消耗与余额的开发者。
• 能接受「API 余额差分 + 本地 token 审计」精度，并愿意看面板上的 无法审计 / 误差 行的人。
• 希望插件出问题时可由 本地 agent + 维修手册 就地修、且 Release 包自带测试与文档的使用者。

不适合需要 与官网控制台完全一致明细、或必须在 Windows 桌面 dsh 上同等体验的场景（README 已说明未适配）。

文档与社区入口¶

DSH 社区插件目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系；选用第三方插件前，建议结合 声明.md、故障记录/ 与本地测试（仓库含 v4-alert、v4-client、v4-drift 等六套测试 + sync）自行判断是否与你的环境匹配。

经过上面的步骤，你可以在移动端 DSH 会话里用一个小圆点持续对照 本日消耗与余额，并在数字或插件异常时，优先依赖其 自修复设计 与显式误差口径，而不是反复手工清零或盲目信任控制台级精度。