前言¶

在使用 DeepSeek Harness (DSH) 进行智能体开发时，需要同时管理多个项目或长期运行任务。追踪 token 消耗和费用分布是常见痛点。手动逐个打开项目查看日志效率低下，且难以直观对比不同模型的成本。dsh-cost-tracker 旨在侧边栏实时展示全局花费统计，无需切换项目即可掌握成本，并自动同步官方定价。

插件定位¶

这是一个用于 DSH 的侧边栏任务花费统计插件，由 ruozhi5067 维护。它解决了跨项目追踪费用和同步官方定价的问题，属于记忆类插件。

核心功能¶

• 侧边栏卡片：在侧边栏底部显示总花费、当前项目花费、token 明细（输入命中、输入未命中、输出）。支持折叠态和展开态，展开态可查看各项目明细。
• 官方定价同步：自动更新 DeepSeek 官方人民币单价。抓取逻辑为启动时、每 12 小时或超过 6 小时未更新时刷新，也可手动点击 ↻ 刷新。若抓取失败，会回退到内置人民币价格。
• 增量读取日志：除了内存中的活跃会话，还增量读取持久化的会话日志，因此侧边栏里未打开的其他项目也会自动显示花费，无需逐个打开项目。
• 插件管理：可在插件管理页管理（批准/停止/移除）。
• 热加载支持：支持热加载补丁（cordis.patch.yml），无需重启即可生效。
• 计费逻辑：仅对会话日志中带 usage 的模型调用计费。
• 内置价格表：内置价格表适配 deepseek-v4-flash / deepseek-v4-pro。

安装与启用¶

本插件作为 profile bundle 安装。

1、进入 profile 目录

cd ~/.dsh/profiles/<profile>

2、安装插件包

pnpm add dsh-cost-tracker

3、将插件加入 bundle 列表
在 ~/.dsh/profiles/<profile>/package.json 中修改 dsh.profile.bundles 字段，将 dsh-cost-tracker 加入列表：

{
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "...", "dsh-cost-tracker"]
    }
  }
}

该配置会自动插入插件行。

使用方法¶

安装后，侧边栏底部（cordis 插件面板上方）会出现花费卡片。
- 查看数据：卡片默认显示总花费和当前项目花费。点击卡片可折叠或展开，展开后显示 token 明细和官方模型单价。
- 快捷操作：在窄侧栏（56px 图标栏）下会显示紧凑的 花费 ¥x 按钮，点击可展开侧边栏。
- 刷新单价：点击卡片上的 ↻ 图标可手动刷新官方单价。
- 组件管理：在侧边栏 Cordis 插件面板中，可以批准/停止/移除动态组件「任务花费统计」。

注意事项¶

• 浏览器端授权：浏览器端授权不跨进程。重启后首次加载动态组件时，需要在 Cordis 插件面板点击一次「允许」。
• 计费依据：费用按官方主表价格计算，峰值/谷值分时价仅展示，费用计算使用官方主表价格。
• 数据隐私：所有数据本机计算，不发送任何会话数据。从官方定价页只读取价格数字。
• 许可证：MIT 许可证。