前言¶

在 DeepSeek Harness（DSH）里跑长会话、换模型或跨高峰/空闲时段时，界面通常只展示 token 用量，很难直观看到「这一轮」和「整段会话」大概花了多少钱。账单要等后台对账，而开发调试又需要当场心里有数。社区插件 dsh-llm-cost（维护者 liandy0731，分类：模型推理）在 DSH 输入区与每轮操作行里叠加本地费用估算，按各模型官网公开单价 × token 数计算，不替代真实账单。

下面介绍插件定位、能力、安装方式，以及单价表与使用上的限制。

这是什么¶

dsh-llm-cost 是给 DeepSeek Harness 用的费用计：在输入框下方显示本次会话的累计花费，在每轮操作行里（token 用量旁边）显示该轮花费，点击可弹出明细。数字为本地估算，不是账单。

• 仓库：https://github.com/liandy0731/dsh-llm-cost
• 社区目录页：https://www.skillhub.cn/plugins/liandy0731/dsh-llm-cost
• 许可证：MIT（见仓库 README）
• 当前 package 版本：0.1.4（见仓库 package.json）

DSH 生态主张「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装插件前建议自行阅读源码与许可证——插件在当前 DSH 进程权限下运行。

核心功能¶

累计花费¶

输入框下方原有统计行末尾新增「累计 ¥x.xxxx」，覆盖整个会话（跨轮次、跨模型、跨高峰/空闲时段）；长会话翻页也不漏算。

本轮花费¶

每轮对话操作行里、紧跟「用量 xxx tok」之后（时间之前）新增「本轮 ¥x.xxxx」，只统计这一轮。

明细弹窗¶

交互与 token 用量弹窗一致：贴着触发点向上弹出、dl 明细行，点外面或 Esc 关闭。内容包含模型、时段（高峰/空闲）、该时段单价、输入（未命中）/ 缓存命中 / 输出各自的 token 数与金额，以及合计。金额保留 4 位小数。

实现要点（只读扩展）¶

插件不修改 DSH 本体，不写会话日志，不订阅模型请求。宿主半边注册会话投影 llmCostTokens，按 provider/model 把整条日志的 token 折成高峰/空闲两组桶；客户端通过 conversation.composer.dock（累计）与 conversation.chat.assistant-actions（本轮）两个只读 slot 展示。本轮金额取自 Chat 层已有的 TurnTokenUsage。

安装与启用¶

该插件未发布到 npm，请按 README 从 GitHub 或本地目录安装。

直接安装（推荐）¶

在 DSH 中让智能体执行：

plugin_manager install_bundle target=github:liandy0731/dsh-llm-cost

安装后刷新页面（客户端半边由页面加载）。

从源码目录安装¶

若已有仓库副本，在 DSH 中执行（将路径换成你机器上的绝对路径）：

plugin_manager install_bundle target=<仓库目录的绝对路径>

安装后刷新页面。若改动的是宿主半边，需要重启 DSH 或移除再安装该 bundle 才会重新导入模块。

单价表与高峰/空闲¶

单价写在 client.js 顶部的 PRICES：单位为元 / 百万 token，按模型 id（或 provider/model 完整路由）索引，每项含 peak（高峰）与 offPeak（空闲）两档。字段含义：

• input：缓存未命中输入
• cacheRead：缓存命中输入
• cacheWrite：缓存写入
• output：输出（含推理 token）

示例结构：

const deepseekFlash = {
  peak:    { input: 2,   cacheRead: 0.04, cacheWrite: 2,   output: 8 },
  offPeak: { input: 1,   cacheRead: 0.02, cacheWrite: 1,   output: 4 },
};

未在表里的模型按 DeepSeek-Flash 估算；带 -free 后缀或走 opencode/ 路由的模型按 0 计。

README 内置表（2026-10 官网价）摘要：

定价来源见 README 中的 DeepSeek 定价、智谱定价。改完单价保存 client.js 后刷新页面即可生效。

高峰/空闲按 DeepSeek 规则：北京时间周一至周五 09:00–12:00、14:00–18:00 为高峰，其余时段（含周末、法定节假日全天）为空闲，空闲价为高峰价的一半。法定节假日表来自国务院办公厅每年 11 月发布的安排通知（当前内置 2026 年，共 33 天），每年需更新一次；无分时价的模型两档可填同一数值。

典型用法¶

安装并刷新后无需额外配置即可使用：

1. 在输入框下方统计行末尾查看「累计 ¥x.xxxx」。
2. 在每条 assistant 消息的操作行中，于「用量 xxx tok」旁查看「本轮 ¥x.xxxx」。
3. 点击金额打开明细，核对模型、时段、分项 token 与合计。

若官网调价或新增模型路由，编辑 client.js 中的 PRICES 后保存并刷新页面。

适用场景与注意¶

适合：在 DSH 里长时间调试智能体、对比不同模型或时段成本、需要与 token 用量并列查看估算金额的场景。

务必知晓：

• 本地估算，不是账单；官网调价后需同步改 PRICES。
• 子代理在独立会话里运行，不计入当前会话累计。
• 节假日表每年需手动更新（文件内有出处与年份注释）。
• 计费口径只认 token；图片/文件上传、Search、Fetch 等按次计费项未折算。

开发时：客户端改动保存后刷新页面；宿主改动需重新导入模块（移除再安装 bundle，或重启 DSH）。

结尾¶

dsh-llm-cost 在 DSH 界面内提供会话级与单轮级 LLM 费用估算，并支持高峰/空闲与缓存分项明细，便于开发时对照 token 用量做成本判断。详情与问题反馈见 GitHub 仓库与社区目录页：

• https://github.com/liandy0731/dsh-llm-cost
• https://www.skillhub.cn/plugins/liandy0731/dsh-llm-cost