ruozhi5067

dsh-cost-tracker

Name: dsh-cost-tracker
Author: ruozhi5067

DSH 侧边栏任务花费统计插件：总花费、当前项目、token 明细与 DeepSeek 官方人民币单价，自动更新，重启自动恢复。

Introduction

DSH（DeepSeek Harness）侧边栏任务花费统计插件：在侧边栏底部显示总花费、当前项目花费、token 明细，以及 DeepSeek 官方人民币单价（自动随官方定价页更新，进程重启后自动恢复）。

侧边栏底部卡片（位于 cordis 插件面板上方，独占一行）
- 折叠态：
```
已花费：¥0.57 当前项目：¥0.30
输入命中：1.2k 输入未命中：3.4k 输出：5.6k
展开 ▸
```
- 展开态：逐项目明细（显示项目名称、总花费、输入命中/未命中/输出 token 数），以及官方模型单价
覆盖全部项目，无需逐个打开：除了内存中的活跃会话，还增量读取持久化的会话日志（sessionPersistence.readFrom），因此侧边栏里未打开的其他项目也会自动显示花费，不需要点击切换项目
官方人民币单价自动更新：抓取 DeepSeek 官方中文定价页（api-docs.deepseek.com/zh-cn/quick_start/pricing）的「元」价格，启动时、每 12 小时、超过 6 小时未更新时自动刷新；↻ 可手动刷新；抓取失败时回退到内置人民币价格
重启自动恢复：作为宿主组合插件，每个根会话启动时自动重建侧边栏组件
可在插件管理页管理：宿主插件行出现在「设置 → 插件 → 全部」清单；动态组件在侧边栏 Cordis 插件面板中可批准/停止/移除

组件由两层组成：

宿主插件 cost-widget-auto（本包，src/index.mjs）：监听 agent/created，为每个根会话调用动态插件运行器的 define() + run()，自动创建/恢复侧边栏组件。浏览器端 UI 只能以动态插件形式运行，因此由这一行承担“持久化”职责。
动态组件「任务花费统计」（widget/host.js + widget/client.js）：实际的费用统计与界面代码，随会话自动加载。

费用计算直接使用会话日志中 provider 上报的 TokenUsage（输入命中=缓存命中输入、输入未命中=非缓存输入、输出=输出），按官方人民币单价折算，(turn:step) 去重、不重复计费。

安装包到 profile（在 profile 目录 ~/.dsh/profiles/<profile>/ 下）：
```
cd ~/.dsh/profiles/<profile>
pnpm add dsh-cost-tracker
```
将该包加入 profile 的 bundle 列表（~/.dsh/profiles/<profile>/package.json 的 dsh.profile.bundles）：
```
{
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "...", "dsh-cost-tracker"]
    }
  }
}
```
其自带 cordis.patch.yml 会自动插入插件行。

修改组件界面/格式：编辑 widget/client.js（界面）与 widget/host.js（统计与价格逻辑），保存后重启生效
价格来源：默认抓取官方中文定价页；仅英文页可用时按官方两版价格交叉推导的汇率折算
模型适配：内置价格表包含 deepseek-v4-flash / deepseek-v4-pro，官方页面结构变化后解析器会按表格结构自适应；若新增模型未命中，费用按 0 计并标记