dsh-tide

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

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

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 是版本标签；升级时换成本仓库的新版本标签重装即可。

无需配置，开箱即用：装好即生效——内置峰时窗口（周一至五 09:00–12:00 / 14:00–18:00，北京时间）、 余额降级（触发线 ¥5 / 恢复线 ¥20）、看门狗每 15 分钟自动巡查。不写任何配置就是这套默认行为； 下面的配置全部可选，只想自定义行为时才需要。

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

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

可选配置（profile 用户层 cordis.patch.yml，覆盖构建默认；不配置即用默认值）：

# 示例：仅当要改默认值（触发线 5 / 恢复线 20）时才需要
- 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 项断言（时钟/窗口/同意/双交接/看门狗/跨重启/跨进程）