前言¶
DeepSeek Harness (DSH) 生态强调插件化与灵活性。在智能体开发或日常使用中，精确掌握每轮对话的 Token 消耗、缓存命中率以及对应的费用是控制成本的关键。dsh-cost 插件由 zydg 维护，旨在解决这一痛点。它通过订阅 DSH 的会话事件流，在每轮对话结束后自动在聊天记录末尾追加统计行，并提供余额查询与数据导出功能。
核心能力¶
- 自动统计行：订阅
uiConversation事件，在每轮助手回复结束后自动追加一行统计信息，包含本轮 Token 消耗（输入/缓存命中/输出）、缓存命中率、费用估算及 DeepSeek API 余额。 - 峰谷计价：基于 DeepSeek 官方 V4.1 Flash / V4 Pro 价格表，根据每次调用的实际时间自动判断高峰/低谷时段进行计费。
- 余额展示：通过
GET https://api.deepseek.com/user/balance查询余额，显示在统计行末尾及输入框上方。 - 模型与价格管理：支持在设置页手动编辑模型、高峰时段及价格，或通过 API (
setPrices,resetPrices) 修改。 - 数据持久化与导出：调用记录与余额快照存储在工作区
dsh-cost/data.json，支持导出为 CSV 或 JSON。
安装与启用¶
通过 DSH 的包管理器安装插件：
dsh plugin --profile web add github:zydg/dsh-cost
安装后重启 Web 应用并刷新页面即可生效。也可以直接在对话中输入以下命令，让 AI 自动执行安装并重启：
帮我安装一下这个dsh plugin --profile web add github:zydg/dsh-cost并重启
使用与注意事项¶
- 费用与余额：费用为估算值，实际以 DeepSeek 官方账单为准。需配置
DEEPSEEK_API_KEY才能显示余额。 - 数据隐私：记录仅包含 Token 元数据（不含消息内容或 API Key）。
- 冲突处理：如果其他插件占用了
/dsh-cost/api路由，需先移除冲突插件。 - 适用范围：未验证其他模型/服务商的可用性，仅针对 DeepSeek 官方模型与价格体系设计。
总结¶
dsh-cost 为 DeepSeek Harness 提供了可视化的成本监控能力，适合需要精细化控制 API 调用成本的开发者。项目开源，可通过 GitHub 访问源码：https://github.com/zydg/dsh-cost。
