前言¶

在 DeepSeek Harness 中开发智能体时，除了查看 Token 总数和吞吐量外，监控 Session 的实际成本至关重要。现有的统计条缺乏直观的成本显示。dsh-session-cost 插件在 Session 的底部统计条（composer dock）中增加了一个成本药丸，直接显示基于模型目录定价的分段成本。

插件概览¶

名称：dsh-session-cost
维护者：GalileoNio
类别：客户端
许可证：MIT
依赖：Node.js >= 20
定位：一个客户端插件，用于在 DeepSeek Harness 的 Session 统计条中显示分段成本。

核心功能¶

1. 成本药丸展示：在 Session 统计条中添加一个成本药丸，显示当前 Session 的总成本。
2. 模型目录定价：成本基于模型目录中的定价进行计算，涵盖 41 个提供商和约 1495 个模型。
3. 按维度细分：点击成本药丸可查看按（模型，计费窗口）分组的详细成本拆解。
4. 手动价格覆盖：允许用户在目录定价之外进行手动价格覆盖。

安装与启用¶

这是一个 Bundle 类型插件，安装后会在 Harness 中注册 Loader 条目。使用 Git 克隆到指定目录：

git clone git@github.com:GalileoNio/dsh-cost.git "$HOME/.dsh/profiles/plugins/dsh-session-cost"

安装完成后，可以通过 Plugins 页面加载，或使用 plugin_manager install_bundle 配合绝对路径进行程序化安装。

配置与使用¶

插件配置位于 Plugins 页面的对应卡片中。由于没有自动生成的 Schema 表单，配置项需手动输入。主要配置项包括：
* 价格列表：定义模型的价格。
* 计费窗口：定义价格生效的时间段。
* 符号与货币：设置成本显示的符号和货币单位。

在 Session 交互过程中，统计条会出现成本药丸。点击该药丸即可查看按（模型，计费窗口）分组的详细成本数据。

实现细节与定价来源¶

• 计算位置：成本计算在 Host 端进行，使用 Session 的完整持久化日志，而非仅依赖聊天窗口的分页数据。
• 定价来源：
  • 模型目录：默认从 Harness 自身的模型目录（@earendil-works/pi-ai）获取定价，支持长上下文分级定价。
  • DeepSeek 官方路由：单独适配 DeepSeek 的官方路由，使用其发布的定价表。
  • 手动覆盖：目录未覆盖的模型或自定义折扣，可通过插件设置进行手动覆盖。

注意事项¶

• 手动配置：当前版本没有自动生成的配置表单，所有设置需手动输入。
• 热更新：插件源代码修改后，通常只需刷新页面即可生效，无需重启 Harness。
• Node 版本：需确保运行环境 Node.js 版本大于等于 20。

总结¶

dsh-session-cost 为 DeepSeek Harness 的 Session 提供了直观的成本监控能力，通过统计条药丸和明细面板，帮助开发者实时掌握分段成本。对于需要精细控制成本的智能体开发场景，这是一个实用的辅助工具。

GitHub 仓库：https://github.com/GalileoNio/dsh-cost
生态目录：https://www.skillhub.cn/plugins/GalileoNio/dsh-cost