前言¶

在 DeepSeek Harness（DSH）里跑长会话、开子代理时，token 用量会分散在多条 assistant/message 事件和实时流里。控制台或账单往往滞后，也很难一眼看到「本会话 + 所有子会话」合计花了多少钱。若你习惯在 Desktop 里连续调试，更需要输入框附近有一个随日志更新的读数，而不是事后手工对表。

下面介绍社区插件 dsh-session-cost（维护者 current1990）：在 composer 下方显示整个会话族的累计费用（人民币），数据来自会话日志与宿主侧投影，客户端只负责渲染。

这是什么¶

dsh-session-cost 是 DSH 的客户端插件（package.json 版本 0.3.7，MIT 许可证），面向 DSH Desktop 0.2.x（README 写明针对 0.2.1-rc.x 的投影与 useProjection 契约）。

一句话：从会话日志的用量事件逐条累加 token，再按可编辑的「按模型、按生效日期」价格表换算成 CNY，并把合计与树状明细推到输入框下方。单价参考 DeepSeek 官方定价页；插件标明为估算工具，不是官方计费凭证。

目录页：SkillHub - dsh-session-cost
源码：github.com/current1990/dsh-session-cost

核心功能¶

实时读数与树状明细¶

• 输入框下方显示整个会话族累计费用，示例文案形态：会话费用 ¥0.27 · 60 次调用 · 子代理 2（本会话 + 子代理会话）。
• 读数是一颗按钮，点击展开小面板，逐行展示本会话与各子代理的费用、调用次数、token。

日志权威与防重复计数¶

费用由会话日志里 assistant/message 的用量事件逐条累加（缓存命中/未命中拆分）。重试与回放不会重复计数。

按调用时间计价（ERAS）¶

价格表带生效日期（宿主 index.js 中的 ERAS）。每条调用按日志事件的 time 取当时单价，调价不会改写历史调用的金额。新增调价时在 ERAS 插入一条（含 since 与 models）即可。

README 内置两段价格区间（元/百万 tokens）：

2026-10-17 起（峰谷：空闲价为高峰一半；高峰 = 北京时间周一至周五 9:00–12:00、14:00–18:00）

2026-10-17 之前（单一价，无峰谷）

未列出的模型按 deepseek-flash 计（保守估算）。计费公式：

费用 = 未缓存输入×未命中价 + 缓存读×命中价 + 缓存写×未命中价 + 输出×输出价

悬停读数可查看高峰/空闲费用，以及各价格区间（如 2026-10-17、pre-2026-10-17）分别花费多少。

渠道与架构¶

• 只计价 DeepSeek 官方渠道：仅 deepseek-official / deepseek-account 有单价；其他渠道只累计 token、不计金额，读数标注「未计价」。
• 零客户端计算：宿主侧 sessionCost projection 折叠结果，经 wire.view 推送到页面；客户端通过 useProjection('sessionCost') 读取整值，不做事件折叠。

插件不依赖额外 npm 包，bundle 自带宿主与客户端代码，安装时无需构建。

安装与启用¶

在 DSH Desktop 中：设置 → 插件 → 添加，选择本机插件目录，或按包名安装（以 Desktop 插件管理器为准，README 未提供 CLI 形式的 dsh plugin add … 命令）。

Harness 会把插件装进当前 profile（desktop），并自动在 cordis.patch.yml 中插入：

- insert:
    - id: session-cost
      name: dsh-session-cost

安装后无需重启即可生效（宿主经 HMR 激活，刷新页面后出现读数）。

典型用法¶

安装并刷新页面后，正常在 Desktop 里对话即可，无需额外配置项。

1. 看 composer 下方的合计读数（费用、调用次数、子代理数量）。
2. 点击读数展开树状明细，核对本会话与各子代理的 token 与费用。
3. 若使用非官方渠道，注意读数上的「未计价」提示，金额仅作 token 统计参考。
4. 若官方调价，可自行在 index.js 的 ERAS 中追加新区间；历史调用仍按旧价计算。

适用场景与注意¶

适合谁：长期在 DSH Desktop 上开发、调试智能体，希望实时把握会话族 token 与人民币估算成本的用户。

权限与安全：插件以当前 DSH 进程权限运行，会读取会话日志与投影状态。安装前请浏览 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。

已知限制（摘自 README）：

• 已结束的子会话金额依赖投影缓存；重启后从 session_projcache 预热，版本不匹配时可能重读子会话日志（启动时最多 200 个）。仅当缓存与日志均不可用时，该子会话显示「未加载」且不计入合计。
• 法定节假日无法从日志推导，峰谷按工作日时段计价。
• 合计在父会话有新事件时刷新；子代理运行中读数可能略滞后，结束后补上。

边缘情况说明见仓库内 docs/RFC-0001-billing-edge-cases.md。

结尾¶

dsh-session-cost 把会话日志里的用量折叠成 composer 下方的 CNY 估算读数，并支持按生效日期与峰谷拆分，适合在 Desktop 0.2.x 上日常盯会话成本。需要明细或改价表时，直接看仓库 README 与 index.js 中的 ERAS。

• 目录页：https://www.skillhub.cn/plugins/current1990/dsh-session-cost
• GitHub：https://github.com/current1990/dsh-session-cost