IFox9Browser
AI 连接与任务故障排查
处理连接、环境控制权和页面过期错误，不通过操作其他环境来绕过问题。
AI 客户端没有 IFox9 工具
确认 IFox9 保持运行、目标客户端已检测并配置、AI 客户端已经重启，并检查客户端是否要求允许 MCP 服务。在 API & MCP 中测试连接。不要为了修复连接而开放公网接口或重新生成签名证书。
常见错误码
| 错误码 | 建议处理 |
|---|---|
UNAUTHORIZED | 核对当前本地 API 令牌；轮换后更新旧令牌。 |
INVALID_ARGUMENT | 按工具当前输入 schema 补齐或纠正参数。 |
PROFILE_NOT_FOUND | 重新列出环境，选择可访问的准确环境。 |
SESSION_NOT_FOUND / STALE_BROWSER_SESSION | 重新打开选定环境，获取新的会话和页面 ID。 |
PAGE_NOT_FOUND | 重新列出页面，按目标 URL 和标题匹配。 |
STALE_SNAPSHOT | 获取新快照，不再复用旧元素引用。 |
LEASE_CONFLICT | 其他客户端正在控制该环境。请其释放或等待，不要擅自改用其他环境。 |
BROWSER_MODE_MISMATCH | 保留当前模式，或经批准后停止并按目标模式重新打开。 |
任务等待人工输入
登录、验证码、通行密钥或设备批准可能需要可视模式，请用户完成验证。不要悄悄重启环境切换模式；重新打开会改变会话 ID，也可能中断工作。
下载或上传失败
先用 browser_prepare_download 准备下载，再执行触发动作，通过 browser_wait_download 获取结果。检查 Downloads/IFox9 MCP、磁盘空间和文件权限。上传应选择允许目录中的文件。收到真实结果后才能确认成功。
反馈问题时提供什么
提供 IFox9 版本、操作系统、AI 客户端及版本、可视或无界面模式、准确错误码，以及使用非敏感环境复现的简短步骤。隐去令牌、凭据、Cookie、私人页面内容和文件路径。联系 IFox9 支持。