dsh-api-cost：DeepSeek Harness 会话与子代理的 API 成本监控插件

前言¶

DeepSeek Harness（DSH）的会话与子代理调用频繁，开发者往往只能从 token 计数估算成本，缺乏细粒度的价格拆分和跨会话汇总。这个插件把 provider 报告的使用量折叠到按路由计费，并在 composer 旁展示当前会话及所有子代理的实时成本，方便在对话中途核对预算。

这是什么¶

dsh-api-cost 是一个 DeepSeek Harness 插件包，包含 Host 插件与 Web Client 插件，由维护者 wei2yun 交付。它不作为 skill 或 agent preset，而是 Harness 插件管理器安装和启用的 bundle。它通过注册 apiCost 投影，将每条 settled 模型调用的 provider 报告用量折叠到按路由计费桶，再由 Client 插件在 composer 的 ambient dock 渲染该值。

核心功能¶

当前会话与所有子代理的 API 成本实时汇总：Host 投影每条 settled 调用的 usage 与 provider/model 路由，Client 在 composer 旁显示总金额与明细。
按时间范围统计：支持 Today、Last 24h、Last 7 days、Last 30 days，汇总当前 Harness home 下所有存储会话（跨工作区）的用量。
路由级价格拆分：按缓存命中/未命中、输入/输出、高峰/低谷时段，显示各模型（如 deepseek-flash 与 deepseek-v4-pro）的用量与费用。
货币切换：支持使用 currency: USD 切换计价币种。
节假日扩展：支持通过 offPeakDates 添加更多节假日，计费时段遵循 DeepSeek 公告。
旧模型兼容：deepseek-v4-flash 与 deepseek-v4-flash-vision-exp 按 Flash 价格计费。
不写日志：所有数据仅从 session store 读取，不向日志追加内容，不持久化数据。

安装与启用¶

安装前请确认已安装 DeepSeek Harness 0.2.1-rc.2 或其他 0.2.x 版本，并启用 Web UI。

从 Web UI 安装：

在侧边栏打开 Plugins。
选择 Install。
输入仓库地址并确认：

https://github.com/wei2yun/dsh-api-cost

从 CLI 安装：

dsh plugin --profile web add github:wei2yun/dsh-api-cost

从 agent 内安装（需调用 plugin_manager）：

plugin_manager:
  action: install_bundle
  address: https://github.com/wei2yun/dsh-api-cost

安装后刷新页面，若页面未出现控制项，可刷新浏览器以获取最新 projection。

典型用法¶

在 composer 旁查看当前会话总费用与明细：点击金额可打开面板，显示各模型的输入/输出用量、缓存命中率与高峰/低谷分段价格。
切换时间范围：点击 Today/Last 24h/Last 7 days/Last 30 days 标签，插件会汇总该 Harness home 下所有已存储会话的用量。
切换币种：在面板或控制项设置 currency: USD，按美元计价。
扩展节假日：在配置中添加 offPeakDates 以支持更多节假日（需按插件文档格式）。
查看子代理费用：控制项会自动聚合所有子代理会话的 apiCost，未完成或未读会话显示 +。

适用场景与注意¶

适合需要在对话过程中实时了解成本分布、按路由拆分费用、汇总多会话用量的 DSH 用户与开发者。
插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证（MIT）。
安装后不改变 Harness 任何设置，仅读取 session store 并在 Web UI 渲染。

短结尾¶

dsh-api-cost 把 DeepSeek Harness 的会话与子代理调用按路由与时段计费，并在 composer 旁提供实时汇总与明细。更多细节与源码见：

目录页：https://www.skillhub.cn/plugins/wei2yun/dsh-api-cost
GitHub：https://github.com/wei2yun/dsh-api-cost