前言¶
在 DeepSeek Harness（DSH）里做会话式开发时，常见的问题是：当前会话已经消耗了多少 token，对应大概多少钱，今天不同模型各用了多少，agent 自己能不能直接查询这些数字。
dsh-agent-pricing 由 Way2LOose4 维护，面向 DeepSeek Harness Web profile，提供 composer 下方的实时成本预览、今日用量浮层，以及 price_estimate / session_cost 两个 agent 工具，价格与 DeepSeek official pricing page 保持同步，并支持 peak / off-peak 感知。
这是什么¶
dsh-agent-pricing 是 DSH 插件，定位为“实时会话成本预览”。它把当前会话累计成本显示在输入区附近，把今日 token 用量整理成浮层图表，并让 agent 可以在任务中查询预估价格和完整会话成本。
该插件使用 MIT 许可证。已核实资料标记它在 DeepSeek Harness Web profile、0.1.0-rc.6 下为 verified。
核心功能¶
实时成本显示¶
打开任意会话后，composer 下方会出现一条紧凑成本行，显示当前会话累计成本。它每 5 秒刷新一次，并支持 CNY ⇄ USD 切换。
今日用量浮层¶
点击 ▸ 图表 可打开今日用量浮层。浮层展示今日 input/output/cache tokens、按小时的使用柱状图、按模型拆分、价格来源、最近核验时间，以及当前是否适用 peak 或 off-peak 档位。
Agent 工具¶
插件注册两个模型工具：
price_estimate：用于单次调用预估。session_cost：用于读取完整会话用量。
这样可以对 agent 问 “how much have we spent?”，它可以用 session_cost 回答当前会话成本，也可以用 price_estimate 先给出事前估算。
价格同步与回退¶
插件在激活时以及之后每 30 分钟抓取 DeepSeek official pricing page。若抓取失败，会回退到仓库的 prices.json，再回退到内置表。失败时按这条回退链处理，估算不依赖某一次抓取成功。
安装与启用¶
先确认环境为 DeepSeek Harness Web profile，并且版本满足已核实的 0.1.0-rc.6 verified。使用 DSH CLI 安装命令：
dsh plugin --profile web add github:Way2LOose4/dsh-agent-pricing
执行后重启 DSH，使插件随启动加载。插件会注册进 Web profile，并随 DSH 启动加载，所以启用和更新后以重启后的实例为准。
典型用法¶
- 打开任意会话，在 composer 下方看到当前会话累计成本行。
- 点击
CNY/USD切换币种；点击▸ 图表打开今日用量浮层。 - 在会话中问 agent：“how much have we spent?”，它会用
session_cost返回当前会话成本；需要事前估算时，它会调用price_estimate。 - 如果需要用本地价格表覆盖，可在 workspace root 放置
agent-pricing.json，该文件用于完全覆盖价格表。
适用场景与注意¶
适合使用 DeepSeek Harness Web profile，并且希望把会话成本、今日用量和 agent 价格查询放在同一个工作台里的开发者。它不需要 API key，也不读取账户余额或 negotiated rates；所有数字都是 estimates，镜像 official public price table。
使用前注意：
- 插件会注册进 Web profile，并随每次 DSH 启动加载，因此相当于在 DSH 进程环境中运行。只安装你信任的插件，安装前检查源码、依赖与 MIT 许可证。
- 成本历史来自本地 session logs；对外网络请求限定为 DeepSeek official pricing page 和仓库 raw
prices.json。 - 价格同步依赖 official pricing page 的公开数据，抓取失败时按仓库
prices.json和内置表回退。 - 若工作区根目录放入
agent-pricing.json，它会完全覆盖价格表。
结尾¶
dsh-agent-pricing 将“当前会话花了多少”“今天用了多少”“agent 能不能自己查价格”这三件事合并到 DeepSeek Harness Web profile 中。已核实资料未提供目录页 URL，可使用 GitHub 仓库地址：Way2LOose4/dsh-agent-pricing。
