前言¶
在 DeepSeek Harness（DSH）里长时间跑对话时，token 用量会在界面里出现，但「这一会话一共花了多少钱」「这一轮按官方价目表该算多少」往往要自己对表或等账单。DeepSeek 还对输入命中/未命中、输出以及高峰/空闲时段有不同单价，节假日规则也需要单独记。下面介绍社区插件 dsh-deepseek-turn-cost（npm 包名 dsh-simple-cost，版本 0.1.0，MIT），由 lhylhy2024 维护，分类为客户端挂件：除 DSH 本身外无额外依赖，把账户余额、峰谷时段、本会话累计花费和逐轮费用直接嵌进界面，并对超阈值的单轮提供按钮触发的 AI 分析。
这是什么¶
一句话：DSH 的账户余额 + 本会话/逐轮计费 widget，按 DeepSeek 官方价目表估算费用，并识别北京时间高峰/空闲与中国法定节假日。
维护者 lhylhy2024；源码仓库 https://github.com/lhylhy2024/dsh-deepseek-turn-cost（GitHub 星标 0）。社区目录条目 https://www.skillhub.cn/plugins/lhylhy2024/dsh-deepseek-turn-cost 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；访问该 URL 时若提示未找到插件，以 GitHub README 为准安装与使用。
界面上的三个落点¶
插件通过 DSH 的 slot 注册 UI，避免同一数字在侧栏和对话里重复出现。
| 落点 | Slot | 内容 |
|---|---|---|
| 侧栏底部用户栏正上方 | sidebar.footer.action |
账户余额（¥ / $，含赠送余额）；高峰时段 / 空闲时段 徽标；距下次切换的分钟数 |
| 会话页输入区下方信息条 | conversation.composer.dock |
本会话累计花费，如「本会话 ¥1.2345」 |
| 每一轮助手回答的动作行 | conversation.chat.assistant-actions |
「用量 xxM tok」后的本轮约计费用；总 token 达阈值时出现 AI 分析（A 按钮） |
累计 token 与轮数仍由 DSH 自带的 ContextMeter 展示，本插件不重复。
计费口径与内置价目¶
内置价目版本戳为 PRICE_VERSION = 2026-09-10（README 记载抓取日期 2026-10-13）。单轮费用按：
cost = 命中输入/1e6 × P_hit + 未命中输入/1e6 × P_miss + 输出/1e6 × P_out
要点如下：
P_*由模型与高峰/空闲决定；空闲价为高峰价的 50%（官方两套并列价目，非折扣文案）。- 高峰：北京时间周一至周五（不含法定节假日）09:00–12:00、14:00–18:00；其余为空闲，含周末与法定节假日全天。
cacheWriteTokens按未命中输入计价；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 |
官方调价时，维护者需改 index.js 顶部 PRICES / HOLIDAYS 并更新 PRICE_VERSION；界面不主动提醒改价。
为什么逻辑在 Host 半边¶
浏览器侧拿不到完整逐轮 token（它们在 Host 会话日志 snapshotEvents() 里），账户凭证也只能由 Host 的 ctx.deepseekAccount 获取；AI 分析需要 ctx.llm.stream，客户端 Remote 的 llm 命名空间没有生成接口。第三方插件也无法自行注册 Remote namespace。
因此 client.js 通过同源 fetch 访问 index.js 注册的回环路由（仅 127.0.0.1 / ::1）：
GET /dsh-simple-cost/state?sessionId=
POST /dsh-simple-cost/analyze
会话组件 slot 自带 sessionId，不依赖 URL 里的会话 id。
安装与启用¶
本插件不在 npm 发布。README 给出两种方式：
① 从仓库目录安装——克隆到本地后，用 DSH 的 plugin_manager 指向绝对路径：
git clone https://github.com/lhylhy2024/dsh-simple-cost.git
plugin_manager { action: "install_bundle", target: "<克隆下来的绝对路径>" }
② 插件市场——提交至 awesome-dsh-plugin 列表后，可在 DSH 内置 dshmarket 一键安装。
安装后刷新页面即可看到三处 UI。修改 client.js 刷新即生效；修改 index.js 需重启 DSH 进程。
典型用法¶
- 登录 DeepSeek 账户并保持 DSH 可访问 Host 能力后，打开任意会话；侧栏上方查看余额与当前高峰/空闲及切换倒计时。
- 在输入框下方信息条查看「本会话 ¥x.xxxx」累计估算。
- 在每一轮助手动作行查看「· 本轮对话约 ¥x.xxxx」；当该轮总 token 不低于插件内配置的阈值时，点击 A 触发 AI 分析（会额外消耗模型 token，分析侧
maxTokens已设为 6000 以避免思考占满预算）。 - 若需对接非默认 API 基址，Host 侧可通过环境变量
DEEPSEEK_BASE_URL覆盖默认https://api.deepseek.com。
适用场景与注意¶
适合：日常在 DSH 里跑长对话、希望按官方峰谷与价目表做本地估算、并快速发现「哪一轮特别贵」的开发者。
务必知晓：
- 插件以当前 DSH 进程权限运行，会请求 DeepSeek 账户余额接口（失败时可能回退 DSH 平台钱包，且无赠送余额拆分）。安装前请阅读源码与 MIT 许可证。
- 估算与真实账单可能有逐轮四舍五入带来的微小差异；法定节假日表内置到 2026 年，跨年需更新
HOLIDAYS；调休上班的周末 README 说明仍按空闲计价。 - 余额优先
GET https://api.deepseek.com/user/balance；仅此一项外部网络目标（可被DEEPSEEK_BASE_URL影响）。
结尾¶
dsh-deepseek-turn-cost 把余额、峰谷提醒、会话累计与逐轮费用收进 DSH 原生 slot，Host 回环路由补齐浏览器拿不到的计费数据；除 DSH 外零依赖。目录页：https://www.skillhub.cn/plugins/lhylhy2024/dsh-deepseek-turn-cost；源码与完整说明：https://github.com/lhylhy2024/dsh-deepseek-turn-cost。
