前言¶
在 DeepSeek Harness（DSH）里长时间跑对话或智能体时，token 用量会在宿主里汇总，但「这一串聊天到底花了多少钱」往往要自己对照官方价目表心算。全局统计也帮不上忙：你关心的是当前这条会话，不是整个进程的总账。下面介绍社区插件 dsh-convo-tally（维护者 Fireawa，SkillHub 分类为「记忆」）：在 Web 侧栏用两行数字回答「这个对话花了多少钱」，并按官方峰谷价在每次模型调用后结算，支持人民币与美元双币显示。
这是什么¶
dsh-convo-tally 是 DSH 的 Web 侧栏插件：只统计当前对话的今日花费与累计花费，不做全站账本。计价依据 DeepSeek 官方中英文价目表（2026-10 核对），高峰与空闲档位按每次调用的发起时刻判定；金额是 tokens × 单价的估算，实际扣费以官方账单为准。插件不联网、不发遥测、不读凭据。当前版本 0.2.3，许可证 MIT，仓库 Fireawa/dsh-convo-tally。
核心功能¶
侧栏展示本对话的两行核心数字：今日花费与累计花费，金额统一两位小数。
- 峰谷角标：标明当前按高峰价还是空闲（谷）价计费，以及距离下一档切换还有多久。高峰为北京时间周一至周五 9:00–12:00、14:00–18:00；其余时段、周末与中国法定节假日全天为空闲，空闲价为高峰价的一半。
- 人民币 / 美元切换：两种货币各用官方各自价目表，不做汇率折算（中英文官方单价并非同一汇率对齐）。
- 一键重置累计：只清除「累计」的显示，「今日」仍为真实值，且只影响当前对话。
- 「账单」：展开查看本对话最近 7 天每日花费、当天调用次数与合计，随币种切换。
- 结算粒度：每次模型调用结算一次，无法做到逐 token 实时跳动；「今日」按北京时间 0 点（UTC+8）切换，而非浏览器本地时区。
计价时会区分缓存命中、缓存未命中与输出 token；宿主 inputTokens 已与 cacheReadTokens 互斥，reasoning token 不计费。子代理单独记账，不并入主对话；无 sessionId 的后台调用（如标题生成、历史压缩）不计入。官方自 2026-11-01 起对 Search / Fetch 按次计费，届时侧栏数字可能偏低——README 已说明该口径。
安装与启用¶
要求 Node.js 20+（见仓库 package.json 的 engines），且本机已安装 DSH。目前仅支持从 GitHub 安装（npm 包尚未发布）。
安装最新版：
dsh plugin --profile web add github:Fireawa/dsh-convo-tally
锁定版本（推荐，避免主分支变动）：
dsh plugin --profile web add github:Fireawa/dsh-convo-tally#v0.2.3
离线安装可从 Releases 下载 dsh-convo-tally-0.2.3.tgz，再执行（路径换成实际文件位置）：
dsh plugin --profile web add ./dsh-convo-tally-0.2.3.tgz
装完后硬刷新页面（Ctrl/Cmd+F5）；若改动在宿主侧，需重启 dsh web。升级时替换版本号即可，无需清缓存，历史金额不会重算。卸载：
dsh plugin --profile web remove dsh-convo-tally
DSH 社区插件以当前 dsh 进程权限运行；安装前建议浏览仓库源码与 LICENSE，确认符合你的环境策略。
典型用法¶
安装并刷新后，侧栏底部会出现记账区域：两行金额旁有峰谷状态，以及重置、币种切换、账单三个操作。
- 正常对话即可——每次模型调用结束后，插件按当时档位与模型（如 deepseek-flash、deepseek-v4-pro）更新今日与累计。
- 需要对照美元账单时，点币种切换；数字按英文官方表重算显示，不是把人民币乘汇率。
- 想只看「从某次起」的累计时，用重置累计；今日仍反映当天真实消耗。
- 点「账单」查看本对话近 7 天按日 breakdown 与合计。
本地改插件代码时，维护者在 README 中给出 link:$PWD 开发安装方式；普通使用者按上文 GitHub 或 tgz 安装即可。
适用场景与注意¶
适合：在 DSH Web 界面里频繁试 prompt、跑长对话或智能体，希望随时看到当前会话成本的人；需要峰谷 awareness、或要在人民币 / 美元两套官方价之间切换查看的人。
注意：
- 数字是估算，不能替代 DeepSeek 官方账单。
- 只计当前对话，不是全局；子代理与无 session 的后台调用规则见上文。
- 插件分类在 SkillHub 为「记忆」，本质是侧栏用量与花费展示，与「长期记忆存储」不是同一类能力——选型时以 README 功能描述为准。
实现上，侧栏插槽在 root 作用域拿不到当前会话，插件在 conversation.composer.dock 放置不渲染的「探针」绑定会话投影，侧栏再读同一 bundle 内的模块变量；切换对话时数字会随之更新。计价折叠语义与宿主 tokenUsage 投影一致，避免流式多次回报导致重复累加。
结尾¶
dsh-convo-tally 把「这个对话花了多少钱」收成侧栏两行数，并附带峰谷、双币与近 7 日账单，适合作为 DSH Web 日常开发的花费参照。DeepSeek Harness 生态强调「一切皆插件」；社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
