# Dfy
**轻量安卓 AI Agent —— 手机里内置一个 Alpine Linux，装上就能执行命令、装软件、跑 JVM**
APK 只做协调者：对话 / 规划 / 工具调用 / 展示。执行层三档可选——
**内置 Linux**（APK 自带 busybox + proot/Alpine，装上即用，`apk` 可装软件）、
**Termux 增强**（pkg 生态、共享存储）、**普通**（纯工作区，无 shell）。
默认内置模式：零配置、零权限、零外部依赖。
---
| 首页 | 对话 + 流式 | 工具卡片 | 设置分层 |
|:---:|:---:|:---:|:---:|
|  |  |  |  |
## ✨ 特性
**执行通道（三档显式选择，无自动魔法）**
- 🐳 **内置 Linux（测试版，默认）**：APK 自带静态 busybox + proot + Alpine 3.22 rootfs——
装上即有完整命令行，`linux_exec` 工具可 `apk add` 装软件（python3 / jq / openjdk 全生态）。
DNS 与阿里云镜像已预置，时区已配北京时间，开箱即用
- 🐚 **Termux 增强**：装了 Termux 并授权后可选此档，走 RUN_COMMAND 下发 bash，
pkg 生态 + 共享存储，能力最全
- 🔌 **OpenAI 兼容**：任何提供 `/chat/completions` + function calling 的服务都能接（DeepSeek / OpenAI / Moonshot / 本地 vLLM / Ollama）
**Agent 能力**
- 🛠️ **十二件套工具**：`shell_exec` / `linux_exec`（内置模式）/ `env_check` / `fs_list` / `fs_read` / `fs_write` / `view_image` / `memory_save` / `memory_delete` / `export_file` / `web_search`（可选） / `generate_image`（可选）
- ☕ **跑 JVM 程序**：内置环境锁定 OpenJDK 17（`apk add openjdk17-jre-headless`），Spring Boot / Maven 构建实测可用
- 🖼️ **附件上传 + 看图**：SAF 多选进 `~/uploads/`；看不看图是模型的决策——干活直接处理，理解内容才 `view_image`
- 🎨 **AI 生图（可选）**：模型自主调 `generate_image` 画图，产物落 `~/images/` 并出预览卡片；OpenAI 兼容接口
- 🧠 **长期记忆**：key-value 存本机，常驻系统提示词，模型用工具自己增删改；抽屉里有管理界面
- 🕰️ **时间感知**：系统提示词每轮实时注入设备时钟
- 📦 **交付卡片**：模型产出文件后一键导出到「下载」目录，可直接打开 / 分享
- 🌐 **联网搜索（可选）**：Kimi / DeepSeek / Tavily 三选一，关闭时模型看不到该工具
- ✂️ **上下文自动压缩**：估算到达阈值自动摘要压缩，阈值与力度可调，长对话不爆上下文
- 💳 **秘钥账户制**：多组厂家配置一键切换，DeepSeek 可查余额；模型列表从接口拉取
**体验与安全**
- 🌗 **三档主题**：跟随系统深色模式 / 深色 / 浅色，全页面适配
- 💬 **多会话**：40 个会话落盘，界面消息与模型上下文双份存，改名 / 置顶 / 防抖保存
- 📝 **自研 Markdown 渲染**：代码块带语言标签 + 一键复制，不引第三方库
- 🗂️ **Unix 风格工具卡片**：每条命令一张卡，工具名 / 参数 / 五种状态分色，展开看输出
- 🛡️ **三层命令守卫**：硬拦截 / 二次确认 / 路径白名单，四档策略可选——内置模式的命令同样过守卫
- 🔍 **应用内更新**：检查更新 → 下载 → 安装，全在 App 内闭环
## 🔧 工作原理
```
┌─────────────────────────────────────┐
│ Dfy Agent APK │
│ Compose UI / AgentEngine 规划循环 │
│ ┌───────────────────────────────┐ │
│ │ AgentToolset（12 工具） │ │
│ │ ↕ CommandGuard 三层守卫 │ │
│ │ BackendRouter 按档位分流 │ │
│ └──────┬──────────┬─────────────┘ │
└──────────┼──────────┼───────────────┘
│ │
┌────────▼───┐ ┌───▼──────────────┐
│ 内置模式 │ │ Termux（可选） │
│ busybox │ │ RUN_COMMAND Intent│
│ proot + │ │ app-shell 执行器 │
│ Alpine │ │ bash / pkg │
│ apk 生态 │ │ │
└────────────┘ └──────────────────┘
```
内置模式的实现要点：可执行文件以伪 `.so` 形式随 APK 分发（落在系统唯一放行的
`nativeLibraryDir`），proot + 用户态 loader 绕过 Android 对数据目录的 W^X 限制——
JVM（OpenJDK 17）实测可跑 Spring Boot。详见
[.wiki/decisions.md](.wiki/decisions.md) 与 [EmbeddedLab 实验记录](https://gitee.com/cc123hh/EmbeddedLab)。
## 🚀 快速开始
### 内置模式（默认，零配置）
1. 安装 APK（[Releases](https://gitee.com/cc123hh/Dfy/releases) 或应用内「检查更新」）
2. 设置里填模型（Base URL / API Key / 模型名，任何 OpenAI 兼容接口）
3. 开聊——「跑个命令看看」「装个 python3」「搭个 Spring Boot hello world」
### 可选：Termux 增强
需要 pkg 生态或共享存储时再配置（装 Termux → `allow-external-apps` → 授权 RUN_COMMAND →
关电池优化），详见设置页引导。不用 Termux 也完全可以，内置模式覆盖绝大多数任务。
**联网搜索、AI 生图是独立的可选能力**，在设置里单独开启并填各自的 Key。
## 🛡️ 安全模型
三层，都在 `CommandGuard` 里，内置模式的命令同样过守卫：
1. **硬拦截**：`rm -rf /`、`mkfs`、`dd of=/dev/block/*`、fork bomb、`pm uninstall com.termux`…
2. **二次确认**：`rm -r`、`pkg/pip/npm/apk install`、`curl | sh`、`git push --force`、`su`、`pm/am/settings`、`kill`…
3. **路径白名单**：写入禁止落到 `/system`、`/vendor`、`/data/adb`、`/proc` 等
四档策略（设置页可切）：**平衡**（默认）/ **严格**（非只读全确认）/ **信任**（只拦致命命令）/
**完全信任**（跳过所有拦截与确认，切换需二次确认，只给完全可控的环境用）。
> 说清楚：这是防手滑的护栏，不是沙箱。命令跑在内置 Linux（App 沙箱内）或用户自己的 Termux 权限里。
## 🧠 关键设计决策