# 故障排除

> 常见问题及解决方法。

Source: https://docs.neurosquad.ai/zh/help/troubleshooting

### 运行安装程序时 Windows 提示“Windows protected your PC”

安装程序目前还没有代码签名，所以 SmartScreen 会发出警告。点击 **More info**，确认应用是
`NeuroSquad-Installer.exe`，然后点击 **Run anyway**。请只从我们的[下载页面](https://neurosquad.ai/zh/download/)
下载安装程序。参见[安装](https://docs.neurosquad.ai/zh/getting-started/installation)。

### 在线安装程序提示无法下载 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` 也有一份）。更新失败时，原来的版本仍可正常使用。
参见[如果出了问题](https://docs.neurosquad.ai/zh/getting-started/installation#if-something-goes-wrong)。

### 我安装的智能体显示为“Not found”

打开 **Settings → Harnesses**，点击 **Check again**。还是找不到？彻底退出 NeuroSquad（包括从托盘退出）后重新启动，
或者通过 **Settings → Setup** 安装该智能体。

### 智能体卡片一打开就关闭

试着在你自己的终端里、同一个文件夹中运行同一个智能体。它在那里显示的信息通常就是答案——最常见的原因是还没有登录。

### 我画了箭头，但智能体说它没有工具

- 确认智能体是 Claude Code、Codex CLI 或 Qwen Code。
- 对于智能体之间的箭头，检查方向：**从**主导智能体**指向**助手智能体。
- 让智能体“检查一下你的 NeuroSquad 连接”。

### 智能体在自己的窗口里运行了命令，而不是在我的终端卡片里

在提示词里明确说：*“所有命令都在相连的终端里运行”*。或者开启[画布模式](https://docs.neurosquad.ai/zh/squads/canvas-mode)。

### 浏览器卡片无法启动

第一次使用时，它需要下载一个浏览器。如果下载中断了，前往 **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** 中添加密钥，然后重启该智能体。

### 卡片一多就感觉很卡

每张智能体卡片都是一个正在运行的程序。关掉不再需要的卡片，然后缩小画布——卡片会变成轻量的[概览磁贴](https://docs.neurosquad.ai/zh/canvas/moving-around)。

## 还是没解决？

到 [NeuroSquad 的 Discord 服务器](https://discord.gg/DyKn8cGTc)提问。说明你做了什么、预期是什么、实际发生了什么；附上截图会更有帮助。

## 智能体卡片上显示“未安装 …”

这台电脑上没有该卡片所用的智能体 CLI（或它不在 PATH 中）——例如主导智能体用你没有安装的智能体创建了助手。卡片提供 **安装…**（安装向导）、**选择其他工具**（把这张卡片切换到已安装的工具，保留位置和箭头）和 **重试**（你自行安装后使用，无需重启）。