DeepDeep

Android 上的个人智能体

_{深度求索，深知你心。}

简体中文 · English

概览 · 功能预览 · UI 展示 · 快速开始 · 安装与配置 · 开发 · 文档 · 贡献 · License

概览

DeepDeep 对标所有手机厂商的内置智能助理，支持长按电源一键唤醒，浮层语音输入和输出。

同时配备完整的 Harness 工程，包含工具、技能、长期记忆、MCP 扩展和插件系统。它便捷地运行在手机上，无需服务器，无需电脑常开，随时随地都可以打开使用，只要你长按电源，一句话，它就能开始工作，把事情办好。

DeepDeep拥有内置的超轻量Linux环境，能够覆盖99%的电脑办公和代码任务，但本质运行在Android手机系统上，也能为你操作手机文件：找寻图片，清理垃圾，整理文件，编写代码，优化手机，甚至通过屏幕工具，开启虚拟屏幕操作你的APP。

除此之外，DeepDeep还拥有丰富的插件生态，能够通过mcp和cli连接外部服务，帮你处理远程任务：接入飞书，企业微信，高德地图，麦当劳MCP，Notion笔记，邮件等。为你的工作，生活，学习各个方面提高效率。

最后，DeepDeep秉持开源开放原则，代码足够安全透明，无任何外部网络服务（除了您向模型服务商的LLM网络请求外），全程无任何数据收集和上传行为。

使用 DeepDeep 时，请遵循 App 内的用户协议。

当前版本为 1.0.0，安装包发布在 GitHub Releases，源码已公开。

功能预览

https://github.com/user-attachments/assets/a6e1d2c3-3d13-4ce4-afec-aaa0d1b5bf5b

多形态交互

_{长按电源唤醒，支持语音与文字交互。}

https://github.com/user-attachments/assets/bfeaac5e-da31-4790-a9e3-3f7e9a6b2018

帮我盯

_{监控预约系统，有空位直接订票。}

https://github.com/user-attachments/assets/32019883-ca2d-40f6-b18f-6c941131cc64

虚拟屏幕操作 App

_{后台不打扰，帮你看帮你做。}

https://github.com/user-attachments/assets/9deb4845-514d-4c42-a197-0fa80f2cd9f4

小程序

_{制作应用添加到桌面。}

https://github.com/user-attachments/assets/d387b523-4283-4269-9302-63f135e3541c

统一扫码

_{统一入口识别各类生态，可自定义策略。}

https://github.com/user-attachments/assets/11c0d18c-192d-4e15-98bf-c6fb95498fae

远程连接

_{连接电脑上的 DSH。}

UI 展示

DeepDeep 界面：主界面、抽屉、模型服务商、设置与个性化

_{主界面、抽屉、模型服务商、设置与个性化。}

快速开始

下载安装包。 从 GitHub Releases 下载最新版本。
安装并打开。 系统要求 Android 10 及以上。首次启动会进入引导界面；建议跟着流程走，也可以跳过，之后在设置中逐项完成。
连接模型。 进入「设置 → 服务商」，选择服务商并填写 API Key，或使用 OAuth 登录。建议使用 DeepSeek 模型，或 GPT 订阅。
初始化 Linux。 进入「设置 → 系统访问」的「Linux 环境」区完成 Alpine 初始化；这一步建议认真完成，请根据提示完成基础配置。
选择系统访问。 默认使用普通档。需要操作其他应用时，在「设置 → 系统访问」中选择并跟随教程开启无线调试或 Root。开启无线调试时，你可以通过系统通知输入验证码，若系统通知无法使用，可以通过小窗化/分屏DeepDeep，在无线配对界面观察验证码，再在 DeepDeep 中输入。

安装与配置

安装

项目	说明
系统	Android 10 及以上
安装包	从 GitHub Releases 下载 APK
账号	没有账号系统；模型 Key 仅保存在本机
升级	使用同一签名覆盖安装；更换签名需要先卸载，卸载会删除本机会话与凭据
网络	对话内容只发送给已配置的模型厂商；市场与更新检查访问 GitHub，可能需要VPN服务

配置

配置项	位置	说明
模型服务商	设置 → 服务商	支持 42 家 Provider；API Key 或浏览器 OAuth
系统访问	设置 → 系统访问	普通 / 无线调试 ADB / Root 三档；档位决定 bash 与文件操作的身份
Linux	设置 → 系统访问 → Linux 环境	初始化 Alpine；安装命令、Node、Python 与编译工具链
Android 集成	设置 → Android 设置	悬浮窗、系统助手、通知与分享接收
远程连接	抽屉 → 远程连接	通过 `dsh-mobile` 配对电脑
插件	抽屉 → 插件	导入签名 `.ddp`；查看能力清单与运行状态
记忆	自动	会话结束时沉淀；可搜索，也可注入当前会话

边界

项目	说明
Linux 隔离	普通、无线调试档的 Alpine 运行在 proot 用户空间，不是安全沙箱；Root 档直接使用系统 root 环境
插件权限	插件与 App 同进程、同 UID，没有沙箱
审批	只分系统访问三档：普通、无线调试、Root，不逐条确认命令
运行位置	任务在本机执行；关闭 App 后停止，目标续跑只在进程内有效
受保护页面	支付、密码等页面禁止截图，Agent 会把控制权交还给你
分发	1.0.0 通过 GitHub Releases 分发，未上架应用商店；源码已公开

开发与构建

模块、构建与验证

模块	职责
`app/`	Compose UI、聊天、文件、设置、插件页、小程序容器与页面装配
`runtime/`	Agent 运行时：会话、工具、记忆、任务、定时器、插件加载
`runtime-api/`	纯 JVM 契约，供 runtime 与宿主解耦
`shell/`	proot 与 ADB/Root 系统访问后端
`design/`	主题、图标、通用组件与设计 token
`plugin-api/`	插件契约与可发布 SDK

需要 JDK 17 或更新版本、Android SDK Platform 36、build-tools 36.0.0。

./scripts/dev-setup.sh        # 首次：检查环境、写 local.properties、拉 SDK、出 APK
./scripts/check.sh            # 日常：编译 + 单测 + lint + 模块边界 + APK
./scripts/check.sh --full     # 交付前：再加插件 SDK ABI 基线
./scripts/check.sh --device   # 再加覆盖安装到手机并启动

dev.pi SDK 由 Gradle 任务从 pi2kotlin v0.6.3 Release 下载并校验 sha256，不依赖本机 ~/.m2。所有 Gradle 调用走 ./scripts/gradlew-locked；本机并发构建可能 OOM。

更多内容见开发指南与插件开发。

文档与反馈

用户指南：安装、系统访问、Linux、插件、小程序、远程连接与常见问题。
开发指南：环境、模块、构建、测试与代码约定。
插件开发：插件契约、清单、签名、生命周期与 UI 扩展。
发布说明：签名、打包与分发流程。
变更记录：按版本记录功能与修复。

贡献

欢迎提交 Issue 与 PR。提交前请阅读贡献指南。插件作者可以从插件开发与 DeepDeep-Official-Plugins 开始。安全相关问题请不要公开提交，直接联系作者。

License

自有代码使用 Apache-2.0。第三方组件、字体与图标的许可信息见 THIRD_PARTY_NOTICES.md。

_{Built on pi · pi2kotlin · Alpine Linux · Jetpack Compose}