dsh-work-buddy
DSH Web GUI 右下角的高密度像素机器人 —— 同时是一本产出账本。
一个原创的方脑袋履带机器人：闲时摸鱼、干活时思考／敲代码、等你做选择时举手提问、回合结束撒花，并把完成数、Token 消耗、估算费用记成账，按今日 / 本周 / 本月 / 年度汇总。
造型是原创的——同属「可爱方头履带机器人」这一通用原型，但刻意不是任何已有角色的复刻。
五个状态
| 状态 | 小人 | 触发条件（只读页面已公开的语义信号） |
|---|
| 摸鱼中 | 眼睛眯成缝，脚边一条鱼，头顶飘 z | 没有运行中的工具、也没有流式输出 |
| 思考中 | 举起右臂，右上角冒思考气泡 | [data-streaming] 存在 |
| 写代码 | 面前一台笔记本，双手搭在键盘上，屏幕光标闪动 | [data-tool][data-state="running"] 存在 |
| 等你选择 | 睁大眼睛，左上角粉色问号气泡（闪烁） | ctx.uiSession.pendingInteractions 非空 |
| 完成！撒花 | 双臂高举，四周落彩纸 | 从忙碌回到空闲（忙够 0.9 秒才算一次） |
鼠标移上去显示当前状态文字；点机器人展开账本。
账本
点击后面板第一行是今日的三项：
完成 12 Token 3.42M 费用 $1.07
Token 数字很大，所以以百万（M）为单位显示。第二行是本周同样的三项，点「展开 本月 / 年度」再多出两行和计价模型选择。
-
完成数：由状态机自己数（MIN_BUSY_MS 防抖，回到空闲连续 3 个采样才记账）。
-
Token：来自会话的持久化计费投影
binding.session.projections.faceOf('tokenUsage')，四个桶
uncachedInputTokens / cacheReadTokens / cacheWriteTokens / outputTokens。
我们记录的是增量：每个会话记住上次读到的值，只把新增部分记进当天的账，所以同一天跨会话切换也不会重复计。
-
费用：按官方 DeepSeek 价目表（USD / 百万 token）估算，含高峰/非高峰两档：
| 模型 | 非高峰 (input / cacheRead / output) | 高峰 |
|---|
deepseek-v4-flash | 0.22 / 0.007 / 0.66 | 0.44 / 0.014 / 1.32 |
deepseek-v4-pro | 0.66 / 0.022 / 1.98 | 1.32 / 0.044 / 3.96 |
高峰窗口是 Asia/Shanghai 周一至周五 09:00–12:00 与 14:00–18:00。
⚠️ 这是估算，不是账单。 计价档位取的是「增量落账那一刻」的时间，而不是每次请求自己的时间戳——投影只带 turn/step，不带时间。持续工作时两者几乎一致，但批量补账会有偏差。要精确对账请用 @ychris12138/dsh-usage-stats。
所有数据存在浏览器 localStorage 的 dsh-work-buddy/ledger/v2，卸载插件不删账本；面板里的「清零」只清账本、保留结算基线。
关于清晰度
精灵画在一张 32×32 的一致网格上（没有大小块混用），画布 160px、image-rendering: pixelated，所以放大后边缘是硬像素而不是插值糊。天线顶灯的颜色随状态变：青=摸鱼、黄=思考、绿=写代码、粉=等你选择 / 撒花。想更大或更小改 lib/client.js 里的 SCALE（整数，5 = 160px）。
结构
lib/index.js —— host 半区，故意留空（这是纯浏览器端插件，但 loader 需要一行才能挂载）。lib/client.js —— 浏览器半区，手写的 window.__ModuleLoader__.load({...}) 工厂，无构建步骤、无第三方依赖，只 get 官方客户端服务，不 require 任何外部模块。cordis.patch.yml —— 往 profile 里插一行插件。
安装
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。
卸载
dsh plugin --profile web remove dsh-work-buddy
