merge: develop → main

README.md

@@ -14,27 +14,19 @@
 
 PhoneClaw 是一个运行在 iPhone 上的本地 AI Agent。它使用 Gemma 4 在设备端完成推理，不依赖云端，不上传聊天内容。
 
-## 项目特点
+## 核心能力
 
-- 完全离线运行，默认不联网
-- 支持图片输入（多模态）
-- 基于文件的 Skill 系统，新增能力不需要重写整个 Agent
-- 支持多轮工具调用
-- 默认可空壳安装 App，再在手机端下载 E2B / E4B
-- 已内置权限管理、System Prompt 编辑、模型切换
-- 针对 iPhone 内存上限做了缓存清理和历史裁剪
+**图片理解（多模态）**：拍照或从相册选图后直接提问，识别内容、解读图表、描述场景。模型在设备端完成推理，照片不会离开手机。
 
-当前已经打通的原生能力：
+**日历 / 提醒事项 / 通讯录**：直接用自然语言创建日历事件、设置提醒（准时弹出通知）、保存或更新联系人。所有写入操作都在本地完成，按手机号自动去重，不会产生重复联系人。
 
-| 能力 | 说明 |
-|------|------|
-| 图片理解 | 拍照或选图后直接提问，支持多模态输入 |
-| 剪贴板 | 读写系统剪贴板 |
-| 设备信息 | 读取设备名称、系统版本、内存等 |
-| 文本处理 | 哈希计算、文本翻转等 |
-| 日历 | 创建日历事件 |
-| 提醒事项 | 创建提醒，准时弹出通知 |
-| 通讯录 | 创建或更新联系人，按手机号去重 |
+**剪贴板与设备信息**：读写系统剪贴板，查询设备名称、系统版本、可用内存等信息，可以在多步任务中作为数据中转使用。
+
+**基于文件的 Skill 系统**：每项能力对应一个 Markdown 文件（SKILL.md），新增或修改能力不需要重新编译 App。Skill 描述语言无关，任何人都可以直接编写和分发。
+
+**完全离线与隐私保障**：所有推理在本地 GPU 完成，默认不建立任何网络连接。聊天内容、图片、个人数据均不上传，不经过任何第三方服务器。
+
+**灵活的模型管理**：支持 Gemma 4 E2B 和 E4B 两个规格，可在手机端直接下载，也可以在构建时打包进 App。内置模型切换、System Prompt 编辑，针对 iPhone 内存限制做了缓存清理和历史裁剪。
 
 
 ## 运行要求

README_EN.md

@@ -14,29 +14,19 @@ A local AI Agent for iPhone. Offline. Private. Native.
 
 PhoneClaw is a local AI Agent that runs entirely on your iPhone. No internet connection. No data uploads. No cloud dependency.
 
-PhoneClaw uses Gemma 4 to run inference entirely on-device. It does not depend on any cloud service and does not upload your conversations.
+## Core Features
 
-## Current Capabilities
+**Image Understanding (Multimodal)**: Take a photo or pick one from your library, then ask questions directly. Identify objects, read charts, describe scenes — all inference happens on your device, and your photos never leave your phone.
 
-| Capability | Description |
-|------------|-------------|
-| Image Understanding | Ask questions about photos or images directly, multimodal input |
-| Clipboard | Read and write the system clipboard |
-| Device Info | Query device name, OS version, memory, and more |
-| Text Tools | Hash calculation, text reversal, and more |
-| Calendar | Create calendar events |
-| Reminders | Create reminders with push notifications at the due time |
-| Contacts | Create or update contacts, deduped by phone number |
+**Calendar / Reminders / Contacts**: Create calendar events, set reminders that fire on time with a push notification, and save or update contacts — all through natural language. Every write operation stays local. Contacts are automatically deduped by phone number.
 
-## Features
+**Clipboard & Device Info**: Read and write the system clipboard, query device name, OS version, and available memory. Useful as a data relay in multi-step tasks.
 
-- Fully offline, no network by default
-- Image input support (multimodal)
-- File-driven Skill system — add new capabilities without rewriting the Agent
-- Multi-round tool calling
-- Supports shell-only app install, then on-device E2B / E4B download
-- Built-in permission management, system prompt editor, and model switcher
-- Dynamic history trimming and GPU cache management for iPhone memory limits
+**File-Driven Skill System**: Each capability is defined by a single Markdown file (SKILL.md). Adding or modifying a skill requires no recompilation. Skills are language-agnostic — anyone can write and share them.
+
+**100% Offline & Private**: All inference runs on the local GPU. No network connections are made by default. Your conversations, images, and personal data are never uploaded or routed through any third-party server.
+
+**Flexible Model Management**: Supports Gemma 4 E2B and E4B. Download models directly on your iPhone, or bundle them into the app at build time. Includes a built-in model switcher, system prompt editor, and automatic history trimming for iPhone memory constraints.
 
 ## Requirements