前言¶

DeepSeek Harness (DSH) 是一个基于插件的智能体开发框架。在开发智能体或使用 DeepSeek 模型时，追踪每个对话的 token 消耗和对应费用是成本控制的关键环节。虽然模型会上报 usage 数据，但 DSH 原生并未提供按会话汇总并以货币形式展示的功能。dsh-session-cost 插件通过解析会话日志中的 usage 数据，提供按会话统计的 token 用量及人民币估算费用。

插件简介¶

这是一个由 jyhn-hunao 维护的 DSH 插件，采用 MIT 许可证。它不依赖构建工具，是一个纯 JS 实现的插件，能够读取模型上报的 token 统计信息，并将其转换为人民币费用进行展示。

核心功能¶

1. 会话级统计：按会话统计模型上报的 token 用量。
2. 工具调用：提供 session_cost 工具，供 Agent 查询一个或多个对话的消耗（不传 sessionIds 时默认查询当前对话）。
3. 命令行查询：
   • /session-cost [sessionId]：查看当前对话或指定会话的累计消耗。
   • /session-cost-config：查看当前价格表。
4. 侧边栏展示：在侧边栏显示会话累计费用（需特定环境支持）。

安装与启用¶

使用官方提供的安装命令添加插件：

dsh plugin --profile <name> add github:jyhn-hunao/dsh-session-cost

首次安装时，如果 pnpm 提示构建脚本未授权，可以在 profile 的 pnpm-workspace.yaml 中加入 allowBuilds: dsh-session-cost: true 并重试。该提示可安全忽略，因为本插件实际没有构建步骤。

使用方法¶

查看消耗¶

用户可以通过命令行查看消耗：

/session-cost                 # 查看当前对话的累计消耗
/session-cost <sessionId>     # 查看指定会话的累计消耗

查看价格表¶

查看当前价格表：

/session-cost-config

让 Agent 查询¶

让 Agent 查询时直接说「查一下每个对话消耗了多少钱」，Agent 会自动调用 session_cost 工具。

价格表配置¶

默认价格表仅包含 DeepSeek 常规费率。DeepSeek 自 2026-08-17 起执行峰谷定价，高峰时段费率更高，默认值为常规费率估算，请按你的实际结算费率覆盖。

在 profile 的 cordis.patch.yml 中按 id 覆盖整行 config（整表替换，未列出的模型回退到 *）：

- patch:
    - id: session-cost
      config:
        pricing:
          deepseek-chat: { inputPerM: 2, cacheReadPerM: 0.5, cacheWritePerM: 2, outputPerM: 8 }
          deepseek-reasoner: { inputPerM: 4, cacheReadPerM: 1, cacheWritePerM: 4, outputPerM: 16 }
          '*': { inputPerM: 2, cacheReadPerM: 0.5, cacheWritePerM: 2, outputPerM: 8 }

已知依赖与限制¶

• 数据来源：费用基于会话日志中模型上报的 usage（assistant/message / assistant/chunk），与 DSH 内置 token 统计同源，数据准确，非估算。
• 侧边栏显示限制：侧边栏行内金额 UI 需要官方仓库支持 sidebar.workspaces.sessionRow 插槽。原版 DSH 尚未包含此插槽，因此侧边栏金额在原版上可能静默不生效（session_cost 工具与 /session-cost 命令不受影响）。若要启用侧边栏显示，需要安装带对应插槽的 DSH 构建。

总结¶

该插件解决了智能体开发中成本追踪的需求，通过解析会话日志中的 token 使用数据，提供直观的费用展示。安装后即可通过命令或配置查看会话费用。

插件目录：
https://www.skillhub.cn/plugins/jyhn-hunao/dsh-session-cost

源码仓库：
https://github.com/jyhn-hunao/dsh-session-cost