前言¶
在使用 DeepSeek API 进行开发时，高峰时段（每天 9:00-12:00、14:00-18:00，北京时间）通常伴随着更高的价格和更慢的延迟。对于频繁调用 API 的开发者而言，手动切换模式或查看余额不仅繁琐，还容易导致不必要的费用支出。本插件旨在通过可视化界面和通知机制，解决这一痛点。
这是什么¶
这是一个由 lsakira 维护的客户端插件。它为 DeepSeek Harness（dsh）提供实时时段指示、高峰前提醒以及 API 余额卡片功能，帮助开发者掌握当前运行状态。
核心功能¶
-
模式指示灯
在界面左下角常驻显示当前时段：
- 梁文峰（高峰）：每天 9:00-12:00、14:00-18:00。
- 梁文谷（非高峰）：其余时间。 -
高峰前提醒
在高峰开始前（默认提前 10 分钟，可配置）弹出右下角通知条。提醒的标题和内容均可自定义。插件仅负责提醒，不干预模型的回复行为。 -
余额卡片
在指示灯上方显示 DeepSeek API 余额（每 5 分钟刷新一次）。当余额低于配置阈值（默认 2 元）时，卡片会变红。
安装与启用¶
前提：已安装并运行 DeepSeek Harness（dsh）。下文 $DSH_HOME 指你的 dsh 数据目录（默认为 ~/.dsh 或 C:\Users\<用户名>\.dsh）。
- 将插件目录放入
$DSH_HOME/tools/dsh-peak-reminder/。 - 编辑
$DSH_HOME/profiles/web/package.json，在dsh.profile.bundles中加入：
"@local/dsh-peak-reminder"
- 在
$DSH_HOME/profiles/web/下执行：
dsh plugin --profile web add ./../../tools/dsh-peak-reminder
- 重启 dsh，刷新浏览器页面。
典型用法¶
- 配置 API Key：在
$DSH_HOME/.credentials.yaml中配置DEEPSEEK_API_KEY。 - 自定义设置：编辑
dsh/client.js顶部的“⚙️ 用户设置区”。ADVANCE_MIN：提前几分钟提醒（默认 10）。REMIND_TITLE：提醒标题（默认“梁文峰要来了”）。BALANCE_RED_BELOW：余额低于多少元变红（默认 2）。
- 改完保存并重启 dsh（或刷新页面）使设置生效。
适用场景与注意¶
- 适用场景：适合需要精细控制 API 调用成本和时间，希望自动获取状态信息的开发者。
- 注意事项：
- 插件只负责显示和提醒，绝不强制，不干预模型回复行为。
- API Key 仅在服务端读取，不出现在浏览器端代码中。
- 余额数据不保证实时准确，使用风险自负。
- 未显示指示灯需刷新页面（F5）或重启 dsh。
结语¶
该插件通过界面常驻指示和通知提醒，降低了手动监控的频率，适合集成到日常的 DSH 工作流中。更多信息请查看：Catalog URL 或 GitHub。
