国庆假期我干了件事：让 Agent 平时睡大觉，数据一变就醒来干活 - 张善友
内容提要
作者国庆七天写代码完成两件事：为 OpenClaw.NET 提交 PR #274，给 MetaSkill 增加幂等直调 API；新开项目 DrasiWake，将 Drasi 感知的数据变化转化为 Agent 会话唤醒。两者拼合实现“数据变了→Agent 被叫醒→恰好执行一次→故障可收场”的闭环，即环境式 Agent。核心工程手段包括幂等键、调用账本、uncertain 状态、outbox、对账、死信和启动期配置校验，强调诚实与可靠性。
延伸解读
幂等键与账本：重试不再赌博
文章通过 PR #274 为 OpenClaw.NET 网关引入 Idempotency-Key 和调用账本，解决了重试可能导致工作流重复执行的问题。账本记录请求哈希和状态，进程重启后能接管未完成调用。这提醒我们，在分布式系统中，幂等设计是避免副作用重复的关键，而账本保留时长（RetentionDays）需与上游重试窗口匹配，否则可能误判重放。
uncertain 状态：诚实面对结果不明
作者将“不确定”建模为一等公民，显式定义 uncertain 状态。当网关在可能已执行但未确认的窗口期崩溃时，调用方会收到冲突响应，而非假装成功或失败。这避免了贸然重试导致重复执行。文章还提到顺序和诚实细节：审计日志需在账本标记完成前持久化，若完成状态写库失败，响应会带持久化警告。这种对不确定性的诚实处理，是可靠系统的基石。
状态同步而非事件溯源：DrasiWake 的收敛思路
DrasiWake 将 Drasi 的 attach 通知视为提示而非持久化事件日志，因此启动恢复、重连、对账和队列溢出时都重新读取当前 results。未派发的唤醒若被更新快照取代，则标记为 Superseded。这体现了状态同步思路：追求收敛到最新真相，而非不重不漏地消费每条变化。对于“叫醒 Agent”场景，这种选型更务实，因为 Agent 醒来看的是最新状态。
启动期配置校验：把跨系统漂移的雷提前引爆
文章指出，网关的幂等账本保留时长（RetentionDays）必须覆盖桥接层所有绑定的最大重试窗口（retry.maxAgeSeconds），否则账本过期后重试会被误判为新调用，导致工作流重复执行。DrasiWake 在启动时硬校验这一条件，不满足则拒绝启动。这种“宁可起不来，不带病上岗”的做法，将跨系统配置漂移的风险提前暴露，避免了运行时事故。
Q&A
什么是环境式 Agent（Ambient Agent）？它和普通 Agent 有什么区别？
环境式 Agent 是一种让 Agent 平时静默、当环境发生值得关注的变化时才被唤醒的架构。与普通 Agent 的“请求—响应”模式不同，它不需要人主动喊它，而是由数据变化触发，干完活后继续休眠。
OpenClaw.NET PR #274 主要解决了什么问题？
PR #274 为 OpenClaw.NET 网关增加了幂等直调 API，解决了桥接层在发送唤醒时可能因崩溃导致重复执行或丢失变化的问题。它通过 Idempotency-Key、调用账本和 uncertain 状态，确保重试安全且结果不明时如实告知上游。
DrasiWake 项目是做什么的？它的核心设计思路是什么？
DrasiWake 是一个独立的 .NET 10 Host，负责将 Drasi 感知到的数据变化翻译成 Agent 会话的唤醒。它的核心思路是“状态同步”而非“事件溯源”：启动恢复、重连、定期对账都重新读取 Drasi 的当前结果集，追求收敛到最新真相，而不是不重不漏地消费每条中间变化。
为什么 DrasiWake 要把“不确定”建模成一等公民？
因为当网关在“可能已执行但未确认”的窗口期崩溃时，调用方看到的不应是成功或失败，而是“不知道”。贸然重试可能导致工作流执行两遍，所以 PR #274 显式定义了 uncertain 状态，配合冲突响应，把结果不明如实告诉上游。
DrasiWake 如何防止跨系统配置漂移导致的事故？
DrasiWake 在启动时逐目标硬校验：网关的幂等保留时长（Gateway.MetaInvocations.RetentionDays）必须覆盖引用它的所有绑定的最大重试窗口（retry.maxAgeSeconds）。不满足则拒绝启动，宁可起不来也不带病上岗。
DrasiWake 的遥测设计有哪些隐私保护措施？
所有标识符都是 SHA-256 派生的短 ID；事实数据、Bearer 凭据、幂等键、原始会话标识一律不进 tag；日志只记固定错误类别和哈希过的查询标识，不记异常消息和载荷内容；默认配置不接 exporter，不主动配就不会发送任何数据。
为什么 DrasiWake 测试全绿了还不宣布 V1-ready？
因为本地 fixture 全绿只证明实现与测试约定一致，而部署环境使用真实版本、真实配置、真实网络，是另一份契约。作者要求在自己的环境里跑通三个真实服务检查并记录结果之前，V1-ready 门禁保持关闭，认为没验证就说 ready 是对用户不诚实。
