dsh-deepseek-turn-cost
DeepSeek Harness 的账户余额 + 本会话计费挂件。
A DeepSeek Harness widget that keeps your account balance in the sidebar, shows the running cost of the
current conversation, and offers a one-click AI breakdown of any single turn that burns more than a
configurable token threshold. Peak / off-peak pricing is applied per the official DeepSeek price list.
No dependencies beyond DSH itself.
它显示什么（三个落点）
| 落点 | Slot | 内容 |
|---|
| 侧栏底部「用户栏正上方」 | sidebar.footer.action | ① 账户余额（¥ / $，含赠送余额）② 时段徽标：高峰时段 / 空闲时段 四个字 ③ 距下次切换的分钟数，如「90 分钟后转为高峰时段」 |
| 会话页底部居中的信息条 | conversation.composer.dock | 本会话累计花费，如「本会话 ¥1.2345」。累计 token 与轮数由 DSH 自带的 ContextMeter 显示，本插件不再重复 |
| 每一轮回答的动作行 | conversation.chat.assistant-actions | ① 紧跟「用量 xxM tok」之后的「· 本轮对话约 ¥0.1234」② 排在「存入记忆 / 开新分支」之后的「AI 分析」按钮（自绘 A 图标），本轮总 token ≥ 阈值时才出现 |
设计取向：侧栏卡片只留「余额 + 时段」两行，所有与本会话/单轮有关的信息都放进对话流本身，避免同一份数字在两处重复。
计费口径
依据 DeepSeek 官方价目表（本插件内置版本戳 PRICE_VERSION = 2026-09-10，抓取日期 2026-10-13）：
cost = 命中输入/1e6 × P_hit + 未命中输入/1e6 × P_miss + 输出/1e6 × P_out
P_* 由 (模型, 高峰|空闲) 决定；空闲价 = 高峰价 × 50%（官方是两套并列的价目表，不是折扣）。- 高峰时段 = 北京时间周一至周五（不含中国法定节假日）09:00–12:00 与 14:00–18:00；其余全部空闲，含周末全天与法定节假日全天。
- 缓存写入（
cacheWriteTokens）官方没有独立单价，本插件按未命中输入计价。
- 思考 token（
reasoningTokens）计入输出计费——官方页面只分输入命中/未命中/输出三档，未单列思考价。
- CNY 与 USD 是两套独立价目表，按余额接口返回的
currency 选表，不做汇率换算。
- 时段归属按该轮开始时间判定。
内置价目表（元 / 百万 tokens）：
| 模型 | 命中·空闲 | 命中·高峰 | 未命中·空闲 | 未命中·高峰 | 输出·空闲 | 输出·高峰 |
|---|
| deepseek-flash | 0.02 | 0.04 | 1 | 2 | 4 | 8 |
| deepseek-v4-pro | 0.15 | 0.30 | 4.5 | 9.0 | 13.5 | 27.0 |
价格与时段规则由 DeepSeek 单方面调整，且价目表页面本身不印生效日期。所以它们在本插件里是常量而非硬编码在逻辑中，改价只需改 index.js 顶部的 PRICES / HOLIDAYS 并把 PRICE_VERSION 往后挪。价格变动不在界面上做提醒。
架构（为什么逻辑在 Host 半边）
浏览器半边拿不到这些数据：
- 逐轮 token 用量只存在于 Host 的会话日志里（
ctx.sessions.get(id).snapshotEvents()）；客户端只能看到被压缩改写过的窗口。
- 账户钱包要经
ctx.deepseekAccount（其文档明确「only Host consumers can obtain a request credential」）。
- AI 分析要跑
ctx.llm.stream；而客户端 Remote 面的 llm namespace 只暴露 discoverModels / listProviders / listConfigurableProviders，没有任何生成接口。
而 DSH 的客户端 Remote namespace 集合是构建期固定的（dsh-api-remotes 里逐个显式导入并 $mount），第三方插件无法注册自己的 namespace。所以本插件走第三条路：
浏览器半边 client.js ──fetch 同源──▶ Host 半边 index.js 注册的两条回环路由
GET /dsh-deepseek-turn-cost/state?sessionId=
POST /dsh-deepseek-turn-cost/analyze
这与 dsh-client-modules 把自己的 bundle 挂在 webServer 上是同一条路。路由只接受回环地址（127.0.0.1 / ::1）。
会话 id 的来源：注册在会话作用域 slot（conversation.composer.dock / conversation.chat.assistant-actions）里的组件，其标准属性自带 sessionId。页面 URL 里既没有 token 也没有会话 id（首页会 303 跳回 ./），所以不依赖 URL。
依赖
除 DSH 本身外没有任何依赖。
package.json 没有 dependencies / peerDependencies / optionalDependencies / devDependencies 字段。index.js（Host 半边）没有任何静态 import——@deepseek-ai/* 只存在于 app.asar 内，从工作区目录静态导入会 ERR_MODULE_NOT_FOUND。全部依赖经 ctx.get() 软取：inject 里只有硬依赖 webServer，credentials / deepseekAccount / sessions / sessionPersistence / llm 缺失时各自降级。client.js（浏览器半边）只 require("react") 与 require("react-dom")（后者仅用于 createPortal），两者都来自 DSH 客户端自己的冻结模块表；不 import 任何 @deepseek-ai/* 包。- 唯一的外部网络目标是
https://api.deepseek.com（你自己的 DeepSeek 账户接口），可用环境变量 DEEPSEEK_BASE_URL 覆盖。
文件
| 文件 | 作用 |
|---|
index.js | Host 半边：余额读取、事件流折叠成逐轮计费（含 messageIds → 轮次映射）、峰谷判定、AI 分析、两条 HTTP 路由。无任何静态 import |
client.js | 浏览器半边：侧栏卡片 + 会话信息条 + 逐轮行 + AI 分析面板 |
cordis.patch.yml | bundle patch：把 Host 半边插入 profile |
package.json | dsh.bundle.patch + dsh.client（platform: web）声明 |
已知限制
- 余额优先走官方公开接口
GET https://api.deepseek.com/user/balance（能区分充值/赠送余额、CNY/USD 多币种）；取不到时回退到 DSH 自己的平台钱包读取，该路径没有赠送余额拆分。
- 高峰/空闲的归属时刻按该轮开始时间判定（官方未说明按开始还是结束计费）。
- 法定节假日表内置到 2026 年（国务院办公厅国办发明电〔2025〕7 号）。跨年需要补表。
- 调休上班的周末仍按空闲计价——官方规则只说「周一至周五（不含中国法定节假日）」，未提调休。
- 会话日志里的
reasoningTokens 若某轮没有上报，则该轮按 0 计——这与官方「思考按输出价计费」的口径一致，不会重复计价。
- AI 分析的成本上限是「思考 + 正文」的总量：
deepseek-flash / deepseek-v4-pro 官方默认开思考模式，思考 token 也计入 maxTokens。实测 maxTokens=1200 时整份预算被思考吃光（finish.reason.kind === 'max-tokens'），只回思考不回正文；现已改为 6000，并且即便正文为空也会把思考内容作为降级结果返回。
- 逐轮费用与实际账单存在极小的四舍五入差（每一轮独立取整到 4 位小数后再求和）。
安装
本插件不在 npm 上发布（npm 上同名的 dsh-deepseek-balance 是另一个作者的另一个插件，与本项目无关）。安装方式二选一：
① 从本仓库安装——克隆到本地任意目录，然后让 DSH 按目录安装：
git clone https://github.com/lhylhy2024/dsh-deepseek-turn-cost.git
plugin_manager { action: "install_bundle", target: "<克隆下来的绝对路径>" }
② 从插件市场安装——本插件正在提交至 awesome-dsh-plugin 精选列表；被收录后即可在 DSH 内置的插件市场（dshmarket）里一键安装，无需手动克隆。
安装后刷新页面即可看到三处落点。改 client.js 后刷新页面即可生效；改 index.js（Host 半边）需要重启 DSH 进程。
