# 配置

> nsq 的设置文件、环境变量，以及它保存数据的位置。

Source: https://docs.neurosquad.ai/zh/cli/configuration

nsq 无需任何设置即可使用。如需调整，编辑 `~/.neurosquad-cli/config.json`（没有就新建一个）。所有字段都是可选的；文件缺失或损坏时使用默认值。

```json
{
  "logos": "auto",
  "notifications": true,
  "sound": true,
  "detachKey": "Ctrl+]",
  "dictation": {
    "enabled": true,
    "hotkey": "CommandOrControl+Shift+Space",
    "mode": "toggle",
    "model": "parakeet-tdt-0.6b-v3"
  }
}
```

| 设置 | 取值 | 默认值 |
| --- | --- | --- |
| `logos` | `auto`、`images`（在能绘制图像的终端里显示真实标志）、`glyphs`（小的彩色徽标）、`neutral`（不使用品牌色） | `auto` |
| `notifications` | 桌面通知——见[通知](https://docs.neurosquad.ai/zh/cli/notifications) | `true` |
| `sound` | 每条通知都播放声音 | `true` |
| `detachKey` | 退出全屏智能体的按键，`Ctrl+<键>` | `Ctrl+]` |
| `dictation.enabled` | 开启或关闭语音输入——见[语音输入](https://docs.neurosquad.ai/zh/cli/dictation) | 开启 |
| `dictation.hotkey` | 全局快捷键，例如 `F9`、`Ctrl+Alt+Space`；`""` 表示不使用 | `CommandOrControl+Shift+Space` |
| `dictation.mode` | `hold`（按住说话）或 `toggle`；不设置时轻按切换、按住录音 | 不设置 |
| `dictation.model` | `parakeet-tdt-0.6b-v3` 或 `whisper-large-v3-turbo` | `parakeet-tdt-0.6b-v3` |

手机访问通过 `nsq phone on|off` 开关，并记录在同一个文件中。

设置在仪表盘和守护进程启动时读取：修改后请重新打开仪表盘；对于守护进程自身的设置（通知、声音），请运行 `nsq down` 再运行 `nsq up`。

## 环境变量

| 变量 | 作用 |
| --- | --- |
| `NSQ_HOME` | 把 nsq 的数据放在 `~/.neurosquad-cli` 以外的地方（不同的目录有各自的守护进程） |
| `OPENROUTER_API_KEY` | 没有系统密钥库时使用的 OpenRouter 密钥 |
| `NSQ_LOGOS` | `images`、`glyphs` 或 `none`——同上面的 `logos` |
| `NSQ_IMAGES=0` | 永不在终端中绘制图像 |
| `NSQ_COLOR` | `truecolor`、`256`、`16` 或 `none`——覆盖自动检测的颜色 |
| `NO_COLOR` | [标准](https://no-color.org)的「不使用颜色」开关，nsq 会遵守 |
| `NSQ_GLYPHS` | `ascii` 或 `unicode`——覆盖自动检测的字符集 |
| `NSQ_AMBIGUOUS_WIDE=1` | 适用于把宽度不明确的字符显示为双宽的终端（部分 CJK 环境） |
| `NSQ_NO_ANIMATION=1` | 不播放动画 |
| `NSQ_ANIMATION=1` | 通过 SSH 时也播放动画（默认在 SSH 中关闭） |
| `NSQ_NO_NOTIFY=1` | 不发送桌面通知（请在启动守护进程的环境中设置） |
| `NSQ_NO_BROWSER=1` | `nsq login` 只打印链接，不自动打开浏览器 |

## nsq 把东西放在哪里

全部位于 `~/.neurosquad-cli`（或 `NSQ_HOME`）中：

| | |
| --- | --- |
| `agents.json` | 你的智能体 |
| `config.json` | 上面的设置 |
| `daemon.log` | 守护进程日志——出问题时首先查看这里 |
| `layers/` | nsq 按智能体传给每个 CLI 的设置 |
| `worktrees/` | 智能体的 [worktree](https://docs.neurosquad.ai/zh/cli/worktrees) |
| `models/` | 语音输入模型 |

机密信息——OpenRouter 密钥和可选的账号登录信息——保存在操作系统的密钥库中，而不在这个文件夹里。