前言¶
在 DeepSeek Harness（DSH）里跑多轮对话时，界面通常会显示 Token 用量，但很少直接给出「这一轮大概花了多少钱、整个会话累计多少」。若要对成本心里有数，只能自己查官方定价、对照四类 Token 手算，或依赖平台账单事后核对。社区插件 dsh-conversation-cost（维护者 solstice621，分类：模型推理）面向 DSH 桌面版：自动拉取模型单价，在每条助手回答的用量与时间之间显示 Cost ≈$x，并在输入框下方展示当前会话累计金额；点击可查看模型、四类 Token 与价格来源。无需新增 API key，无运行时 npm 依赖，不修改 App 或 asar，可独立停用、卸载。
这是什么¶
dsh-conversation-cost 是独立社区插件，包名 dsh-conversation-cost。它在 Harness 内读取会话用量与公开价格目录，按每百万 Token 单价汇总到「单轮回答」与「本会话累计」，界面以美元 USD 展示估算值，不进行汇率换算。订阅渠道会额外给出 API 价格折算的「订阅等值」参考，明细中与 API 估算分开显示；该参考不代表订阅实际扣款。
DSH 生态强调「一切皆插件」；插件目录页在 skillhub.cn，与 DeepSeek / 幻方无官方从属关系。源码与说明见 GitHub：solstice621/dsh-conversation-cost，许可证 MIT。
界面与显示规则¶
每轮回答结束后，顺序为 用量 → Cost → 时间。标签默认显示 Cost ≈$x；加载中、读取失败、未计价各有标识；后台校验时保留已显示金额，不额外弹出「更新中」类提示。
输入框下方显示当前会话自己的累计金额，不重复计入 fork 继承的上下文。点击任一 Cost，可查看对应范围（本轮或会话）的模型、普通输入、缓存读取、缓存写入、输出及单价，以及价格来源。
核心功能¶
| 能力 | 说明 |
|---|---|
| 每轮回答费用 | 汇总该轮已记录的各次模型调用，不混入其他轮次 |
| 会话累计费用 | 仅计本会话记录，不合并子会话、不重复 fork 历史 |
| 自动价格同步 | 启动时读取，之后每 6 小时刷新；明细中可手动同步 |
| 离线回退 | 同步失败保留最近成功缓存；首次离线使用随包公共价格快照 |
| 多模型与分档 | 每次调用使用自己的模型与价格；上下文档位按该次完整输入选择 |
| 本地费用缓存 | 先展示缓存，后台校验；新用量增量更新并落盘 |
价格从哪里来¶
- deepseek / deepseek-official / deepseek-account：来自 DeepSeek 官方定价页，按调用时间应用峰谷、周末与中国节假日规则（节假日数据含随包 2026 年日历；无可用日历年份不会猜测峰谷价）。
- 其他 API 渠道：models.dev 公共目录，精确匹配
provider/model，不会因名称相似借用其他渠道价格。 - codex-subscription / openai-codex：用 models.dev 中同模型的 OpenAI API 价计算订阅参考价值。
- opencode-go-subscription / opencode-go：优先 models.dev 的 Go 同模型价；缺价时仅可用 OpenCode Zen 相同模型 ID 的 API 参考价，明细中会注明参考路由。
可与 dsh-openai-auth、dsh-opencode-go-auth 搭配使用；本插件不依赖它们的授权流程，也不负责登录或查询订阅额度。
金额如何计算¶
以每百万 Token 的单价计算每条用量记录，再汇总到对应回答和会话：
金额 =（普通输入 × 输入单价
+ 缓存读取 × 读取单价
+ 缓存写入 × 写入单价
+ 输出 × 输出单价）/ 1,000,000
推理 Token 已包含在输出中，不重复相加。单次金额保留计算精度，最终显示四位小数；极小的正数显示小于 $0.0001。历史用量按当前价格重估；价格更新可能改变旧会话显示，插件不保存历次账单或历史价格版本。因此适合查看成本量级，不是平台账单。
统计基于原始日志中 assistant/message 的有效 usage；工具按次费用、无有效助手用量的失败尝试等不保证纳入。
安装与启用¶
README 记载已在 macOS + DeepSeek Harness Desktop 0.2.1-rc.3 上验证。插件不设宿主版本门槛，启动时会检查会话读取和认证 Fetch 接口；其他宿主版本与操作系统尚未完成桌面验证。
安装前请自行阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，出站请求仅用于 models.dev、DeepSeek 定价页及按需的 holiday-cn 年度日历，不上传对话、用量或凭据。
- 在 Harness 左侧打开「插件」→「添加插件」。
- 填写以下地址，安装并启用：
github:solstice621/dsh-conversation-cost#main
- 若当前窗口尚未出现 Cost，刷新 Harness 界面；仍未出现时完全退出并重新打开。
- 打开一个已有会话，即可看到累计费用和已完成回答的逐轮费用，无需为验证功能重新发送模型请求。
固定版本可将 #main 换为指定提交 SHA；已有 tag 使用各 tag 对应声明。插件直接提供可运行 JavaScript，无需构建或执行第三方安装脚本。本地打包、CLI 安装、更新与卸载见仓库 docs/INSTALL.md。
典型用法¶
安装并启用后无需额外配置项或 API key。正常对话即可：每轮结束后在用量旁查看该轮 Cost ≈$x，在输入框下方查看会话累计；需要核对单价或四类 Token 时，点击 Cost 打开明细。价格长期离线或缺价时，可在明细中使用「立即同步价格」（对应宿主 POST /api/conversation-cost/prices/refresh）。
本地缓存路径（<DSH_HOME> 为 Harness 数据目录）：
<DSH_HOME>/cache/dsh-conversation-cost/prices.json
<DSH_HOME>/cache/dsh-conversation-cost/sessions/<sessionId>.json
快照不含对话正文、密钥或 replayState；损坏或不匹配时会忽略并重新从会话日志读取。
适用场景与注意¶
适合：在 DSH 桌面版里做智能体或多模型调试、需要快速对照 Token 与美元估算、对比不同路由或模型成本时。
注意：
- 当前版本固定美元显示，提供逐轮与会话累计两个入口，尚无隐藏 Cost 或改币种设置。
- 缺价显示「未计价」，不会当成免费；部分缺价时标签只合计可计价部分。
- 恢复或导入会话应使用新会话 ID；费用缓存不重用已删除会话 ID。
- 进程崩溃可能留下
.json.lock；确认无写入者后可手动清理该会话残留锁。
结尾¶
dsh-conversation-cost 把公开定价与会话用量接到 Harness 界面里，用最少操作看到每轮与会话的 API 成本估算。目录页：skillhub.cn/plugins/solstice621/dsh-conversation-cost；源码与完整说明：github.com/solstice621/dsh-conversation-cost。
