从零到第一条
AI 对话。

01 / 系统要求

万象不提供模型 API。你需要自备 OpenAI / Anthropic / Gemini 兼容协议的密钥，或任意第三方中转服务。没有密钥也能用，但 AI 相关能力不可用。

02 / 下载安装

正式版 APK 有两个官方渠道，内容完全一致，任选其一：

覆盖升级是安全的 —— 所有版本的签名一致，老用户直接装新包即可，不会丢数据。

安装时系统可能提示「未知来源」。万象是官网自签名分发，不在任何应用商店上架，需要手动允许安装。

03 / 首次启动

第一次打开会进入引导配置，共两页，按顺序走完即可用：

1. 系统设置 —— 选择发行版与镜像加速线路。发行版支持 Ubuntu / Debian / Kali / Arch / Fedora / Alpine / AlmaLinux / Rocky / openSUSE / Manjaro 共十种；镜像线路三选一：自动择优（推荐）、官方源（Global CDN）、国内镜像加速。这一步可以在页内直接开始安装，也可以跳过。
2. 模型设置 —— 填接口地址与 API Key。填完点「拉取模型列表」可同步服务端可用模型；也能手动输入模型名，或从剪贴板 / 本地 JSON 导入已有配置。

引导可以随时跳过。之后想重看页面级引导，去「乾坤 → 关于 → 重看功能引导」。

权限提示：万象会申请存储权限与通知权限。存储权限用于读写工程文件与沙箱目录；若拒绝，沙箱内将无法访问手机文件。

04 / 配置模型

万象支持 OpenAI / Anthropic / Gemini 三种兼容协议。第三方中转站通常选 OpenAI 协议。

加模型有两种方式：

• 点「拉取模型列表」从服务端同步，勾选需要的 —— 最省事，推荐首选。
• 手动输入模型名（如 gpt-4o）—— 中转站的模型名常常拉不全，这时手动补。

添加后可以在模型上单独配置上下文窗口、价格与能力开关（图片输入、工具调用等）。

一个模型能不能「看图」、「能不能调工具」，取决于你勾的能力开关，不取决于模型名。配错了会表现为「图片发不出去」或「AI 不肯用工具」。

05 / 界面导览

底部四个页签是整个应用的骨架：

「乾坤」顶部提供全局搜索 —— 记不清某个开关在哪一层菜单时，直接搜功能名即可跳转。

06 / 准备 Linux 环境

万象的沙箱不是「附带的终端」，而是 AI 真正执行命令的地方。第一次使用需要先把它装起来。

1. 进「工坊 → 终端」。容器初始化相关步骤在这里触发；也可以直接在引导第一页选择发行版开始安装。
2. 选择发行版。共支持十种，常用的是 Ubuntu 24.04 LTS（工具链最全，推荐）与 Debian 12（更轻）。另有 Kali、Arch、Fedora、Alpine、AlmaLinux、Rocky、openSUSE、Manjaro 可选。
3. 等待下载与解压完成。这一步取决于网络，走国内镜像通常几分钟。

装好后可以验证：

cat /etc/os-release
uname -a
apt update

沙箱内没有真实的 root 权限，也没有 systemd。不要跑 mount、sysctl、chown 这类需要内核权限的命令；需要常驻的后台服务请用万象提供的进程工具注册，而不是 systemctl。

07 / 第一次对话

进「智枢」，在输入框里输入需求并发送。AI 会自动判断是否需要调用工具 —— 读文件、执行 Shell、搜索、跑构建，都在沙箱里完成。

几个值得一开始就养成的习惯：

• 说清目标而不是步骤。「把这个工程的构建错误修掉」比「打开 build.gradle 改第 42 行」效果好得多。
• 长任务让它自己拆。万象的智能体循环会自己规划多步，不必你手把手喂。
• 善用「停止」。发现方向不对就中断，已生成的内容会保留，不会白跑。

08 / 工坊：建立工程

「工坊」是项目管理的入口，三种起步方式：

工程建立后可以：

• 构建 —— 在沙箱里跑构建流程，日志与产物都可查
• Git 工作台 —— 状态、分支、提交、差异、标签，含提交拓扑图
• 终端 —— 直接进工程目录的原生 PTY

私有仓库的凭据存在「工坊 → Git → 凭据」里，按主机保存，支持账号密码或访问令牌。导入时若检测到缺凭据会自动弹窗；再次编辑时用户名会自动回填，令牌留空表示保持不变。

09 / 权限与执行档位

万象有三种执行档位，能力递增，但都不需要解锁 Bootloader：

档位可以在「乾坤 → 运行环境」里切换与查看当前生效状态。

绝大多数场景 PRoot 就够用。只有当你要让 AI 操作别的应用界面、或做需要系统权限的操作时，才需要往上升级。升档会显著扩大 AI 能触及的范围，请自行评估。

10 / 效率技巧

• 后台保活：跑构建、装依赖这类耗时任务前，先在「乾坤 → 软件权限」里开启后台运行保活，否则切到后台可能被系统杀掉。
• 悬浮小窗：智枢支持桌面悬浮，可以一边看文档一边让 AI 干活。
• 反馈与诊断：遇到问题时用「智枢 → 反馈与诊断」导出诊断包，里面包含构建日志、Git 操作、沙箱执行、MCP 状态、网络诊断等 —— 比口头描述有用得多。
• 检查更新：在「乾坤 → 关于」里手动检查，会显示更新日志、安装包大小与下载进度。
• 外观：「乾坤 → 外观」可切换玄同与澄明两套主题，深浅色均支持。

11 / 常见问题

遇到上表之外的问题，可以到官方 QQ 交流群（群号 905971993）提问，群里也有离线安装包与完整版使用说明。

下一步

跑通第一条对话之后，可以继续看：

• 插件开发指南 —— 把你的工具装进沙箱
• 模板制作指南 —— 把一套工程变成可分享的起点
• 架构说明 —— 了解它是怎么跑起来的