# NeuroSquad Docs

> NeuroSquad 是一款适用于 Windows 和 macOS 的免费桌面应用，可以把 AI 编程智能体的命令行工具——Claude Code、Codex CLI、Gemini CLI、OpenCode 以及另外 15 个——作为实时终端卡片并排运行在同一张画布或网格中。从智能体画一条箭头到另一张卡片，智能体就获得那张卡片的工具：浏览器、终端、笔记、MCP 服务器或另一个智能体。智能体完成或需要你回应时它会提醒你，可以从手机操作，并精确显示每个智能体的花费。这里是它的用户指南。

- 下载 Windows 或 macOS 版: https://neurosquad.ai/zh/download/
- 产品网站（关键信息、常见问题、智能体命令行工具、插件、更新日志）: https://neurosquad.ai/zh/llms.txt

整份指南合为一个文件: https://docs.neurosquad.ai/zh/llms-full.txt

每个页面也提供纯 Markdown 版本：在地址后加 `.md`（例如 /zh/canvas/arrows.md）。

## 快速入门

- [NeuroSquad 是什么](https://docs.neurosquad.ai/zh/getting-started.md): 用两分钟了解 NeuroSquad 能做什么，以及它背后的几个核心理念。
- [安装](https://docs.neurosquad.ai/zh/getting-started/installation.md): 下载 Windows 版 NeuroSquad 安装程序，选好安装位置，其余一切交给首次运行的设置向导。
- [在 macOS 上安装](https://docs.neurosquad.ai/zh/getting-started/macos.md): 在 Apple 芯片或 Intel 的 Mac 上安装 NeuroSquad——在终端里一行命令，或者用 .dmg——以及首次打开时 macOS 会询问什么。
- [账号与登录](https://docs.neurosquad.ai/zh/getting-started/account.md): NeuroSquad 为什么需要登录、应用内如何登录、套餐与设备、离线使用，以及应用到底发送哪些使用统计。
- [你的第一个工作区](https://docs.neurosquad.ai/zh/getting-started/first-workspace.md): 为项目文件夹创建一个工作区，或者先打开现成的演示工作区和 Launch day 工作区四处看看。
- [你的第一个智能体](https://docs.neurosquad.ai/zh/getting-started/first-agent.md): 添加一张智能体卡片，发送你的第一条提示词，并在它完成时收到通知。
- [熟悉界面](https://docs.neurosquad.ai/zh/getting-started/the-window.md): 侧边栏及其五个分区、画布、顶栏和状态栏——各部分分别在哪里。

## 画布

- [画布基础](https://docs.neurosquad.ai/zh/canvas.md): 画布是一块无限延伸的白板，你的智能体和它们的工具以卡片的形式存在于其上。
- [添加与排列卡片](https://docs.neurosquad.ai/zh/canvas/cards.md): 如何在画布上添加、移动、调整大小、重命名、选择和删除卡片。
- [箭头赋予能力](https://docs.neurosquad.ai/zh/canvas/arrows.md): 从智能体向另一张卡片画一条箭头，智能体就能使用那张卡片。
- [网格模式](https://docs.neurosquad.ai/zh/canvas/grid-mode.md): 让智能体在整齐、可调整大小的网格中并排显示——随时切回画布。
- [分组](https://docs.neurosquad.ai/zh/canvas/groups.md): 把相关的卡片放进一个带名称、带颜色的框里，一键缩放到它。
- [缩放、平移与撤销](https://docs.neurosquad.ai/zh/canvas/moving-around.md): 在大画布中移动、缩小时的概览磁贴，以及撤销布局更改。
- [画布工具](https://docs.neurosquad.ai/zh/canvas/tools.md): 对齐参考线与吸附、小地图、颜色标签、演示模式、吉祥物、箭头日志和工作区模板。

## 智能体

- [支持的智能体](https://docs.neurosquad.ai/zh/agents.md): NeuroSquad 能运行哪些 AI 编程智能体，以及各自支持哪些功能。
- [已完成 / 需要你的输入](https://docs.neurosquad.ai/zh/agents/notifications.md): NeuroSquad 如何告诉你某个智能体已完成，或正在等你回答。
- [给智能体分配任务](https://docs.neurosquad.ai/zh/agents/tasks.md): 把看板上的任务分配给特定的智能体，并让它们自行领取下一个任务。
- [提示词队列与每日提示词](https://docs.neurosquad.ai/zh/agents/queue.md): 为忙碌的智能体排好接下来的提示词，或每天发送同一条提示词。
- [角色](https://docs.neurosquad.ai/zh/agents/roles.md): 一键给智能体一份工作说明——评审者、测试者、研究者等。
- [长时间会话](https://docs.neurosquad.ai/zh/agents/long-sessions.md): 关注上下文、压缩上下文、在用量上限后自动继续、交接给新的智能体，以及记录工作日志。
- [统一的指令文件](https://docs.neurosquad.ai/zh/agents/instructions.md): 在 AGENTS.md 中写一次项目指令，所有智能体都能读到。
- [隔离的工作树](https://docs.neurosquad.ai/zh/agents/worktrees.md): 给智能体一份独立的项目副本，让多个智能体互不干扰对方的修改——并添加一个使用不同 AI 的评审者。
- [危险模式](https://docs.neurosquad.ai/zh/agents/dangerous-mode.md): 让智能体无需停下来请求许可就能工作——以及什么时候不该这样做。
- [智能体卡片详解](https://docs.neurosquad.ai/zh/agents/card-menu.md): 智能体卡片的标题栏及其 ⋯ 菜单，逐项说明。

## 卡片

- [全部卡片](https://docs.neurosquad.ai/zh/cards.md): 你可以放到画布上的每一种卡片，以及它们各自的用途。
- [终端](https://docs.neurosquad.ai/zh/cards/terminal.md): 画布上的真实 shell——供你使用，也可供智能体在其中运行命令。
- [浏览器](https://docs.neurosquad.ai/zh/cards/browser.md): 画布上的真实浏览器，智能体可以看见并使用它。
- [笔记](https://docs.neurosquad.ai/zh/cards/note.md): Markdown 共享笔记——你和智能体共用。
- [待办清单](https://docs.neurosquad.ai/zh/cards/todo.md): 你和智能体一起保持更新的清单。
- [任务看板](https://docs.neurosquad.ai/zh/cards/kanban.md): 为你的小队准备的看板——把每个任务分配给一个智能体，让下一个任务自动开始。
- [便签](https://docs.neurosquad.ai/zh/cards/sticky.md): 用醒目的标题和标签来组织和说明你的画布。
- [专注计时器](https://docs.neurosquad.ai/zh/cards/flow-timer.md): 一个专注计时器，在专注时段结束前暂缓智能体的“已完成”提醒。
- [参考资料](https://docs.neurosquad.ai/zh/cards/reference.md): 希望智能体随时参考的链接、图片、PDF 和文件夹。
- [开发服务器](https://docs.neurosquad.ai/zh/cards/dev-servers.md): 列出你电脑上正在运行的所有开发服务器——一键在浏览器卡片中打开。
- [预算](https://docs.neurosquad.ai/zh/cards/budget.md): 为整个工作区设置 token 上限，超出时暂停其中的智能体。
- [网页监视](https://docs.neurosquad.ai/zh/cards/web-watch.md): 监视一个网页，在它发生变化时通知你的智能体。
- [站会](https://docs.neurosquad.ai/zh/cards/standup.md): 每日摘要，汇总工作区中每个智能体今天做了什么。

## 智能体小队

- [什么是智能体小队](https://docs.neurosquad.ai/zh/squads.md): 多个智能体在同一张画布上协同工作，由箭头相连。
- [负责分派任务的主导智能体](https://docs.neurosquad.ai/zh/squads/lead-agent.md): 让一个智能体把任务交给其他智能体，并收集它们的回答。
- [卡片模式](https://docs.neurosquad.ai/zh/squads/canvas-mode.md): 智能体通过卡片工作——它会自己打开终端、浏览器、笔记和助手智能体。
- [小队配方](https://docs.neurosquad.ai/zh/squads/recipes.md): 可以直接照搬到画布上的现成小队配置。

## 远程访问

- [手机上的智能体](https://docs.neurosquad.ai/zh/remote.md): 在手机上查看和操控 NeuroSquad——无论在家还是在外。
- [配对手机](https://docs.neurosquad.ai/zh/remote/pairing.md): 打开远程访问，用手机扫描二维码。
- [不在家时](https://docs.neurosquad.ai/zh/remote/internet.md): 通过免费的 Cloudflare 隧道，在移动数据或其他网络下访问 NeuroSquad。
- [在手机上能做什么](https://docs.neurosquad.ai/zh/remote/on-the-phone.md): 工作区、智能体实时屏幕、提示词、新卡片和提醒——都能在手机上完成。

## 语音输入

- [用说话代替打字](https://docs.neurosquad.ai/zh/dictation.md): 按下快捷键，开口说话，你的话就会变成文字——全程在你自己的电脑上处理。
- [语音模型](https://docs.neurosquad.ai/zh/dictation/models.md): 在默认语音模型和更大、更准确的模型之间进行选择。
- [语音输入历史](https://docs.neurosquad.ai/zh/dictation/history.md): 你口述过的所有内容都在侧边面板里，随时可以再次复制。

## 概览

- [用量与费用](https://docs.neurosquad.ai/zh/usage.md): 精确查看智能体用了多少 token、花了多少钱——按智能体、工作区、智能体类型、模型和提供商分类。

## 模型提供商

- [概述](https://docs.neurosquad.ai/zh/providers.md): 选择每个智能体运行在哪个 AI 模型上——使用你自己的登录，或通过 OpenRouter 这样的提供商。
- [OpenRouter](https://docs.neurosquad.ai/zh/providers/openrouter.md): 用一个 OpenRouter 密钥，让 Claude Code、Codex CLI、OpenCode、Kilo Code、Qwen Code、Gemini CLI、GitHub Copilot CLI、Hermes Agent、Pi、omp、Factory Droid 或 Crush 运行在数百个模型上。
- [CLI 账号](https://docs.neurosquad.ai/zh/providers/accounts.md): 并排保留多个 Claude Code 或 Codex 登录，查看每个套餐的限额用了多少，一键在另一个账号上继续工作。

## 集成

- [概述](https://docs.neurosquad.ai/zh/integrations.md): 把你的智能体连接到 Telegram，以及已保存的 token 和密钥是如何存放的。
- [Telegram 机器人](https://docs.neurosquad.ai/zh/integrations/telegram.md): 在 Telegram 中给智能体发消息并收到它们的回复——它们完成时还会提醒你。

## 技能与 MCP

- [概览](https://docs.neurosquad.ai/zh/skills-mcp.md): 来自 skills.sh 的技能和任意 MCP 服务器的工具——安装一次，用箭头交给指定的智能体。
- [目录与安装](https://docs.neurosquad.ai/zh/skills-mcp/catalog.md): 搜索 MCP Registry 和 skills.sh，看清将要运行的内容，把服务器和技能安装到 NeuroSquad 自己的文件夹。
- [交给智能体](https://docs.neurosquad.ai/zh/skills-mcp/cards.md): MCP 服务器卡片和技能卡片——用箭头连到智能体；只有连上的智能体才能获得。

## 插件

- [概览](https://docs.neurosquad.ai/zh/plugins.md): 内置的附加功能，用箭头连接到智能体即可使用——无需重启，也不改动 CLI 自身的设置。
- [RTK-AI Token Saver](https://docs.neurosquad.ai/zh/plugins/rtk-ai-token-saver.md): 把智能体连接到它，它的 git、ls、grep 和测试命令的输出就会被压缩——token 更少，事实不变。
- [Caveman](https://docs.neurosquad.ai/zh/plugins/caveman.md): 把智能体连接到它，回答就会变短——没有废话，代码、命令和错误信息保持原样。
- [记忆 (mem0)](https://docs.neurosquad.ai/zh/plugins/mem0-memory.md): 智能体跨会话共享的长期记忆：它们保存事实和决定，之后再回忆起来。保存在你的电脑上。
- [Context7 — 最新文档](https://docs.neurosquad.ai/zh/plugins/context7-docs.md): 把智能体连接到它，智能体就会查阅所用库的最新、匹配版本的文档，而不是依赖训练时记住的内容。
- [代码图谱](https://docs.neurosquad.ai/zh/plugins/code-graph.md): 把智能体连接到它，智能体就能按结构找代码——谁调用了某个函数、它又调用了什么、某个符号在哪里定义——而不是一遍遍 grep、一个个读文件。
- [Graphify](https://docs.neurosquad.ai/zh/plugins/graphify.md): 代码结构的实时地图。已连接的智能体向它提出结构性问题而不是 grep，每次查询都会在地图上实时亮起。

## 概览

- [设置](https://docs.neurosquad.ai/zh/settings.md): NeuroSquad 设置中可以调整的内容，逐节说明。

## 卡片 SDK

- [概览](https://docs.neurosquad.ai/zh/card-sdk.md): 为 NeuroSquad 画布开发你自己的卡片——能观察并指挥智能体、通过箭头交换数据、为智能体提供新工具的小型 Web 应用——并在 GitHub 上分享。
- [安装社区卡片](https://docs.neurosquad.ai/zh/card-sdk/community-cards.md): 什么是社区卡片，如何从 GitHub 安装，如何读懂权限对话框，以及如何更新、关闭、撤销权限或移除卡片。
- [已验证卡片](https://docs.neurosquad.ai/zh/card-sdk/verified-cards.md): 经 NeuroSquad 团队审核的社区卡片列表——在哪里找到它、Verified 徽章代表什么又不代表什么、已验证更新如何工作，以及作者如何提交卡片审核。
- [快速上手](https://docs.neurosquad.ai/zh/card-sdk/quick-start.md): 用模板创建卡片，在 NeuroSquad 中实时运行并热重载，发布到 GitHub，再从那里安装。
- [清单文件参考](https://docs.neurosquad.ai/zh/card-sdk/manifest.md): neurosquad-card.json 的每个字段——身份信息、大小、权限、设置表单、端口和工具——以及应用会检查的规则。
- [权限](https://docs.neurosquad.ai/zh/card-sdk/permissions.md): 卡片的十三项权限——每项的风险、用户在安装时看到的原话、它解锁的能力，以及应用强制执行的范围规则。
- [connect() 与卡片对象](https://docs.neurosquad.ai/zh/card-sdk/api.md): 把卡片连接到 NeuroSquad、类型化的 Card 对象、它实时更新的上下文，以及调用任意方法、监听任意事件。
- [卡片外框与对话框](https://docs.neurosquad.ai/zh/card-sdk/api/card-ui.md): 卡片的标题栏——标题、状态、徽章——概览图块、提醒、调整大小、链接、镜头聚焦和创建卡片；提示条、确认对话框和卡片菜单。
- [存储与设置](https://docs.neurosquad.ai/zh/card-sdk/api/storage-settings.md): 按卡片和按卡片包的持久化键值存储，以及读取和修改应用根据清单绘制的设置表单。
- [主题、语言与生命周期](https://docs.neurosquad.ai/zh/card-sdk/api/environment.md): 实时跟随应用的主题和语言、可见性与暂停、工作区、运行时申请可选权限，以及卡片日志。
- [智能体与终端](https://docs.neurosquad.ai/zh/card-sdk/api/agents.md): 列出智能体及其实时状态、轮次事件、读取相连智能体的屏幕、发送提示词，以及在相连终端中运行命令。
- [端口：卡片之间的通信](https://docs.neurosquad.ai/zh/card-sdk/api/ports.md): 通过箭头的类型化输入和输出——知名类型和你自己用 JSON Schema 定义的类型、emit、send、请求/响应、保留值、探查相连卡片接收什么，以及内置笔记、待办清单、任务看板、便签、智能体和终端的端口。
- [给智能体的工具（MCP）](https://docs.neurosquad.ai/zh/card-sdk/api/tools.md): 在清单中声明工具、在卡片中实现它，让相连的智能体通过 NeuroSquad 的 MCP 服务器调用——结果、图片、错误、进度、取消和超时。
- [网络](https://docs.neurosquad.ai/zh/card-sdk/api/network.md): card.net.fetch——经由 NeuroSquad 代理访问卡片声明过的主机：JSON、二进制和流式响应、请求头中的密钥、重定向与限制。
- [文件、剪贴板与用量](https://docs.neurosquad.ai/zh/card-sdk/api/files.md): 读取、写入、列出和监视工作区文件夹中的文件；复制到剪贴板；工作区的令牌用量和费用。
- [错误与限制](https://docs.neurosquad.ai/zh/card-sdk/api/errors.md): CardSdkError 和每个错误码、各自的成因与应对方法，以及卡片协议的全部限制一览表。
- [React 绑定](https://docs.neurosquad.ai/zh/card-sdk/react.md): CardProvider 以及 @neurosquad/card-sdk/react 的各种 hook——上下文、设置、存储、智能体、端口、工具、主题、语言和可见性。
- [UI 套件与样式](https://docs.neurosquad.ai/zh/card-sdk/styling.md): 随心所欲地设计卡片样式，或借助基于应用实时主题的可选 ui.css 套件呈现原生外观——类名、变量，以及沙箱对样式、字体和图片的规则。
- [用模拟宿主测试](https://docs.neurosquad.ai/zh/card-sdk/testing.md): createMockHost——一个在内存中运行的 NeuroSquad，执行与应用相同的检查，记录你的卡片做过的事，并能在测试或浏览器预览中驱动它。
- [CLI 参考](https://docs.neurosquad.ai/zh/card-sdk/cli.md): neurosquad-card 的 create、dev、validate 和 pack——每个参数、每个命令检查什么，以及开发链接如何找到应用。
- [发布与更新](https://docs.neurosquad.ai/zh/card-sdk/publishing.md): 在 GitHub 上分享卡片、用户可以用哪些地址安装、安装如何锁定、更新如何送达用户以及何时需要再次同意，还有卡片与协议的版本管理。
- [安全检查清单](https://docs.neurosquad.ai/zh/card-sdk/security.md): 沙箱已经保证了什么，以及作者在分享卡片前要过一遍的检查清单——最小权限、提示词注入、密钥、网络、文件、命令和更新。
- [在手机上](https://docs.neurosquad.ai/zh/card-sdk/phone.md): 使用远程访问时自定义卡片如何显示——只有标题栏和概览图块，代码在电脑上运行——以及这对卡片设计意味着什么。
- [常见问题与排错](https://docs.neurosquad.ai/zh/card-sdk/faq.md): 面向卡片用户和作者的解答，以及常见错误的修复方法——卡片连接不上、脚本被拦截、安装后文件缺失、权限与箭头错误、速率限制。

## 帮助

- [概览](https://docs.neurosquad.ai/zh/help.md): 解答、解决方法、快捷键，以及你的数据存放在哪里。
- [常见问题](https://docs.neurosquad.ai/zh/help/faq.md): 大家最常问的问题，快速解答。
- [故障排除](https://docs.neurosquad.ai/zh/help/troubleshooting.md): 常见问题及解决方法。
- [键盘快捷键](https://docs.neurosquad.ai/zh/help/shortcuts.md): NeuroSquad 中的所有键盘快捷键。
- [你的数据存放在哪里](https://docs.neurosquad.ai/zh/help/data.md): NeuroSquad 在你的电脑上保存了什么、存放在哪里，以及如何备份或重置。
- [面向 AI 助手的文档](https://docs.neurosquad.ai/zh/help/ai-assistants.md): 把这份文档交给 ChatGPT、Claude 或卡片中的编程智能体——每个页面都有纯 Markdown 版本，还有单文件目录。

## 其他语言

- en: https://docs.neurosquad.ai/llms.txt
- ru: https://docs.neurosquad.ai/ru/llms.txt