前言¶
DeepSeek Harness 的计费策略包含明显的峰谷时段（Peak/Off-peak）。在 Web UI 中查看当前阶段、倒计时和单次会话成本比较繁琐。dsh-tidewatch 旨在解决这个问题，通过一个悬浮卡片提供直观的监控视图。
插件简介¶
dsh-tidewatch 是一个由 proDreams 维护的 Web UI 插件。它挂载在 DSH 界面的输入框右侧，实时显示当前计费阶段、剩余时间、会话成本以及详细的 Token 统计。核心价值在于将官方 UTC 时区的计费规则映射到用户本地时区，并支持多语言。
核心功能¶
- 阶段概览：通过颜色点（琥珀色为 Peak，绿色为 Off-peak）和倒计时展示当前计费阶段。
- 潮汐线：展示当前阶段已过的时间比例。
- 本地时区窗口表：将官方 UTC 计费窗口转换为用户所在时区的日历视图，当前行高亮显示。
- 周末规则：周六和周日（UTC 日历日）全天均为 Off-peak，表格自动合并为全天行。
- 实时费率：展示当前阶段的缓存命中/未命中输入价格及输出价格。
- 会话 Token 统计：显示输入、缓存读写、输出和推理 Token 的本地化格式。
- 分模型成本：点击“Session cost”行可展开查看每个模型的具体 Token 和费用。
- 货币切换：支持在 CNY 和 USD 之间一键切换，并自动保存偏好。
- 真实国际化：卡片文案跟随 DSH 界面语言（支持 EN/CN/RU），提供原生体验。
- Shell 集成：读取
--dsw-*主题 Token，支持深色/浅色模式，并使用官方 Primitive 组件。
安装与启用¶
安装前请确保已安装 DeepSeek Harness 并启用 dsh plugin，且环境满足 Node.js >= 20。
dsh plugin --profile web add github:proDreams/dsh-tidewatch
安装后需重启 dsh web 服务，插件才会生效。插件会挂载在 Composer 右侧。
典型用法¶
- 查看状态：卡片默认显示当前阶段名称和倒计时，点击徽章可展开/折叠面板。
- 成本明细：在面板中点击“Session cost”行，可查看按模型拆分的 Token 消耗与费用。
- 切换货币：在面板中点击货币标签可切换 USD 或 CNY。
注意事项¶
- 版本警告：npm 上存在的旧版本包
dsh-tidewatch(v1.0.6) 作者未更新，价格和规则已过时，切勿安装。请务必使用 GitHub 仓库提供的安装命令。 - 计费逻辑：插件严格按照官方 UTC 计费窗口计算费率，不涉及网络请求或 API Key。
- 权限要求：插件以 DSH 进程权限运行，无需额外的网络访问或 API 密钥。
总结¶
dsh-tidewatch 为 DSH 用户提供了可视化的计费监控工具。通过将复杂的 UTC 计费规则转化为本地化的窗口表和实时卡片，它帮助开发者更精准地把握成本。
- 插件目录：SkillHub Catalog
- 源码地址：GitHub
