Skip to content

armgit / andee

Public Imported from GitHub
0

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.6.0

booboosui9fe72ee7ee21
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c133679..d25d0f8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,8 @@ Notable changes to Andee. The format follows [Keep a Changelog](https://keepacha
## Versioning policy
-- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`12` / `"0.5.3"`**.
+- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`13` / `"0.6.0"`**. The
+ Mac's product version is read from that same `versionName`, so both bodies carry one number.
- 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** or
Android refuses the upgrade; the same number must never be reused for two different builds.
@@ -28,6 +29,80 @@ hash into `versionName` at build time would close this hole; it is not implement
## [Unreleased]
+## [0.6.0] - 2026-10-26
+
+**The assistant now has a second body.** Andee runs on macOS, on the same brain as the phone: the
+agent loop, the notebook, the memory, the tools and the emotion ball are one implementation in a new
+`core/` module, and each body supplies only the parts that are genuinely its own — the accessibility
+service and the IME on Android, the accessibility API, real mouse and keyboard, and a sandboxed
+terminal on the Mac. Two devices that run it can also be **friends**: they pair by QR code and ask each
+other for help, on-body, over an encrypted link with no server in between.
+
+This is the largest release so far by a wide margin — 53 commits, 217 files, +23,976 lines — and the
+version number finally moves on capability rather than being argued about: MINOR, as the policy says.
+
+Two behavioural changes ride along that a reader should not miss. **CodeFlying is now the default
+backend** on a fresh install, replacing on-device as the starting point. And on both bodies the wake
+word, the settings, and the self-check now describe the same app, so "phone" and "Mac" differ only in
+what the body can physically do.
+
+### Added
+
+- **The Mac app** (`desktop/`, Compose Desktop). A floating ball above every window; the same chat,
+ settings, self-check, notebook, scenes, expressions, artifacts, topic and vault cards as the phone,
+ laid out as a sidebar with a glass panel on a real backdrop; voice in and out (the same four engines
+ as Android, under `desktop/.../desktop/voice/`); notifications read and triaged the way the phone
+ does; mouse, keyboard, screen and window access through the accessibility API; screenshot and
+ screen-region zoom with the same grid and crosshair; and **a sandboxed terminal** (`run_command`) as
+ one of its hands, with a policy file and a trash broker rather than a blanket shell.
+- **`:core`, a platform-neutral module.** The brain loop, the four voice engines, the notebook's logic,
+ the tool schemas, the emotion-ball renderer and the wire types moved out of `app/` so both bodies
+ share one implementation. `BrainHost` is the interface a body implements; the brain never sees an
+ Android or a desktop type. A golden-text test pins the model-facing strings *before* the split, so a
+ refactor that changes what the model reads fails loudly.
+- **Friends** (`core/peer/`). Two Andees pair by QR code — one-time, two minutes, three tries — and the
+ code carries the showing device's key fingerprint, so the scanner pins that key and no other. Every
+ link afterwards is a signed handshake against pinned keys with forward-secret session keys; replayed,
+ altered or reordered frames drop the link. Two kinds, chosen by whoever shows the code: **my device**
+ (another of your own; its requests run as your own) and **friend** (somebody else's — the owner is
+ asked first, five minutes then it counts as no answer, and the work runs over `GuestHost` with no
+ memory, no history, no vault, no personal data and no terminal: screen, ask, show a page, open an app
+ or a link, and nothing else). Off until switched on; discovery is mDNS plus the last address that
+ worked.
+- **`device.permissions.request`** on the Mac — a permission concierge that asks for what a task needs
+ and explains the grant in System Settings when macOS will not show the prompt itself.
+- **Long jobs handed to the clock** on both bodies, so a slow task stops holding the conversation.
+
+### Changed
+
+- **CodeFlying is the default backend on a fresh install.** The previous rule hid the CodeFlying tab
+ entirely unless the build was configured for it, and started on-device. Now the tab always leads, is
+ what a fresh install starts on, and says the same thing with or without a key: what it is, how to get
+ one, and a tappable link. The key row is always visible with show/hide and copy, and it displays the
+ key *in effect* — saving it back unchanged stores nothing, so a build's key is not pinned as an
+ override. **A build with no server configured, like the ones attached here, has nowhere to send and
+ says so** until a key is typed or another backend is picked.
+- **The Mac and the phone now describe themselves the same way.** The READMEs, this file and
+ `docs/permissions.md` say the project is two bodies on one brain, and the permission tables gain a
+ row for what a friend's request can and cannot reach.
+- **The Mac reads CodeFlying's build settings from `local.properties`**, like the phone — a generated
+ properties resource rather than a `BuildConfig`, because a JVM app has none.
+- **The product version comes from the phone's `versionName`**, so both bodies carry one number. The
+ bundle version macOS requires of a `.dmg` stays `1.0.0` and is not the product version.
+
+### Fixed
+
+- **The ball stops repainting a still window**, and the GPU draws it again — a Mac idle-cost fix that
+ also removed a thread leak.
+- **A tap-to-talk path on the Mac** where the microphone opened but nothing listened.
+- **A long task no longer empties the history**, a new request interrupts the old one instead of
+ queueing behind it, and voice ends on silence rather than on a timeout.
+- **Words typed or spoken over a question card answer it** instead of starting a new turn.
+- **A notebook save that did not happen fails** instead of answering "Saved."
+- **A todo set from a notification stays untrusted when it fires**, the same rule its creation had.
+- **Silent reviews no longer ask for thinking**, which was spending reasoning tokens on a turn nobody
+ reads.
+
## [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
diff --git a/DISCLAIMER.md b/DISCLAIMER.md
index 5dbf1b9..c275a1c 100644
--- a/DISCLAIMER.md
+++ b/DISCLAIMER.md
@@ -35,7 +35,7 @@ An **experimental** piece of software that you install on **your own device**. I
| What | Goes to | Default |
|---|---|---|
| Your speech (ASR) and its speech (TTS) | **The speech provider you select** — Volcengine / ByteDance by default, or Google | Whichever is picked in ⚙ → **Backend → Voice provider**: Volcengine → `openspeech.bytedance.com`; Google → `aiplatform.googleapis.com`. A build packaged with a Google key comes up on Google; the source checkout defaults to Volcengine |
-| The conversation, **and every tool result** | The "brain" you configured | `brain=local` (the out-of-box default) → `api.deepseek.com` on a Chinese UI and `api.openai.com` on an English one; in hub mode, your own `hub_url` |
+| The conversation, **and every tool result** | The "brain" you configured | **A fresh install starts on CodeFlying** → the server this build was packaged for, if any. A build with no server configured (like the ones attached to releases here) has nowhere to send and says so until you either type a CodeFlying key or pick another backend. Pick **on-device** and it goes to `api.deepseek.com` on a Chinese UI and `api.openai.com` on an English one; in hub mode, your own `hub_url` |
| The private notebook (`Notebook` — what it remembers about you, what it promised) | **On this device only** | Filtered out of the hub payload |
| **Version check**: your version number, phone model / brand / OS version, UI language, one random install ID | **A server the maintainers run** (not a third party) | Once on first launch, and once per tap on the self-check page's **Check again**; capped at 10 per IP per day |
@@ -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.3.
+- *"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.6.0.
- *"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.md
index 8935c19..c2174be 100644
--- a/DISCLAIMER.zh-CN.md
+++ b/DISCLAIMER.zh-CN.md
@@ -34,7 +34,7 @@
| 什么数据 | 去哪 | 默认 |
|---|---|---|
| 你说的话(语音识别)、它说的话(语音合成) | **你选的那家语音服务商** —— 默认是火山引擎(字节跳动),也可以选 Google | 看 ⚙ → **后端 → 语音服务商** 选了谁:火山 → `openspeech.bytedance.com`;Google → `aiplatform.googleapis.com`。打包时内置了 Google 密钥的构建默认走 Google;源码检出默认走火山 |
-| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | `brain=local`(开箱默认)→ 中文界面走 `api.deepseek.com`、英文界面走 `api.openai.com`;hub 模式下走你自己的 `hub_url` |
+| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | **全新安装默认走 CodeFlying** → 就是这台包构建时配的那台服务器(如果有的话)。没配服务器的包(比如本仓库 Release 挂的那几个)无处可发,它会明说,直到你填一个 CodeFlying key 或改选别的后端。改选**本机**后:中文界面走 `api.deepseek.com`、英文界面走 `api.openai.com`;hub 模式下走你自己的 `hub_url` |
| 私人笔记本(`Notebook`:它记住的你、以及它答应过的事) | **只在本机** | 不进 hub 载荷,不外发 |
| **版本自检**:当前版本号、手机型号 / 品牌 / 系统版本、界面语言、一个随机安装 ID | **维护者自己的一台服务器**(不是第三方) | 首次启动一次,以及在自检页点「重新检查」时一次;同一 IP 每天最多 10 次 |
@@ -45,7 +45,7 @@
**因此"本机模式"不等于"本地处理"** —— 本机模式只是把大脑从 hub 换成了你填的那个服务商。它没有让数据留在设备上,一个字都没有。
所以:
-- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.5.3"。
+- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.6.0"。
- 「您的数据不会离开设备」——**不成立,而且不要说**。
## 3. 它真的能做什么(以下都不是危言耸听,是代码里的现状)
diff --git a/README.md b/README.md
index 37f439e..ce8592b 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@
<a href="https://www.codeflying.app/andee"><img alt="Build online" src="https://img.shields.io/badge/build%20online-no%20token%20setup-12b76a"></a>
<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(Apple%20silicon)-555555"></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="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>
@@ -700,7 +700,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 | 12 / 0.5.3 | see [CHANGELOG.md](CHANGELOG.md) for the policy |
+| versionCode / versionName | 13 / 0.6.0 | 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`):
@@ -1133,7 +1133,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.3`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.
+**`v0.6.0`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.
## Related documents
diff --git a/README.zh-CN.md b/README.zh-CN.md
index d2094e2..09c3c34 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -23,7 +23,7 @@
<a href="https://www.codeflying.net/andee"><img alt="在线构建" src="https://img.shields.io/badge/在线构建-免打包、免配令牌-12b76a"></a>
<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(Apple%20silicon)-555555"></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="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>
@@ -525,7 +525,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 | 12 / 0.5.3 | 策略见 [CHANGELOG.md](CHANGELOG.md) |
+| versionCode / versionName | 13 / 0.6.0 | 策略见 [CHANGELOG.md](CHANGELOG.md) |
| applicationId / namespace | `net.kuafuai.andee` | 从模板里没改,不影响功能 |
**运行库依赖**(`app/build.gradle`):
@@ -992,7 +992,7 @@ CLAUDE.md 给 AI 编码助手看的架构说明(英文)
随包分发的第三方组件清单在 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。再分发之前请先看:
**ML Kit 扫码 SDK 和 `play-services-*` 不是开源许可**,而且扫码模型是运行时从 Google 拉的。
-改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.5.3`**,故意停在
+改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.6.0`**,故意停在
pre-1.0:线上协议和构建开关都还在动。
## 相关文档
diff --git a/app/build.gradle b/app/build.gradle
index 3ef5d9f..a1dea64 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -34,8 +34,8 @@ android {
applicationId "net.kuafuai.andee"
minSdk 30
targetSdk 34
- versionCode 12
- versionName "0.5.3"
+ versionCode 13
+ versionName "0.6.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
diff --git a/docs/permissions.md b/docs/permissions.md
index 38f317e..8ac180a 100644
--- a/docs/permissions.md
+++ b/docs/permissions.md
@@ -104,7 +104,7 @@ Andee has a vault (`config/Vault.kt`) for the account passwords you enter yourse
| What | Where it goes | Default |
|---|---|---|
| Speech recognition (what you say), speech synthesis (what he says) | **The speech provider you select** — Volcengine (ByteDance) by default, or Google | Whichever is picked in ⚙ → **Backend → Voice provider**: Volcengine → `openspeech.bytedance.com`; Google → `aiplatform.googleapis.com`. A build packaged with a Google key comes up on Google; the source checkout defaults to Volcengine |
-| Conversation content, **and every tool result** | The "brain" **you** configured | `brain=local` (the out-of-box default) → `api.deepseek.com` on a Chinese UI and `api.openai.com` on an English one; in hub mode, your own `hub_url` |
+| Conversation content, **and every tool result** | The "brain" **you** configured | **A fresh install starts on CodeFlying** → the server this build was packaged for, if any. A build with no server configured (like the ones attached to releases here) has nowhere to send and says so until you either type a CodeFlying key or pick another backend. Pick **on-device** and it goes to `api.deepseek.com` on a Chinese UI and `api.openai.com` on an English one; in hub mode, your own `hub_url` |
| Private notebook (`config/Notebook.kt`: what he remembers about you, what he promised) | **On-device only** | It is `localOnly` and never enters the hub payload |
| **Version check**: your version number, phone model / brand / OS version, UI language, one random install ID | **A server the maintainers run** (not a third party) | Once on first launch, and once per tap on **Check again**; capped at 10 per IP per day |
| **A request you send a friend**, and its report back | **Directly to that device**, over an end-to-end encrypted link on your Wi-Fi — no server in between | Only what the model put in the request. It is told never to pass on your memory, accounts or contacts unless you asked; a friend's request on *your* device runs where it cannot see any of them |
diff --git a/docs/permissions.zh-CN.md b/docs/permissions.zh-CN.md
index 953744a..75b5e13 100644
--- a/docs/permissions.zh-CN.md
+++ b/docs/permissions.zh-CN.md
@@ -104,7 +104,7 @@ Andee 有一个保险箱(`config/Vault.kt`),用来存你自己填进去的
| 什么数据 | 去哪 | 默认值 |
|---|---|---|
| 语音识别(你说的话)、语音合成(他说的) | **你选的那家语音服务商** —— 默认是火山引擎(字节跳动),也可以选 Google | 看 ⚙ → **后端 → 语音服务商** 选了谁:火山 → `openspeech.bytedance.com`;Google → `aiplatform.googleapis.com`。打包时内置了 Google 密钥的构建默认走 Google;源码检出默认走火山 |
-| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | `brain=local`(开箱默认)→ 中文界面走 `api.deepseek.com`、英文界面走 `api.openai.com`;hub 模式下走你自己的 `hub_url` |
+| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | **全新安装默认走 CodeFlying** → 就是这台包构建时配的那台服务器(如果有的话)。没配服务器的包(比如本仓库 Release 挂的那几个)无处可发,它会明说,直到你填一个 CodeFlying key 或改选别的后端。改选**本机**后:中文界面走 `api.deepseek.com`、英文界面走 `api.openai.com`;hub 模式下走你自己的 `hub_url` |
| 私人笔记本(`config/Notebook.kt`:记住的你、答应过的事) | **只在本机** | 是 `localOnly`,不进 hub 载荷 |
| **版本自检**:当前版本号、手机型号 / 品牌 / 系统版本、界面语言、一个随机安装 ID | **维护者自己的一台服务器**(不是第三方) | 首次启动一次,以及在自检页点「重新检查」时一次;同一 IP 每天最多 10 次 |
| **你发给朋友的请求**,以及对方的回报 | **直接到那台设备**,走你 Wi-Fi 里的端到端加密连接,中间没有服务器 | 只有模型写进请求里的内容。它被要求不传你的记忆、账号、通讯录,除非你让它传;朋友发到*你*设备上的请求,在看不到这些的地方运行 |
diff --git a/docs/releases/v0.6.0.md b/docs/releases/v0.6.0.md
new file mode 100644
index 0000000..ec8bd9b
--- /dev/null
+++ b/docs/releases/v0.6.0.md
@@ -0,0 +1,225 @@
+# v0.6.0
+
+**The assistant now has a second body.** Andee runs on macOS on the same brain as the phone — the agent
+loop, the memory, the notebook, the tools and the face are one implementation, and each body supplies
+only the parts that are genuinely its own. Two devices that run it can also be **friends**: they pair by
+QR code and ask each other for help, on-body, over an encrypted link with no server in between.
+
+Two things changed that are easy to miss, so they are named here rather than buried: **a fresh install
+now starts on CodeFlying** rather than on-device, and the Mac app exists at all.
+
+> **These binaries are unsigned or locally signed, and bare.** The APK is the `debug` build — the release
+> build type has no `signingConfig` and this repository has no keystore, so `assembleRelease` emits an
+> APK that will not install until you sign it. The two `.dmg`s are signed with a **local identity, not an
+> Apple Developer ID**, so Gatekeeper blocks the first open of a downloaded copy: **right-click Andee →
+> Open**, or System Settings → Privacy & Security → **Open Anyway**. Once. After that, and after every
+> update signed the same way, Accessibility and Screen Recording stay granted. Removing that step needs a
+> Developer ID ($99/year) and notarization, which this project does not have.
+>
+> All binaries are built with **no keys configured** — no CodeFlying key, no voice-provider key. See
+> **[Download](#download)** for what that means and what to supply yourself.
+
+## Highlights
+
+- **A Mac app.** The same assistant, with a floating ball above every window, the same cards, the same
+ voice, the same memory — plus the hands a Mac has: mouse and keyboard, any app's accessibility tree,
+ the screen, notifications, and **a sandboxed terminal**.
+- **Friends.** Two Andees pair by scanning a QR code, one-time and expiring in two minutes, and the code
+ carries the showing device's key fingerprint so the scanner pins that key and no other. After that
+ every link is a signed handshake with forward-secret session keys.
+- **Two kinds of friend, and the difference matters.** *My device* — another of your own; its requests
+ run as your own. *Friend* — somebody else's; you are asked first, and the work runs with **no memory,
+ no history, no vault, no personal data and no terminal**.
+- **CodeFlying is the default backend on a fresh install.** The tab always leads and says the same thing
+ with or without a key: what it is, how to get one, and a link.
+- **One number for both bodies.** The Mac's version is read from the phone's `versionName`.
+
+## What's Changed
+
+### Added
+
+- **The Mac app** (`desktop/`, Compose Desktop, macOS 14+, Apple silicon **or** Intel). A floating ball
+ above every window; the same chat, settings, self-check, notebook, scenes, expressions, artifacts,
+ topic and vault cards as the phone, as a sidebar with a glass panel on a real backdrop; voice in and
+ out through the same four engines as Android; notifications read and triaged the way the phone does;
+ mouse, keyboard, screen and window access through the accessibility API; screenshot and screen-region
+ zoom with the same grid and crosshair; and **a sandboxed terminal** (`run_command`) as one of its
+ hands, with a policy file and a trash broker rather than a blanket shell.
+- **`:core`, a platform-neutral module.** The brain loop, the four voice engines, the notebook's logic,
+ the tool schemas, the emotion-ball renderer and the wire types moved out of `app/` so both bodies
+ share one implementation. `BrainHost` is the interface a body implements; the brain never sees an
+ Android or a desktop type. A golden-text test pins the model-facing strings **before** the split, so a
+ refactor that changes what the model reads fails loudly instead of quietly.
+- **Friends** (`core/peer/`). Pairing is a one-time QR code (two minutes, three tries) whose payload
+ names the shower's key fingerprint, so the scanner pins that key and no other. Every link afterwards
+ is a signed handshake against pinned keys with forward-secret session keys; replayed, altered or
+ reordered frames drop the link. Off until switched on. Discovery is mDNS (JmDNS on the Mac,
+ `NsdManager` on the phone) plus the last address that worked, because mDNS does not always arrive.
+- **`device.permissions.request`** on the Mac — asks for what a task needs, and explains the grant in
+ System Settings when macOS will not show the prompt itself.
+- **Long jobs handed to the clock** on both bodies, so a slow task stops holding the conversation.
+- **A way out of the key rows** on both settings cards — switching to CodeFlying from wherever you are.
+- **GitHub and Discord links** from the gesture line, and a Chinese half for `docs/permissions`.
+
+### Changed
+
+- **CodeFlying is the default backend on a fresh install.** The previous rule hid the CodeFlying tab
+ unless the build was configured for it, and started on-device. Now the tab always leads, is what a
+ fresh install starts on, and says the same thing with or without a key. The key row is always visible
+ with show/hide and copy, and displays the key **in effect** — saving it back unchanged stores nothing,
+ so a build's key is not pinned as an override. **A build with no server configured, like the ones
+ attached here, has nowhere to send and says so** until a key is typed or another backend is picked.
+- **The Mac reads CodeFlying's build settings from `local.properties`**, like the phone — a generated
+ properties resource rather than a `BuildConfig`, because a JVM app has none.
+- **The project now describes itself as two bodies on one brain.** The READMEs, `CLAUDE.md` and
+ `docs/permissions` were rewritten to say so, and the permission tables gained a row for what a
+ friend's request can and cannot reach.
+
+### Fixed
+
+- **The ball stops repainting a still window**, and the GPU draws it again — an idle-cost fix on the Mac
+ that also stopped leaking ball threads.
+- **A tap-to-talk path on the Mac** where the microphone opened but nothing listened.
+- **A long task no longer empties the history**, a new request interrupts the old one instead of queueing
+ behind it, and voice ends on silence rather than on a timeout.
+- **Words typed or spoken over a question card answer it** instead of starting a new turn.
+- **A notebook save that did not happen now fails** instead of answering "Saved."
+- **A todo set from a notification stays untrusted when it fires**, the same rule its creation had.
+- **Silent reviews no longer ask for thinking**, which was spending reasoning tokens on a turn nobody
+ reads.
+
+## Download
+
+### macOS (macOS 14 or later)
+
+The architecture is **not** a universal binary — an Apple silicon build will not start on an Intel Mac,
+and the other way round. Take the one that matches:
+
+| File | Take it if |
+|---|---|
+| `Andee-0.6.0-arm64.dmg` | an Apple silicon Mac (M1 and later) — **most Macs** |
+| `Andee-0.6.0-x64.dmg` | an Intel Mac |
+
+Open the `.dmg`, drag **Andee** to Applications, then launch it. Gatekeeper blocks the first open — see
+the note at the top. It asks for **Accessibility** and **Screen Recording**; without them it runs but
+cannot act on other apps or capture the screen.
+
+### Android (Android 11 / API 30 or later)
+
+The APK is **per-ABI**, so pick the file that matches your device:
+
+| File | Take it if |
+|---|---|
+| `andee-0.6.0-debug-arm64-v8a.apk` | anything bought in the last several years — **almost everyone** |
+| `andee-0.6.0-debug-armeabi-v7a.apk` | an older 32-bit device |
+| `andee-0.6.0-debug-x86_64.apk` | an emulator |
+
+### These builds are deliberately bare
+
+Built from source with nothing configured — **verified against the generated config, not assumed**. No
+CodeFlying key, no voice-provider key, no private endpoint or model name:
+
+- CodeFlying is the backend a fresh install starts on, but **with no server configured it has nowhere to
+ send** — the self-check says exactly that, and nothing is pre-wired to anyone's backend.
+- **The voice provider comes up on Volcengine**, with no provider key of any kind baked in.
+- The phone's default language is **English** for a device that has never picked one; the Mac's follows
+ its language switch.
+- The thinking default is off.
+
+### What you have to supply
+
+**On Android**, the assistant cannot do anything until it has a brain. Either put a CodeFlying key in
+**⚙ → Backend → CodeFlying**, or pick **on-device** and give it an OpenAI-compatible endpoint and model
+(an English UI defaults to `https://api.openai.com/v1` and `gpt-4o-mini`; a Chinese UI to
+`https://api.deepseek.com` and `deepseek-flash`). A voice key is optional — without one the assistant is
+silent but still works on screen, and the voice exit still works, because it is matched from recognized
+speech rather than from the model.
+
+**On the Mac**, it is the same two decisions in the same card.
+
+Then, on Android in this order: grant **Overlay** → enable **Accessibility** → tap the ball. On the Mac:
+launch it, and grant Accessibility and Screen Recording when it asks. Until the keys are in, the card
+will name what is missing — that is the self-check working, not a fault.
+
+> **Would you rather not configure keys at all?** Then these binaries are the wrong door — they are for
+> people who want to run their own. 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. Note it produces **an Android APK, not a Mac app** — macOS packages can
+> only be built on macOS.
+
+## Known issues
+
+- **The Mac build is signed with a local identity, so Gatekeeper blocks the first open** and there is no
+ notarization. The one-step workaround is above; removing it needs an Apple Developer ID.
+- **A Mac build made on another machine, without that machine's signing keychain, is ad-hoc signed** —
+ its identity is locked to the build's hash, so installing it over an existing copy makes macOS treat it
+ as a **different app**: Accessibility and Screen Recording must be granted again, and a stale switch
+ for the old copy may sit in System Settings showing "on" while doing nothing. User data is unaffected —
+ it lives outside the bundle, in `~/Library/Application Support/Andee`.
+- **The two Mac downloads are not a universal binary**, and there is no lipo'd build here. Take the one
+ matching your Mac.
+- **Friends are new, and the discovery path is the fragile part.** mDNS is not reliable in both
+ directions on every network — the Mac's resolver and Android 12's one-service-at-a-time limit were both
+ worked around, and the last-good-address fallback covers the rest, but a network that blocks multicast
+ entirely will not find a peer without that history.
+- **A friend's request is run by a throwaway brain with no terminal and no personal data** — but it still
+ acts on your screen, with your grants. The card names who is asking before the first request, and
+ "always allow" is remembered per friend (`autoAccept`); there is no surface that lists what a friend
+ has run, only the app log.
+- **`assets/andee_key.txt` is tracked by git and is not in `.gitignore`.** It ships empty, which is
+ correct. But a local build that fills it in would be a key in a tracked file, and nothing stops that
+ being committed.
+- **`.gitignore` ignores `/build` at the repository root, not `build/` at any depth.** The new modules
+ each carry their own `.gitignore` for this, so the tree is correct today; a module added without one
+ would stage its build output on a reflex `git add`.
+- **The wake threshold's margin is thin**, carried from `v0.3.2`: 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.** Carried over from `v0.3.1`; the app's own
+ default has been light since `v0.4.1`.
+- 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, 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. On Android the app asks for accessibility,
+overlay, notification access, SMS and call log, and it can complete a payment by tapping; on the Mac it
+asks for accessibility, screen recording and notifications. 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
+
+**Android:**
+
+```bash
+git clone https://github.com/kuafuai/andee
+cd andee
+git checkout v0.6.0
+./gradlew :app:assembleDebug # installs as-is, signed with the debug certificate
+```
+
+**macOS** (Apple silicon, macOS 14+, Command Line Tools):
+
+```bash
+./gradlew :desktop:createDistributable # → desktop/build/compose/binaries/main/app/Andee.app
+./gradlew :desktop:packageDmg # → a .dmg
+```
+
+An Apple silicon Mac can build **both** architectures — the arch is decided by whichever JVM runs
+Gradle, and Rosetta runs an x86_64 one. The README's Quick start has the two-chip recipe, including the
+`createRuntimeImage` trap that silently produces a mixed binary. To reproduce the attached builds, leave
+`local.properties` with no `CODEFLYING_*` keys and no `GOOGLE_VOICE_*` keys.
+
+**Upgrading from v0.5.3:** `versionCode` moves `12 → 13`, so the APK installs normally. The Mac app
+never existed before, so there is nothing to upgrade on that side. **The one change to watch is
+CodeFlying becoming the default backend**: an existing install keeps whatever it had saved, so nothing
+stops working — it is a fresh install that starts on CodeFlying now. If you were relying on the
+out-of-box behaviour being on-device, that is a deliberate change, not a regression.
+
+**Full Changelog**: https://github.com/kuafuai/andee/compare/v0.5.3...v0.6.0