故障排除

应用打不开（macOS）

「无法验证开发者」或类似提示 → 「系统设置 → 隐私与安全性」允许；或对 Swiflow.app 右键 → 打开。

模型调用失败

1. 设置 → Agent：核对 API Base、Key、模型名
2. 本机能否访问该 API（公司代理 / 地域限制）
3. 额度或模型名是否有效

搜索没结果

设置里换搜索 Provider；大陆可试 Bing（浏览器），并启用 Browser 工具。

轻应用起不来

• python 类型：关于页安装 Python+UV，看轻应用日志
• 依赖缺失：在对话里让 Agent 修依赖或改实现

MCP 连不上

1. 类型是否匹配（stdio / sse / streamable）
2. stdio：终端能否跑通同一条 uvx/npx 命令
3. 保存后点 Reload；看 capabilities 是否有工具
4. 首次拉包失败多半是网络——换镜像或代理后再试

exec / browser 提示禁用

Tools 里打开对应开关；若仍禁用，检查服务配置里的 exec_enabled / browser_enabled（自托管 config.json）。

Docker 里浏览器异常

加 --shm-size=256m（或使用仓库 compose）。

还不行

关于页打开日志目录，带着报错片段到 GitHub Issues 反馈。