故障排除
运行安装程序时 Windows 提示“Windows protected your PC”
安装程序目前还没有代码签名，所以 SmartScreen 会发出警告。点击 More info，确认应用是
NeuroSquad-Installer.exe，然后点击 Run anyway。请只从我们的下载页面
下载安装程序。参见安装。
在线安装程序提示无法下载 NeuroSquad
NeuroSquad-Installer.exe 需要访问发布 NeuroSquad 的 github.com。请检查网络连接或代理，然后点击
重试。如果 GitHub 正在限制来自你所在网络的请求，请等几分钟，或直接下载完整安装程序：
https://neurosquad.ai/downloads/NeuroSquad-Setup.exe。SHA-256 校验和不一致的文件，在线安装程序绝不会运行。
它的日志位于 %TEMP%\NeuroSquad-Installer-<日期>.log。
安装失败，或安装程序提示 NeuroSquad 仍在运行
关闭 NeuroSquad（包括托盘中的图标），或点击 结束并继续 让安装程序结束它的进程。其他情况下，失败页面会说明出了什么问题，
完整日志位于 %TEMP%\NeuroSquad-Setup-<日期>.log（安装文件夹中的 install.log 也有一份）。更新失败时，原来的版本仍可正常使用。
参见如果出了问题。
我安装的智能体显示为“Not found”
打开 Settings → Harnesses，点击 Check again。还是找不到？彻底退出 NeuroSquad（包括从托盘退出）后重新启动， 或者通过 Settings → Setup 安装该智能体。
智能体卡片一打开就关闭
试着在你自己的终端里、同一个文件夹中运行同一个智能体。它在那里显示的信息通常就是答案——最常见的原因是还没有登录。
我画了箭头，但智能体说它没有工具
- 确认智能体是 Claude Code、Codex CLI 或 Qwen Code。
- 对于智能体之间的箭头，检查方向：从主导智能体指向助手智能体。
- 让智能体“检查一下你的 NeuroSquad 连接”。
智能体在自己的窗口里运行了命令，而不是在我的终端卡片里
在提示词里明确说：“所有命令都在相连的终端里运行”。或者开启画布模式。
浏览器卡片无法启动
第一次使用时，它需要下载一个浏览器。如果下载中断了，前往 Settings → Browser，点击 Resume download。
语音输入没有反应
- 可能还没有下载语音模型——这时状态栏会显示 Dictation: download the model。在 Settings → Dictation 中下载即可。
- 可能有其他应用占用了同一个快捷键——在 Settings → Dictation 中更换。
- 检查 Windows 是否允许桌面应用使用麦克风（Windows Settings → Privacy & security → Microphone）。
- 如果文字进了剪贴板却没进入智能体，说明当时 NeuroSquad 不是前台窗口——直接粘贴即可。
手机连不上
- 使用 Local network 时，手机必须连在同一个 Wi-Fi 上。试着在 Settings → Remote access 中换一个 Network address。
- 使用快速互联网隧道时，每次 NeuroSquad 启动地址都会变——重新扫码即可。
Usage 什么都不显示
用量读取自 Claude Code、Codex CLI、OpenCode、Hermes Agent、Pi 和 omp 的日志；其他智能体不会被统计。 试试更长的时间段，或点击 Refresh。
Telegram 卡片连不上
粘贴 BotFather 发给你的完整 token，然后给你的机器人发送 /start，并在卡片中点击 Allow。
来自未被允许的聊天的消息会被忽略。
使用 OpenRouter 的智能体却用了我平常的登录
没有保存密钥——智能体的模型标签会变成琥珀色。在 Settings → Providers 中添加密钥，然后重启该智能体。
卡片一多就感觉很卡
每张智能体卡片都是一个正在运行的程序。关掉不再需要的卡片，然后缩小画布——卡片会变成轻量的概览磁贴。
还是没解决？
到 NeuroSquad 的 Discord 服务器提问。说明你做了什么、预期是什么、实际发生了什么；附上截图会更有帮助。
智能体卡片上显示“未安装 …”
这台电脑上没有该卡片所用的智能体 CLI（或它不在 PATH 中）——例如主导智能体用你没有安装的智能体创建了助手。卡片提供 安装…（安装向导）、选择其他工具（把这张卡片切换到已安装的工具，保留位置和箭头）和 重试（你自行安装后使用，无需重启）。