本仓库是 PAI 的 Android 移植版,基于桌面版 P-AI 二次开发,面向移动端重构。 桌面版原仓库(持续更新、功能最全):kawayiYokami/P-ai
A self-growing AI work system on Android — agent delegation, long-term memory, tool review, MCP, and sandboxed Linux workspace, all on your phone.
PAI 是一个持续进化的 AI 工作系统,不只是聊天客户端。它围绕对话、任务、记忆、部门、工具、审查与远程消息组织成一套完整系统。Android 版将桌面端核心能力搬进移动端:
- Rust 异步后端(tokio + Tauri 2 WebView 桥接),响应快、本地运行
- Vue 3 + DaisyUI 移动端 UI,适配安全区、返回键、录音等交互细节
- 全部数据本地存储,无中间服务器,API Key 不出设备
- 对话与任务:本地会话、远程会话(微信/飞书/钉钉/OneBot)、多会话并行、会话自动压缩归档
- 部门与人格:多部门、多人格独立配置,各带独立头像与私有记忆;本地会话支持多智能体群聊
- 工具与审查:内置 Skill 体系、MCP 支持、工具执行审查链,AI 可自主管理 MCP/Skill/人格/部门
- 记忆与上下文:长对话动态压缩归档,低成本全面记忆系统,越用越懂你
- Android 沙盒工作区:内置 proot Linux 运行环境(arm64),支持 Ubuntu Base rootfs 下载/导入,
在手机上跑 Linux 命令与脚本;
llm-workspace直接映射为 Linux/workspace与/root/.pai - 远程前端模式:输入电脑 PAI 的地址与端口,手机即成为电脑 PAI 的远程前端, 实时同步聊天与设置界面;电脑 PAI 回复时手机仍收到通知
- 移动端细节:内嵌 WebView 单窗口架构、设置页可滚动、录音权限适配、安全区适配、 系统分享导出沙盒文件、content URI 文件导入
APK 发布在 GitHub Releases:
- 推送
v*tag 触发 Android Release 构建:release 包 + secrets 签名后发布 - 推送
main/dev分支触发 Android Build (Debug) 构建:debug APK 上传到 Actions artifact
安装后在应用内配置 LLM API Key 即可开始使用;如需语音输入、记忆检索等能力, 可在「设置 → LLM」补充 STT、Embedding、Rerank 等模型。
环境要求:Node.js(pnpm)、Rust 工具链、Android SDK + NDK(建议 r27+)。
# 前端依赖
pnpm install
# 类型检查
pnpm typecheck
cd src-tauri && cargo check --target aarch64-linux-android
# 构建 Android APK(aarch64)
pnpm tauri android build --apk --target aarch64 --debug # debug 包
pnpm tauri android build --apk --target aarch64 # release 包注:若全局 Cargo 配置了
rustc-wrapper=sccache或特定镜像源,构建 Android target 时 可能需要用--config覆盖(见 docs/android-development-guide.md)。
CI 构建(GitHub Actions):
- Android Build (Debug):
main/dev分支推送或手动触发,构建 debug APK, 版本号由 git 派生(versionCode= 提交总数,versionName=git describe派生), 上传签名后的P-ai-<分支名>-aarch64.apk到 artifact - Android Release:推送
v*tag 或手动触发,release 构建 + secrets 签名 (KEYSTORE_BASE64/KEYSTORE_PASSWORD/KEY_ALIAS/KEY_PASSWORD), 发布签名 APK 到 GitHub Release
- Android 开发指南:Android 移植分支的构建、调试与发布说明
- 更新日志:按版本维护的 changelog(
CHANGELOG.md由脚本生成) - 桌面版完整文档见上游仓库 kawayiYokami/P-ai
本项目是 kawayiYokami/P-ai(桌面版 P-AI)的 Android 移植, 感谢原作者与上游社区。技术栈依赖:Tauri 2 · Vue 3 · DaisyUI · Tailwind CSS · tokio · reqwest · rusqlite · tantivy · proot(Termux)等优秀开源项目。
This project is licensed under GNU General Public License v3.0.