配置

nsq 无需任何设置即可使用。如需调整，编辑 ~/.neurosquad-cli/config.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`	桌面通知——见通知	`true`
`sound`	每条通知都播放声音	`true`
`detachKey`	退出全屏智能体的按键，`Ctrl+<键>`	`Ctrl+]`
`dictation.enabled`	开启或关闭语音输入——见语音输入	开启
`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`	标准的「不使用颜色」开关，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
`models/`	语音输入模型

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