安装与首次运行
需要 Linux，以及已登录的 Qoder CLI 1.1.64 或更新版本。 其他 Agent 见配置与 Agent 启动。
获取安装包
AW 当前使用 Preview 包，尚未接入 ANOLISA CLI 或 RPM。
从通过的 AW Integration 构建
下载 aw-preview-linux-x86_64-… artifact，解压 ZIP 后得到安装包和 SHA256SUMS。
CI 包面向 Linux x86_64，要求 glibc 2.39 或更新版本，例如 Ubuntu 24.04。
需要自行编译或使用 Linux aarch64 时，按源码构建 生成安装包，再继续本页。构建过程需要联网下载依赖。
| 安装包 | 内容 |
|---|---|
aw-core | AW 启动与配置工具 |
aw-provider-tokenless | Tokenless 与其所需 RTK，需先安装 core |
aw-provider-sec-core | 安全 Provider 和 sec-core 程序，需先安装 core |
aw-all-in-one | 上述三个组件 |
分包必须来自同一次构建。选择 all-in-one 时直接安装到新目录，无需再安装分包。
安装
在解压后的 artifact 目录执行。以下版本应与下载包名一致；首次体验使用 core，
需要全部能力时将 AW_BUNDLE_KIND 改为 aw-all-in-one。
sha256sum -c SHA256SUMS
export AW_VERSION=0.1.0-preview.1
export AW_BUNDLE_KIND=aw-core
export AW_BUNDLE="$AW_BUNDLE_KIND-$AW_VERSION-linux-$(uname -m)"
export AW_PREFIX="/opt/aw-preview/$AW_VERSION"
tar -xzf "$AW_BUNDLE.tar.gz"
sudo install -d -m 755 /opt/aw-preview
sudo "./$AW_BUNDLE/aw" install --bundle "$PWD/$AW_BUNDLE" --prefix "$AW_PREFIX" --scope system
export PATH="$AW_PREFIX/bin:$PATH"
aw --help
校验结果应全部为 OK，安装完成会报告已安装的软件包。
安装器拒绝覆盖已有组件；升级请使用新安装目录。
后续终端也需要设置 AW_PREFIX 和 PATH，可以写入自己的 shell 配置。
无需系统后台的个人安装，可把 AW_PREFIX 改成自己拥有的绝对路径，并去掉安装命令的
sudo，并选择 --scope user（默认值）。安装目录的父目录不得被其他用户写入。
root 后台应使用 root 管理的安装目录。scope 必须明确选择；sudo 不会自动选择
system 或其他用户的数据库。
安装目录和包数据库所在的文件系统需要支持匿名临时文件、
硬链接、原子重命名和目录的持久同步。若错误中出现 O_TMPFILE，应把报告的目录改放到
支持该操作的文件系统。
不启动服务或 Provider 即可检查安装：
aw list --installed --prefix "$AW_PREFIX"
aw doctor --prefix "$AW_PREFIX"
清单读取安装记录；doctor 检查记录中的文件。新安装把软件包信息写入所选数据库，
并在 $AW_PREFIX/.aw-packages 中保存数据库位置。显式指定安装目录的查询按该位置
读取，因此普通用户创建配置时也可读取 system 安装。旧 Preview 安装仍在该目录保存
组件记录。查询不会迁移记录或创建数据库，详见包数据库与文件检查。
创建配置
已有 AW 时，可以使用同一个本地安装器：
aw install --prefix "$AW_PREFIX" --bundle "/absolute/path/to/unpacked-bundle"
对于上面的 system 安装目录，命令还需加上 sudo 和 --scope system。
此入口接受解压后的 Preview 包，以及用 package.json 描述的独立包，不接受组件名、
下载 URL 或 RPM/DEB 包。Preview Provider 包仍要求先安装同一次构建的 core；
独立普通工具不必包含 AW core 或声明 Provider。精确依赖必须已在同一安装目录中，
或由同一个 Preview 组合包提供。执行前可用 --dry-run 查看计划，见
安装计划与恢复。安装不启动服务、不注册 Agent Hook、
不启用 Provider。独立 aw-package 命令已删除；首次安装使用 bundle 根目录的 aw，
并显式传入绝对 --bundle 路径，后续操作使用已安装的 aw。
以普通用户创建配置，数据保存在安装目录之外。
export AW_HOME="$HOME/aw"
export AW_QODER="$(command -v qodercli)"
install -d -m 700 "$AW_HOME" "$AW_HOME/workspace"
qodercli --version
aw config init --prefix "$AW_PREFIX" \
--config "$AW_HOME/aw.yaml" --state-dir "$AW_HOME/state" \
--qoder "$AW_QODER"
aw validate --config "$AW_HOME/aw.yaml"
AW_QODER 应为真实可执行文件的绝对路径。config init 创建完整配置，不覆盖已有文件。
安全与压缩需另行启用，见 sec-core和 Tokenless。
启动并验证
cd "$AW_HOME/workspace"
aw run --config "$AW_HOME/aw.yaml" --agent qoder
应看到 AW 实例信息并进入 Qoder。请它用工具读取当前目录，按原生提示处理权限确认。 确认工具能返回结果后退出 Qoder，在同一终端执行。
aw status --config "$AW_HOME/aw.yaml"
aw stop --config "$AW_HOME/aw.yaml"
启用 Provider 后，按对应页面验证效果。