FAQ and Troubleshooting CN

FAQ 与故障排除

Launch

问题	检查
Agent 没启动	CLI 是否安装、app 能否看到 PATH、terminal 选择、workspace 是否存在
打开了错误 terminal	在 Launch 里切换 Terminal selector
Resume 变成新对话	Agent 是否支持 resume，session 是否属于当前 workspace
Launch 按钮切换时闪烁	使用 v0.6.5 或更新版本；早期构建有 selector transition 闪烁

Profiles 与 Models

问题	检查
Provider 提示模型不支持	Upstream model mapping、custom model 拼写、provider plan 是否可用
Claude 发出 deepseek-v4-pro[1m] 之类模型	使用 v0.6.5 或更新版本；suffix normalization 会去掉 Claude 内部后缀
Codex 的 /model 能看到 provider 名称	VibeAround 暴露 description/model list metadata；选中的 fake ID 内部会映射回 provider model
Profile 在一个 Agent 可用，另一个不可用	检查 API type route：Codex 需要 OpenAI Responses，Claude 需要 Anthropic Messages
Claude auth conflict warning	不要同时使用 Claude account token 和 ANTHROPIC_API_KEY，除非明确需要

Channels

问题	检查
Telegram bot 没反应	Token、bot privacy mode、chat permissions
Discord bot 没反应	Message Content Intent、是否 mention bot、server permissions
Slack command 不识别	使用 /va ...，检查 Socket Mode app token 和 slash command 配置
微信二维码过期	重启 channel/plugin 并重新扫码
频道输出太啰嗦	关闭 verbose.show_thinking 和 verbose.show_tool_use

Web 与 Tunnel

问题	检查
127.0.0.1:12358/va/ 打不开	Runtime process、端口冲突、app logs
公网 URL 要 pairing	正常行为；通过已连接频道发送 pairing code
反复 pairing	浏览器 cookies 被阻止或过期
Preview link 过期	让 Agent 重新创建 preview

Packaging

问题	检查
macOS 提示 app damaged	Quarantine/signing/notarization 状态
Windows installer 被拦截	Code signing 和 SmartScreen reputation
Linux AppImage 无法运行	FUSE/AppImage dependencies

Logs 和 Settings 在哪里

主要本地状态在：

~/.vibearound/

常用文件：

• settings.json
• profiles/*.json
• plugin install directories
• auth/pairing state

不要在 public issue 里贴 API keys 或 channel tokens。