WopalSpace5 分钟上手
本指南带你从零跑通第一个 WopalSpace 空间：安装 → setup → 启动 Workbench → 与 Agent 协作。
整个流程约 10–15 分钟（主要是首次下载引擎与本体）。
1. 安装 wopal 命令
curl -fsSL https://wopal.cn/install.sh | bash
wopal --version
卡住？回到 安装 看平台说明与排错。
2. 运行首次 setup
wopal setup
wopal setup 是三段式向导：
- Inspect：检查 Git、网络、目录权限等前置条件。
- Configure：选择第一个空间的路径（默认
~/WopalSpace）、本体类型，并填写 AI provider 的 API Key。 - Execute：准备
WOPAL_HOME、拉取本体、安装 ellamaka 引擎、物化基础能力、初始化并注册第一个空间。
执行完会输出下一步提示：cd <space> 与 wopal start。
wopal setup幂等：重复运行只会补齐缺失项，不会覆盖你的空间文件。
3. 启动 Workbench
进入空间目录并启动引擎：
cd ~/WopalSpace
wopal start
wopal start 会：
- 若 ellamaka 未运行，则在后台启动引擎（默认端口 4096）；
- 在本机默认浏览器打开 Web Workbench；
- 命令随后退出，不长期占用终端。
在远端 SSH 会话里，wopal start 只输出 URL 而不尝试打开浏览器——你可以用本地端口转发访问。
常用选项：
wopal start --port 8080 # 指定端口
wopal start --no-open # 只输出 URL，不打开浏览器
wopal start --password # 绑定 0.0.0.0 并启用 LAN 访问（设置访问密码）
4. 在 Workbench 里与 Agent 协作
Workbench 打开后，你就面对主 Agent Wopal。直接用自然语言下指令即可，例如：
帮我在 projects/ 下看看有没有可以重构的脚本，并给出方案
Wopal 会自动加载相关技能（如 space-master 做流程路由、dev-flow 驱动开发任务、agents-collab 规范委派）。
第一次必做的结构校准
新空间首次使用时，先运行：
/init
/init 会消费 wopal space scan 的只读扫描结果，在你确认后提出 STRUCTURE.md 的更新方案与模板差异处理，让 Agent 准确理解你的空间结构。
沉淀经验
协作中产生的偏好、避坑知识与规则，用 slash 命令沉淀：
/wopal:memo— 记录本次会话要点到日记/wopal:evolve— 沉淀用户偏好、长期经验与空间规则（写入需你确认）/wopal:memory— 检索已有记忆
5. 创建更多空间
第一个空间由 wopal setup 创建；后续空间用 space init：
wopal space init my-api --type coding
--type 选择本体类型分支（common / coding / content / finance），默认 common。