WopalSpace
安装命令
安装说明
选择桌面应用或命令行安装，两条入口汇合到同一个配置向导，完成后即可进入工作台。
安装命令
Windows (PowerShell)
安装脚本先安装 Wopal CLI，随后自动运行 wopal setup 打开配置向导。如果终端环境不允许自动启动，安装完成后手动运行 wopal setup 即可。
下载 Desktop 应用
支持 MacOS、Windows、Linux。自动识别你的系统，推荐合适版本。安装后首次启动进入配置向导，完成后进入工作台。
正在检查正式版最新版本…
手动安装 命令行安装不适用于你的环境时，可以下载 Wopal CLI 安装包并解压使用：将可执行文件放入本地
~/.wopal/bin/ 目录，并把该目录加入系统的 PATH 后，运行 wopal setup 开始配置。系统要求
安装前请确认你的环境满足以下条件：
- 核心解包 环境需安装 python3 或 node 之一 (用于解析最新版本清单)
- 前置工具 需要 curl (用于拉取程序) 以及 tar 或 unzip (用于解包)
- Shell 支持 Zsh / Bash / Fish (MacOS、Linux) 或 PowerShell/WSL (Windows)
- 系统架构 支持 MacOS (Intel / Apple Silicon M系列)、Linux (x64) 与 Windows (x64)
安装流程
1
安装程序
上方的安装命令会安装 Wopal CLI 到你的系统。安装完成后，你将获得 wopal 命令；在可交互的终端中，安装脚本会自动运行配置向导，无需手动操作。
2
完成配置
配置向导会准备引擎、本体和你的第一个空间。如果安装时没有自动启动向导，随时运行 wopal setup 即可。
3
进入工作台
配置完成后进入工作台，Agent 会自动加载空间结构和规则，你可以立即开始协作。
安装之后
安装完成后，以下是你的工作空间中实际会发生的事情。
安装与校验
脚本将精准探测 CPU 架构与 OS，通过 SHA-256 校验确保下载包无损坏。内置缓存穿透（Cache-Buster）重试应对 CDN 异常。
自动写入 Shell 环境变量
自动匹配当前 shell 类型，将 WOPAL_HOME 和 PATH 写入对应 Profile（如 .zshrc），由专属标志块包裹，干净且可重入。
配置向导自动接管
在可交互的终端中，安装脚本会自动运行 wopal setup 打开配置向导，准备引擎、本体与首个空间；完成后即可直接进入工作台。
安装遇到问题？
如果自动安装未成功，可以按照以下步骤排查：
安装后提示 wopal 命令不存在
当前终端会话尚未感知新安装的命令。请执行 source ~/.zshrc (如使用 bash 则为 source ~/.bashrc) 重载配置，或直接打开一个新终端；如果配置向导没有自动打开，运行 wopal setup 即可。
安装脚本执行失败
可以重新运行一次安装命令；网络异常或下载中断时，重试通常可以完成。如果仍然失败，请使用上方的「手动安装」指引，或直接下载 Desktop 应用。
在 CI 或自动化环境中安装
在 CI 或非交互环境中，安装脚本只会安装 Wopal CLI，不会自动启动配置向导。之后在交互终端中运行 wopal setup 即可完成配置。curl -fsSL https://wopal.cn/install.sh | bash -s -- --no-setup
测试版（Beta）是什么？
测试版是独立的 Desktop 通道，适合想提前体验新功能的用户，可能包含未稳定的问题。测试版与正式版是不同的应用，可以共存安装；如果你使用命令行安装，请用 wopal setup --beta 保持通道一致。