前言¶

在 DeepSeek Harness（DSH）里连续调用模型时，账单往往滞后于控制台，流式输出下的吞吐和首字延迟也缺少常驻反馈。仅靠服务商后台或事后对账，很难在当次会话里判断「这一轮花了多少、跑得是否顺畅」。下面介绍社区插件 dsh-cost-speed（维护者 Unstivl，分类：模型推理）：在输入框上方提供停靠条，用本机 DeepSeek BPE 估算 token 并折算金额，同时在生成过程中展示 TPS、首字延迟与上下文占用；数据默认只留在本机。

这是什么¶

dsh-cost-speed 是 DSH 的组合包插件：宿主半侧监听 llm/stream 等事件做计价与聚合，浏览器半侧在 Web 载体里渲染停靠条与统计卡片。它不替代官方账单，而是为日常开发提供本地估算与实时读数。仓库地址：GitHub — Unstivl/dsh-cost-speed；社区目录页：skillhub.cn 插件页。

核心功能¶

计费与价目¶

• 按真实 DeepSeek BPE 分词估算 token，再按本机价目表折算人民币金额（元 / 百万 tokens）。
• 默认示例价目对齐 DeepSeek 官方 API 空闲价；高峰时段（北京时间周一至周五 9:00–12:00、14:00–18:00）可按两倍计算。
• 价目可在面板中编辑，保存到 ~/.dsh/cost-monitor/pricing.json，重启后仍生效；provider / model 支持 * 通配，未匹配模型只统计 token、金额记为未计价。
• 插件不发任何出站网络请求；账本不含提示词、回复或密钥。

统计视图与实时读数¶

• 停靠条默认显示「今日估算费用」；悬浮展开后可切换时、日、周、月四张图（小时折线、日 24 柱、周一至周日、月历热力图，默认日视图）。
• 流式生成时显示 TPS、首字延迟、上下文占用与缓存命中；分词与吞吐统计移植自社区插件 dsh-live-token-stats。

兼容性与平台¶

• 要求 DSH >=0.2.1-rc.3 且 <0.3.0（见 package.json 的 engines.dsh）。
• 浏览器半侧注册在 web 平台；README 注明当前只支持 Web 平台（Desktop 与 Web 形态共用同一 Web 载体）。
• 宿主半侧仅依赖 Node 内置模块与 DSH 的 llm/stream 事件；无构建步骤，无运行时 npm 依赖。

安装与启用¶

从插件面板¶

1. 侧栏打开「插件」，点「添加插件」。
2. 粘贴仓库地址并确认：

https://github.com/Unstivl/dsh-cost-speed

3. 安装后插件出现在「已安装插件」；新组合包默认启用。按提示重启或等待热重载。

从命令行¶

将 desktop 换成你的 profile 名称：

dsh plugin --profile desktop add github:Unstivl/dsh-cost-speed

开关¶

在插件页打开 dsh-cost-speed 卡片，行开关同时控制宿主半侧与停靠条。关闭后停靠条消失、账本保留；重新打开会继续累计。状态写在 profile 的 cordis.patch.yml，跨会话生效。

典型用法¶

查看费用与趋势¶

安装并启用后，输入框上方会出现停靠条。日常使用无需额外配置即可看到今日估算费用；需要对比用量时，悬浮展开切换时 / 日 / 周 / 月视图。

调整价目表¶

面板内直接改价目并保存即可。也可手动编辑 ~/.dsh/cost-monitor/pricing.json，结构示例（单位：元 / 百万 tokens）：

{
  "note": "说明文字",
  "rules": [
    { "provider": "deepseek-official", "model": "deepseek-flash",
      "price": { "input": 1, "output": 4, "cacheRead": 0.02, "cacheWrite": 4 },
      "peak": { "multiplier": 2, "windows": [[9, 12], [14, 18]], "weekdaysOnly": true, "timezoneOffsetMinutes": 480 } },
    { "provider": "*", "model": "*", "price": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 } }
  ]
}

free: true 用于有意按零计价的线路；末尾至少保留一条 */* 兜底规则。

本机数据目录¶

启动时会读本机会话日志补齐历史，仅取 token 计数、模型名与来源。

适用场景与注意¶

适合谁： 在 DSH Web 界面里高频调试智能体、需要当会话内感知估算费用与流式性能的开发者。

估算与账单： 金额为按上报 token 与本地价目的估算，可能与最终账单不一致；货币符号固定为人民币元。

安全与权限： 宿主插件在 DSH 进程内运行，具备该进程的 Node 权限；安装第三方插件前请先阅读 lib/ 与 SECURITY.md。本插件在本机 HTTP 服务上暴露读接口，并对 Origin / Host 等做校验。

生态说明： DSH 奉行「一切皆插件」；skillhub.cn 等为社区目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

经过上面的步骤，你可以在 DSH 输入区上方同时看到本地估算费用与流式 TPS、首字延迟、上下文占用，并把价目与账本留在 ~/.dsh/cost-monitor/。当前发行版本见仓库 package.json（如 0.2.1），许可为 MIT。

• 社区目录：https://www.skillhub.cn/plugins/Unstivl/dsh-cost-speed
• 源码与文档：https://github.com/Unstivl/dsh-cost-speed