潮汐计费卡 proDreams/dsh-tidewatch

Napkin Tools：DSH Tidewatch

Русская версия

一个浮动的高峰/低谷潮汐表，用于 DeepSeek Harness 网页界面。它停靠在输入框旁边，一眼就能回答三个问题：当前处于哪个计费时段、这个时段还剩多久、本次会话已经花了多少钱。

卡片跟随 DeepSeek Harness 的界面语言（英语、中文、俄语），按你所在的时区渲染官方的高峰/低谷时段，并用 Intl 按当前语言格式化金额、token 和时钟时间。

这是 dsh-tidewatch 的分支，原作者 KhalilYamber（MIT），为国际化作过重写：用真正的 i18n 层替换硬编码的中文文案，重新设计了卡片，并加入本地时区时段表。计费算法和会话预估结构来自原项目。

目录

- 功能
- 环境要求
- 安装
- 升级与卸载
- 从原版 1.x 升级
- 使用
- 作用范围
- 高峰时段
- 计费模型
- 界面语言
- 主题与基础组件
- 项目结构
- 数据流
- 开发与验证
- 已知限制
- 致谢
- 作者
- 支持
- 许可

功能

- 一眼看清时段 — 琥珀色（高峰）或绿色（低谷）状态点，配当前时段名称，以及到下次切换的实时倒计时。
- 潮汐线 — 标题栏显示当前时段已经过去多少。
- 本地时区时段表 — 把官方 UTC 时段映射到你自己的日历日，并标出当前行；时段本身始终按 UTC 判定（官方定义）。
- 周末与节假日规则 — 周六、周日和中国法定节假日全天低谷，因此时段表会合并成一行全天，倒计时直接跳到下一个工作日高峰。
- 当前时段费率 — 你所在时段的缓存未命中/缓存命中输入价格，以及每 1M token 的输出价格。
- 会话 token — 输入、缓存（读 + 写）、输出和推理，按语言区域格式化。
- 按模型计费 — 展开会话费用行，查看每个模型的 token 和费用；总计等于各部分之和。
- 人民币或美元 — 默认跟随界面语言（中文 → 人民币，其他 → 美元）；一键切换，并会记住选择。
- 真正的 i18n — 卡片跟随 DeepSeek Harness 语言，内置英语、中文和俄语词典，并提供俄语作为可选语言。
- Shell 集成 — 读取 --dsw- 主题 token（浅色和深色），优先使用官方 StateDot、Tag、Tooltip 和 useDismissOnOutsidePointer 原语；当 shell 未暴露这些原语时，回退到内置实现。
- 键盘可访问 — 徽章和展开行是真正的按钮，带焦点环、aria-expanded / aria-pressed 状态，潮汐线带 progressbar 角色。

要求

- Node.js ≥ 20。
- DeepSeek Harness，带 dsh plugin 命令（web 配置档）。
- 无需其他东西：价格表内置，插件自身不需要 API key 或网络访问。

安装

徽章显示在 web UI 中，所以请安装到 web 配置档。

Option 1: the latest main (recommended; follows the repository)
dsh plugin --profile web add github:proDreams/dsh-tidewatch

Option 2: a pinned release tag (reproducible installs)
dsh plugin --profile web add github:proDreams/dsh-tidewatch#v2.1.1

Option 3: the tarball attached to a GitHub Release (pinned and offline-friendly)
dsh plugin --profile web add https://github.com/proDreams/dsh-tidewatch/releases/download/v2.1.1/dsh-tidewatch-2.1.1.tgz

Local directory (development)
dsh plugin --profile web add link:/path/to/dsh-tidewatch

安装后重启 dsh web；潮汐徽章出现在输入框右侧。

npm 包 dsh-tidewatch 不是我们的。 npm 上只有原作者发布的旧副本（1.0.6，2026-08-22），其价格和规则已过时，本分支刻意不上 npm。不要安装它，也不要根据它判断当前计费——请使用上面的任一选项。

升级和卸载

dsh plugin --profile web update dsh-tidewatch # or re-run the add above
dsh plugin --profile web list dsh-tidewatch # installed version
dsh plugin --profile web remove dsh-tidewatch # uninstall

发布历史见 CHANGELOG.md。

从原版 1.x 升级

2.0.0 新增 i18n 层、本地时间窗口表和重新设计的卡片。计费本身未变。

如果你在 1.1.2 之前用过原版插件，有两个早先的修复值得了解：

