第 2 章：安装与配置——把应用装进手机，打通命令通道
这一章教你完成从下载到能用的全部准备：设备要求、下载安装、权限授予，以及最关键的 Termux 命令通道配置。
读这一章预计需要 15 分钟。读完后，你就能成功安装并完成基础配置。
2.1 设备要求
在使用本应用前，你需要一台搭载 Android 8.0（API 26）及以上版本的 Android 设备，应用无法在低于 Android 8.0 的设备上使用。
此外，请确保设备至少有 200MB 的剩余存储空间和 400MB 的空余内存。
怎么查你的 Android 版本：
打开「设置」→ 找到「关于手机」→ 查看「Android 版本」一栏2.2 下载应用
什么是 APK？ APK 就是安卓软件的安装包文件，就像电脑上的 .exe。
你可以通过以下任一官方渠道下载本应用：
| 渠道 | 地址 |
|---|---|
| GitHub | https://github.com/lyracode-app/Lyra-Code |
| Gitee | https://gitee.com/yukisoffd/lyra-code |
注意
本应用完全开源免费，切勿相信付费提供安装包的渠道。如果你需要安装社区提供的修改版或衍生二改应用，请核对应用来源是否安全可信，避免安装包含恶意代码的软件。如果不放心，可以自行下载源码编译安装包（见构建）。
安装时提示「未知来源」怎么办？
Android 出于安全考虑，默认禁止安装非应用商店的 App。当你点击 APK 时会弹窗提示，点 「仍要安装 / 允许此来源」 即可。这是正常的，因为 Lyra Code 本来就是从官网下载的。
2.3 安装受限怎么办
本应用不存在恶意代码。如果你的安装器反馈有病毒拦截了安装，请截图详细内容反馈给开发者。
- 中国大陆发售的设备：反馈「无备案」是正常的，允许安装即可。
- 非国行设备：谷歌官方会在 2027 年开始全面推行新的侧载策略，你在安装本软件时可能遭到 Google Play 安全框架的拦截，需要参考此页面进行高级流程才能安装：https://android-developers.googleblog.com/2026/03/android-developer-verification.html
简要操作流程：
- 在系统设置中启用开发者模式。
- 确认你没有被胁迫或诱导开启：谷歌会有一个环境检查，确保这个过程不是被恶意启动。
- 重启设备并重新认证：拦截远程控制以及监视行为。
- 保护性时间：等待 24 小时后进行设备 PIN 码或生物识别认证。
- 安装应用：以上步骤完成后即可正常安装。
如果谷歌后续有新的侧载政策变更或流程变化，本应用会考虑进行开发认证以简化安装流程。
2.4 使用 ADB 安装
你也可以使用 ADB 命令直接安装，这个方法可以绕过系统安装器，无论是国行还是非国行设备：
adb install -r lyra-code.apk2.5 首次打开：权限与存储
安装完成后，桌面上会出现 Lyra Code 图标，点开它。
2.5.1 系统权限请求
第一次启动时，手机会弹出权限请求，一般有两个：
| 权限 | 弹窗会怎么说 | 该不该给 | 不给会怎样 |
|---|---|---|---|
| 存储权限 | 「允许 Lyra Code 访问照片和文件？」 | ✅ 允许 | 无法读取/保存文件，核心功能不可用 |
| 通知权限 | 「允许 Lyra Code 发送通知？」 | ✅ 允许（推荐） | 定时任务完成时无法提醒你 |
如果手滑点了「拒绝」，别慌：随时可以去
设置 → 应用 → Lyra Code → 权限里补开。
2.5.2 「所有文件访问」权限（Android 11 及以上）
Lyra Code 自带一个双栏文件管理器，默认浏览 /storage/emulated/0（手机存储根目录）。Android 11 及以上需要单独授予「管理所有文件」权限：
设置 → 应用 → Lyra Code → 权限 → 所有文件访问权限 → 允许各品牌手机路径可能略有不同
小米/红米：设置 → 应用设置 → 应用管理 → Lyra Code → 权限管理 → 所有文件访问权限 华为/荣耀：设置 → 应用 → 应用管理 → Lyra Code → 权限 → 所有文件访问权限 OPPO/vivo：设置 → 应用管理 → Lyra Code → 权限 → 存储和文件 → 所有文件访问权限 三星：设置 → 应用 → Lyra Code → 权限 → 文件和媒体 → 允许管理所有文件
不开会怎样？ 文件浏览、复制、删除等批量操作会受限。如果只用 AI 对话不碰文件，可以先不开，等需要时再补。
2.6 配置 Termux（让 AI 能执行命令）
这是新手最容易卡住的一步，我们慢慢来。
2.6.1 为什么必须装 Termux？
Lyra Code 的「执行命令」能力，是通过另一个叫 Termux 的 App 来实现的。没装 Termux，AI 就不能运行任何命令（不能装软件、不能跑脚本、不能管理 Git）。
2.6.2 安装 Termux
- 在 F-Droid（Termux 官方推荐的商店）搜索 Termux 安装，或者去官网
https://termux.dev下载； - 安装后打开一次 Termux，让它完成首次初始化（会显示一个命令行窗口，这是正常的）。
2.6.3 打开「允许外部应用调用」开关
在 Termux 里输入下面这行命令（可以直接复制粘贴），然后按回车：
mkdir -p ~/.termux && (grep -qxF 'allow-external-apps=true' ~/.termux/termux.properties || echo 'allow-external-apps=true' >> ~/.termux/termux.properties) && termux-reload-settings这行命令干了三件事（不理解没关系，执行就好）：
- 创建 Termux 的配置目录；
- 在配置文件里写入
allow-external-apps=true（允许其他 App 调用 Termux）； - 重新加载设置让配置生效。
2.6.4 安装基础软件包（建议执行）
在 Termux 里输入下面这行，按回车（第一次会下载几百 MB 数据，耐心等待）：
pkg update && pkg install git openssh python nodejs-lts ripgrep file| 软件包 | 有什么用 |
|---|---|
| git | 代码版本管理（从 GitHub 下载/推送项目） |
| openssh | SSH 远程连接服务器 |
| python | 运行 Python 脚本 |
| nodejs-lts | 运行 JavaScript/Node.js 项目 |
| ripgrep | 快速搜索文件内容 |
| file | 查看文件类型 |
如果提示
pkg: command not found，说明 Termux 没初始化好，先关掉 Termux 重新打开一次，或更新一下：pkg update。
2.6.5 回到 Lyra Code，打开 Termux 权限开关
- 打开 Lyra Code → 右下角/侧边栏进入设置页；
- 找到 「Termux 权限」 或类似开关；
- 把它打开（会弹出授权提示，点允许）。
常见错误
没开这个开关的话，AI 的 run_command 工具会自动禁用——你让 AI 跑命令，它会说「命令执行不可用」。这时候回来检查这一节的三步：Termux 装了没？allow-external-apps=true 写了没？设置里的开关开了没？
2.6.6 验证配置是否成功
配置完成后，回到对话页，对 AI 说：
帮我执行命令
echo hello看看能不能用
如果正常，AI 会执行并返回 hello。恭喜，命令通道打通了！
2.7 设置页速览（新手版）
进入设置页后，你会看到这些配置项。大多数保持默认就好，但你要知道它们是干嘛的：
| 配置项 | 它是干嘛的 | 新手建议 |
|---|---|---|
| 模型服务商 | 添加/管理你的 AI 服务商、API Key、模型 | 必配（第 8 章详解） |
| 系统提示词 | 设定 AI 的「人设」和行事规则 | 暂不动 |
| Termux 权限 | 命令执行通道的开关 | 必开（见 2.6） |
| 联网搜索黑名单 | 屏蔽不想让 AI 打开的网站 | 暂不动 |
| Agent 工具开关 | 逐个启用/禁用 AI 的工具 | 暂不动 |
| 主题/字体/刷新率 | 界面显示效果 | 按喜好调 |
| 缓存与存储 | 查看应用占用的存储空间 | 暂不动 |
| 应用权限 | 查看系统授予应用的权限，点击可跳转系统权限页 | 按需 |
| 备份 | 导出/导入你的数据 | 建议装好后先备份一次 |
2.8 新手最容易踩的 6 个坑
- 没装 Termux 就让 AI 跑命令 → 提示「命令不可用」。按 2.6 配置。
- 没给存储权限 → 文件相关操作报错。去系统设置里补开权限。
- API Key 填错/没填 → AI 一直报错或转圈。检查服务商配置（见第 8 章）。
- 手机存储路径找不到 → 记住默认工作区是
/storage/emulated/0/Lyra，不是/storage/emulated/0本身。 - 把 API Key 发到群里/网上 → 立刻去服务商后台吊销并重新生成。
- 遇到弹窗直接点「拒绝」 → 很多权限后面很难想起在哪补，先点允许，不需要的以后也能关。
2.9 安装相关 FAQ
Q：安装时提示「未知来源」怎么办？ A：这是正常的。点「仍要安装 / 允许此来源」即可（见 2.2）。
Q：安装器提示有病毒/风险？ A：本应用不存在恶意代码。若被拦截，请截图反馈给开发者；国行设备反馈「无备案」是正常的（见 2.3）。
Q：下载的 APK 打开后无法安装？ A：先确认手机系统为 Android 8.0 及以上；再确认「未知来源」已允许。仍不行可尝试 ADB 安装（见 2.4）。
本章完 · 下一章：快速上手——配置第一个模型服务商，发出第一句问候