档 2:远端排障
档 2:远端排障
Section titled “档 2:远端排障”档 2 让 Agent 排查远端或线上类故障,而不是让你 SSH 上去复制日志。
你提供/确认
Section titled “你提供/确认”- 在桌面端创建或选择目标 Host。
- 选择安装方式:生成安装命令后在目标机器执行,或通过 SSH 直推自动安装。
- 提供目标服务和日志位置的线索,例如服务名、端口、日志文件、journalctl unit 或启动命令。
- 审批 Agent 生成的远端 deployment 和日志来源配置。
生成安装命令时,命令会包含主机身份和 bootstrap 信息,例如 --host-id、--transport direct|tunnel、--bind-address、--port、--bootstrap-token、--require-auth。如果选择 SSH 直推,桌面端会用该 Host 的 SSH 凭据安装并启动 superdev-agent。
host_ids 纪律
Section titled “host_ids 纪律”写入远端 host_ids 前,Agent 必须先调用 list_hosts。只能使用 is_self=false 的非本机 hosts[].id。展示名、SSH hostname、IP 和用户口头描述都不是稳定 ID。
Agent 会自己做什么
Section titled “Agent 会自己做什么”- 根据 Host、服务线索和日志线索产出远端 deployment / 日志来源配置,写入前先 preview,需要时等待审批。
- 继续用
tail_logs、search_logs、get_log_context读取远端日志。 - 用
diagnose_service、analyze_trace_logs、summarize_error_window收集确定性证据。 - 写出带证据、推理链、置信度和下一步验证的根因说明。
远端排障不是“Agent 让人 SSH 上去 tail”。SuperDev 的价值是让 Agent 和人看到同一套聚合后的运行态证据。