前言¶
在 DeepSeek Harness (DSH) 中追踪使用成本时，需要针对不同模型和时间段设定价格。dsh-ui-pricing 插件解决了这个问题：它提供了一个用户可配置的定价系统，支持按模型设定列表价格，并允许通过时间策略和乘数来调整每日成本，同时通过 CostLine 在 composer 界面实时展示支出。
插件定位¶
这是 DeepSeek Harness 的一个用户可配置成本定价插件，由 ivvan3016 维护，类别为 admin-security，使用 MIT 许可证。
安装与启用¶
该插件通过 npm 包分发，包含预构建的工件，安装后无需额外设置。
dsh plugin --profile web add dsh-ui-pricing
安装或更新后，必须重启 dsh web 进程。这是因为客户端插件清单和预测注册表是在服务器启动时构建的。
配置¶
在插件页面卡片中，可以配置定价设置。该设置包含模型列表价格、默认时间策略以及每日例外。
模型价格¶
设置每百万个 tokens 的货币单位价格。缓存写入费用按缓存未命中输入率计算（DeepSeek 暂无单独的写入价格）。未在列表中定义的模型价格为 0。
时间策略¶
默认策略为 00:00–24:00 的一个时间段，乘数为 1.0。在插件页面卡片中，可以为每个工作日定义自己的时间表，每个时间段包含一个 HH:MM 窗口和一个 multiplier。乘数为 1.0 时为原价，0.5 时为半价。
pnpm 允许列表¶
如果从 GitHub 源码安装，构建过程可能被 pnpm 阻塞。如果遇到 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 错误，需要复制 pnpm 打印的精确键值到配置文件的 pnpm-workspace.yaml 中：
allowBuilds:
dsh-ui-pricing@https://codeload.github.com/ivvan3016/dsh-ui-pricing/tar.gz/<commit-hash>: true
该键绑定到某个具体的提交哈希，包名不匹配，且仅在更新依赖到新提交时变化。
CostLine 使用¶
插件在 composer dock 注册了一个 CostLine 组件，用于显示所有活跃会话的总支出。
查看与修正¶
CostLine 显示带有“估算”徽章的总计。点击金额（在可写部署中）可打开就地编辑器，预填充当前总计。输入修正后的总数会替换估算值，且后续使用量仍会在此基础上累加。修正值与自动计算值的差值会作为 manualSpend 保存。
24小时乘数条带¶
右侧显示当前本地时间和生效的乘数，以及一条 24 小时的乘数条带，标记当前分钟的位置。条带中的颜色表示折扣（低于原价）、溢价（高于原价）或中性（原价）。
注意事项¶
- 未列出模型：价格默认为 0，直到在设置中定义。
- 时间线对齐：拖动或点击时间线边界时，它们会吸附到整点，分钟级调整需在设置文档中完成。
- 覆盖机制：每日例外是默认时间表的副本，后续对默认时间表的修改不会影响已存在的例外。
- 数据刷新：CostLine 的总计会在当前会话发出事件或重新打开时刷新，以读取最新的会话预测。
