快速开始
如果你只想尽快把 Mind 跑起来，不需要先把所有专题正文看完。
按这条路径走就够了：先确认环境，再发一条最小命令，最后再决定是否进入交互式、星图协议或订阅。
确认命令入口
先用 mind --help 确认 CLI 可用；需要 Helix MCP 时再显式加 --mcp。
安装 CLI 并准备终端
优先用 npm 全局安装；如果使用安装包，再把 Mind/MindEngine 目录加入 PATH。
先跑通，再决定怎么继续
先确认一条最小命令能跑通；后面是进入交互循环、批跑星图，还是订阅远端任务，再按需要继续分流。
发送最小命令
先跑通一条最小任务，再进入设备、协议、多媒体或星图专题。
npm install -g @craftline/mind → mind --help → 发一条最小命令。
安装 Mind CLI
推荐使用 npm 全局安装，Windows 和 macOS 使用同一条命令：
npm install -g @craftline/mind
安装完成后验证命令入口：
mind --help
@craftline/mind 是主入口包，安装时会按当前系统拉取对应运行时包：
- Windows：
@craftline/mind-win32 - macOS：
@craftline/mind-darwin
如果安装后提示找不到 mind 命令，先关闭并重新打开终端；仍不可用时，再检查 npm 全局 bin 目录是否已经加入 PATH。
先确认命令入口
mind --help
chat / fast 依赖 Helix MCP 服务；外接 MCP 和原生 coding 协作优先使用不依赖 Helix 的 xtra。需要进入 Helix 执行面时，再使用：
mind --mcp
进入 REPL 后可以继续使用：
/model <model-id>：只更新主模型 ID，写入本地config.toml，下一轮请求生效/effort：打开推理强度选择菜单，写入主模型槽位/preferences：打开本地配置页面，维护模型、密钥、Base URL、route 和服务域名/helix-link：检查/下载 Helix runtime asset，启动或复用本地 Helix 服务，并接入当前会话/helix-unlink：从当前会话移除 Helix MCP，不停止本地 Helix 服务/helix-home：启动或复用本地 Helix 服务，并打开http://127.0.0.1:3333/helix-stop：停止本地 Helix 服务
Helix runtime asset 缺失时会先显示确认菜单，取消后不会下载或启动。
如果你是从 Software Center 进入，建议先阅读 Software 首页内置 README，其中包含环境变量、后台管理中心与基础使用说明。
准备终端与环境变量
如果通过 npm install -g @craftline/mind 安装，通常不需要手动配置 Mind/MindEngine 路径。下面的 PATH 配置主要用于 Software Center 或安装包方式。
- Windows：推荐 `Windows Terminal`
- macOS：推荐 `iTerm2` 或系统 `Terminal`
- npm 全局安装后，优先重新打开终端验证 `mind --help`
- 不推荐默认挂 VPN 或系统代理
- 只有明确要兼容网关时，再单独配置 `base_url`
- 先保证直连可用，再谈代理兼容
macOS：
echo 'export PATH="/Applications/Mind/MindEngine:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows：
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Program Files\Mind\MindEngine",
"User"
)
$env:Path += ";C:\Program Files\Mind\MindEngine"
最小命令
先跑一条最小命令
mind --xtra "请用工程视角概述当前系统的核心能力、边界与典型使用场景"
需要持续交互时进入 REPL
mind
需要批跑和回归时用 --code
mind --chat --code api_batch.md
需要外接工具协作时用 --xtra
mind --xtra "Open DBHub and query the users table"
外接 MCP 服务需提前可访问；如果同一轮还要搜索、修改或验证代码，也可以继续使用原生 coding 链路。
需要等待远端任务时用 --agent
mind --agent
交互式运行
如果你想连续试多个目标，直接进 REPL 更顺手：
mind
进入 REPL 后可继续输入目标：
概述当前系统的核心能力与边界
对 path/to/video.mp4 做关键帧抽取，并输出证据
打开系统设置，稳定等待 2 秒后返回桌面
查询外接数据库里的 users 表
需要结束上一段上下文但继续留在 REPL 时，输入 /new 开始新对话；当前模式、模型配置和待发送附件会保留。
如果要接回最近 24 小时内的旧会话，输入 /resume 打开恢复菜单。恢复列表会按当前模式过滤，例如当前是 xtra 时只展示 xtra 的历史游标；菜单中用 ↑/↓ 滚动、Enter 选择、q 取消。
在 REPL 中调整模型
- 输入
/model <model-id>可以只修改主模型 ID，例如/model gpt-5-codex。 - 输入
/effort可以用二级菜单选择推理强度：low / medium / high / xhigh。 /model <model-id>会写入本地config.toml的[model.primary].model；/effort会写入[model.primary].reasoning_effort；当前正在进行的一轮不会中途切换，下一轮请求会读取新配置。- 输入
/preferences打开本地配置页面，适合同时维护模型名、API key、Base URL、route 和服务域名。
常见问题
已经联网，但一直 timeout？
- 这类问题优先归到网络链路问题，先关闭 VPN、本地代理和系统代理
- 某些 VPN 或代理会中断 CLI 长连接、SSE 或流式响应，表现为一直
timeout - 先在直连网络下验证；只有明确需要兼容网关时，再配置
base_url
出现 SSL 证书错误？
- 这类问题优先归到证书链被改写，常见原因是抓包工具做了 HTTPS 中间人代理
- 先关闭抓包工具后再试；如果仍然开启证书注入，也会继续报这个错误
timeout和证书校验失败是两类问题：前者偏链路中断，后者偏 TLS 证书被替换或无法被系统信任
配置、环境变量和服务状态说明在哪里？
- Software Center 内置
README - 当前页面
- 模型和密钥配置改为维护本地
config.toml - REPL 中可用
/model <model-id>快速更新主模型 ID，也可用/preferences打开配置页面