快速开始
如果你只想尽快把 Mind 跑起来，不需要先把所有专题正文看完。
按这条路径走就够了：先确认环境，再发一条最小命令，最后再决定是否进入交互式、外接协作或订阅。
确认命令入口
先用 mind --help 确认 CLI 可用；需要 Helix MCP 时再显式加 --helix。
安装 CLI 并准备终端
优先用 npm 全局安装；如果使用安装包，再把 Mind/MindEngine 目录加入 PATH。
先跑通，再决定怎么继续
先确认一条最小命令能跑通；后面是进入交互循环、外接协作，还是订阅远端任务，再按需要继续分流。
发送最小命令
先跑通一条最小任务，再进入设备、协议或多媒体专题。
npm install -g @craftline/mind → mind --help → 发一条最小命令。
安装 Mind CLI
推荐使用 npm 全局安装，Windows 和 macOS 使用同一条命令：
npm install -g @craftline/mind
安装完成后验证命令入口：
mind --help
mind doctor
mind doctor 会只读检查本地配置、外部 MCP 配置、Helix 运行组件和 Mind coding 工具；它不会创建文件、启动服务或访问网络。需要交给脚本处理时使用 mind doctor --json。
需要把 Mind 接入 Codex 等 MCP host 时，使用 mind mcp-server 作为 stdio server 启动命令。
@craftline/mind 是主入口包，安装时会按当前系统拉取对应运行时包：
- Windows：
@craftline/mind-win32 - macOS：
@craftline/mind-darwin
如果安装后提示找不到 mind 命令，先关闭并重新打开终端；仍不可用时，再检查 npm 全局 bin 目录是否已经加入 PATH。
先确认命令入口
mind --help
默认执行链路使用原生工具和已启用的外接 MCP。需要进入 Helix 执行面时，可以在启动时显式接入：
mind --helix
mind --helix api
只写 --helix 时默认选择 app 工具过滤器；可显式传入 api。不传 --helix 时不连接 Helix。
进入 REPL 后可以使用全部 slash 命令；完整清单、参数和行为说明统一见交互模式。
常用入口按任务分组：会话管理使用 /new、/resume、/archive、/fork；配置与权限使用
/permissions、/provider、/model、/effort、/preferences；运行管理使用 /listen、
/mailbox、/ps、/stop；工具连接使用 /tools、/hooks、/agent、/skills、/mcp 和
/helix-link。
/helix-mode 和 /helix-home 发现 Helix runtime asset 缺失时会先显示确认菜单；确认后只下载，完成后需要重新打开应用，再通过 --helix 或 /helix-link 接入，不会在当前命令中启动服务。
如果你是从 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"
CLI 命令入口
CLI 命令、参数、子命令和组合规则统一见命令行使用参考。
最常用的三条路径是 mind exec（单次任务）、mind（持续交互）和 mind agent listen（远端订阅）。
最小命令
完整的选项位置、图片与模型组合、stdin、会话恢复和 MCP 管理示例见命令行使用参考。
先跑一条最小命令
mind exec "请用工程视角概述当前系统的核心能力、边界与典型使用场景"
需要持续交互时进入 REPL
mind
需要外接工具协作时使用 exec
mind exec "Open DBHub and query the users table"
外接 MCP 服务需提前可访问；如果同一轮还要搜索、修改或验证代码，也可以继续使用原生 coding 链路。
需要等待远端任务时用 agent listen
mind agent listen
交互式运行
如果你想连续试多个目标，直接进 REPL 更顺手：
mind
进入 REPL 后可继续输入目标：
概述当前系统的核心能力与边界
对 path/to/video.mp4 做关键帧抽取，并输出证据
打开系统设置，稳定等待 2 秒后返回桌面
查询外接数据库里的 users 表
需要结束上一段上下文但继续留在 REPL 时，输入 /new 开始新对话；当前模型配置和待发送附件会保留。
如果要接回最近 24 小时内的旧会话，输入 /resume 打开恢复菜单。恢复列表会按当前工作区和会话来源筛选；菜单中用 ↑/↓ 滚动、Enter 选择、q 取消。
在 REPL 中调整模型
- 输入
/model <model-id>可以只修改主模型 ID，例如/model gpt-5-codex。 - 输入
/effort可以用二级菜单选择推理强度：low / medium / high / xhigh。 /model和/effort会写入当前 Provider Profile 的模型与推理强度；当前正在进行的一轮不会中途切换，下一轮请求会读取新配置。字段和配置示例见交互模式。- 输入
/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打开配置页面