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(release): v0.3.1 ships a debug APK as a stopgap
booboosui5ea63ecbd307
diff --git a/README.md b/README.mdindex 1ea992a..8f7ef67 100644--- a/README.md+++ b/README.md@@ -292,6 +292,13 @@ started, and once it runs out, tokens are purchased.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.+To build it yourself instead:> **Requirements**diff --git a/README.zh-CN.md b/README.zh-CN.mdindex 645a17d..632afa9 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -254,6 +254,11 @@ Android。跟它要一个 Andee,它会交给你一个**已经配好令牌**的4. 开悬浮窗,再开无障碍 → 那颗球就出现了```+还有中间那条路 —— **最新一次 [Release](https://github.com/kuafuai/andee/releases/latest) 上挂了一个裸的+debug 包**。它省掉的是「自己打包」,**省不掉「配令牌」**:包里没有任何密钥、默认英文、CodeFlying 关闭,+所以你得自己在 ⚙ → **后端 → 本机** 里填上模型和语音的密钥,它才能干活。它是**拿来试用的过渡包,不是+分发包** —— 为什么、以及代价是什么,发版说明里写清了。+想自己编译的话:> **环境要求**diff --git a/docs/releases/v0.3.1.md b/docs/releases/v0.3.1.mdindex ac53613..1d1b098 100644--- a/docs/releases/v0.3.1.md+++ b/docs/releases/v0.3.1.md@@ -6,10 +6,13 @@ the policy would have made this `0.4.0`. It is recorded rather than left for somfrom the history, because a version number that disagrees with its own policy is the kind of thingthat reads as an oversight later.-> **No APK is attached to this release, on purpose.** The release build type has no `signingConfig`-> and there is no keystore in this repository, so `assembleRelease` emits-> `app-<abi>-release-unsigned.apk`, which will not install until you sign it. Shipping a binary a-> reader cannot install would be worse than shipping none. Build it yourself — see *Install* below.+> **This release carries an APK — the `debug` build, as a stopgap.** The release build type has no+> `signingConfig` and there is no keystore in this repository, so `assembleRelease` emits+> `app-<abi>-release-unsigned.apk`, which will not install until you sign it. Rather than ship nothing+> while that decision is still open, the attached APK is the debug variant: signed with the standard+> Android debug certificate, and it installs as-is. It is `debuggable`, it is larger than a signed+> release build, and it is **bare** — no keys, English, CodeFlying off. See **[Download](#download)**+> for the two keys you will have to supply yourself before it can do anything.## Highlights@@ -131,6 +134,58 @@ that reads as an oversight later.`reports/ball-faces-lab.html`, and the debug WebSocket server (`net/BodyWsServer`) still binds`0.0.0.0:9008` with no authentication (documented in `SECURITY.md`).+## Download++Android 11+ (`minSdk 30`). The APK is **per-ABI** (`splits` in `app/build.gradle`), so pick the file+that matches your device:++| File | Take it if |+|---|---|+| `andee-0.3.1-debug-arm64-v8a.apk` | anything bought in the last several years — **this is the one for almost everyone** |+| `andee-0.3.1-debug-armeabi-v7a.apk` | an older 32-bit device |+| `andee-0.3.1-debug-x86_64.apk` | an emulator |++### This build is deliberately bare++It is built from source with nothing configured — **verified against the generated `BuildConfig`, not+assumed**:++- `CODEFLYING_ENABLED` is `false`, and both `CODEFLYING_KEY` and `CODEFLYING_DOMAIN` are empty, so+ **CodeFlying is not available in this build** and nothing is pre-wired to a hosted backend.+- `DEFAULT_LANG` is `en`: a device that has never picked a language comes up in **English**.+- The thinking default is off.++### The two keys you have to supply yourself++**The assistant cannot do anything until you give it two keys.** Open **⚙ → Backend → On-device** and+fill in:++1. **The model key (LLM)** — an OpenAI-compatible endpoint plus a model name. On an English UI these+ default to `https://api.openai.com/v1` and `gpt-4o-mini`; a Chinese UI defaults to+ `https://api.deepseek.com` and `deepseek-flash`.+2. **The voice key (Volcengine)** — speech recognition and synthesis. Optional: without it the+ assistant is silent but still works on screen.++Then, in this order: grant **Overlay** → enable **Accessibility** → tap the ball. Until the keys are+in, the card the assistant puts up will name what is missing — that is the self-check working, not a+fault.++> **Would you rather not configure keys at all?** Then this APK is the wrong door. Use the one-click+> page instead — **[codeflying.net/andee](https://www.codeflying.net/andee)** (mainland China) or+> **[codeflying.app/andee](https://www.codeflying.app/andee)** (everywhere else). Describe what you+> want, tap the build button, and you get a package with the **tokens already configured** plus a QR+> code to scan. Starting is free and the free token allowance is **finite — once it runs out, tokens+> must be bought.** It is a separate service with no direct relationship to this project, with its own+> terms, pricing and data handling.++### Why a debug build, when the README says not to hand one out++Because the alternative, today, is no binary at all. The README's advice still stands for anything you+*distribute*: a debug APK is `debuggable`, and its certificate is the **shared Android debug key** —+so it cannot install over a release-signed build, which means moving from this to a signed release+takes an uninstall, and an uninstall takes the notebook and the vault with it. Use this to try the+thing, not to hand it to someone who will depend on it.+## Before you installRead **[DISCLAIMER.md](../../DISCLAIMER.md)** and@@ -139,10 +194,10 @@ notification access, SMS and call log, and it can complete a payment by tapping.that path is Android's `FLAG_SECURE`; the prompt-level checks on risky actions are instructions to themodel, not enforcement.-## Install+## Install from source-Android 11+ (`minSdk 30`), arm64-v8a for anything bought in the last several years. There is no binary-in this release; build one:+If you would rather build it yourself — or need a *signed* release build, which is what you should+actually distribute:```bashgit clone https://github.com/kuafuai/andee@@ -151,10 +206,12 @@ git checkout v0.3.1./gradlew :app:assembleDebug # installs as-is, signed with the debug certificate```-`assembleRelease` needs your own keystore — the repo has none, so it produces an unsigned APK. Either-way the APK is **per-ABI** (`splits` in `app/build.gradle`), so pick the file that matches the device.-Full from-scratch setup is in the README's **Provisioning** section. Then, in this order: grant-Overlay → enable Accessibility → tap the ball → put in your own keys under ⚙.+To reproduce the attached build exactly, leave `local.properties` with no `CODEFLYING_*` keys and+`DEFAULT_LANG=en`; that is the whole configuration, and nothing is passed on the command line.++`assembleRelease` needs your own keystore — the repo has none, so it produces an unsigned APK that+will not install until you sign it. Full from-scratch setup, including the JDK traps, is in the+README's **Provisioning** section.**Upgrading from v0.3.0:** `versionCode` moves `4 → 5`, so this installs over it normally. With the**local brain** (the out-of-box default), if your UI is in English and you never saved an LLM endpoint