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、支持任意模型,记忆和密码绝不离开设备。
chore(release): v0.5.3
booboosuibea617453026
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 495c48f..c133679 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,7 +4,7 @@ Notable changes to Andee. The format follows [Keep a Changelog](https://keepacha## Versioning policy-- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`11` / `"0.5.2"`**.+- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`12` / `"0.5.3"`**.- Releases are tagged `vMAJOR.MINOR.PATCH`, `versionName` mirrors the tag without the leading `v`,and `versionCode` increases by one per release. `versionCode` must increase **monotonically** orAndroid refuses the upgrade; the same number must never be reused for two different builds.@@ -28,6 +28,71 @@ hash into `versionName` at build time would close this hole; it is not implement## [Unreleased]+## [0.5.3] - 2026-10-22++**You can now tell it to stop, out loud, and it will.** "Exit Andee" / "Take a break" (and their+Chinese equivalents) ends the current task and closes the assistant — microphone and wake word+included — with no model call in the path. The rest of the delta is aiming: a large fix for apps that+hand accessibility a blank root, and a documentation pass on the grid it aims with.++The version number is **a deliberate departure from the policy below**. The policy says MINOR for a new+capability and this delta has one, which would make it `0.6.0`; it is `0.5.3` because the capability is+an escape hatch rather than a new way of working, and the two things it is most likely to be confused+with — asking how to exit, or cancelling a subscription — are deliberately *not* commands. Recording it+here rather than leaving a `feat` under a patch for a reader to wonder at.++**This release carries work from a teammate.** The voice-exit feature arrived as [PR+#14](https://github.com/kuafuai/andee/pull/14) from [@lirongkuafuai](https://github.com/lirongkuafuai),+closing [issue #13](https://github.com/kuafuai/andee/issues/13) — fifteen commits, reviewed and merged+rather than imported wholesale.++### Added++- **Voice exit: say it and it stops** (`asr/VoiceExitCommand.kt`). Recognized **on the device, without a+ model call** — an utterance that matches is handled before any card answer or brain submission, so it+ works even when the model is unreachable. It cancels the running task, stops the service and closes+ the assistant, which also **stops the microphone and the wake word**; the app icon starts it again.+ The match is **whole-utterance and user-initiated only**: *"how do I exit Andee"*, *"cancel my+ subscription"* and a quoted command all stay ordinary turns, and a phrase that arrives on an+ automatic follow-up window is ignored (that one has its own test). While a meeting is recording it+ refuses and says why — end the meeting and save the minutes first. Teardown is guarded so a late+ transcript, wake callback or TTS fallback cannot reopen an overlay after the exit was asked for.+- **`popup_open` / `popups` on tap, long-press and screenshot results**, read from the window list,+ which survives a withheld tree. The model could not tell an open menu from a closed one by eye and+ reopened one **six times**; a blind tap aimed *inside* a popup is now refused, with the reason.++### Fixed++- **Aiming on an app that withholds its tree** (measured on WeChat 8.0.79 / HONOR, where accessibility+ gets a blank root and every tap is aimed by eye off a screenshot downscaled to ~0.48×). The injection+ itself was already exact — the misses were all aiming, and this is a large fix:+ - **The grid labels moved to the edges.** Printed at each cell's centre, the `H` column's label sat+ exactly on WeChat's 「··」 button and **hid it**. They are now rulers — letters along the top,+ numbers down the left — and nothing printed inside a cell belongs to the device.+ - **A gesture on a tree-blind app must fall inside a zoom taken since the last one.** Measured:+ zoom-aimed taps changed the screen **33/41** times, screenshot-aimed **124/211**, and the misses+ opened profiles, followed people and deleted comments.+ - **A cell is now fifteen parts, not nine** (`3 × 5`: `top-left` … `bottom-right`). The old nine names+ still parse as aliases mapped to the outer rows, so anything written against the previous+ vocabulary aims where it used to.+ - **The markers are magenta (`#E000FF`), not red** — red is every unread badge in every Chinese app,+ and a red crosshair beside WeChat's red dot read as part of the app. The caption also moved above+ the ring, because below is where the next target is.+ - **Prompt side:** close a small menu by tapping its opener again rather than with `back` (the menu is+ unfocused, so `back` left Moments entirely), and keep list progress instead of restarting at item 1.++### Changed++- **The READMEs' description of aiming was corrected.** They said it taps by *"which third of it"* and+ that the crosshair is *red*; both stopped being true in this release. They now say "which part of it"+ and magenta. Found by re-reading the sentence against the code, not by a search.+- **The English README's language badge is back to ASCII.** A web edit on 2026-10-21 changed the badge+ label from `Chinese` to the Chinese characters for it, which put Han characters back into a file that+ is checked for zero of them. The link target was never in question and did not move. If a Chinese+ label on the English page is actually wanted, that is a decision to make deliberately — the badge is+ the one place a reader who cannot read English has to be able to see themselves — and not something+ to arrive at by accident.+## [0.5.2] - 2026-10-19**Two fixes from watching it work on an app that hides its element tree, and a new hero image.** Thediff --git a/CLAUDE.md b/CLAUDE.mdindex 59338e2..d7b724e 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -135,6 +135,11 @@ Ported from generic_bridge (phone.sh), whose finding is the founding rule here:- 🔴 **`swipe_by_coordinates` does not coast by default, and that is the fix rather than a preference.** A plain `StrokeDescription` lifts while still moving, so the list flung several screens past the target and the model lost its place (measured on a tree-blind 朋友圈: 64 steps / 341 s for one comment). The stroke is now a **continued stroke that holds at the end point** for `SWIPE_HOLD_MS` before lifting — `ACTION_CANCEL` ends a scroll without a fling, so the list moves about as far as the finger did and the distance becomes the control. `fling=true` keeps the old single-stroke behaviour for long jumps, and its tool text says to take a fresh look afterwards rather than assume where it stopped. **A cancelled hold still leaves the list where the finger put it** — do not "fix" that by retrying the gesture.- 🔴 **The tap right after blind typing is refused unless it came from a zoom** (`requireAimedSend`). On an app that withholds its tree, the input strip above the keyboard is thin and sits on top of the post below it, so a grid-cell tap aimed at it lands on that content instead — twice out of two on the same 朋友圈 reply box. After a `type_text` on a tree-blind app, only a tap carrying `on="zoom"` is accepted, with an error that says why; leaving the box clears `typedBlindAt`. Related: `A11yIme.sendsOnlyFromButton` reads `IME_FLAG_NO_ENTER_ACTION` with no custom `actionId` — on such a field (WeChat's comment box) `submit_input` used to report success while sending nothing, so it now reports that it cannot and names the app's own send button.- **Screenshot pixels are never 0-1000 units, and `zoom_screen_region` reports the rectangle it actually showed** (`region`). A capture arrives downscaled (often ~576 px wide as the model sees it), so a position measured in those pixels is the wrong number for `zoom`'s `x/y/w/h`; every zoom echoing `region` back is what lets the model notice it was in the wrong space. The tool text also states that **our own ball is never in a capture** — the device hides its overlays for the instant of capture — because a model that saw a round blue shape blamed it for covering a button and routed around it.+- 🔴 **The grid labels are rulers on the edges, not captions in the cell — and that was a bug, not a restyle.** They used to be printed at each cell's CENTRE, where the `H` column's label sat exactly on WeChat's 「··」 button and hid it (measured, 2026-10-20). Letters now run along the **top** edge and numbers down the **left**, like a map's rulers; nothing printed inside a cell is the device's.+- 🔴 **A tap or long-press on a tree-blind app must fall inside a zoom taken since the last gesture**, and `ZOOM_CONFIRM_MS = 60_000` is the window. The measurement that forced it: zoom-aimed taps changed the screen **33/41** times, screenshot-aimed ones **124/211**, and the misses opened profiles, followed people and deleted comments. This is the strict form of the `requireAimedSend` rule above; that one guards the tap after typing, this one guards every gesture on an app that hands accessibility a blank root.+- **A cell now has fifteen parts, not nine** (`PART_COLS = 3` × `PART_ROWS = 5`, in `ScreenController.PARTS`: `top-left` … `bottom-right`). The old nine names still parse as **aliases** mapped to the outer rows, so a payload written against the previous vocabulary aims where it used to — that was deliberate, and it is why the tool text can say "nine thirds **or**, vertically, upper/lower".+- **`popup_open` / `popups` come from the window list, which survives a withheld tree.** The brain could not tell an open menu from a closed one by eye and reopened one six times; the result now carries the fact, and a blind tap *inside* a popup is refused. Prompt side: close a small menu by tapping its **opener** again, not with `back` — the menu is unfocused, so `back` left Moments entirely — and keep list progress instead of restarting from item 1.+- **The markers are magenta (`#E000FF`), not red.** Every other obvious colour is already taken by real UI (red is every unread badge in every Chinese app, and a red crosshair beside WeChat's red dot read as part of the app), and the ring is the one piece of evidence about where a tap landed. `TapMarkerUi`'s caption sits **above** the ring, not below, because below is where the next target is.- `take_screenshot` downscales to **1280 on the long side** before base64 — proportions are preserved and the 0-1000 protocol is scale-invariant, so this is free token savings.- **Stuck-loop guard**: per-location counting, not consecutive-with-no-change (the real dead-loop interleaves menu opens, wrong pages and backs, and apps emit content events constantly — both naive conditions miss it). Gestures within 120 px of each other share a bucket; within 5 minutes, the 4th tap on the same bucket is refused with an error telling the brain to stop, re-observe, and ask the user. Swipes are exempt (list scrolling legitimately repeats); e-taps are exempt (re-tapping a confirmed element is normal operation).- **NO_TREE policy** (empty-list hint): prefer `back`/`home` to exit and retry via a different route over blind coordinate taps — a wrong exit costs one tap, a wrong tap can cost the task.diff --git a/DISCLAIMER.md b/DISCLAIMER.mdindex c5c9184..5dbf1b9 100644--- a/DISCLAIMER.md+++ b/DISCLAIMER.md@@ -46,7 +46,7 @@ The second row needs spelling out: **tool results are part of the conversation.***So "local mode" does not mean "processed locally."** Local mode swaps the hub for whichever provider you typed in. It does not keep a single byte on the device.Therefore:-- *"We do not monitor or store your data"* — **mostly true, but do not overclaim it.** No database, no behavioural analysis, and no reading of anything you send; the one exception is the version check, which tells us that some device of some model on some IP is running 0.5.2.+- *"We do not monitor or store your data"* — **mostly true, but do not overclaim it.** No database, no behavioural analysis, and no reading of anything you send; the one exception is the version check, which tells us that some device of some model on some IP is running 0.5.3.- *"Your data never leaves the device"* — **false. Do not claim it.**## 3. What it can actually do (not hypotheticals — current state of the code)diff --git a/DISCLAIMER.zh-CN.md b/DISCLAIMER.zh-CN.mdindex 714b921..8935c19 100644--- a/DISCLAIMER.zh-CN.md+++ b/DISCLAIMER.zh-CN.md@@ -45,7 +45,7 @@**因此"本机模式"不等于"本地处理"** —— 本机模式只是把大脑从 hub 换成了你填的那个服务商。它没有让数据留在设备上,一个字都没有。所以:-- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.5.2"。+- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.5.3"。- 「您的数据不会离开设备」——**不成立,而且不要说**。## 3. 它真的能做什么(以下都不是危言耸听,是代码里的现状)diff --git a/README.md b/README.mdindex eb3831e..eb9bb26 100644--- a/README.md+++ b/README.md@@ -28,7 +28,7 @@<p align="center"><a href="./README.md"><img alt="README in English" src="https://img.shields.io/badge/English-d9d9d9"></a>- <a href="./README.zh-CN.md"><img alt="Chinese" src="https://img.shields.io/badge/中文文档-d9d9d9"></a>+ <a href="./README.zh-CN.md"><img alt="Chinese" src="https://img.shields.io/badge/Chinese-d9d9d9"></a></p><p align="center">@@ -140,7 +140,7 @@ It reads the screen as a compact element outline — one indented line per elemetap — and when the app draws its own pixels (mini-programs, WebViews, games) it falls back to thescreenshot. General-purpose models are bad at computing coordinates and good at reading them, so it**never does the maths**: every screenshot it sees carries a faint labelled 8×12 grid, it taps by-*cell + which third of it*, and for tight targets it zooms in and sees a red crosshair where the tap+*cell + which part of it*, and for tight targets it zooms in and sees a magenta crosshair where the tapwould land before committing. A per-location guard refuses the fourth tap on the same spot, so aconfused model stops and asks instead of hammering.@@ -587,7 +587,7 @@ Pure Kotlin, no Compose; the whole thing hangs off two pillars, `WindowManager`| 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'` || **Build JDK** | **17–20** | see [Which JDK](#which-jdk) — this is the step people get stuck on |-| versionCode / versionName | 11 / 0.5.2 | see [CHANGELOG.md](CHANGELOG.md) for the policy |+| versionCode / versionName | 12 / 0.5.3 | see [CHANGELOG.md](CHANGELOG.md) for the policy || applicationId / namespace | `net.kuafuai.andee` | never changed from the template. It affects nothing |**Runtime dependencies** (`app/build.gradle`):@@ -1016,7 +1016,7 @@ Read it before redistributing: **the ML Kit barcode SDK and the `play-services-*open-source**, and the barcode model is fetched from Google at runtime.See [CHANGELOG.md](CHANGELOG.md) for what changed and for the versioning policy. The latest release is-**`v0.5.2`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.+**`v0.5.3`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.## Related documentsdiff --git a/README.zh-CN.md b/README.zh-CN.mdindex 7d4707b..4d54afd 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -121,7 +121,7 @@ https://github.com/user-attachments/assets/866e8333-e97b-4bf5-9525-540f9fdb01cd它把屏幕读成一份精简的元素提纲 —— 每个元素一行、按层级缩进、带一个能直接点的编号;遇到 App 自己画像素的地方(小程序、WebView、游戏)就退回看截图。通用大模型**算**坐标很差、**读**坐标很好,所以它**从不做这道数学题**:它看到的每张截图上都叠着一层淡淡的、带标号的 8×12 网格,点按时报的是-「第几格 + 格子里的哪三分之一」;目标太小时它会先放大,看到一个红色十字标出"会点在这儿",确认了再+「第几格 + 格子里的哪一份」;目标太小时它会先放大,看到一个品红十字标出"会点在这儿",确认了再下手。同一个位置点到第四次会被拦下,糊涂了的模型只能停下来问你,而不是一直戳。**2. 能打字,但它不是输入法。**@@ -424,7 +424,7 @@ Google),再填该服务商的密钥。这是两个独立的服务,条款| 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'` || **构建用 JDK** | **17–20** | 见[配 JDK](#配-jdk),这是最容易卡住的一步 |-| versionCode / versionName | 11 / 0.5.2 | 策略见 [CHANGELOG.md](CHANGELOG.md) |+| versionCode / versionName | 12 / 0.5.3 | 策略见 [CHANGELOG.md](CHANGELOG.md) || applicationId / namespace | `net.kuafuai.andee` | 从模板里没改,不影响功能 |**运行库依赖**(`app/build.gradle`):@@ -887,7 +887,7 @@ CLAUDE.md 给 AI 编码助手看的架构说明(英文)随包分发的第三方组件清单在 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。再分发之前请先看:**ML Kit 扫码 SDK 和 `play-services-*` 不是开源许可**,而且扫码模型是运行时从 Google 拉的。-改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.5.2`**,故意停在+改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.5.3`**,故意停在pre-1.0:线上协议和构建开关都还在动。## 相关文档diff --git a/app/build.gradle b/app/build.gradleindex db89b03..7743660 100644--- a/app/build.gradle+++ b/app/build.gradle@@ -34,8 +34,8 @@ android {applicationId "net.kuafuai.andee"minSdk 30targetSdk 34- versionCode 11- versionName "0.5.2"+ versionCode 12+ versionName "0.5.3"testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"diff --git a/docs/releases/v0.5.3.md b/docs/releases/v0.5.3.mdnew file mode 100644index 0000000..5561537--- /dev/null+++ b/docs/releases/v0.5.3.md@@ -0,0 +1,213 @@+# v0.5.3++**You can now tell it to stop, out loud, and it will.** Say "Exit Andee" or "Take a break" and the+assistant cancels what it is doing and closes — microphone and wake word included — with no model call+in the path. The rest of the delta is aiming: a large fix for apps that hand accessibility a blank root,+found by measuring rather than by reading code.++> **The attached APK is 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.++**This release carries a teammate's work.** The voice-exit feature arrived as+**[PR #14](https://github.com/kuafuai/andee/pull/14)** from+[@lirongkuafuai](https://github.com/lirongkuafuai), closing+**[issue #13](https://github.com/kuafuai/andee/issues/13)** — fifteen commits, reviewed and merged. The+aiming fix is from the maintainer.++## Highlights++- **A way out that does not need the model.** "Exit Andee" / "Take a break" (and the Chinese+ equivalents) is matched **on the device** and handled before any card answer or brain submission, so+ it works even when the model is unreachable. It cancels the running task, stops the service and+ closes the assistant, which also stops the microphone and the wake word.+- **It is a whole-utterance match, on purpose.** *"How do I exit Andee"*, *"cancel my subscription"*+ and a quoted command all stay ordinary turns. A phrase arriving on an automatic follow-up window is+ ignored. While a meeting is recording it refuses, and says why.+- **Aiming on an app that hides its element tree is now much better.** On WeChat the grid label was+ sitting **on top of** a button and hiding it; gestures on such an app must now be aimed off a fresh+ zoom (measured: zoom-aimed taps changed the screen **33/41** times, screenshot-aimed **124/211**, and+ the misses opened profiles, followed people and deleted comments); and the model is told when a menu+ is open instead of guessing and reopening it.++## What's Changed++### Added++- **Voice exit** (`asr/VoiceExitCommand.kt`). Recognition happens on the device with no model call —+ the utterance is matched before any card answer or brain submission. It cancels the running task,+ stops the body service, and closes the assistant; **the microphone and the wake word stop with it**,+ and the app icon starts it again. The trigger list is deliberately tight and matched whole-utterance:+ asking how to exit, cancelling a subscription, or quoting a command must remain an ordinary turn+ rather than unexpectedly shutting the assistant down. A phrase arriving on an **automatic follow-up+ window is ignored** (`userInitiated`), with its own test. **While a meeting is recording it refuses**+ and explains that the meeting must be ended and its minutes saved first. Teardown is guarded so that+ a late transcript, a wake callback or a TTS fallback cannot reopen an overlay after exit was asked+ for — the failure that would make "it closed" untrue a second later.+- **`popup_open` / `popups` on tap, long-press and screenshot results.** Read from the window list,+ which survives an app withholding its tree. The model could not tell an open menu from a closed one+ by eye and reopened one **six times**; a blind tap aimed *inside* a popup is now refused, with the+ reason, instead of landing on whatever the popup is covering.++### Fixed++- **Aiming on an app that withholds its element tree** (measured on WeChat 8.0.79 / HONOR, where+ accessibility gets a blank root and every tap is aimed by eye off a screenshot downscaled to ~0.48×).+ The injection itself was already exact — **every miss was an aiming miss**:+ - **The grid labels moved to the edges.** Printed at each cell's centre, the `H` column's label sat+ exactly on WeChat's 「··」 button and **hid it**. They are rulers now — letters along the top edge,+ numbers down the left — and nothing printed inside a cell belongs to the device.+ - **A gesture on a tree-blind app must fall inside a zoom taken since the last one.** Zoom-aimed taps+ changed the screen **33/41** times; screenshot-aimed ones **124/211**, and the misses opened+ profiles, followed people and deleted comments. This is the general form of the rule that already+ guarded the tap after blind typing.+ - **A cell is now fifteen parts, not nine** (`3 × 5`: `top-left` … `bottom-right`). The old nine+ names still parse as **aliases** mapped to the outer rows, so anything written against the previous+ vocabulary aims where it used to — that was deliberate.+ - **The markers are magenta (`#E000FF`), not red.** Red is every unread badge in every Chinese app,+ and a red crosshair next to WeChat's red dot read as part of the app rather than as the device's+ own annotation. The caption also moved **above** the ring, because below is where the next target+ is.+ - **Prompt side:** close a small menu by tapping its **opener** again rather than with `back` (the+ menu is unfocused, so `back` left Moments entirely), and keep list progress instead of restarting+ from item 1.++### Changed++- **The READMEs' description of aiming was corrected.** Both said it taps by *"which third of it"* and+ that the crosshair is **red** — neither survived this release. They now say "which part of it" and+ magenta.+- **The English README's language badge is back to ASCII.** A web edit on 2026-10-21 changed the badge+ label from `Chinese` to the Chinese characters for it, putting Han characters back into a file that+ is checked for zero of them. The link target never moved.++## 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.5.3-debug-arm64-v8a.apk` | anything bought in the last several years — **this is the one for almost everyone** |+| `andee-0.5.3-debug-armeabi-v7a.apk` | an older 32-bit device |+| `andee-0.5.3-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.+- **The Google voice settings are empty too**, so this build comes up on **Volcengine** and has no+ provider key of any kind baked in.+- `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** — speech recognition and synthesis. Pick the provider first (**Voice provider** →+ Volcengine or Google), then fill in that provider's key: a Volcengine Speech key, or a Google Vertex+ Express key plus a GCP project *number* and a location. Optional: without it the assistant is silent+ but still works on screen — **including the voice exit**, which is matched from recognized speech+ and does not need the model.++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.app/andee](https://www.codeflying.app/andee)**, or+> **[codeflying.net/andee](https://www.codeflying.net/andee)** in mainland China. 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.++## Known issues++- **There is no visible control for the voice exit, and no way to change its phrases.** The list is+ compiled in, and editing it means rebuilding. It is also **English and Chinese only** — a device set+ to another language has no exit phrase it recognizes.+- **The exit phrase must be the whole utterance.** "Okay, exit Andee please" does not match. That is+ the deliberate trade (a substring match would fire on "why did you exit Andee"), but it means the+ feature is easy to fail at by accident, and a failed attempt gives no feedback that it was close.+- **The zoom-then-aim rule is deliberately blunt, and it expires rather than persisting.** On an app+ that hides its tree, *every* plain grid-cell tap is refused, including one aimed somewhere legitimate+ — the model has to zoom first. The rule lifts after two minutes, and clears as soon as the box goes+ away.+- **`fling=true` still coasts unpredictably.** The option exists for long jumps, and its text says so,+ but nothing verifies where the list stopped.+- **The wake threshold's margin is thin**, carried from `v0.3.2` and unchanged here: the eight measured+ judgements sit in 1.47–2.05 with the line landing in the gap between 1.69 and 1.77 — 0.08 wide. There+ is still no quality gate on enrolment takes.+- **A light generated page still fades in over a dark stage.** `TextPage`, `TracePage`,+ `Theme.Body.Fullscreen`'s window background and `HtmlActivity`'s WebView backdrop are all still dark.+ Carried over from `v0.3.1`; the app's own default has been light since `v0.4.1`.+- **A build with CodeFlying compiled in but no API key can still raise the wrong complaint.** The+ availability test looks at `CODEFLYING_ENABLED` and the domain rather than the key. Carried from+ `v0.1.1` onward; not fixed by this release.+- **`assets/andee_key.txt` is tracked by git and is not in `.gitignore`.** It ships empty, which is+ correct — the per-user token is written in at package time. But a local build that fills it in would+ be a key in a tracked file, and nothing currently stops that being committed.+- **`.gitignore` ignores `/build` only, not `build/` at any depth.** A checkout with extra Gradle+ modules writes their build outputs into `<module>/build/`, which is **not** ignored — two such+ directories holding ~258 MB were present during this release. They were never committed and are not+ part of it, but the rule is worth widening before someone adds a module and stages the result by+ reflex.+- The two issues `v0.1.0` listed are **unchanged and untouched in this release**:+ `tools/verify_faces_lab.py` still reports 7/16 assertions passing against the committed+ `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`).++## Before you install++Read **[DISCLAIMER.md](../../DISCLAIMER.md)** and+**[docs/acceptable-use.md](../acceptable-use.md)** first. This app asks for accessibility, overlay,+notification access, SMS and call log, and it can complete a payment by tapping. The only guardrail on+that path is Android's `FLAG_SECURE`; the prompt-level checks on risky actions are instructions to the+model, not enforcement.++## Install from source++If you would rather build it yourself — or need a *signed* release build, which is what you should+actually distribute:++```bash+git clone https://github.com/kuafuai/andee+cd andee+git checkout v0.5.3+./gradlew :app:assembleDebug # installs as-is, signed with the debug certificate+```++To reproduce the attached build exactly, leave `local.properties` with no `CODEFLYING_*` keys, no+`GOOGLE_VOICE_*` 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.5.2:** `versionCode` moves `11 → 12`, so this installs over it normally. Nothing+you configured is discarded and there is nothing to migrate — the voice exit is compiled in, not+configured. The aiming changes alter what the model does, not what the device stores.++**Full Changelog**: https://github.com/kuafuai/andee/compare/v0.5.2...v0.5.3