dsh-usage-cost
GitHub: https://github.com/lhh666-6/dsh-usage-cost
npm: dsh-usage-cost
实时显示 DeepSeek 会话 token 用量与成本的 DSH 插件（状态栏小胶囊 + 详情面板）。全部数据本地计算、本地持久化，不上传任何内容。
功能
- 常驻胶囊：注册到会话标题栏右侧
conversation.session.header.utilities，显示模型名、输入/输出 token、本次会话成本；流式输出期间数字实时滚动，估算值带 ~ 标记。
- 详情面板：点击胶囊展开，显示输入/输出 token、缓存命中/未命中 token、总 token、本次成本、耗时、tokens/s、今日/本月累计成本、数据状态（估算中/已校准/未完成）。
- 实时估算 + 权威校准：流式期间用本地 tokenizer（
gpt-tokenizer）估算，按「每 50 个 chunk 或每 100ms」节流；请求结束用 DeepSeek 返回的 usage（prompt_tokens/completion_tokens/prompt_cache_hit_tokens/prompt_cache_miss_tokens）校准。
- 成本计算：
cost = cache_hit/1e6 * cacheHit + cache_miss/1e6 * cacheMiss + completion/1e6 * output（人民币/百万 token）。价格表可配置，模型名模糊匹配（deepseek-chat-2025-xxx → deepseek-chat）；缺失价格只显示 token，成本显示「未配置价格」。
- 持久化：本次会话数据走 session projection（由
session-projection-cache 落盘）；今日/本月/按模型累计写入 $DSH_HOME/usage-cost/aggregates.json，重启不丢。
- 边界：流式中断/报错保留估算并标记「未完成」，不覆盖历史准确数据；切换会话由投影按会话隔离，不串数据；多币种暂不做汇率，默认人民币。
架构
这是一个双面 DSH 插件包（与 dsh-plugin-desktop 同一套插件系统，无需改动主程序）：
- Host 面（
lib/index.js）：注册 usageCost session projection（纯 fold，框架自动做实时推送 + 落盘 + 重放），监听 session/event 累计今日/本月/按模型数据，注册 usage-cost settings 段用于价格配置。
- Client 面（
lib/client.js）：dsh.client manifest + exports["./client"]，注册状态栏胶囊；组件通过标准 useProjection('usageCost') 读实时值。
目录
dsh-usage-cost/
├── package.json # dsh.bundle.patch + dsh.client manifest + exports
├── cordis.yml # Host 行声明（insert usage-cost）
├── tsconfig.json # Host 面类型检查
├── tsconfig.client.json # Client 面类型检查
├── tsdown.config.ts # 打包 lib/index.js + lib/client.js
└── src/
├── index.ts # Host 插件入口
├── types.ts # 纯类型 + SessionProjectionMap 声明合并
├── pricing.ts # 价格表、模糊匹配、成本公式
├── estimator.ts # gpt-tokenizer 封装
├── projection.ts # usageCost session projection 单元
├── aggregates.ts # 今日/本月/模型累计 + JSON 持久化
└── client/
├── index.ts # Client 插件入口
├── UsageCapsule.tsx
└── format.ts
构建
npm install
npm run build # tsdown 打包 + tsc 声明
npm run typecheck # 仅类型检查
安装到 DSH Desktop / DSH
插件通过官方 dsh plugin 语义安装（Desktop 内等价于 desktopPnpm.runPlugin）：
# npm 安装（推荐，预构建）
dsh plugin --profile desktop add dsh-usage-cost
dsh plugin --profile web add dsh-usage-cost
# 或直接从 GitHub 安装
dsh plugin --profile desktop add github:lhh666-6/dsh-usage-cost
dsh plugin --profile web add github:lhh666-6/dsh-usage-cost
安装后重启（或切换一次 profile），发起对话时状态栏即出现用量胶囊。
价格配置
默认价格（人民币 / 百万 token）：
| 模型 | 缓存命中 | 缓存未命中 | 输出 |
|---|
deepseek-chat | ¥0.5 | ¥2 | ¥8 |
deepseek-reasoner | ¥1 | ¥4 | ¥16 |
可在 $DSH_HOME/settings.yaml 的 usage-cost 段覆盖（或通过 DSH 设置页的插件配置）：
usage-cost:
models:
- id: deepseek-chat
cacheHit: 0.5
cacheMiss: 2
output: 8
- id: deepseek-reasoner
cacheHit: 1
cacheMiss: 4
output: 16
chunkInterval: 50
timeIntervalMs: 100
官方价格会变动，请以 DeepSeek 最新价格为准更新此表。
模型体验
无。本插件只观察会话事件与 provider usage，不注入任何模型可见指令、工具或请求字段。
