gateway-diagnose

网关诊断

找到出现故障的请求、事件、运行或流程 ID，以及预期行为。从现有证据入手；诊断本身并不授权发送探测消息。

查看当前网关入口点、服务配置以及所有权说明／运行手册。使用 joelclaw gateway --help 查看受支持的状态、事件和诊断命令。探测依赖项前，先确认服务的部署位置；本地集群缺失并不能证明由远程管理的依赖项发生故障。

追踪实际路径：入口流量、持久化队列、策略、网关会话、适配器和投递回执。对比时间戳、关联 ID、进度和配置的超时时间。队列等待时间长本身不能证明 Agent 已挂起。即使依赖项降级，仍可能可以有效诊断通道和会话。

沿着第一个相关故障追查其根因。如果是审计，请报告故障。如果是经授权的修复，请修复该故障并继续诊断其他独立问题。不要仅仅因为第一次探测失败就停止整个任务。

使用已配置的模型、提供方、进程所有者和当前启动源。历史错误字符串只是线索，并不意味着必须恢复旧的内嵌控制器、轮询所有者租约或模型固定配置。

保留唯一的传输和网关所有者。不要启动竞争的轮询器或网关，不要削弱访问控制，不要按名称终止进程，也不要重置共享工作区。获得授权时，使用所有者服务专用的重启或恢复路径。

验证受影响的行为，并报告确切的观察结果。成功提交到队列并不能证明已完成投递。诊断报告中绝不要打印令牌、原始私人消息或身份验证文件。