- 1.1.2 — V4 Pro 计费。 官方定价页脚注 (2) 和 2026-09-10 变更日志说明，V4 Pro API 服务在 2026-09-14 之后继续提供，计费方式不变（如有变化将另行通知）。
早先的构建沿用新闻页的解读，把 deepseek-v4-pro 按 2026-09-14 04:00 UTC 起的 Flash 价格计费，结果低估了 pro 调用：缓存未命中约 4.4 倍，缓存命中约 7.3 倍，输出约 3.3 倍。重新定价边界 V4_PRO_RETIRE_BOUNDARY 又变回哨兵值，所以 pro 始终按自己的费率计费；路由分支保留，等官方日期出现时只需填入即可。
- 1.1.1 —— 三个价格时代。 计费现在根据调用自身的时间戳选择档位，costUsage 投影移到 stateVersion 4。升级后持久化会话会重放一次，因此 2026-08-16 到 2026-09-10 之间的调用恢复为第一套高峰时段表（它们此前按较新的低价计费）。实时计费从未受影响。

用法

- 徽标停靠在输入框右侧，与输入框垂直居中。窗口太窄时改为移到输入框上方，且绝不遮挡输入区或内置统计栏。
- 点击徽标展开或收起面板：窗口表、当前档位费率、token 明细和货币切换。
- 点击 Session cost 行展开按模型拆分的费用明细。
- 货币切换立即生效并持久保存；CNY 显示 2 位小数，USD 显示 4 位。
- 展开的面板绝不超过徽标上方的可用空间——高度预算从徽标本身量起，所以小屏幕上不会遮住输入框。

范围

卡片统计写入会话事件流的模型调用，也会汇总会话的下级（子代理）会话，因此团队运行会显示整个任务的费用。token 总计和按模型拆分也包含它们；子代理那部分显示在总计下方，形如 incl. subagents N · $X。

它不包含从未进入会话事件流的调用：实验性的 Auto review（Auto 权限预设会用同一模型审查每个受支持的工具调用）、会话标题生成、上下文压缩、web-search 包装器以及其他聊天。这些会计入账户——账户级数字见 Platform → Usage（或某个用量追踪插件）。

高峰时段

DeepSeek 于 2026-08-17 引入按一天中时段区分的高峰/低谷定价：

| 窗口（UTC） | 北京时间 | 档位 |
| 01:00 – 04:00 | 09:00 – 12:00 | 高峰 |
| 04:00 – 06:00 | 12:00 – 14:00 | 低谷 |
| 06:00 – 10:00 | 14:00 – 18:00 | 高峰 |
| 10:00 – 次日 01:00 | 18:00 – 次日 09:00 | 低谷 |

低谷价格是高峰价格的一半。卡片按 UTC 窗口（官方定义）判断档位，并按查看者所在时区渲染表格。

周末和中国节假日：周六和周日（UTC 日历日）以及中国法定公共节假日（一个内置北京日历日期表（2026 年），全天按低谷价计费，不切换高峰/低谷；下一次切换落在下一个工作日的第一个高峰窗口。高峰窗口从 UTC 01:00 和 06:00 开始，所以窗口内 UTC 日期与北京日期一致，倒计时能跨过长假（春节、国庆）。

计费模型

- 单位：USD / 1M tokens（与官方定价页口径一致）。费用 = 输入未命中 × cacheMiss + 输出 × output + （缓存读取 + 缓存写入）× cacheHit；其中「output」已包含推理 token。
- 三个价格时期，按调用自身的时间戳选择（保证历史正确性；各档依次为缓存命中 / 缓存未命中 / 输出）：

| 时期 | 范围（UTC） | deepseek-flash 各档 |
| 基础价 | 2026-08-16 16:00 之前 | 0.0028 / 0.14 / 0.28 |
| 首个高峰时段表 | 2026-08-16 16:00 – 2026-09-10 04:00 | 高峰 0.014 / 0.44 / 1.32，低谷减半 |
| V4.1 Flash 调价 | 2026-09-10 04:00 起 | 高峰 0.006 / 0.3 / 1.2，低谷减半 |

- 每次调用都按其事件时间戳所在档位计费，所以费用不会在阶段切换或调价时漂移。
- 账本以 USD 存储。面板按固定汇率 6.67 显示 CNY（与官方人民币价目表一致），或直接显示 USD。

界面语言

这张卡片是标准的 DeepSeek Harness 成员：它注册 tidewatch 语言命名空间，并通过框架翻译器读取文案，所以在 Settings → Language 里切换界面语言，卡片会立即跟着切换。

| 语言 | 状态 |
| English | 已发布（en）——查找链的回退语言 |
| Chinese (Simplified) | 已发布（zh） |
| Russian | 已发布（ru），并由插件加入语言目录 |

