前言¶
在使用 DeepSeek Harness (DSH) Web GUI 进行开发时，开发者需要直观地了解当前工具的运行状态以及 Token 消耗情况。现有界面通常缺乏这种实时的、可视化的反馈。dsh-work-buddy 插件通过一个像素风格的机器人提供这种反馈，并记录会话产出。
是什么¶
由 AMC-tp 维护的插件。它将一个原创的方头履带机器人添加到 Web GUI 右下角。机器人不仅模拟工作状态（思考、打字），还作为账本记录完成回合数、Token 使用量以及估算费用。
状态机¶
机器人共有五个状态，通过观察机器人的行为和图标变化即可判断当前 DSH 的运行情况：
- 摸鱼中：没有运行中的工具，也没有流式输出。机器人眼睛眯成缝，脚边有一条鱼，头顶飘出 z。
- 思考中：右上角冒出思考气泡，举起右臂。触发条件为 DOM 中存在
[data-streaming]。 - 写代码：面前有一台笔记本，双手搭在键盘上，屏幕光标闪动。触发条件为 DOM 中存在
[data-tool][data-state="running"]。 - 等你选择：睁大眼睛，左上角粉色问号气泡（闪烁）。触发条件为
ctx.uiSession.pendingInteractions非空。 - 完成！撒花：从忙碌回到空闲（连续 3 次采样且忙碌时间超过 0.9 秒）。机器人双臂高举，四周落彩纸。
账本与计费¶
点击机器人可展开账本面板。账本支持按今日、本周、本月、年度查看数据。
- 数据展示：第一行显示完成数、Token（以百万为单位）和估算费用。
- 数据来源：完成数由状态机防抖计数；Token 来自
binding.session.projections.faceOf('tokenUsage')的增量记录；费用基于 DeepSeek 官方价目表（含高峰/非高峰）。 - 定价模型：支持
deepseek-v4-flash和deepseek-v4-pro两个模型，不同模型在高峰和非高峰时段有不同费率。 - 存储位置：数据存储在浏览器的
localStorage中，路径为dsh-work-buddy/ledger/v2。
安装与启用¶
通过命令行安装：
dsh plugin --profile web add github:AMC-tp/dsh-work-buddy
或使用本地路径：
dsh plugin --profile web add link:D:\path\to\dsh-work-buddy
安装后需重启 dsh web。
使用方法¶
- 查看状态：鼠标悬停在机器人上，显示当前状态文字。
- 查看账本：点击机器人，展开面板查看详细数据。
- 切换视图：在面板中选择 Today / Week / Month / Year。
- 调整模型：在账本中切换定价模型。
- 重置：点击面板内的 Reset 清空账本数据（不清除结算基线）。
注意事项¶
- 插件无构建步骤，无第三方依赖，纯浏览器端运行。
- 费用为估算值，并非官方账单。计价时间取的是增量落账时刻，而非请求发起时刻。
- 数据存储在浏览器的
localStorage中，路径为dsh-work-buddy/ledger/v2。卸载插件不会删除已存储的账本数据。
