# Gitea MCP 失败链路发现

- 当前宿主机 `command -v gitea-mcp` 无输出；server.js 已有命令存在性检查，
  缺失时抛出稳定错误码 `gitea_mcp_not_found`。
- runner 在命令检查后创建/复用 Codex App 会话，再通过
  `thread/start.config.mcp_servers.gitea` 注入 stdio MCP；当前没有独立的 MCP
  initialize 预检。
- Codex App `thread/start` 请求超时为 60 秒；如果 MCP 子进程存在但启动后立即
  退出，任务可能等待较久或只在 app-server 事件出现后才失败。
- 队列异常终态会发送一次 `giteabot: 任务失败：...`；正常流程只发送起始的
  `giteabot: 已收到`，最终正文由 MCP/REST 兜底负责。
- 当前工作区存在大量其他代理未提交改动，本轮只改动与 MCP 失败链路直接相关的
  文件和独立测试/文档，禁止 reset 或覆盖无关变更。