前言¶
DSH 的扩展方式偏“一切皆插件”：Web 界面的功能可以通过插件接入，而不是把每个需求都写进主程序。对于使用 dsh 做智能体开发的场景，一个具体问题是：不同提供方、不同模型的 token 单价不同，还可能设置高峰时段；会话运行后，如何在 Web 界面里直接看到本次输入、输出和总费用，而不只是看到 token 数？
dsh-token-pricing 是一个社区维护的第三方插件，用于在 dsh Web 界面中配置按提供方/模型的 token 价格，并提供费用读数、费用浮窗和跨项目费用统计。它不向模型请求添加工具、提示段或设置值；资料称 Token 影响为零。
这是什么¶
dsh-token-pricing 是面向 dsh Web 界面的第三方（非官方）插件，由社区维护，与 deepseek-ai 官方发布无关。它主要解决三件事：
- 按提供方/模型配置美元价格，包括未命中输入、缓存命中输入和输出。
- 在会话底部数据栏、费用浮窗中查看会话费用。
- 在跨项目费用统计面板中按项目和按模型汇总。
包名是 dsh-token-pricing，仓库地址是 https://github.com/LightClear/dsh-token-pricing，许可证为 MIT。
核心功能¶
- 按提供方/模型配置美元价格：输入未命中、缓存命中输入、输出。
- 支持任意多个高峰时段，并在时段内使用高峰价格档。
- 会话底部数据栏显示输入、输出和总费用。
- 提供可折叠、可拖拽的费用浮窗，包含「按轮计价」和「按模型计价」两种视图。
- 提供跨项目费用统计面板，按项目和按模型两个维度汇总。
- 会话详情页支持逐步明细、时间窗过滤和 CSV 导出。
- 修改价格条目后，会按新价重算历史会话费用。
- 不向模型请求添加工具、提示段或设置值；资料称 Token 影响为零。
安装与启用¶
下面按“先确认环境，再安装插件，最后启动验证”的顺序说明。
前置条件¶
需要 Node ≥ 22、pnpm，以及一个可用的 dsh 安装。官方 CLI 可安装为：
npm i -g @deepseek-ai/dsh
也可以从源码启动：
pnpm dsh
安装到 web profile¶
先执行包名安装命令：
dsh plugin --profile web add dsh-token-pricing
资料同时给出 git 源安装方式：
dsh plugin --profile web add github:LightClear/dsh-token-pricing
启动与验证¶
经过上面的步骤后，启动或重启 dsh Web：
dsh web
启动后打开「设置 → 模型定价」配置价格。资料描述的成功表现是：右下角出现费用小球，对话底部数据栏显示费用读数。
更新与卸载¶
如需更新或卸载：
dsh plugin --profile web update dsh-token-pricing
dsh plugin --profile web remove dsh-token-pricing
典型用法¶
- 打开「设置 → 模型定价」，为某个模型配置输入未命中、输入命中和输出费率。
- 如需要高峰计价，添加多个高峰时段；时段内使用高峰价格档。
- 在会话底部数据栏查看本次会话的输入、输出和总费用。
- 展开费用浮窗，在「按轮计价」与「按模型计价」之间切换。
- 打开跨项目费用统计面板，使用时间窗（全部/今天/7天/30天）、含归档开关，并导出 CSV。
注意：未配置计价路由或计价规则的模型用量不计入费用读数，或在视图中提示「未设置计价」。
适用场景与注意¶
适合在 dsh Web 界面中查看多个模型、多个项目 token 费用的开发者。它不向模型请求添加工具、提示段或设置值；资料称 Token 影响为零。
使用前注意：
- 它是第三方非官方插件，由社区维护，与 deepseek-ai 官方发布无关。
- 插件以当前 dsh 进程权限运行，安装前应检查 GitHub 仓库源码和
package.json中的MIT许可证。 - 资料称本包只声明两个自用运行时依赖（
schemastery、zod），且安装不会拉取任何内部包。 - 若 profile 中已存在 id 为
token-pricing的插件行，安装后会产生冲突，需移除其一。 - 未配置计价规则或计价路由的用量可能不计入费用读数，或在视图中提示「未设置计价」。
结尾¶
dsh-token-pricing 的价值，是把 dsh Web 会话中的 token 用量变成可按模型、按轮次、按项目查看的费用读数，并在修改价格条目后重算历史会话费用。本次已核实资料未提供可引用的社区目录页 URL；GitHub 仓库为：
https://github.com/LightClear/dsh-token-pricing
