DeepSeek Harness 插件

dsh-tidewatch

DeepSeek 峰谷时刻悬浮卡片:官方峰谷时段、当前档位、距下一阶段倒计时与本次会话 API 花费(人民币)。A floating tide card for DeepSeek Harness: official peak/off-peak windows, live phase countdown and this session's API cost in CNY.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
KhalilYamber/dsh-tidewatch
最近更新
2026年8月21日
分类
记忆
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/KhalilYamber/dsh-tidewatch
插件名:dsh-tidewatch
作者:KhalilYamber

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-tidewatch

DeepSeek 峰谷时刻悬浮徽章:一张悬浮在输入框旁的潮汐卡,告诉你此刻是峰期还是谷期、距下一阶段还有多久、本次会话花了多少钱。

  • 状态点:峰期橙红 / 谷期蓝绿,一眼可辨
  • 折叠态:● 峰期 距谷期 03:33 · ¥0.12
  • 展开态(点击展开):官方峰谷时段表(北京时间)、当前档位价格、本次会话 Token 明细、汇率设置
  • 计费:官方峰谷两档价格(美元口径),按每次调用实际发生时刻的档位计价,缓存命中/未命中分开
  • 币种:默认人民币显示(固定汇率 6.82,与官方人民币标价一致),展开面板可一键切换美元(4 位小数)
  • 跟随 GUI 亮/暗主题(--dsw-* 变量)

峰谷时段(官方依据)

DeepSeek 官方自 2026-08-17 起实施峰谷分时定价:

时段(UTC)北京时间档位
01:00 – 04:0009:00 – 12:00
04:00 – 06:0012:00 – 14:00
06:00 – 10:0014:00 – 18:00
10:00 – 次日 01:0018:00 – 次日 09:00

谷期价格为峰期的一半。徽章按 UTC 窗口判定当前档位(官方口径),时段表展示按北京时间。

周末规则(2026-08-23 起):周六/周日(UTC 自然日)全天按谷期计价,无峰谷切换;下一阶段切换点为下周一首次进入峰时。

计费口径

  • 价格单位:美元 / 1M tokens(官方定价页口径),成本 = 输入未命中 × cacheMiss + 输出 × output + (缓存读 + 缓存写) × cacheHit
  • 峰谷时代之前(2026-08-16 16:00 UTC)的调用按当时的基础价计费(历史正确性)
  • 每次调用的费用按事件发生时刻的档位计算,跨峰谷切换不漂移
  • 账本金额以美元存储,显示时按固定汇率 6.82 换算人民币(默认)或直接显示美元

安装

> 需求:Node.js ≥ 20 + DeepSeek Harness(带 dsh plugin 命令的版本)。

# npm 包安装(发布后可用)
dsh plugin --profile web add dsh-tidewatch

# 或本地目录(开发调试)
dsh plugin --profile web add link:./dsh-tidewatch

安装后重启 dsh web 生效。

使用

  • 徽章悬浮在输入框右侧、与输入框垂直居中对齐;窄窗口放不下时自动移到输入框上方,不遮挡输入框与官方统计栏
  • 点击徽章展开/收起详情面板:时段表、当前档位价格、Token 明细、币种切换(¥ / $)
  • 点击「本次会话费用」行可展开分模型花费明细(各模型的 token 与花费分别列出,合计 = 分模型之和)
  • 币种选择即时生效并记住;人民币 2 位小数,美元 4 位小数

文件结构

dsh-tidewatch
├── package.json          # dsh.bundle.patch + dsh.client.platform 声明
├── cordis.patch.yml      # 装配行
├── scripts/build.sh      # 构建:语法检查 + zod junction
├── lib/
│   ├── pricing.js        # 纯函数:峰谷窗口、isPeakHour/peakPhaseAt、价格表、costOf
│   ├── index.js          # 宿主:costUsage 会话投影(按事件时刻计费)
│   └── client.js         # 前端:悬浮徽章(__ModuleLoader__ bundle)
├── docs/PORTING.md       # 移植到其他宿主的适配说明
└── test/verify.mjs       # 纯模块自检(node test/verify.mjs,19 项)

数据流

模型调用 usage 块(assistant/chunk、assistant/message 事件)
        │  lib/index.js:costUsage 会话投影(zod schema 校验)
        ▼
  token 桶 + 美元成本(按事件时刻峰谷档位)
        │  useProjection('costUsage')(浏览器端)
        ▼
  lib/client.js:悬浮徽章渲染(秒级倒计时 + 汇率换算显示)

开发与验证

DSH_CHECKOUT=<harness 源码根目录> bash scripts/build.sh   # 语法检查 + zod junction
node test/verify.mjs                                       # 峰谷数学与计费自检(19 项,含双份常量一致性)

已知限制

  • 价格表内置(V4-Flash / V4-Pro 官方 2026-08-17 价)。官方调价后需手动同步 lib/pricing.js(计费)与 lib/client.jsDISPLAY_PRICES(展示)两处常量
  • 时段判定固定按 UTC(官方口径),时段表展示按北京时间(UTC+8)
  • 花费为美元账本 × 固定汇率 6.82 换算人民币(与官方人民币标价一致);展开面板可切换美元显示

借鉴与许可

峰谷数学(isPeakHour / peakPhaseAt / tierFor / costOf)与会话投影结构借鉴自 dsh-cost-meter(MIT License),按精简目标改写。

[MIT](LICENSE) © 2026 KhalilYamber