DeepSeek Harness 费用实时统计插件 (dsh-cost-tracker)

在 DeepSeek Harness（DSH）的插件生态中，监控 API 调用的成本是精细化管理的重要一环。特别是面对不同模型的定价、缓存命中与未命中的差异，以及高峰/空闲时段的费率变化，手动统计往往难以做到实时与精准。az790871109/dsh-cost-tracker 旨在解决这一需求，它作为 DSH 的一个 Profile 插件，提供实时的费用统计与后台余额管理功能。

功能特性¶

该插件通过监听 llm/stream 事件实现实时计费，主要具备以下能力：

实时计费与精准累加：监听模型调用流，即时累加 token 数量。
精确计价模型：支持按模型区分单价，区分缓存命中与未命中的 token，支持高峰与空闲档位切换。
纯人民币展示：默认汇率 7.2，面板支持手动调整汇率。
后台余额管理：提供充值入口，实时显示余额、本周期消耗及剩余额度。
项目与对话汇总：面板顶部展示当前对话所在项目的费用总和，下方显示逐条对话的明细。
交互式悬浮面板：面板可拖拽、可折叠，颜色跟随 DSH 主题。
模型可查：注册了 deepseek_cost 工具，可直接询问模型查看费用。
跨进程持久化：统计状态写入本地文件，重启后继续累加。
零侵入自动启动：作为 profile 插件随 DSH 启动加载，无需额外激活。

安装与启用¶

安装过程包含文件复制与配置修改，具体步骤如下：

    mkdir -p "$DSH_HOME/profiles/web/node_modules"
    cp -R . "$DSH_HOME/profiles/web/node_modules/dsh-cost-tracker"

修改配置文件以加载插件。在 $DSH_HOME/profiles/web/cordis.patch.yml 末尾追加以下内容：

    - insert:
        - id: cost-tracker
          name: dsh-cost-tracker

重启 DSH Web 服务：

    pkill -f "dsh/lib/bin.js web"
    dsh web

重启后打开页面，右下角将出现费用悬浮面板。

使用方法¶

安装完成后，可通过面板或对话直接操作：

查看费用：在对话中直接询问模型「我花了多少钱」，或查看面板主读数。
充值管理：在面板输入框输入金额并点击「充值」。
切换档位：点击面板按钮切换计费档位（自动/空闲/高峰）。
修改汇率：在面板底部「汇率」输入框调整数值。
清零统计：点击面板「清零」按钮重置所有数据。
面板交互：按住标题栏拖动面板，单击标题栏折叠或展开。

注意事项¶

使用前需注意以下几点限制与依赖：

数据性质：这是本机估算值，并非官方账单，与官方账单可能存在偏差。
统计范围：只统计插件加载后的调用，历史消息不计入。
价格同步：价格表硬编码在 lib/index.js 的 BASE_PRICES 中，官方调价后需手动更新源码。
状态文件：删除 $DSH_HOME/storages/cost-tracker-state. 即可清零。
生效方式：修改 cordis.patch.yml 或源码后，必须重启 dsh web 才能生效。
React 依赖：Client 端必须使用 factory: function (require) + require("react") 获取 React，不能用全局 React，否则渲染会报错。
依赖环境：Host 端依赖 tools 和 webServer，Client 端依赖 slots（来自 @deepseek-ai/dsh-client-runtime）。

生态信息¶

维护者：az790871109
许可证：MIT
仓库地址：https://github.com/az790871109/dsh-cost-tracker