跳转到内容

档 2:远端排障

档 2 让 Agent 排查远端或线上类故障,而不是让你 SSH 上去复制日志。

  1. 在桌面端创建或选择目标 Host。
  2. 选择安装方式:生成安装命令后在目标机器执行,或通过 SSH 直推自动安装。
  3. 提供目标服务和日志位置的线索,例如服务名、端口、日志文件、journalctl unit 或启动命令。
  4. 审批 Agent 生成的远端 deployment 和日志来源配置。

生成安装命令时,命令会包含主机身份和 bootstrap 信息,例如 --host-id--transport direct|tunnel--bind-address--port--bootstrap-token--require-auth。如果选择 SSH 直推,桌面端会用该 Host 的 SSH 凭据安装并启动 superdev-agent

写入远端 host_ids 前,Agent 必须先调用 list_hosts。只能使用 is_self=false 的非本机 hosts[].id。展示名、SSH hostname、IP 和用户口头描述都不是稳定 ID。

  • 根据 Host、服务线索和日志线索产出远端 deployment / 日志来源配置,写入前先 preview,需要时等待审批。
  • 继续用 tail_logssearch_logsget_log_context 读取远端日志。
  • diagnose_serviceanalyze_trace_logssummarize_error_window 收集确定性证据。
  • 写出带证据、推理链、置信度和下一步验证的根因说明。

远端排障不是“Agent 让人 SSH 上去 tail”。SuperDev 的价值是让 Agent 和人看到同一套聚合后的运行态证据。