第二节 下载、运行与系统要求
[!ref] 新手教程：分步安装与首次登录的手把手引导见快速上手指南「安装与登录」节；本节按平台给出系统要求、下载与运行方式的完整说明。
2.1 系统要求
| 类别 | 要求 |
|---|---|
| 操作系统 | Windows 10（1809）及以上；macOS 12.0 Monterey 及以上；主流 Linux 发行版（Ubuntu 22.04 / Debian 12 / CentOS Stream 9 及更新） |
| 国产化操作系统 | 银河麒麟桌面 V10 SP1（Kylin-Desktop-V10-SP1-2503）；统信 UOS V20（Uos-Desktop-V20-1060） |
| 处理器架构 | x86-64（64 位）；macOS 同时支持 Apple Silicon（arm64） |
| 运行时依赖 | Windows：系统自带 WebView2 运行时；Linux：webkit2gtk（4.0 / 4.1，按发行版选对应构建）；macOS：系统内置 WebKit，无需额外安装 |
| 内存 | 最低 8 GB，推荐 16 GB |
| 磁盘 | 最低 1 GB 可用空间，推荐 2 GB 以上（本地会话 / 技能 / 日志 / 代码索引） |
| 显示 | 建议 1280 × 720 及以上分辨率 |
| 网络 | 首次启动需联网获取模型列表；日常需可访问账号服务与所选模型供应商接口（可离线使用的能力见相应章节） |
2.2 下载与运行（免安装）
AVL Code 免安装、下载即用 —— 没有安装向导。到官网下载页 www.avlcode.cn/#download 选择对应平台的构建后直接运行即可（内测版走 alpha 渠道，各平台链接恒为最新构建）：
| 平台 / 构建 | 运行方式 |
|---|---|
| Windows x64 | 下载后直接双击运行（免安装、无向导） |
| macOS 通用版（Universal） | Intel 与 Apple 芯片通用；拖入 应用程序 后运行 |
| macOS Apple 芯片版（arm64） | 仅 Apple 芯片、体积更小；拖入 应用程序 后运行 |
| Linux x64 通用 | 解压后直接运行 |
| Linux AppImage | 免安装单文件，加执行权限（chmod +x）后直接运行 |
| Linux Snap | Snap 包（snap install） |
| Linux WebKit 4.1 | 面向较新发行版（依赖 webkit2gtk-4.1） |
| 银河麒麟 V10 SP1 | 国产化专门构建（Kylin-Desktop-V10-SP1-2503，x86） |
| 统信 UOS V20 | 国产化专门构建（Uos-Desktop-V20-1060） |
- Windows / Linux：下载即运行，无需安装。
- macOS：建议把应用拖进 应用程序 文件夹再运行 —— 否则从「下载」/「桌面」直接运行时，检查更新会被系统 App Translocation 机制锁住（见 §27.7.2）。
- 国产化环境：银河麒麟 V10 SP1、统信 UOS V20 提供专门构建。
文档见 www.avlcode.cn/docs（用户手册 / 快速上手指南 / 参考手册）。
首次启动时会进行少量本地初始化，整个过程对用户透明，无需额外操作。
2.3 首次启动
启动后将看到主界面三大分区：
- 左侧栏：工作区列表 + 登录入口 + 设置入口。
- 中央会话区：会话标签页 + 消息流 + 输入框。
- 右侧浮层（按需弹出）：计划 / 待办、助手配置、审批弹窗等。
如果是首次启动，建议先点击左下角的「登录」按钮完成账号绑定（见第三节）。未登录状态下也可以用，但需要在 设置 → 模型 中手动配置 API Key。
2.4 命令行入口（高阶）
除桌面应用之外，AVL Code 还提供一组命令行入口，供希望脚本化或在远程服务器上协同使用的用户。命令行版本与桌面版共享同一份会话与配置，互相之间可以接力。命令行入口的具体获取方式与子命令清单见 设置 → 数据 → 命令行工具。
主二进制内置的 TUI 子命令（无需额外安装）：
| 命令 | 用途 |
|---|---|
AVL-Code tui |
在终端里启动 AVL Code 的 TUI 版本，与桌面版共享同一份会话 |
AVL-Code zagent-tui |
直接启动批处理对话 TUI，适合脚本化驱动 |