dsh-cost-log

English | 简体中文

DSH 原生插件：按 DeepSeek 价格表实时计算当前对话花费，并把金额徽标放在输入框旁边（输入框卡片工具行右侧、模型选择器左侧）。金额由 Host 端的 durable 会话投影 costLog 计算，跟着会话日志走——翻页、上下文压缩、历史补拉都不会改变累计值；浏览器端只读投影并渲染，不发任何外部请求。

为什么选择 dsh-cost-log？

它不只是把 token 乘以一个固定单价，而是面向 DeepSeek 官方模型与 DSH 会话机制设计的成本投影。1.0.0 是稳定版，今后只维护 DeepSeek 价格变化与 DSH 兼容性。

| 优势 | 具体表现 | | --- | --- | | 会话级持久累计 | 成本在 Host 的 durable session projection 中计算，不依赖浏览器标签页；翻页、上下文压缩和历史补拉都不会改变累计值。 | | DeepSeek 专属计价 | 分开计算缓存命中、缓存未命中、缓存写入与输出，并按 Flash / Pro、北京时间峰谷时段、CNY / USD、新旧价格表自动选价。 | | 不重复，也不猜价 | 同一 turn/step 的 usage 按投影替换规则去重；遇到未知第三方模型只标记未完整计价，不套用可能错误的默认单价。 | | 隐私优先，零额外部署 | 不读取 API Key、不查询账户余额、不发送外部请求，也不需要数据库、代理或额外常驻服务。 | | 费用就在工作流里 | 徽标常驻输入框旁，发送前后都能看到会话总额；点击才展开明细，并自动跟随 DSH 的语言与明暗主题。 |

功能

• 输入框旁常驻金额徽标，token 用量变化时自动更新；货币可在 DSH 设置 > 插件 > Plugin configuration 中选择（CNY / USD，默认 CNY），选择保存在当前浏览器。
• 悬浮提示语言跟随 DSH 系统语言（中文 / English）。
• 悬停费用图标后只显示：输入 tokens、输出 tokens、flash 花费、pro 花费。
• 所有展示费用四舍五入保留两位小数；不足 0.01 时显示为 <0.01。
• 2026-08-17 起人民币新价格表：
  • deepseek-v4-flash：空闲 0.05 / 1.5 / 4.5，高峰 0.10 / 3.0 / 9.0（元/百万 tokens）
  • deepseek-v4-pro：空闲 0.15 / 4.5 / 13.5，高峰 0.30 / 9.0 / 27.0（元/百万 tokens）
• DeepSeek 官方美元价格表：
  • deepseek-v4-flash：空闲 $0.007 / $0.22 / $0.66，高峰 $0.014 / $0.44 / $1.32（美元/百万 tokens）
  • deepseek-v4-pro：空闲 $0.022 / $0.66 / $1.98，高峰 $0.044 / $1.32 / $3.96（美元/百万 tokens）
• 高峰时段按北京时间：9:00-12:00、14:00-18:00；其余为空闲，空闲价为高峰价一半。
• 生效时刻之前自动使用旧价格表（人民币与美元均为旧表）。
• 只给 DSH 内置 deepseek-official provider 的完整模型 ID deepseek-v4-flash 与 deepseek-v4-pro 计价；显示名称对应 DeepSeek-V4-Flash 与 DeepSeek-V4-Pro。
• 未识别的第三方模型不猜价：徽标显示 ≈/¥0+ 或 ≈/$0+。
• 样式使用 DSH WebUI 设计令牌（--dsw-alias-*），明暗主题自动跟随。

价格来源：DeepSeek 官方人民币价格页与官方美元价格页，最后核验于 2026-08-15。

计价口径

