From fd06a54f57a88d0eab3b7cc4d192ad481eec9762 Mon Sep 17 00:00:00 2001 From: Kellyvv Date: Mon, 6 Apr 2026 06:18:59 +0800 Subject: [PATCH] docs: rewrite features as descriptive paragraphs (Core Features style) --- README.md | 28 ++++++++++------------------ README_EN.md | 28 +++++++++------------------- 2 files changed, 19 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index ae3cf06..da70014 100644 --- a/README.md +++ b/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 内存限制做了缓存清理和历史裁剪。 ## 运行要求 diff --git a/README_EN.md b/README_EN.md index 6a3ce21..abb1ee5 100644 --- a/README_EN.md +++ b/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