排障
按层排查安装、Launch、Profile、Handover、Channel 和 Preview 问题。
文档提示:当前文档全部由 Codex 生成,正在积极审阅、扩充和优化中。
排查 VibeAround 时,最好先隔离每一层。先验证最简单的本地路径,再逐步加入 Profile、远程访问、Channel 和 Preview。
安装问题
检查:
- 是否下载了适合当前平台的安装包。
- App 是否可以打开。
- 本地安全提示或系统权限是否已处理。
- VibeAround 本地数据目录是否可写。
- 安装版本是否符合预期。
Agent Launch 问题
检查:
- Agent 是否能在 VibeAround 外部运行。
- Workspace 路径是否存在。
- 选中的 Terminal mode 是否可用。
- Provider Profile 是否有效。
- 历史 Session 是否仍有可恢复状态。
Provider Profile 问题
检查:
- API key 或凭据值。
- Base URL。
- API shape。
- Model name 和 alias。
- Provider region。
- Streaming 或 tool-call 支持。
- Provider error body。
Remote 或 Handover 问题
检查:
- 本地 runtime 是否在线。
- Session 是否仍然存在。
- 当前入口是否已经 pairing 或授权。
- Tunnel 是否只在需要时启用。
- Workspace 是否仍可访问。
Channel 问题
检查 plugin status、channel credentials、bot permissions、workspace binding、command prefix behavior,以及谁被允许发送消息。
Preview 问题
检查目标是否存在、dev server 是否运行、preview link 是 owner-only 还是 shared、是否需要 Tunnel,以及链接是否已过期。