Andee lives on your phone or Mac and uses any app like you do—no integrations, no root, any model; memory and passwords never leave your device | Andee 住进你的手机或 Mac,像你一样操作任何 App——无需集成、无需 Root、支持任意模型,记忆和密码绝不离开设备。
docs(readme): install comes first and leads with CodeFlying; the recent features
booboosuia395e20842c5
diff --git a/README.md b/README.mdindex 97fc545..fbdeab3 100644--- a/README.md+++ b/README.md@@ -5,10 +5,10 @@<p align="center"><a href="https://www.codeflying.app/andee">Build online</a> ·- <a href="https://www.codeflying.app/andee">Try now</a> ·+ <a href="#install">Install</a> ·<a href="docs/getting-started.md">Getting started</a> ·<a href="#key-features">Features</a> ·- <a href="#quick-start">Quick start</a> ·+ <a href="#build-from-source">Build from source</a> ·<a href="#provisioning">Provisioning</a> ·<a href="#what-it-looks-like">What it looks like</a> ·<a href="#permissions-why-each-one-and-what-happens-if-you-refuse">Permissions</a> ·@@ -23,7 +23,7 @@<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0%20%2B%20conditions-155eef"></a><a href="app/build.gradle"><img alt="Platform" src="https://img.shields.io/badge/platform-Android%2011%2B%20(API%2030)-3ddc84"></a><a href="desktop/build.gradle"><img alt="macOS" src="https://img.shields.io/badge/platform-macOS%2014%2B%20(arm64%20%2F%20x64)-555555"></a>- <a href="app/build.gradle"><img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-1.9.22-7f52ff"></a>+ <a href="app/build.gradle"><img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-2.1.21-7f52ff"></a><a href="docs/permissions.md"><img alt="No content telemetry" src="https://img.shields.io/badge/telemetry-no%20content-0f6e56"></a><a href="CONTRIBUTING.md"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-fdb062"></a></p>@@ -53,6 +53,41 @@<https://github.com/user-attachments/assets/bf560279-d86c-4301-9bcb-01d60fa33d06>+## Install++**Recommended: one-click build on [CodeFlying](https://www.codeflying.app/andee).** Open the page and tap the+build button; what you get is an installable package with **the model and voice keys already configured** —+scan to download, install, and it can talk. No building it yourself, no signing up for keys at three different+providers. New accounts get a free allowance to get started; after that, tokens are purchased.+(中文:[codeflying.net/andee](https://www.codeflying.net/andee))++```text+1. Open https://www.codeflying.app/andee → build → scan to download+2. Install+3. Grant Overlay, then Accessibility → the ball appears; tap it to talk+```++CodeFlying is a separate service with no direct relationship to this project; its own terms, pricing and data+handling apply.++**Or download a release.** Every [release](https://github.com/kuafuai/andee/releases/latest) carries a phone+package and a Mac package, in English and in Chinese:++| Device | Download | After installing |+| --- | --- | --- |+| Android phone / tablet (Android 11+) | `andee-<version>-en-android-arm64-v8a.apk` (almost every device) | grant Overlay, then Accessibility |+| Mac, Apple silicon (macOS 14+) | `andee-<version>-en-mac-arm64.dmg` | open the dmg, drag Andee to Applications; allow Accessibility and Screen Recording when it asks |+| Mac, Intel | `andee-<version>-en-mac-x64.dmg` | the same |++Release packages carry **no keys**: after installing, put your CodeFlying key (you get one when you sign up there)+in ⚙ → **Backend**, or switch to On-device and enter your own model and voice keys. When a newer version is out,+it tells you once at launch; Upgrade takes you to CodeFlying.++To build it yourself, see [Build from source](#build-from-source). For why each permission is needed and what+happens if you refuse, see [Permissions](#permissions-why-each-one-and-what-happens-if-you-refuse).++## What it is+**It is not here to help you use your phone. It is here to be the thing that lives in it.** Once it isinstalled, the device has a resident rather than a set of features: it does its thinking **on that device**,keeps a notebook only it can read, and behaves the same when nobody is watching. What it *is* comes first@@ -193,7 +228,8 @@ test decides what gets written: *"next time I deal with them, would not knowingit wrong?"* The notebook is **private** — the tools are `localOnly` and filtered out of the hubpayload, so habits and promises never leave the device. On top of it sits a real scheduler, undera hard rule: the moment it says "I'll remind you", the task must already be set and confirmed. And it-is yours to read: **What it remembers** lists every memory and every scheduled task — all deletable.+is yours to read: the **notebook** has eight tabs — Self · Cares · Diary · Plan · People · Wiki · Memories ·+Todos — and every memory and todo there is deletable.**Finished topics get put away, not deleted.** A conversation that has ended is the most expensivething in every later request and the least likely to be needed again, so the nightly review folds itinto a titled summary with a one-line marker left in its place — and the verbatim conversation is@@ -207,6 +243,18 @@ conversation alone, *"nobody is watching you, nobody is waiting for you to answemake no sound, and do not touch the device. It closes out its own promises, notes which habits areworth turning into a scene next time, and ends empty-handed rather than inventing something to record.+**9. It has things of its own.** (new)+It keeps **who it is** (a short first-person account it rewrites as things happen), **what it cares about** (a+community you handed it, something it promised someone, a question it wants to work out — each with how often it+means to look), **the people it knows** (only the ones it has actually dealt with, never copied from your+contacts), and a **wiki** (the plans, research and reviews it writes, as Markdown files you can open and send on).+Every night it writes a **diary** page in its own voice — a status report is refused.+**It gets up by itself, with nobody asking**: while you are using the device it checks about every 20 minutes+whether something has waited too long, and if so works on it for a while — writing a plan, tidying the people it+knows, noting a thought, at most one bubble. It **does not touch the screen, speak, or send anything for you**+then, and the device enforces that. How overdue something is, and whether it got done, are counted by the device+from the record, not taken from the model. Settings → On its own turns it off.+### Face — a character, not a theme**9. Six looks, nineteen moods, and a face it chooses.**@@ -318,38 +366,10 @@ channels — speech, text, a full-screen page, saved artifacts, long text, and pEverything drawn here is in this repository, down to the guard rails — see[Why you can check this instead of trusting it](#why-you-can-check-this-instead-of-trusting-it).-## Quick start--The fastest route skips the two things that actually stop people: **building it yourself, and wiring-up tokens.**+## Build from source-**[codeflying.app](https://www.codeflying.app/andee)** (English) · **[codeflying.net](https://www.codeflying.net/andee)**-(Chinese) is a general platform for exactly that shape of problem — **you describe the app you want in-words, and it develops and publishes it for you.** No Android knowledge required. Ask it for Andee and-it hands you an installable package with the keys already configured. Or open the-**[one-click page](https://www.codeflying.app/andee)**, tap the build button, and get a-pre-configured package with a QR code — scan to download.--**It is a separate service with no direct relationship to this project** — not Andee's build channel,-and not covered by anything in this repository. Its own terms, pricing and data handling apply.--Two things it does **not** skip. **You still install the package** — the device side is still an APK-that has to be put on the device. And **the free token allowance is finite**: it covers getting-started, and once it runs out, tokens are purchased.--```text-1. Open https://www.codeflying.app/andee (Chinese: https://www.codeflying.net/andee)-2. Describe the Andee you want-3. Build → download the package (keys already configured) → install-4. Grant Overlay, then Accessibility → the ball appears-```--Or take the middle route — **a bare debug APK is attached to the-[latest release](https://github.com/kuafuai/andee/releases/latest)**. That skips building it yourself,-but **not** the token setup: no keys are configured, it comes up in English, and CodeFlying is off, so-you put your own model and voice keys in under ⚙ → **Backend → On-device** before it can do anything.-It is a stopgap for trying the thing rather than a distribution build; the release notes say why and-what it costs.+If you only want to use it, see [Install](#install) above. This is the route for building it yourself; the full+Android steps are further down, under [Provisioning](#provisioning).**On a Mac**, build the desktop app from the same checkout (Apple silicon, macOS 14+, the Command Line Toolsfor `swiftc`, and the same JDK 17–20):@@ -411,6 +431,9 @@ JAVA_HOME=~/jdk-x64/jdk-17.0.20.1+1/Contents/Home \./gradlew --stop && ./gradlew :desktop:packageDmg # → Andee-1.0.0.dmg (arm64)```+Both architectures write the **same** file, `desktop/build/compose/binaries/main/dmg/Andee-1.0.0.dmg`, so the+second build overwrites the first — rename it to the name in the table above before building the other one.+**Two failures here are silent.**`createRuntimeImage` is declared up to date whenever its *inputs* have not changed, and the JVM it@@ -487,7 +510,7 @@ which surfaces as a **connect timeout** — the device looks like it has a netwohas is a blank field. Everything else still works; it is just mute and deaf.Whichever you pick, the audio goes to that provider — see [DISCLAIMER.md](DISCLAIMER.md).-> **If you took the CodeFlying route in [Quick Start](#quick-start), both keys are already baked in.**+> **If you took the CodeFlying route in [Install](#install), both keys are already baked in.**> ⚙ → **Backend** will show **CodeFlying** as the active tab; LLM, ASR, TTS and the long tail of> third-party APIs (image / video / music generation, geolocation, weather, PDF, search, news,> stocks, …) all go through one key, wrapped and billed by CodeFlying so you don't sign up for each@@ -699,7 +722,7 @@ If you want to see how the decisions were made rather than only what was decidedDescribe the Andee you want, and it hands you an installable package with the keys alreadyconfigured — nothing to compile locally, and nothing about Android to understand first. A freetoken allowance gets you started; it is finite, and once it runs out, tokens are purchased.-- **Self-hosted.** Clone, build, install. See [Quick start](#quick-start) and the provisioning+- **Self-hosted.** Clone, build, install. See [Build from source](#build-from-source) and the provisioningwalkthrough in [Provisioning](#provisioning). Point it at any OpenAI-compatible endpoint and itruns with no private backend at all.- **Bring your own body.** The tool contract is the seam. Anything that can speak it — a phone, a@@ -715,7 +738,7 @@ Pure Kotlin, no Compose; the whole thing hangs off two pillars, `WindowManager`| What | Value | Why || ------------------------- | ------------------- | ----------------------------------------------------------------------------------------- || Android Gradle Plugin | 8.3.1 | `agp` in `gradle/libs.versions.toml` |-| Kotlin | 1.9.22 | pinned at the top of `app/build.gradle` |+| Kotlin | 2.1.21 | pinned in the root `build.gradle`; all three modules move together || compileSdk / targetSdk | 34 | Android 14 || minSdk | 30 | Android 11 — `AccessibilityAction.ACTION_IME_ENTER` and `takeScreenshot` are both API 30+ || Java / Kotlin JVM target | 1.8 | `sourceCompatibility` 1.8, `jvmTarget = '1.8'` |@@ -855,7 +878,7 @@ Gradle reads either.- Network (WiFi / 4G / 5G all fine). ASR and TTS go over the public internet, the brain hub goes overthe LAN; in `local` mode only the public internet is used-### Install+### Installing a build you made```bash./gradlew installDebug # device attached over USB, or already on wireless adb@@ -1105,6 +1128,9 @@ Blur or avoid anything private — yours or anyone else's — before it goes up.| Show and tell | What you built with it, fun or not — see [Showcase](#showcase) || Security | Vulnerabilities — privately, never in a public issue. See [SECURITY.md](SECURITY.md) || Product / online | Trying Andee without building it yourself — [codeflying.app](https://www.codeflying.app/andee) · [codeflying.net](https://www.codeflying.net/andee) |+| WeChat | Add Andee as a friend — scan the code below, or tap the WeChat icon at the foot of the chat |++<p align="center"><img src="images/wechat-qr.jpg" width="220" alt="Scan with WeChat to add Andee as a friend"></p>## Security disclosurediff --git a/README.zh-CN.md b/README.zh-CN.mdindex de35ab2..549bda4 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -9,10 +9,10 @@<p align="center"><a href="https://www.codeflying.net/andee">在线构建</a> ·- <a href="https://www.codeflying.net/andee">立即体验</a> ·+ <a href="#安装">安装</a> ·<a href="docs/getting-started.zh-CN.md">入门指南</a> ·<a href="#核心能力">核心能力</a> ·- <a href="#快速开始">快速开始</a> ·+ <a href="#从源码构建">从源码构建</a> ·<a href="#权限每一项为什么以及你拒绝了会怎样">权限</a> ·<a href="#为什么你可以去核对而不是选择相信">可核对</a> ·<a href="SECURITY.md">安全</a> ·@@ -25,7 +25,7 @@<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0%20%2B%20conditions-155eef"></a><a href="app/build.gradle"><img alt="Platform" src="https://img.shields.io/badge/platform-Android%2011%2B%20(API%2030)-3ddc84"></a><a href="desktop/build.gradle"><img alt="macOS" src="https://img.shields.io/badge/platform-macOS%2014%2B%20(arm64%20%2F%20x64)-555555"></a>- <a href="app/build.gradle"><img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-1.9.22-7f52ff"></a>+ <a href="app/build.gradle"><img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-2.1.21-7f52ff"></a><a href="docs/permissions.zh-CN.md"><img alt="遥测不含内容" src="https://img.shields.io/badge/遥测-不含内容-0f6e56"></a><a href="CONTRIBUTING.zh-CN.md"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-fdb062"></a></p>@@ -50,6 +50,36 @@https://github.com/user-attachments/assets/866e8333-e97b-4bf5-9525-540f9fdb01cd+## 安装++**推荐:到 [CodeFlying](https://www.codeflying.net/andee) 一键打包。** 打开页面点「立即打包」,拿到的是一个+**已经配好模型和语音令牌**的安装包,扫码下载、装上就能说话 —— 不用自己打包,也不用去各家申请密钥。+新用户有免费额度,够你上手;用完之后需要购买。(English: [codeflying.app/andee](https://www.codeflying.app/andee))++```text+1. 打开 https://www.codeflying.net/andee → 立即打包 → 扫码下载+2. 安装+3. 开悬浮窗,再开无障碍 → 那颗球就出现了,点它说话+```++CodeFlying 是一个独立的服务,和本项目没有直接关系;它自己的条款、定价和数据处理方式,都是它自己的。++**也可以直接下载发布包。** 每次 [Release](https://github.com/kuafuai/andee/releases/latest) 都挂着手机和 Mac+两种包,中英文各一份:++| 设备 | 下载哪个 | 装好之后 |+| --- | --- | --- |+| Android 手机 / 平板(Android 11+) | `andee-<版本>-zh-android-arm64-v8a.apk`(绝大多数设备) | 开悬浮窗、开无障碍 |+| Mac,Apple 芯片(macOS 14+) | `andee-<版本>-zh-mac-arm64.dmg` | 打开 dmg,把 Andee 拖进「应用程序」;它要「辅助功能」和「屏幕录制」时允许 |+| Mac,Intel | `andee-<版本>-zh-mac-x64.dmg` | 同上 |++发布包里**没有任何令牌**:装好之后要在 ⚙ → **后端**里填 CodeFlying 的密钥(在 CodeFlying 注册就有),+或者切到「本机」填你自己的模型和语音密钥。有新版本时,它启动时会提醒你一次,点「去升级」就到 CodeFlying。++想自己从源码构建,见[从源码构建](#从源码构建)。权限为什么要、拒绝了会怎样,见[权限](#权限每一项为什么以及你拒绝了会怎样)。++## 他是谁+**他不是来帮你用手机的,他是来住进这台设备的。** 装上去之后,这台设备是多了一个住户,而不是多了一堆功能:他**在这台设备上**思考,留一本只有他自己能读的笔记本,而且没人看着的时候还是同一个样子。这里先说他**是什么**,再说他**能做什么**。@@ -163,7 +193,7 @@ Android 13 及以上,它通过无障碍服务自带的输入通道打字 —*"下次跟这个人打交道,不知道这件事会不会让我搞错?"* 这本笔记本是**私人的** —— 对应工具是`localOnly`,在发往 hub 的载荷里被过滤掉,习惯和承诺从不离开设备。上面还有一个真的调度器,规矩很硬:说出"我会提醒你"的那一刻,任务必须**已经设好并确认过**。而且这本笔记你看得到:-**「它记得的事」**里列着每一条记忆和每一个定时任务,每一条都可以删。+**「小本本」**分八页 —— 自己 · 在意 · 日记 · 打算 · 人 · 维基 · 记忆 · 待办,记忆和待办每一条都可以删。**聊完的话题会被收起来,而不是删掉。** 一段结束了的对话,是之后每一次请求里最贵、又最不可能再被用到的东西。所以每晚的复盘会把它折成一段带标题的摘要,原地只留一行标记 —— 逐字的对话存档在旁边。回溯里那些消息变成一张卡片,上面有**继续话题**、**对话记录**和**产出物**。你问到摘要里没写的细节时,@@ -174,6 +204,15 @@ Android 13 及以上,它通过无障碍服务自带的输入通道打字 —*"没人在看你,也没人在等你回答。"* 两条规矩:**不许出声**,**不许碰设备**。他去收尾自己许下的承诺,记下哪些习惯下次值得提议成情景,并且**宁可空手结束,也不为了记而编一条**。+**9. 他有自己的事。**(新)+他会写下**自己是谁**(一段第一人称的自述,会随经历改写)、**在意的事**(你交给他的一个社区、答应别人的+一件事、一个想弄明白的问题 —— 每件都有「多久该看一次」)、**认识的人**(只记他真正打过交道的人,不从通讯录+同步),以及一个**维基**(他写的方案、调研、复盘,都是 Markdown 文件,可以打开、可以发给别人)。每晚写一页+**日记**,用他自己的口气,不许写成工作汇报。+**没人叫他,他也会自己动起来**:你在用设备时,他大约每 20 分钟想一想有没有哪件事拖得太久;值得就自己做一会儿+—— 写方案、整理认识的人、记下想法,最多留一个气泡。这时候他**不碰屏幕、不出声、也不替你发任何东西**,这一条是+设备强制的。多久算拖久、做没做成,都由设备按记录来算,不听他自己说。设置里「自己动起来」可以关掉。+### 脸 —— 性格,不是主题皮肤**9. 六个形象、十九种情绪,表情它自己挑。**@@ -268,33 +307,10 @@ agent loop **就是** `LocalBrain`。它让系统提示词保持不变,把会图上画的每一样都在本仓库里,连护栏也在 ——见[为什么你可以去核对,而不是选择相信](#为什么你可以去核对而不是选择相信)。-## 快速开始--**最快的一条路,省掉的是真正卡住人的那两件事:自己打包、自己配令牌。**--**[codeflying.app](https://www.codeflying.app/andee)**(English)· **[codeflying.net](https://www.codeflying.net/andee)**-(中文)就是一个干这件事的通用平台 —— **你用一句话描述想要的应用,它帮你开发并发布。** 不需要先懂-Android。跟它要一个 Andee,它会交给你一个**已经配好令牌**的安装包。也可以直接打开-**[一键体验页](https://www.codeflying.net/andee)**,点「立即打包」即可复制母应用、生成一个已配好令牌的-安装包二维码,扫码下载。--**它是一个独立的服务,和本项目没有直接关系** —— 不是 Andee 的构建通道,本项目里的东西也管不到它。-它自己的条款、定价和数据处理方式,都是它自己的。--有两件事它省不掉。**装这一步省不掉** —— 设备那侧仍然是一个 APK,仍然要装到设备上。-**免费 token 额度也是有限的** —— 够你上手,用完之后需要购买 token。+## 从源码构建-```text-1. 打开 https://www.codeflying.net/andee (English: https://www.codeflying.app/andee)-2. 描述你想要的 Andee-3. 构建 → 下载安装包(令牌已配好)→ 安装-4. 开悬浮窗,再开无障碍 → 那颗球就出现了-```--还有中间那条路 —— **最新一次 [Release](https://github.com/kuafuai/andee/releases/latest) 上挂了一个裸的-debug 包**。它省掉的是「自己打包」,**省不掉「配令牌」**:包里没有任何密钥、默认英文、CodeFlying 关闭,-所以你得自己在 ⚙ → **后端 → 本机** 里填上模型和语音的密钥,它才能干活。它是**拿来试用的过渡包,不是-分发包** —— 为什么、以及代价是什么,发版说明里写清了。+只想用、不想自己构建的话,看上面的[安装](#安装)。下面是自己构建的路:Android 的完整步骤在后面的+[构建配置](#构建配置)、[配 JDK](#配-jdk)、[把自己构建的包装到设备](#把自己构建的包装到设备)几节。**在 Mac 上**,同一份代码可以构建桌面版(Apple 芯片、macOS 14+,要装 Command Line Tools 来提供`swiftc`,JDK 同样是 17–20):@@ -336,6 +352,9 @@ JAVA_HOME=~/jdk-x64/jdk-17.0.20.1+1/Contents/Home \./gradlew --stop && ./gradlew :desktop:packageDmg # → Andee-1.0.0.dmg(arm64)```+两种架构打出来的文件名**都是** `desktop/build/compose/binaries/main/dmg/Andee-1.0.0.dmg`,后打的会覆盖先打的 ——+打完一个先按上表改名,再打另一个。打包要先装 `dmgbuild`,步骤见英文 README 的 Mac packaging 一节。+**这里有两处失败是静默的。**只要**输入**没变,`createRuntimeImage` 就被判成 up-to-date —— 而它跑在哪个 JVM 上并不算输入。换架构时@@ -402,7 +421,7 @@ Google),再填该服务商的密钥。这是两个独立的服务,条款其实是那一栏空着。其余功能照常,只是既听不见也说不出。不管你选哪家,音频都会发到那家 —— 见 [DISCLAIMER.zh-CN.md](DISCLAIMER.zh-CN.md)。-> **如果你走的是[快速开始](#快速开始)里 CodeFlying 那条路,这两把 Key 都已经在安装包里了。**+> **如果你走的是[安装](#安装)里 CodeFlying 那条路,这两把 Key 都已经在安装包里了。**> ⚙ → **后端**会直接显示 **CodeFlying** 这一 tab 为当前后端;LLM、ASR、TTS 以及海量第三方 API> (AI 图片/视频/音乐生成、地理位置、天气、PDF、搜索、新闻、股票……)都走同一把 Key,由 CodeFlying> 统一封装并计费,免去你逐一申请密钥和维护账单的麻烦。上面两把 Key 只适用于你自己配置的**本机** tab。@@ -489,7 +508,7 @@ Google),再填该服务商的密钥。这是两个独立的服务,条款发布"的通用平台,**是独立服务,不属于本项目。** 描述你想要的 Andee,它会给你一个已经配好令牌的安装包;本地不用编译,也不用先懂 Android。免费额度够上手,用完之后需要购买 token。-- **自己部署。** 克隆、构建、安装 —— 见[快速开始](#快速开始),以及本文下面完整的+- **自己部署。** 克隆、构建、安装 —— 见[从源码构建](#从源码构建),以及本文下面完整的[装机顺序建议](#装机顺序建议)。接任意 OpenAI 兼容端点即可运行,**不依赖任何私有后端**。- **换一具身体。** 工具契约就是那道缝。任何说得出这套契约的东西 —— 手机、平板、另一块硬件@@ -521,7 +540,7 @@ Google),再填该服务商的密钥。这是两个独立的服务,条款| 项 | 值 | 说明 ||---|---|---|| Android Gradle Plugin | 8.3.1 | `gradle/libs.versions.toml` 里的 `agp` |-| Kotlin | 1.9.22 | `app/build.gradle` 顶部固定 |+| Kotlin | 2.1.21 | 根目录 `build.gradle` 固定,三个模块一起动 || compileSdk / targetSdk | 34 | Android 14 || minSdk | 30 | Android 11 —— 因为要用 `AccessibilityAction.ACTION_IME_ENTER`(API 30+)和 `takeScreenshot`(API 30+) || Java / Kotlin JVM target | 1.8 | `sourceCompatibility` 1.8、`jvmTarget = '1.8'` |@@ -649,7 +668,7 @@ Linux 通常是 `/home/<user>/Android/Sdk`,Windows 是- 需要麦克风,否则 ASR 用不了- 需要联网(WiFi / 4G / 5G 都行)—— ASR / TTS 走公网,大脑 hub 走 LAN;用 `local` 模式则只走公网-## 安装+## 把自己构建的包装到设备```bash./gradlew installDebug # 设备已插 USB 或已连 wifi adb@@ -954,6 +973,9 @@ CLAUDE.md 给 AI 编码助手看的架构说明(英文)| 好玩的用法 | 你用它做过什么,实用不实用都行 —— 见[好玩的用法](#好玩的用法) || 安全 | 漏洞 —— 走私密渠道,永远不要开公开 issue。见 [SECURITY.md](SECURITY.md) || 产品 / 在线 | 不想自己打包就想试 Andee —— [codeflying.net](https://www.codeflying.net/andee) · [codeflying.app](https://www.codeflying.app/andee) |+| 微信 | 加 Andee 为好友 —— 扫下面的码,或者点聊天页底部的微信图标 |++<p align="center"><img src="images/wechat-qr.jpg" width="220" alt="用微信扫码,添加 Andee 为好友"></p>## 安全披露diff --git a/docs/getting-started.md b/docs/getting-started.mdindex 9f957fa..e821580 100644--- a/docs/getting-started.md+++ b/docs/getting-started.md@@ -10,7 +10,7 @@ Pick the route that matches what you want to do:- **Try it without building:** use the [CodeFlying build page](https://www.codeflying.app/andee) for a pre-configured APK. This is a separate service, and its own terms and token limits apply.- **Try a repository build:** download the bare debug APK from the [latest release](https://github.com/kuafuai/andee/releases/latest). It has no credentials, so you must configure the on-device model and voice keys later.-- **Build it yourself:** follow the Android requirements and commands in [Quick start](../README.md#quick-start), then use the detailed [Provisioning](../README.md#provisioning) reference if the toolchain is not ready.+- **Build it yourself:** follow the Android requirements and commands in [Build from source](../README.md#build-from-source), then use the detailed [Provisioning](../README.md#provisioning) reference if the toolchain is not ready.For a first run, use a real Android 11 (API 30) or newer device. An emulator can install the app, but most device-control features are not meaningful there.diff --git a/docs/getting-started.zh-CN.md b/docs/getting-started.zh-CN.mdindex 1e9b9a9..e5dcfa9 100644--- a/docs/getting-started.zh-CN.md+++ b/docs/getting-started.zh-CN.md@@ -10,7 +10,7 @@- **不自己构建,先试用:** 使用 [CodeFlying 构建页](https://www.codeflying.net/andee) 获取已经配置好的 APK。这是独立服务,条款和 token 额度以它自己的规则为准。- **试用仓库构建包:** 从[最新 Release](https://github.com/kuafuai/andee/releases/latest)下载裸 debug APK。里面没有密钥,之后必须自己配置本机模型和语音密钥。-- **自己构建:** 先按 [README 的快速开始](../README.zh-CN.md#快速开始)准备环境和执行命令;工具链没有配好时,再看详细的[装机配置](../README.zh-CN.md#构建配置)。+- **自己构建:** 先按 [README 的从源码构建](../README.zh-CN.md#从源码构建)准备环境和执行命令;工具链没有配好时,再看详细的[装机配置](../README.zh-CN.md#构建配置)。第一次运行请使用 Android 11(API 30)或更新版本的真机。模拟器可以安装,但大多数设备操作功能在那里没有实际意义。diff --git a/images/wechat-qr.jpg b/images/wechat-qr.jpgnew file mode 100644index 0000000..33e2bf9Binary files /dev/null and b/images/wechat-qr.jpg differ