OS-ETC-IRIDIS 使用手册

01 关于本手册与项目

OS-ETC-IRIDIS 是开源项目 IRIDIS（作者 WWRJ3321）的 ETC 分支：完整保留原作者的一切功能与版权，在此基础上由 ETQWFD 维护，新增 armeabi-v7a（32 位）支持，让 32 位 / 旧款 / 低配安卓手机也能正常安装运行（GGUF、MNN、语音、智能体终端均可用）。

推理、语音、记忆全部在手机本地完成，数据不出手机；只有下载模型 / 语音包 / 运行库、智能体主动联网、或你手动开启局域网 API 时才联网。

02 系统要求

32 位设备推荐使用 4B 以下模型以保持流畅；LiteRT-LM 引擎官方只提供 64 位库，32 位设备会自动隐藏该引擎，GGUF 与 MNN 不受影响。

03 安装与升级

首次安装

1. 从 GitHub Releases 下载 OS-ETC-IRIDIS APK（单一安装包，同时支持 32 / 64 位，约 40 MB）。
2. 安装时允许「安装未知来源应用」的提示。
3. 打开 App，在「模型管理」下载或导入模型后即可对话。

从旧版 IRIS LocalAI 升级

工作区位置

工作区默认在公共目录 /storage/emulated/0/Download/IRIDIS（可在文件管理器直接看到）。授予「全部文件访问」后模型等大文件都放这里；未授予时使用应用专属目录 Android/data/com.iridis/files/，两个位置都会在应用内列出。

04 模型管理

• 下载模型：在「模型管理」的在线列表中选择并下载（需要网络）；下载进度可暂停。
• 导入模型：把 GGUF 文件拷入 Download/IRIDIS/models（或应用专属目录），MNN 模型以文件夹形式放入同一目录，应用会自动扫描。
• 移动与删除：在「模型管理」可将私有目录模型移动到公共目录（不合并同名文件）；删除前会二次确认。
• NPU：仅骁龙 8 系 64 位设备可用；首次使用需在应用内同意高通许可并下载 QNN 运行库（不随 APK 分发）。

05 对话与推理

• 新建对话：列表页右上角新建；每个对话独立上下文。
• 采样参数：在「设置 › 生成」调整 temperature / top_p / top_k / min_p / repeat_penalty 等；单条消息也可临时指定。
• 思考模式：推理模型默认展示思考过程（reasoning_content），可在设置关闭。
• 编辑与重新生成：长按或点击消息可编辑、可重新生成多个版本，历史版本可回退。
• 继续生成：生成中断后可「继续」补写。
• 性能调校：KV 缓存复用让后续轮次更快；空闲时按设置自动卸载模型释放内存；「设置 › 性能与资源」可切换资源档。

06 智能体与终端

在对话页开启「智能体」后，模型可以调用工具完成任务：

• 文件工具：在工作区内读写、移动、删除文件（沙箱限制在工作区内，路径经检查）。
• Termux 完整 Linux（内置）：v2.3.3 起内置「Termux 中文核心」（32 位，源自官方 bootstrap，已汉化：中文欢迎语/提示符/别名，软件源为北京清华 TUNA 镜像）。在 设置 › 智能体 › 终端与浏览器 › 命令环境 选择 Termux，点「一键安装内置 Termux」即可，无需另外下载安装任何终端应用。已安装并授权外部 Termux 时自动优先使用完整版。
• 内置 Alpine（可选）：Linux 终端 也提供 proot + Alpine Linux 环境，32 位设备自动使用 armv7 根文件系统，64 位使用 aarch64；Alpine 根文件系统默认从北京清华镜像源下载。
• 联网搜索：模型主动请求后经你确认才联网（默认不联网）。
• 定时任务：可安排周期任务（如每天提醒），任务执行前会先征得确认。
• 备份：设置 › 存储空间 › 备份与恢复，一键导出 / 导入工作区与配置。

07 记忆与知识库

• 长期记忆：对话中的要点自动沉淀为记忆，后续对话自动注入；可在设置查看与清理。
• 知识库：把 txt / md / html 文档放入工作区 knowledge 目录，在「上下文与记忆」中重建索引后即可检索引用。
• 上下文窗口：可调整最大上下文长度；超长对话会自动摘要压缩。

08 本地语音

• 离线识别：首次使用按提示下载语音包（sherpa-onnx），之后完全离线识别。
• 离线合成：朗读回复同样本地完成。
• 免提对话：语音模式开口即可打断，说完自动识别发送。
• 管理：语音包与引擎状态在「设置 › 语音」查看；删除语音包可释放空间。

09 局域网 API

在「设置 › API 服务」开启后，手机就是一个 OpenAI / Ollama 兼容的模型服务器，默认端口 8686：

• Base URL：http://127.0.0.1:8686/v1（本机）；开启「允许局域网访问」后显示局域网地址（如 http://192.168.1.23:8686/v1）。
• OpenAI 兼容：GET /v1/models、POST /v1/chat/completions（支持流式 SSE）。
• Ollama 兼容：GET /api/tags、POST /api/chat。
• 健康检查：GET /health（无需鉴权）。
• API Key：仅本机访问时可不设；开启局域网后强制使用（格式 sk-iris-…，可在页面重新生成）。带 Origin 头的浏览器 / 插件请求即使本机也必须带 Key，否则 403。
• 生成请求与应用内对话共用模型并排队，客户端断开会立即取消，不会占用。

curl 示例

curl http://127.0.0.1:8686/v1/chat/completions \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"stream":true,"messages":[{"role":"user","content":"用一句话介绍你自己"}]}'

Python 示例

from openai import OpenAI
client = OpenAI(base_url="http://192.168.1.23:8686/v1", api_key="sk-iris-...")
for chunk in client.chat.completions.create(
        model="default", stream=True,
        messages=[{"role": "user", "content": "你好"}]):
    print(chunk.choices[0].delta.content or "", end="")

更完整的接口与错误码说明见仓库内 docs/API.md。

10 性能与资源

• 资源档：「设置 › 性能与资源」按机型选择，低档优先省电。
• 空闲卸载：对话空闲一段时间后自动释放模型内存。
• 温度限速：机身发热时自动降频保护。
• 32 位提示：armeabi-v7a 设备请用 4B 以下模型；同一模型在 64 位设备上速度更快。

11 常见问题

12 支持与反馈

使用中遇到任何问题，欢迎直接联系开发者：

项目地址：github.com/ETQWFD/OS-ETC-IRIDIS · 上游：github.com/WWRJ3321/IRIDIS（WWRJ3321）

OS-ETC-IRIDIS © 2026 · Apache-2.0 · 保留原作者 WWRJ3321 的一切版权与致谢。