前言¶
在 DeepSeek Harness (DSH) 的智能体开发与日常使用中，prompt 生成、推理以及上下文缓存会消耗大量 token。如果没有实时的财务反馈，开发者可能面临意外的账单激增、错失夜间折扣窗口，或者无法发现失控的子代理费用。dsh-cost-meter 插件旨在解决这些问题，它将高精度成本遥测芯片直接嵌入到 DeepSeek Harness 对话头部，提供实时会话成本显示、分时电价切换以及 Token 定价功能。
插件定位¶
该插件由 GooDAnDReaDY 维护，遵循 MIT 协议。它通过增量流式遥测技术，无需轮询即可实时计算 prompt、completion 和缓存读写的 token。插件支持双档位（高峰/非高峰）电价引擎，能够自动识别官方 DeepSeek 高峰时段（提供 50% 非高峰折扣），并确保历史会话支出永久锚定于执行时的费率。
核心功能¶
- 增量流式遥测：实时计算 token 消耗，包含 prompt、completion 和缓存读写，避免 UI 卡顿。
- 双档位电价引擎：支持 DeepSeek 官方高峰时段，自动检测 50% 非高峰折扣。
- UTC 半小时时段不可变性：历史支出数据永久绑定到执行时的费率档位。
- 提供商感知路由：区分直连提供商与托管网关（如 OpenRouter）。
- 交互式 UI 与设置：支持自定义货币符号、汇率和时区配置。
- 性能与缓存：采用 O(K) 次变更计算优化，支持服务器缓存与 ETag。
- 目录同步与导出：支持手动目录同步（API 或 UI），并提供快速摘要导出。
- 预算与建议：提供预算阈值警告和省钱建议。
- 状态与多模型：原生圆点状态指示器（支持脉冲警告），支持多模型折叠面板。
- 上下文缓存节省：自动计算并高亮缓存带来的财务节省。
安装与启用¶
安装该插件需要使用官方安装命令：
dsh plugin --profile web add @goodandready/dsh-cost-meter
安装完成后，重启 DeepSeek Harness 实例并刷新浏览器即可加载插件。
配置与使用¶
配置分为 GUI 设置和 YAML 高级设置两部分。
基础配置（GUI）¶
主要标量参数（如 currency、usdRate、displayTimeZone、useOpenRouter、refreshHours）可在界面 Settings → Plugins → Plugin Settings → Cost Meter 中直接编辑。
高级配置（YAML）¶
复杂的字典或数组结构配置（如 prices、modelMap、deepseekPeakPrices、manualPeakWindowsUtc、manualOffPeakMultiplier）需在 settings.yaml 中配置。
配置项说明：
* currency: 显示货币符号（如 $, ₽, €）。
* usdRate: 汇率乘数（每 1 USD 对应的货币单位）。
* displayTimeZone: IANA 时区，用于格式化高峰/非高峰窗口。
* useOpenRouter: 是否自动从 OpenRouter 获取费率与折扣窗口。
* prices: 手动费率配置（每百万 token 的输入、输出、缓存命中/写入价格）。
* modelMap: 模型路由覆盖（"provider/model" -> OpenRouter model id）。
* manualPeakWindowsUtc: 手动定义高峰时段（HH:MM-HH:MM UTC）。
* manualOffPeakMultiplier: 手动非高峰倍率。
数据同步¶
- API 同步:
POST /dsh-cost-meter/refresh - UI 同步: 点击界面上的 “Sync Now” 按钮。
运行环境与依赖¶
- Node.js: 需要版本 >= 20。
- 依赖库:
zod。 - Peer Dependencies:
@deepseek-ai/cordis(版本 >= 4.0.1)@deepseek-ai/schemastery(版本 >= 3.18.1)
总结¶
dsh-cost-meter 通过在头部集成实时成本芯片，解决了 AI 开发中费用不可见的问题。开发者可以基于实时数据调整策略，利用非高峰时段降低成本。插件遵循 DSH Locale Standards，支持中英文本地化。