| 用量 | 计费方式 | | --- | --- | | 缓存未命中输入 | inputTokens，按“百万 tokens 输入（缓存未命中）” | | 缓存命中输入 | cacheReadTokens，按“百万 tokens 输入（缓存命中）” | | 缓存写入 | cacheWriteTokens，DeepSeek 不单独报价，按缓存未命中计 | | 输出 | outputTokens，按“百万 tokens 输出” |

金额是依据 provider 上报 token usage 的参考估算，不是 DeepSeek 官方账单。usage chunk 与同一 turn/step 的 assistant/message 会按 projection 替换规则去重，不会重复计费。

生效前价格表

新价格生效前使用官网当前价格：

// lib/index.js
const LEGACY_RATES = {
  flash: { inputHit: 0.02, inputMiss: 1, output: 2 },
  pro:   { inputHit: 0.025, inputMiss: 3, output: 6 },
}

const LEGACY_RATES_USD = {
  flash: { inputHit: 0.0028, inputMiss: 0.14, output: 0.28 },
  pro:   { inputHit: 0.003625, inputMiss: 0.435, output: 0.87 },
}

架构

浏览器 (Client)                               DSH Host
┌────────────────────────────┐   session   ┌──────────────────────────────┐
│ conversation.input.right    │  projection │ sessionProjections 注册表    │
│ 输入框工具行右侧费用徽标    │ ◄────────── │ costLog 投影                 │
│ useProjection('costLog')    │  durable    │  ├ request/header 记当前模型  │
│ React + 手写 bundle          │             │  ├ assistant/chunk usage     │
│ locale + localStorage        │             │  └ assistant/message usage  │
└────────────────────────────┘             │ 按时间 × 模型 × 峰谷计价      │
                                            │ 同时输出 CNY / USD            │
                                            └──────────────────────────────┘

• Host（lib/index.js）：注册 sessionProjections 投影键 costLog，同时输出人民币与美元成本。
• Client（lib/client.js）：手写 CJS bundle（window.__ModuleLoader__.load），注册在 conversation.input.right 插槽（由 ui-conversation 提供，就在输入框卡片内），读取 useProjection('costLog')；通过 locale 服务显示系统语言，并在 Plugin configuration 提供保存在浏览器本地的费用货币选择。
• 无外部 HTTP 调用、无 Cookie、无数据库、无本地服务、无构建步骤。

安装

从 npm 安装：

dsh plugin --profile web add dsh-cost-log

从 GitHub 安装：

dsh plugin --profile web add github:kami-mura/dsh-cost

安装后，回到正在运行 DSH 的终端按 Ctrl+C 停止旧进程，然后重新启动：

dsh web

卸载：

dsh plugin --profile web remove dsh-cost-log

依赖 DSH 运行时能力：Host sessionProjections；Client slots、locale、react 平台模块与 ui-conversation 的 conversation.input.right 插槽（DSH 内置）。

快速开始

1. 安装插件并重启 DSH Web。
2. 打开任意会话。
3. 输入框右侧会出现费用徽标；悬停可查看 token 用量，点击可查看 flash / pro 花费明细。

切换货币：打开 DSH 设置 > 插件 > Plugin configuration，选择 CNY 或 USD。

文件

| 文件 | 说明 | | --- | --- | | lib/index.js | Host 半体（costLog 会话投影 + 峰谷计价 + 设置命名空间） | | lib/client.js | Client bundle（输入框旁花费徽标 + Plugin configuration 货币卡片） | | cordis.patch.yml | 组合包 patch（安装后加入 profile 层栈） | | package.json | 包声明（dsh.bundle.patch + dsh.client.platform: "web"） | | tests/pricing.test.mjs | 价格、模型核验、峰谷边界与投影折叠测试 | | tests/client.test.mjs | DSH 客户端模块注册回归测试 |

运行测试：

node --test tests/*.test.mjs

贡献

1.0.0 起进入稳定维护：不再增加功能，只在 DeepSeek 官方价格变化或 DSH 接口变化时更新。修改用户可见内容时，请同步更新英文与中文 README。

License

MIT