安装与使用指南
从下载到下达第一个任务，大约三分钟。如意只以 APK 形式分发，不依赖应用商店，也不需要注册本站账号。
01 系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Android 10（API 29）及以上 |
| 安装包 | ruyi-0.1.37.apk，约 89.3 MB |
| 存储空间 | 建议预留 500 MB 以上，供运行环境与任务文件使用 |
| 模型服务 | 需自行配置一家模型服务商（账号登录或 API Key） |
| 其它 | 无需 Root、无需应用商店、无需本站账号 |
02 下载并校验安装包
在官网下载区点击「下载 APK」。为确保文件在传输中没被替换，建议核对 SHA-256 校验值：
082bef2fda57f479f6d5b9647bd2297f8bb7fc963216b8f09cc508f4ee960e4c
Windows 可在文件所在目录打开命令提示符执行 certutil -hashfile ruyi-0.1.37.apk SHA256；macOS / Linux 执行 shasum -a 256 ruyi-0.1.37.apk。两者输出应与页面给出的值完全一致（忽略大小写与空格）。
只从官方直链下载。如果校验值对不上，请删除该文件并重新从本站下载，不要安装。
03 安装
- 打开安装包
在手机的「下载」目录或通知栏点击已下载的 APK。
- 允许此来源
首次安装时，系统会提示「未知来源应用」。选择「允许此来源」或按提示在设置中开启，然后返回继续。这是 Android 对非商店应用的正常提示。
- 完成安装
点击「安装」，等待完成。桌面会出现「如意」图标，可正常打开。
部分小米 / MIUI 设备若提示「禁止通过 USB 安装」或安装被拦截，属于系统安全设置，与安装包无关；从手机浏览器直接下载安装即可绕开这一限制。
04 首次配置
- 打开如意
欢迎页会介绍四项核心能力，点「开始设置」进入配置。
- 连接模型服务商
在模型配置页选择一家服务商，用账号登录或填入你自己的 API Key。如意不附带模型服务，这一步由你掌控。
- 下达第一个任务
回到对话主页，用一句话说明目标，或点首页给出的示例任务直接开始。
任务执行时，屏幕上会出现悬浮小窗，可以随时查看进展或接管。建议先从不涉及支付、发布和删改数据的简单任务试起。
05 按需开启能力
在「设置中心」可逐项开启或关闭：手机操作（依赖无障碍服务）、悬浮胶囊、定时任务、记忆与技能、语言与外观。不需要的能力可以一直保持关闭。
需要注意的是，部分系统（如 Android 10）对后台自动化与无障碍服务有额外限制，某些能力可能显示为不可用；这是系统版本差异，升级到 Android 12 及以上体验更完整。
06 常见问题
提示「解析安装包失败」
通常是文件没下载完整，或系统版本低于 Android 10。请重新下载并核对文件大小与 SHA-256。
模型一直连不上
检查网络、服务商账号状态与 API Key 额度，并在模型配置页重新验证一次。
界面看起来没有毛玻璃效果
Android 10 / 11 不支持真模糊，界面会退化为半透明卡片，功能不受影响。
覆盖安装后数据会丢吗
同一应用的正常升级会保留本地数据。若从测试包切换到正式包（属于不同的应用标识），两者会并存，需手动迁移数据。
07 卸载与数据清理
在系统「设置 → 应用管理 → 如意」中选择卸载，应用私有目录里的对话、记忆、技能与任务文件会一并移除。若只想重置，可先选择「清除数据」。
你在模型服务商处产生的记录与密钥，需要在该服务商后台单独处理，卸载本应用不会自动撤销。详见隐私政策。
08 用微信给闲置旧机派活
家里有台吃灰的 Android 手机？把它装上如意，就能用随身那台手机（iPhone 也可以）在微信里给它派活。任务由旧机执行，进度和结果再发回微信，不用电脑，也不用自己搭服务器。
- 旧机装好如意并完成首次配置
系统需 Android 10 及以上。按前面第 02–04 步安装、连接模型服务商，保持联网（建议连 Wi-Fi 并接着电源）。
- 在旧机上打开微信绑定页
进入「设置 → 微信 → 扫码绑定」，屏幕会显示一张二维码。二维码仅用于本次绑定，请勿转发给他人。
- 用控制端微信扫码并确认
用随身手机上的微信扫这张码并确认授权。控制端可以是 Android，也可以是 iPhone；绑定的是扫码的这个微信账号。
- 在微信私聊里下达任务
打开与如意的私聊，直接发文字说明要做什么。旧机在后台执行，追问、进度与结果都会回到这个会话。
请留意首版边界：目前只接收绑定账号本人的私聊文字，支持如意追问、任务结果与通知；涉及付款确认、敏感手机接管的操作，仍需在这台旧机上手动完成。图片、语音、文件、群聊与多账号为后续版本。可在「设置 → 微信」里随时暂停接收或解除绑定，解绑会删除本机保存的绑定信息。
该通道默认关闭，需你主动扫码启用。如意不搭建中继服务器，但两端都要联网；消息按微信自身规则经由其服务端，绑定凭证经 Android 密钥库加密后只保存在旧机本机。请仅用于你本人所有的设备与账号，并遵守微信平台的相关规则。更多说明见隐私政策。
09 悬浮窗与后台屏
任务开始执行后，如意会把后台画面实时收进屏幕右下角的一块悬浮小窗。你可以继续用手机做别的事，不用一直停留在如意界面上。
- 绿框：正在后台执行
任务在自己的「后台屏」上运行，小窗显示当前页面与操作过程。点一下小窗可以放大查看细节，再点一次收起。
- 橙框：需要你处理
遇到登录、验证码、付款确认等必须由本人完成的步骤，小窗会自动放大并变成橙色边框，同时在对话里说明原因。处理完告诉如意，它会接着往下做。
- 在「后台屏」里看全部任务
从左上角菜单进入「后台屏」，可以看到每个在跑的任务卡片与实时画面；点「看画面」展开，点任务可回到对应对话。
- 按需开关
在「设置中心 → 悬浮胶囊」里可以关闭或重新开启小窗；关闭后任务仍会执行，只是不再浮在其他应用上方。
能力边界：官网展示的是京东 App 在 Android 10 真机上的操作画面，用于呈现「如意操控第三方 App」的效果。要在任意第三方 App 上完成全自动执行，需 Android 12 及以上并按引导完成系统的无线调试配对；Android 10 可能显示「手机操作还没准备好」，此设备上如意主要在内置浏览器的后台屏里工作。涉及登录、验证码、付款等敏感步骤一律由你本人在设备上确认。实际表现可能随系统版本、厂商定制与第三方 App 限制而不同。
悬浮窗使用系统的「显示在其他应用上层」权限，画面内容不会上传；屏幕内容仅发送给你自己配置的模型服务商，详见隐私政策。