- DeepSeek Harness 只自带 zh 和 en，所以插件自己把 Russian 加进语言列表。其他插件遇到该语言时回退到英文。
- 在没有 locale 服务的 shell 上，卡片回退到浏览器语言，而不是默认成某个写死的语言。
- 文案从不拼接片段：每个字符串都是各语言自己维护的 {placeholder} 模板，字典一旦不一致，测试套件就会失败。

主题与基础组件

卡片通过 --dsw- 变量跟随 DeepSeek Harness 主题，每个插件本地 token 都保留一套能感知配色方案的兜底值，所以在没有主题层的宿主上也能显示正确。

- 亮色和暗色都支持；阶段强调色（琥珀色或绿色）是唯一的高饱和颜色。
- 数字使用 shell 的等宽字体栈并启用表格数字，面板读起来像仪表盘。
- 前端优先使用官方共享基础组件——StateDot、Tag、Tooltip 和 useDismissOnOutsidePointer——当 shell 的模块表没有暴露这些组件时，降级到内置实现它们。

项目结构

dsh-tidewatch
├── package.json # dsh.bundle.patch + dsh.client.platform manifest
├── cordis.patch.yml # bundle patch row
├── scripts/build.sh # build: syntax check + zod junction
├── lib/
│ ├── pricing.js # pure functions: windows, isPeakHour/peakPhaseAt, three price eras, costOf
│ ├── index.js # host: costUsage session projection (billed per event time)
│ └── client.js # browser: floating tide card + i18n dictionaries (__ModuleLoader__ bundle)
├── docs/PORTING.md # adaptation notes for other hosts
└── test/verify.mjs # pure-module self-test (node test/verify.mjs)

数据流

model-call usage blocks (assistant/chunk, assistant/message events)
│ lib/index.js: costUsage session projection (zod-schema validated)
▼
token buckets + USD cost (per-event-time peak/off-peak tier)
│ useProjection('costUsage') (browser)
▼
lib/client.js: card rendering (per-second countdown, Intl formatting, FX conversion)

开发与验证

DSH_CHECKOUT=<harness source root> bash scripts/build.sh # syntax check + zod junction
node test/verify.mjs # 90 checks: peak math, billing, i18n, time zones

测试套件用桩 React 和模拟插件上下文把真实客户端 bundle 跑起来，因此检验的是实际发布的字典、回退链、区域感知格式化和时区窗口表，而不是它们的副本。

已知限制

- 价格写死在代码里，覆盖三个时期（基础价 / 首个高峰时段表 / V4.1 Flash 调价）；V4-Pro 采用 2026-08-17 的官方费率。按官方定价页脚注 (2) 和 2026-09-10 变更日志，V4 Pro 在 2026-09-14 之后计费方式不变，继续提供服务，所以 pro 始终按自己的费率计费，V4_PRO_RETIRE_BOUNDARY 保持哨兵值，等待官方日期。官方价格变动时，要手动同时更新 lib/pricing.js（计费）和 lib/client.js 里的 DISPLAY_PRICES 常量（展示），并把被取代的档位保留为另一个历史时期。
- 模型名：deepseek-flash 是当前名称（V4.1 Flash）；别名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 和 deepseek-v4.1-flash 都按当前 flash 费率计费（见 MODEL_ALIASES）。
- 档位判定固定用 UTC（官方定义）；窗口表只用于展示层的本地化。
- 节假日表靠手工维护：lib/pricing.js 和 lib/client.js 里各存了一份 2026 年 33 个中国法定节假日；每年 11 月国务院发布次年通知时，两份都要扩充（一致性检查会让它们保持同步）。借调周末的补班日仍算非高峰，因为
- 官方规则把每个周末都算作非高峰时段。
- 人民币显示采用固定汇率换算（6.67 USD → CNY，与官方人民币价格一致），不是实时汇率。

致谢

- 原项目：dsh-tidewatch，作者 KhalilYamber（MIT）——计费算法、价格时期模型和会话预估结构都来自这里。
- 高峰/非高峰算法和预估结构改编自 dsh-cost-meter（MIT），为精简体积重写。

作者

程序作者：Ivan Ashikhmin 联系 Telegram：https://t.me/proDreams

本程序是「Code on a Napkin」项目的一部分。

- 网站：https://pressanybutton.ru/
- Telegram 频道：https://t.me/napkincode

支持

如果你喜欢这个项目，想支持它继续开发，可以考虑捐赠：

- 通过 YooMoney 支持
- 通过 Telegram 的 Tribute 支持
- 通过我们的 Telegram 机器人支持

你的支持能帮助项目成长，改进未来的功能！

许可证

本项目采用 MIT 许可证。它是 KhalilYamber 的 dsh-tidewatch 的衍生作品；两份版权声明都保留在 LICENSE 文件中。