dsh-cost-stats

DSH Web 插件：会话级成本统计面板。

面向谁，解决什么

面向：想随时看清每个会话、每个模型 token 用量与费用的 DSH 用户
解决：不用再手动估算成本，一个面板实时统计当前会话的 token 消耗、缓存命中率与费用，支持 USD / CNY

功能

实时统计当前会话的 token 用量与费用估算
按模型分组展示：未缓存输入、缓存读、缓存写、输出
按请求明细展示：每次请求（一次模型调用）的 token 用量与费用
显示缓存命中率
支持 USD / CNY 双币种显示

效果预览

![成本统计面板](docs/images/cost-panel.png)

![成本分析](docs/images/cost-analysis.png)

支持的模型定价

单价由 DSH 内置的 pi-ai 官方价目表提供（@earendil-works/pi-ai 的 dist/providers/data/*.json，USD / 百万 tokens），覆盖 37 个提供商、700+ 模型，且随 DSH 升级自动更新。插件在 host 侧注册 costStats 会话投影，用这套官方价对 provider 回报的真实 token 用量计费，浏览器端直接读投影结果——不再维护手写价目表。

个别模型（例如 claude-opus-5-thinking 这类经自定义 provider 接入的模型）不在 pi-ai 目录里，面板会显示「—」而非猜测一个价格。

刷新价目表（开发用）

价格快照由脚本生成，DSH 升级 pi-ai 后重跑一次即可：

node scripts/sync-prices.mjs

脚本默认读取 DSH 安装目录下的 pi-ai 数据，也可显式传路径：

node scripts/sync-prices.mjs /path/to/pi-ai/dist/providers/data

安装

第 1 步：安装 DSH 本体

插件依赖 DSH (DeepSeek Harness)。如果终端执行 dsh -V 提示 command not found，说明还没装：

npm install -g @deepseek-ai/dsh

装好后确认一下：

dsh -V

第 2 步：安装并登记插件

整段复制到终端执行即可，不用手改任何文件：

PLUGIN=dsh-cost-stats
REPO=newbieYi/dsh-cost-stats
PROFILE="$HOME/.dsh/profiles/web"

dsh plugin --profile web add "github:$REPO" \
&& test -f "$PROFILE/node_modules/$PLUGIN/cordis.patch.yml" \
&& node -e '
const fs = require("fs");
const file = process.argv[1] + "/package.json";
const name = process.argv[2];
const pkg = JSON.parse(fs.readFileSync(file, "utf8"));
const profile = ((pkg.dsh ??= {}).profile ??= {});
const list = (profile.bundles ??= []);
if (!list.includes(name)) {
  list.push(name);
  fs.writeFileSync(file, JSON.stringify(pkg, null, 2) + "\n");
}
console.log("已登记 bundles:", list.join(", "));
' "$PROFILE" "$PLUGIN" \
|| echo "安装未完成，profile 未被改动。请检查网络后重跑本段。"

看到 已登记 bundles: ... dsh-cost-stats 就成功了，继续第 3 步。

看到 安装未完成 说明包没下载下来（常见原因：网络不通、pnpm 不可用）。这时 profile 没有被改动，DSH 仍能正常启动；解决网络问题后重跑本段即可。

第 3 步：重启 DSH

插件在启动时装载，改完配置必须重启才生效。请正常退出，不要用 kill -9，否则会话数据可能来不及落盘：

1. 切到正在运行 dsh web 的那个终端窗口，按 Ctrl + C 等它自己退出； 2. 重新启动：

dsh web

如果找不到原来的终端窗口，可以先查一下进程再正常终止：

lsof -ti :3080 | xargs kill

第 4 步：验证

浏览器打开 DSH Web，进入任意会话，tab 栏里应该能看到「成本统计」。

常见问题

装完没有「成本统计」tab？ 九成是没重启。也可以检查 ~/.dsh/profiles/web/package.json 的 bundles 里有没有 "dsh-cost-stats"。

启动时报 cannot resolve profile bundle "dsh-cost-stats"？ bundles 里登记了插件，但 node_modules 里没有这个包。重跑第 2 步那段即可（它会先确认下载成功再动 profile）。

如果始终装不上，用这条命令把登记撤掉，DSH 就能正常启动，之后再从容排查网络问题：

node -e '
const fs = require("fs");
const file = process.env.HOME + "/.dsh/profiles/web/package.json";
const pkg = JSON.parse(fs.readFileSync(file, "utf8"));
const list = pkg.dsh?.profile?.bundles ?? [];
pkg.dsh.profile.bundles = list.filter((n) => n !== "dsh-cost-stats");
fs.writeFileSync(file, JSON.stringify(pkg, null, 2) + "\n");
console.log("剩余 bundles:", pkg.dsh.profile.bundles.join(", "));
'

启动时报 declares no dsh.bundle 或 failed to read overlay ... cordis.patch.yml？ 包下载得不完整。重跑第 2 步；若仍然如此，先 dsh plugin --profile web remove dsh-cost-stats 再重新 add，避免 pnpm 复用坏的缓存。

表格里出现 unknown 模型？ DSH 内部调用（生成会话标题、上下文压缩等）不带模型标识，它们的 token 会归到 unknown 行，属于正常现象。

使用

启动 DSH Web 后，在对话界面的 tab 栏中点击「成本统计」即可查看当前会话的 token 消耗与费用。

License

MIT

来源信息

安装

检查来源文件