前言¶
在 DeepSeek Harness（DSH）里跑长会话、子代理或跨平台路由时，Token 用量往往能在上下文面板里看到，但「这次对话大概花了多少钱」「账号还剩多少」「当前是峰时还是谷时」通常要自己对照官网价目表心算。上游社区插件多按 models.dev 的美元簿计价，DeepSeek 峰桶还会统一乘固定系数，且不区分法定节假日。
下面介绍社区插件 dsh-cost-breakdown（维护者 liaimei）：在保留 dsh-context 上下文洞察能力的基础上，叠加官方人民币价目表（峰谷 + 法定节假日）、输入框下方常驻费用读数，以及按平台分币种的费用汇总。插件归类为 admin-security，可在 SkillHub 目录页 与 GitHub 仓库 查看来源与说明。
这是什么¶
dsh-cost-breakdown 是 DSH 的 Web 侧插件（包名 dsh-cost-breakdown，当前版本 0.1.0，许可证 Apache-2.0）。仓库说明其 src/ 基于 dsh-context（main@209169d）逐字保留上游逻辑，再叠加本仓库自有的计价与读数能力；与上游包不同名，理论上可并存，但 README 不建议同时启用，以免两套上下文入口在界面上重复。
它要解决的问题可以概括为三点：余额可见、峰谷与节假日按官方口径估算人民币费用、每个会话（含子代理衍生会话）的消耗构成可对照查看，并通过输入框下方读数与右侧栏、左侧统计页等多个入口呈现——各入口职责分开，避免 Token 与金额混在同一行里让人误换算。
保留的上游能力¶
安装后仍可使用 dsh-context 一类能力，例如：
- 上下文仪表盘：组成、趋势、浏览器、事件列表、文件活动、Agent 网络；
- 左侧栏「统计」页：全部会话 Token 汇总与费用汇总；
/context命令与Ctrl/⌘弹窗；- 每会话 Token 卡（含子 Agent 折叠）与平台消费相关展示逻辑的上游基础。
本插件在此基础上改写了计价来源、部分界面分栏与输入区读数，详细差异见仓库 NOTICE、FORK.md。
核心功能¶
官方人民币价目表与峰谷¶
计价逻辑在 src/shared/officialRates.ts。对官方表收录的模型，按元/百万 Token 分三桶：缓存命中、未命中（含缓存写入）、输出；谷价为峰价一半。
| 模型 | 谷价（缓存命中 / 未命中 / 输出） | 峰价 |
|---|---|---|
| DeepSeek-V4.1-Flash | 0.02 / 1 / 4 | 0.04 / 2 / 8 |
| DeepSeek-V4-Pro | 0.15 / 4.5 / 13.5 | 0.3 / 9 / 27 |
峰谷判定（北京时间）：周一至周五 09:00–12:00、14:00–18:00 为高峰，其余为空闲。内置 2026 年国务院法定节假日安排（31 天），节假日全天按谷价，与周末一致。宿主配置可覆盖：
holidays: ['2026-10-01', ...] # YYYY-MM-DD，北京时间
若配置中没有任何合法日期，会安全回退到内置表，而不是当作「无节假日」（后者会在节假日仍按高峰计价）。官方表未收录的模型仍走 models.dev 美元分支与回退；峰谷在宿主侧完成（src/host/foldMetering.ts 的 isPeakAt），落库桶携带当时适用费率。
计价口径（重要）：DSH 里 cacheReadTokens 是缓存命中输入，inputTokens 是未命中输入（含缓存写入），outputTokens 含思考 token，三桶互不重叠。插件按三桶分别计价；费用为估算值，以平台账单为准。未配置费率的模型会标注「未配置费率」，不会显示 ¥0。
输入框下方常驻读数¶
上游没有该入口。收起时一行展示：本会话费用 · 余额 · 当前峰/谷（样式对齐官方同排 Token 读数胶囊）。峰/谷为实时计算，徽标附带距离下一次翻转的倒计时；悬停与展开卡内写全峰时段。周末与法定节假日会直接说明全天谷价原因，而非误导性倒计时。
点击可展开详情卡：内嵌与统计页相同的 Token 统计、费用统计 两张卡，以及当前时段官方价目表；浮层 portal 到 document.body，避免被输入区 overflow 裁剪。
余额来源按序尝试：① DSH 账号登录（deepseekAccount，桌面端登录即可，不需要 API key）；② API-key 提供方。读数先展示缓存值，再按 60 秒周期校正。
各入口各答一件事¶
| 入口 | 回答的问题 |
|---|---|
| 左侧栏「统计」页 | 全部会话 Token 与费用汇总 |
| 会话内「上下文」标签页 | 只讲上下文与 Token，页面上不出现金额 |
| 右侧栏「本会话汇总」面板 | 本会话 Token 汇总 + 各平台消费 |
| 输入框下方读数 | 当前所用平台的消费与余额 |
平台消费汇总（statsPlatforms.tsx）：一个会话可能跨多平台，每个平台一张卡，各自币种（DeepSeek ¥、第三方 $、积分平台积分），绝不相加；卡内为逐模型消费与调用次数。三处费用估算共用 client/cost.ts 的 estimateSessionCostByBucket，减少读数漂移。
衍生会话与数据来源¶
子代理 / fork 会话在 session/end-seed { inherited: true } 处截断继承前缀，只计本会话真实发生的调用，避免重复计费（上游行为，本仓库保留）。
| 数据 | 来源 |
|---|---|
| 余额 | 宿主 host/balance.ts 请求 api.deepseek.com/user/balance（插件不接触令牌） |
| 用量 | 会话日志 assistant/message 的 usage，宿主折叠为（provider, model, 时段）桶 |
| 价格 | 官方人民币表；其余 models.dev |
| 时段 | 北京峰谷规则 + 节假日表 |
安装与启用¶
插件面向 web profile，仓库自带 lib/ 编译产物，从 GitHub 安装时不需要本地构建。package.json 声明 Node 引擎为 ^22.19.0 || >=24.0.0，并与 DSH 0.1.7-rc.2、0.2.0-rc.2 标记为 compatible。
先做安装，再重启 DSH（宿主半区不热生效）：
dsh plugin --profile web add github:liaimei/dsh-cost-breakdown
装完后输入框下方应出现常驻费用读数。若怀疑宿主未加载新代码，可用带会话 cookie 的请求检查：POST /api/dsh-cost-breakdown/skills 应返回 200；404 则重启 DSH。README 提醒：排查时慎用 dsh plugin list，该命令会触发 reconcile 并可能改动 lock；只读状态时可查看 ~/.dsh/profiles/<profile>/package.json 与 node_modules/。
本地开发可选用 link 安装（路径替换为你的检出目录）：
dsh plugin --profile web add "dsh-cost-breakdown@link:/path/to/dsh-cost-breakdown"
典型用法¶
- 看当前会话花了多少、余额多少：会话输入框下方读数；需要明细时点开浮层，查看 Token/费用卡与价目表。
- 看全账号历史汇总：左侧栏进入「统计」页，分别查看 Token 段与费用段；DeepSeek 官方用量会话在费用段可见峰谷拆分（仅当前在用平台）。
- 只看上下文、不看钱：留在「上下文」标签页或
/context；金额在右侧栏「本会话汇总」的费用段。 - 自定义节假日：在宿主配置中设置
holidays数组；格式错误或全非法日期时回退内置 2026 表。
适用场景与注意¶
适合谁：长期在 DSH Web 端使用 DeepSeek 官方或混合路由、需要按人民币官方峰谷估算会话成本、并希望在 composer 旁持续看到余额与峰谷状态的开发者。
务必知晓：
- 插件以当前 DSH 进程权限运行；安装前应阅读 源码与 LICENSE，确认符合你的安全与合规要求。
- 与 dsh-context 功能重叠度高，同时启用易造成重复入口。
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态是「一切皆插件」的独立社区分发模式。
- 费用为基于日志 usage 与价目表的估算，实际扣费以平台账单为准。
结尾¶
dsh-cost-breakdown 把 dsh-context 的上下文可视化保留下来，并把 DeepSeek 官方人民币峰谷、节假日、分平台分币种账单，以及 composer 旁常驻读数接到同一套数据口径上。若你需要在 Harness 里直接对照「本会话多少钱、还剩多少、现在是峰还是谷」，可从目录页或 GitHub 按上述命令安装，重启后即可在输入框下方验证。
- 目录页：https://www.skillhub.cn/plugins/liaimei/dsh-cost-breakdown
- GitHub：https://github.com/liaimei/dsh-cost-breakdown
