Zero Agent

Zero Agent 是一款面向 Android 的本地优先 AI 图片对话应用。它使用兼容 OpenAI Responses API 的服务生成、编辑和连续迭代图片，并把会话与图片保存在设备本地。

当前版本：0.2

功能

• 通过文字或最多 16 张参考图片发起图片生成
• 基于 previous_response_id 连续修改同一张图片
• 流式显示生成中的局部图片
• 后台持续生成，并支持取消和超时处理
• 本地保存会话、消息和图片
• 新建、切换、重命名和删除会话
• 全屏查看、保存和分享生成结果
• 长按图片继续编辑或下载，长按文字选择复制
• 在设置中配置 API 地址、密钥和响应模型

技术栈

• Kotlin 2.2
• Jetpack Compose / Material 3
• Android Gradle Plugin 9.1
• Gradle 9.3.1
• Kotlin Serialization 与 Coroutines

应用最低支持 Android 9（API 28），目标 SDK 为 Android 16 / API 36。

开发环境

建议使用最新版 Android Studio，并安装项目所需的 Android SDK。首次打开项目后，让 Android Studio 完成 Gradle 同步。

项目从根目录的 local.properties 读取本地配置。该文件已被 Git 忽略，不应提交到仓库：

sdk.dir=C\:\\path\\to\\Android\\Sdk
OPENAI_BASE_URL=https://your-api.example/
OPENAI_API_KEY=your-api-key
OPENAI_RESPONSE_MODEL=gpt-5.6
OPENAI_IMAGE_MODEL=gpt-image-2
OPENAI_REASONING_EFFORT=high

也可以使用同名的 Gradle 属性；签名配置还支持从环境变量读取。

默认 API 地址为 https://ai.apecho.com/。应用会把地址规范化为 /v1/responses，因此所配置的服务需要兼容 Responses API 及 image_generation 工具。

构建与测试

Windows：

.\gradlew.bat testDebugUnitTest
.\gradlew.bat assembleDebug

macOS / Linux：

./gradlew testDebugUnitTest
./gradlew assembleDebug

Debug APK 默认生成在 app/build/outputs/apk/debug/。

Release 签名

构建签名 Release APK 前，需要在本地提供以下配置：

RELEASE_STORE_FILE=path/to/release.keystore
RELEASE_STORE_PASSWORD=...
RELEASE_KEY_ALIAS=...
RELEASE_KEY_PASSWORD=...

签名文件、local.properties、APK 和构建目录均已在 .gitignore 中排除。Release 构建不会嵌入 OPENAI_API_KEY，用户需要在应用设置中自行填写。

.\gradlew.bat assembleRelease

数据与安全说明

• 会话记录和图片保存在应用私有目录中，不提供云同步。
• API 密钥保存在应用的本地 SharedPreferences 中，不会由项目代码上传到仓库。
• 当前未使用 Android Keystore 加密 API 密钥；请只在可信设备上使用，并妥善保护设备备份与调试环境。
• 应用已关闭 Android 系统备份，并在备份规则中排除了 SharedPreferences 和图片目录。

项目结构

app/src/main/java/com/example/zeroagent/
├── config/       # API 与模型配置
├── data/         # 会话模型和本地存储
├── generation/   # 后台生成、状态与超时处理
├── network/      # Responses API 客户端
└── ui/           # Jetpack Compose 界面

设计说明和实现计划位于 docs/superpowers/。

License

本仓库目前尚未添加开源许可证。在许可证确定前，公开源代码不代表自动授予复制、修改或分发权利。