潮汐暂停 wobenshiwomu/dsh-tide

dsh-tide

DeepSeek Harness 插件：看时机的优雅暂停（Graceful Pause on Timing）。
退潮时暂停，涨潮时回来 —— 在「时机不对」的时刻，让智能体优雅地把项目停在安全点、留下可继承的交接，而不是硬停或继续烧钱。

两条链路（同一套骨架：暂停 → 双交接 → 条件唤醒）

Part 1 · 峰时提醒（温和事件：给你选择权）
- 谷→峰切换（「梁文谷」转「梁文峰」）时，向最近活跃的会话注入一条用户可见提醒：「在 15 秒内回复『暂停』可优雅收尾（先留交接，等便宜时段再继续）；不回复则照常推进。」
- 回复「暂停」→ 进入收尾：模型写两份交接（人一份 + 模型一份）→ 调用 submit_pause_handoff 落盘 → 会话进入「已暂停」。
- 超时默认继续：有些项目「宁愿多花钱、不能停」——15 秒是「抓在场的人」的窗口，不是等你做决定的窗口。设计上这是「同意机制」，不是「省钱强制」。
- Never Ask 模式下静默跳过（不打扰）。

Part 2 · 余额降级（危险事件：强制处理）
- 余额 ≤ lowBalanceCNY → 向活跃会话注入降级收尾指令（不需要用户同意），模型写双交接后停下。
- 看门狗：暂停后按 watchdogSeconds（默认 15 分钟）轮询余额；恢复到 resumeBalanceCNY 以上 → 自动唤醒模型继续任务（模型交接原文随唤醒消息注入）。
- 未达恢复线则保持暂停，不重复打扰。

工作机制（全部使用公开 API，已在本机 DSH 源码逐项验证）

| 环节 | 机制 |
| 时间驱动 | 宿主 setInterval tick（默认 10s）；峰谷为北京时间周一至五 09:00–12:00、14:00–18:00（peakWindows 可覆盖，支持 leadMinutes 提前量） |
| 注入提醒/审计 | session.append('user/message', msg, { surfaceOp: 'append' }) —— surfaceOp 在回合外上下文是必须的（surface 契约），审计元数据在 source.tide 字段 |
| 唤醒模型 | ctx.sessionController.resolveAgent(sid) → agent.followup(message) → ctx.sessions.flush()（与 dsh-schedule 同款用法） |
| 收尾产物 | submit_pause_handoff 工具：human 交接写工作目录 TIDE-PAUSED-handoff.md（+归档），model 交接写 $DSH_HOME/storages/dsh-tide/handoffs/<会话>.md 并随唤醒注入 |
| 余额 | 官方 GET {baseUrl}/user/balance（Bearer，key 走 ctx.credentials → 环境变量兜底），免费不耗额度 |
| 状态 | 内存状态机 + 落盘 state.json（暂停项跨重启）；问询窗口/暂停标记可从会话日志重建（跨进程可用） |

安装

GitHub 直装（推荐，国内网络可直连，无需 npm 账号）：

dsh plugin --profile web add 'https://codeload.github.com/wobenshiwomu/dsh-tide/tar.gz/v0.1.0'

或在图形界面：侧栏「插件」→ 添加插件 → 填上面这条 URL。装完重启 DSH 生效。
URL 末段的 v0.1.0 是版本标签；升级时换成本仓库的新版本标签重装即可。

本地/开发安装（本机路径）：

dsh plugin --profile web add /path/to/dsh-tide

配置（profile 用户层 cordis.patch.yml，覆盖构建默认）：

- id: dsh-tide
config:
lowBalanceCNY: 1 # 低余额触发线（元） resumeBalanceCNY: 3 # 余额恢复线（元，须大于触发线）
peakWindows: ['1-5 09:00-12:00', '1-5 14:00-18:00']
leadMinutes: 0 # 峰时提醒提前量（分钟） askTimeoutSeconds: 15 # 提醒时效 watchdogSeconds: 900 # 看门狗轮询间隔

⚠️ 触发线必须小于恢复线（low < resume）；相等或倒置会形成「唤醒后立刻再暂停」循环，启动时会打印配置提醒。

配置项（全量）

| 键 | 默认 | 说明 |
| askEnabled | true | 峰时提醒总开关 |
| peakWindows | 周一至五 09:00–12:00 / 14:00–18:00 | 峰段（北京时间），格式 "<0-6/*> <HH:MM>-<HH:MM>" |
| leadMinutes | 0 | 峰时提醒提前量 |
| askTimeoutSeconds | 15 | 提醒中承诺的回复窗口 |
| askValidMinutes | 10 | 窗口后仍有效的答复时限（超过视为继续） |
| guardWhileWrapping | true | 收尾期间拦下「开新战线」工具（denyPattern） |
| denyPattern | job_\|create_goal\|update_goal\|todo_write\|send_message\|subagent\|workflow\|ralph | 收尾期拦截正则 |
| activeWindowMinutes | 720 | 只提醒最近活跃过的会话 |
| balanceEnabled | true | 余额降级总开关 |
| lowBalanceCNY | 5 | 低余额触发线（≤ 即触发） |
| resumeBalanceCNY | 20 | 恢复线（> 即唤醒） |
| balancePollSeconds | 60 | 常规余额轮询间隔 |
| watchdogSeconds | 900 | 暂停后的看门狗间隔 |
| balanceBaseUrl | https://api.deepseek.com | 余额接口 base |
| apiKeyRef | DEEPSEEK_API_KEY | 凭据服务引用名 |
| tickSeconds | 10 | 宿主 tick 间隔 |
| storageDir | $DSH_HOME/storages/dsh-tide | 状态与模型交接目录 |
| debugSeedSessions | [] | 调试：预置为"已追踪"的会话 ID |

审计（都在会话日志里，source.tide 字段）

subtype: ask（峰时提醒）· consent（用户同意）· decline（继续）· expired（过期）· wrap（收尾指令）· paused（已暂停，含双交接路径）· woken（看门狗唤醒）· resumed（手动恢复）。

已知边界

- 节假日不建模：官方峰段不含法定节假日；本插件按"周一至五"计算（节假日白天会按峰处理，偏差方向保守——最多多提醒一次）。
- resolveAgent 会接管会话：提醒送到哪个会话，该会话的写句柄就属于当前实例；多实例（web + headless 同时）共用同一会话时会出现锁冲突——单实例使用无影响。
- 不采用原生 ask_user_question：其 timed 模式非宿主默认，且设置项所在的嵌套行无法被用户层 patch 覆盖（实测）；本插件的非阻塞提醒方案不依赖任何 ask 模式， headless 环境行为一致。
- 收尾质量取决于模型；submit_pause_handoff 是兜底（未调用则不会标记"已暂停"）。
- 与 dsh-calm 架构同源（pre-step 注入 + 工具闸门），可共存。

测试

npm install # 首次：安装测试所需的宿主依赖
npm test # 仿真测试：89 项断言（时钟/窗口/同意/双交接/看门狗/跨重启/跨进程）

e2e/ 目录留有真实环境 E2E 用过的配置样例（含 mock 余额服务器脚本）供参考。