ruozhi5067/dsh-cost-tracker

README excerpt

dsh-cost-tracker DSH（DeepSeek Harness）侧边栏任务花费统计插件：在侧边栏底部显示 总花费、当前项目花费、token 明细 ，以及 DeepSeek 官方人民币单价 （自动随官方定价页更新，进程重启后自动恢复）。 功能 - 侧边栏底部卡片 （位于 cordis 插件面板上方，独占一行） - 折叠态： - 展开态：逐项目明细（显示 项目名称 、总花费、输入命中/未命中/输出 token 数），以及官方模型单价 - 覆盖全部项目，无需逐个打开 ：除了内存中的活跃会话，还增量读取持久化的会话日志（ sessionPersistence.readFrom ），因此侧边栏里未打开的其他项目也会自动显示花费，不需要点击切换项目 - 官方人民币单价自动更新 ：抓取 DeepSeek 官方中文定价页（ api-docs.deepseek.com/zh-cn/quick start/pricing ）的「元」价格，启动时、每 12 小时、超过 6 小时未更新时自动刷新；↻ 可手动刷新；抓取失败时回退到内置人民币价格 - 重启自动恢复 ：作为宿主组合插件，每个根会话启动时自动重建侧边栏组件 - 可在插件管理页管理 ：宿主插件行出现在「设置 → 插件 → 全部」清单；动态组件在侧边栏 Cordis 插件面板中可批准/停止/移除 工作原理 组件由两层组成： 1. 宿主插件 cost-widget-auto （本包， src/index.mjs ）：监听 agent/created ，为每个根会话调用动态插件运行器的 define() + run() ，自动创建/恢复侧边栏组件。浏览器端 UI 只能以动态插件形式运行，因此由这一行承担“持久化”职责。 2. 动态组件「任务花费统计」 （ widget/host.js + widget/client.js ）：实际的费用统计与界面代码，随会话自动加载。 费用计算直接使用会话日志中 provider 上报的 TokenUsage （输入命中=缓存命中输入、输入未命中=非缓存输入、输出=输出），按官方人民币单价折算，(turn:step) 去重、不重复计费。 安装 方式 A：作为 profile bundle（推荐） 1. 安装包到 profile（在 profile 目录 /.dsh/profiles/ / 下）： 2. 将该包加入 profile 的 bundle 列表（ /.dsh/profiles/ /package.json 的 dsh.profile.bundles ）： 其自带 cordis.patch.yml 会自动插入插件行。 方式 B：用户补丁层（无需改 bundle） 1. 安装包到 profile 的 node modules（同上第一步）。 2. 在 /.dsh/profiles/…

Category