在 DeepSeek Harness（DSH）中，会话的消耗、委托链路的成本归属以及高峰时段的定价策略，是开发者和管理员需要明确的关键信息。dsh-api-cost 旨在为 DSH 提供精确的成本估算能力，支持区分高峰与低谷费率，并将委托或团队花费归因到触发该花费的具体会话中。
这是一个 DeepSeek 成本估算插件，支持高峰/低谷费率、委托或团队花费归因，以及基于宿主会话预测的折叠计算。由 NIRVANA-APOC 维护，属于 admin-security 类别，开源协议为 MIT。
核心功能¶
- 费率区分：支持区分高峰和低谷时段的费率。
- 花费归因：将委托或团队花费归因到引发该花费的会话。
- 会话预测：基于宿主的会话预测数据进行计算。
- 可视化组件：提供 Composer Pill 和成本面板。
- 高峰规避：提供“避开高峰”开关，可挂起请求至低谷时段。
- 命令行工具：提供
/cost命令和session_cost工具。 - 数据读取：支持通过 HTTP 读取。
安装与启用¶
使用官方安装命令即可将插件添加到 web 配置文件中：
dsh plugin --profile web add dsh-api-cost
安装后需要重启 DSH，因为客户端组件需要重新组合才能生效。
典型用法¶
1. 查看成本概览¶
在界面中，插件提供了两种展示方式：
- Composer Pill：显示当前会话的估算花费和生效时段（高峰/低谷）。点击 Pill 可打开详细面板。
- 成本面板：点击 Pill（或按回车）后，会弹出包含以下内容的面板：
- 总金额、本次会话与其他会话的分摊
- 高峰与低谷的分摊
- 定价调用次数、覆盖率
- 当前费率
- 下一个时段变更的倒计时
- 避开高峰 开关
2. 命令行查询¶
使用 /cost 命令可以在终端打印与 Pill 相同的摘要，包括覆盖率警告：
/cost [sessionId] [auto|self|tree|team]
使用 session_cost 工具，允许助手读取某个会话的估算值，默认为调用会话。
3. 作用域说明¶
命令和面板支持以下作用域：
auto（默认）：验证会话所属团队，否则使用委托树。self：仅当前会话。tree：当前会话及其所有持久化子代理。team：整个团队（需要验证成员关系）。
适用场景与注意¶
该插件要求 DeepSeek Harness 版本为 0.2.0-rc.2，并挂载 sessionProjections、sessionProjectionCache 和 sessionQuery 能力（web 和 desktop 配置文件默认包含这些）。
对于开发环境，源码构建需要 Node.js 24 或更高版本；发布的包自带预编译 JavaScript，无需本地编译。
重要限制：“避开高峰”开关依赖 LLM 服务。如果没有 LLM 服务，该开关无法挂起请求。此外，Token 桶和按模型的详细拆分数据仅通过 /cost、session_cost 和 HTTP 读取提供，不在面板中展示。
总结¶
dsh-api-cost 为 DSH 提供了从会话到团队层面的精细化成本管理能力。通过直观的 Pill 和面板，结合命令行工具，可以清晰地追踪花费归属与时段费率。更多细节与源码，可参考下方的目录页或 GitHub 仓库。
