Rabi 消息投递与排障

先选正式入口

通用接口由 Manager 持有：Agent 会话操作使用 /api/agent/threads，消息端发送使用 /api/agent/send，健康与业务状态使用当前 Manager 受管 GET。先读取 接口合同。宿主提供正式工具时优先使用，工具名和参数映射由宿主适配技能说明；不要求所有 Agent 都安装 DSH 插件。

普通子 Agent 工具不能代替受管的跨宿主会话投递。缺少工具时使用该宿主已支持的正式 Manager 传输；没有合法入口则报告具体缺失，不猜测工具名、不绕过权限、不换宿主或另建任务。

排障顺序

1. 先区分用户要“检查为什么失败”还是“发送这段消息”。排障授权不等于发送测试消息、修改绑定、创建会话或重启宿主的授权。
2. 通过当前 Host 动态发现 Manager，并使用受管入口的 GET /meta 核对。不得抄用技能、旧对话或日志里的历史端口；不得用近期记忆读取充当健康探针。
3. 先读当前工具说明与 Manager 接口合同；调用 /api/agent/help 后检查 contractLevel 与 coverage.missing，发送还要读取 /api/agent/send/capabilities。baseline 不是精确 schema，缺失字段必须读取专用 contractResource；再通过 /api/agent/threads 的只读操作查询目标宿主、会话、绑定和可投递状态。工具参数以当前合同为准，不编造操作名或 JSON 字段。
4. 使用完整目标会话 ID 定位；标题、工作目录和时间只能辅助核对。明确区分“直接投递给指定 Agent 会话”和“外部消息按 Route 绑定转发”，不能仅凭 Route 未绑定就断定所有投递方式都失败。
5. 根据正式返回区分：Manager 不可达、适配器不支持、目标不存在、绑定缺失、会话不可投递、鉴权失败、投递被拒、结果未知。只读查询成功不能证明消息已经送达。
6. 正式返回仍不能解释问题时，才定位对应实现、配置或日志。先确认实际运行版本和源码位置，只检查与错误相关的路径；本地文件不代替 Manager 权威状态，不直接修改业务 JSON。
7. WorkBuddy 的 Hook 正常不代表消息通道正常；会话存在也不代表可投递。以 Manager 当前返回的存活、心跳、端点与会话类型等状态为证据，不凭旧截图推断。

帮助响应中的 catalogDigest 与 channelsDigest 只用于比较完整目录或渠道描述是否变化；筛选响应的 catalogDigest 仍属于完整目录。摘要相同不代表权限、Agent 启停、对象状态或 Manager 身份不变，也不能把 baseline 升格为 verified。切代或合同错误后仍重新发现并核验 /meta，不凭摘要省略回执读回。

正式投递与回复

• 发送前确认目标及正文属于用户请求；目标有歧义时等待用户明确，不猜选、不新建替代会话。
• Agent 间投递填写完整来源会话 ID、来源 Agent 类型及 responsePolicy；要求回复时填写 responseInstruction。来源不能取目标 ID 或由标题猜测。
• 插件向 Manager 只传 messageSource，来源会话必须与 sourceThreadId 一致；遵守当前接口对来源字段的定义。
• 正式回复填写 inReplyToRequestId、result 和 nextAction，关联原请求；最终聊天文字不算正式回复已投递。
• 存储写入前读取现行接口合同，使用稳定 Idempotency-Key 和适用的强 ETag If-Match；校验 HTTP 状态、回显键、ETag、资源身份及 uncertain。
• 超时、503、写后切代或结果不确定：保留原键和正文，先权威读回，不自动重发。412：重新读取并确认原意，再用新键与新 ETag。
• 分开报告“Manager 已接受”“目标已收到”“目标已完成回复”。消息端发送必须取得 Manager 与渠道回执；没有对应证据不宣称该阶段成功。

触发示例与范围

• “就是 rabi 没法投递消息到 workbuddy 的问题” → 本技能；先健康核对与只读会话检查，不先搜源码、不先发测试消息。
• “让 Rabi 把这段话发给 DSH 的指定会话” → 本技能；核对目标和来源后走正式投递工具。
• “向 QQ 群发送这段话” → 本技能选择消息端入口，并按 QQ 专项技能核对收件目标。
• “给 Rabi 新增一种 Agent 宿主” → Agent 适配器接入技能，不把未实现能力当普通绑定问题。
• “当前 Codex 使用某个人格” → use-rabi-codex-context，不属于跨会话消息投递。

验收边界

技能被发现、可加载、描述覆盖请求，只能证明入口已就位；不能证明模型每次都会命中，也不能证明真实投递已修复。真实投递验收需要明确的目标、获授权的正文及正式回执。技能检查不启动该验收。