v0.2.1 — 明细弹层观感修复

v0.2.1 — 明细弹层观感修复

只改界面呈现，计价逻辑与数据口径不变。

修复

• 逐轮明细改为两行布局：第一行「轮次 · 模型 · 该轮花费」，第二行「token · 时段」。
  • 模型名不再被截断成 deepseek-official/deeps…（现在显示模型 id，完整路由放在悬浮提示里）。
  • 轮次标签不再被挤成 第 1...，能看清是第几轮。
• 单价来源时间本地化：由原始的 2026-10-22T06:48:37.262Z 改为本地 MM-DD HH:mm。
• 弹层不再被视口裁切：高度按触发器上方实际可用空间自适应（上限 460px），最后一行不会被切掉。
• 明细列表取消内层滚动：改为整个面板一起滚动，避免嵌套滚动条。

升级

dsh plugin --profile web add dsh-billing-capsule@0.2.1

Desktop 端：

dsh plugin --profile desktop add dsh-billing-capsule@0.2.1

替换已安装包后需要重启 DSH 才能加载新的客户端模块代。

验证

node --check 通过；node --test 21/21（新增时间格式化用例与逐轮模型字段断言）。

v0.2.0 — dsh-billing-capsule

v0.2.0 — dsh-billing-capsule

首个面向 DSH 插件市场的版本：包名与仓库名对齐，修复改名后底栏座位不注册的问题。

安装

npm（推荐）

dsh plugin --profile web add dsh-billing-capsule

dsh plugin --profile desktop add dsh-billing-capsule

源码

dsh plugin --profile web add github:CKLYZZQ/DSH-plugin-Billing-Capsule

本版变更

• 更名：@local/dsh-billing → dsh-billing-capsule（版本 0.1.0 → 0.2.0，v0.1.0 保留不动）。
• 修复：客户端浏览器模块的 id 必须等于包名；改名时只改了 package.json，导致 Host 半正常激活但底栏座位静默不注册。已对齐，并新增测试断言守住这条契约。
• 座位顺序：conversation.composer.dock 的 order 改为 2，避免与内置 usage（order 1）撞序。
• README 对齐 dsh-plugin.org 收录要求：一句话价值、dsh plugin --profile web add 安装命令、真实输出、权限与外部服务、能力分类。

功能

在输入框底栏（会话统计 / token 用量 / 上下文 右侧）新增「账单」胶囊：实时显示当前会话按 DeepSeek 官方价目表（高峰/空闲双档）折算的人民币花费；点开看四类 token 分桶与逐轮明细。

• 会话总量取自整会话 tokenUsage 投影，历史分页不会少算；逐轮数据仅用于分摊，仅当轮次合计吻合且每轮路由唯一时判定精确，否则标 ≈。
• Host 半每 12 小时抓取官方价格页并解析，经 loopback-only 的 /dsh-billing/prices.json 提供给客户端；失败静默回落内置基线。
• 价目表外的模型显示 --，不计金额。

兼容

DSH 0.2.0-rc.2 与 0.2.1-rc.2（profile desktop）已验证座位注册与价格路由；Windows / macOS / Linux 均可（纯 JS，零原生依赖、零构建脚本）；目标 profile 需组合 ui-conversation 与 ui-chat。

权限与外部服务

唯一对外请求是抓取 api-docs.deepseek.com 的官方价格页（默认每 12 小时）；/dsh-billing/prices.json 与 /dsh-billing/refresh 仅回环可达、只读价格数据；不读取凭据、无遥测、不上传会话数据。

已知限制

• 中国法定节假日未内置，可按 holidays 配置补日期。
• 官方价格页改版导致解析失败时，保留内置基线（弹层显示来源与日期）。
• 金额为估算参考，非计费凭证。

许可

MIT。测试夹具 tests/fixture-pricing.html 为 DeepSeek 官方文档页副本，版权归 DeepSeek, Inc.，不适用 MIT，且不包含在安装包内。

v0.1.0 — 会话账单

v0.1.0 — 会话账单

DSH Web GUI 输入框底栏的第四项：显示当前会话按 DeepSeek 官方单价折算的花费，点击展开四类 token 分桶与逐轮明细。

安装

git（推荐，无需 GitHub 凭据）

plugin_manager → install_bundle → target:
git+https://github.com/CKLYZZQ/DSH-plugin.git#v0.1.0

本 Release 附件（离线）

下载 local-dsh-billing-0.1.0.tgz，把 install_bundle 的 target 传该文件的绝对路径。

装完刷新页面即可；胶囊出现在「会话统计 / token 用量 / 上下文」右侧。卸载：侧栏 Plugins 页取消选择，或 remove_bundle。

这版有什么

• 胶囊：会话累计花费（¥ 两位小数；不足 1 分显示 <¥0.01；估算值带 ≈；价目表外的模型显示 --，不编造金额）
• 弹层：未缓存输入 / 缓存读取 / 缓存写入 / 输出 四桶的 token、时段单价与小计；计价模型；单价来源与数据时间；逐轮明细（最新一轮在最上）
• 自动查价：Host 半抓取官方价格页并解析，经同源路由 /dsh-billing/prices.json 提供给客户端，默认每 12 小时刷新；抓取或解析失败静默回落内置基线，不阻塞显示
• 精确性：会话总量取自整会话 tokenUsage 投影，历史分页不会少算；仅当已加载轮次合计吻合且每轮模型路由唯一时判定精确，否则标 ≈ 并在弹层写明原因
• 高峰/空闲：北京时间周一至周五 9:00–12:00 与 14:00–18:00 为高峰，其余及周末按空闲（半价）；官方价目表无缓存写入价，该桶按 0 计；法定节假日可经 holidays 配置
• 零依赖：零 dependencies、零 peerDependencies、零 install script，不 import 任何 @deepseek-ai/*

要求

• DSH 0.2.0-rc.2（在 profile desktop 上验证）
• 目标 profile 需组合 ui-conversation（底栏座位）与 ui-chat（逐轮数据）；webServer 可选，缺失时只用内置基线；dsh-token-meter 缺失时不显示（拿不到会话总量）

已知限制

• 逐轮数据取自 ui-chat 同版本的内部节点形状，已收敛在单一适配函数内；拿不到即降级为整会话估算，不报错
• 中国法定节假日未内置，需在 cordis.patch.yml 的 holidays 中补日期
• 官方价格页改版导致解析失败时，保留内置基线（弹层显示来源与日期）

许可

MIT。测试夹具 tests/fixture-pricing.html 是 DeepSeek 官方文档价格页的副本，版权归 DeepSeek, Inc. 所有，不适用 MIT，且不在安装包内。