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.8.1 — a cuter Andee, and four fixes from using it

booboosui25d72e1c64fd
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e6b2c1f..2f9146a 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 **`18` / `"0.8.0"`**. The
+- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`19` / `"0.8.1"`**. 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
@@ -29,6 +29,58 @@ hash into `versionName` at build time would close this hole; it is not implement
## [Unreleased]
+## [0.8.1] - 2026-10-30
+
+**A cuter Andee, and four fixes that came out of using it.** The default face was retuned against the
+reference illustrations, and the rest is the kind of thing that only shows up on a real device: a key
+saved from the self-check sheet that the running brain never saw, home gestures on the phone, and a
+voice handshake that failed silently.
+
+### Changed
+
+- **The default face, retuned toward the reference illustrations.** A periwinkle body with a peach rim
+ light, bigger and darker eyes with two glints, eyes and cheeks raised (`eyeY 0.09 → 0.07`) with the
+ mouth left low, rounder horns, and finer meshes for the eyes, mouth, horns and props. Gloss drops
+ `0.22 → 0.05` and the rim light becomes fully mixed (`rimTintMix 0.55 → 1.0`), which is what moves it
+ from plastic to matte.
+ The look's `name` is unchanged — this is the same character with a new face, not a new one, so nobody's
+ saved choice moves.
+
+### Fixed
+
+- **Thinking no longer carries the bigger eyes past the edge of the head.** Oversized eyes made the old
+ drift values visible as an error: the thinking drift is now `0.03` (was `0.075`) and the head turn it
+ drives `0.04` (was `0.09`), with the slow sway and the drift capped together at `0.10 rad` so the outer
+ eye cannot roll off the sphere. Brief actions — a shake, a look around — are deliberately *not* capped,
+ since they end before it matters. Checked over 36 frames at `dp 420` and at the folded `dp 136`.
+- **A key saved from the self-check sheet now reaches the running brain.** Measured on a device: v0.8.0
+ reinstalled at 14:30 built its brain with an empty key, self-check reported `brain:FAIL` at 14:30:34,
+ the key was saved at 14:31 (a 36-character `kft_` value in `voice_prefs.xml`) — and the first typed
+ sentence at 14:33 still answered *"no key"*. The brain speaks that line from its own `cfg`, which is a
+ snapshot taken at construction, and nothing re-read it. The self-check page can appear while the
+ service is already running (its `onCreate` falls through whenever `ensureOverlays()` cannot vouch for
+ the overlay, which includes accessibility being off while the brain is alive), so the path that
+ assumed "no service, nothing to rebuild" was only true of one of its two entry points.
+ `BodyCoreService` already made this comparison for its own sheet; it is lifted out as
+ `reconcileBackendAfterSettings(beforeHub, beforeBrain)` and called from both hosts.
+- **Home gestures and overlay navigation on the phone.** Navigation boundaries are covered and failed
+ home actions are logged rather than dropped.
+- **Overlay opening and closing on the phone** does less work per frame, as does layout during keyboard
+ transitions.
+- **A refused voice handshake reads as a scrollback error.** On the Mac a tap that could not connect
+ used to fail silently; the reason now reaches the conversation.
+- **Volcengine voice endpoint and resource defaults show as hints** in settings rather than looking
+ like something already filled in.
+
+### Documentation
+
+- **Volcengine voice needs an entitled resource, not just a key.** A newly opened service defaults to
+ post-paid and can only be used from Volcengine's own trial page — calls over the API are refused, so a
+ correct key in a filled-in field still dies at the handshake. The switch is on the console's
+ **开通管理** page. Recorded because the two failure shapes both surface as `ASR ws refused: …` and
+ neither message points at that page. Two ASR resource ids this build can use are named in the README,
+ and version 2.0 is explicitly ruled out.
+
## [0.8.0] - 2026-10-29
**It has something of its own now, and it can act on it.** Until this release every turn began with an
diff --git a/DISCLAIMER.md b/DISCLAIMER.md
index 88edeb9..8f9702d 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.8.0.
+- *"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.8.1.
- *"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 a526610..3881599 100644
--- a/DISCLAIMER.zh-CN.md
+++ b/DISCLAIMER.zh-CN.md
@@ -45,7 +45,7 @@
**因此"本机模式"不等于"本地处理"** —— 本机模式只是把大脑从 hub 换成了你填的那个服务商。它没有让数据留在设备上,一个字都没有。
所以:
-- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.8.0"。
+- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.8.1"。
- 「您的数据不会离开设备」——**不成立,而且不要说**。
## 3. 它真的能做什么(以下都不是危言耸听,是代码里的现状)
diff --git a/README.md b/README.md
index 392ab0a..453c0f7 100644
--- a/README.md
+++ b/README.md
@@ -774,7 +774,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 | 18 / 0.8.0 | see [CHANGELOG.md](CHANGELOG.md) for the policy |
+| versionCode / versionName | 19 / 0.8.1 | 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`):
@@ -1210,7 +1210,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.8.0`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.
+**`v0.8.1`** — 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 5d66099..bf44c67 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -568,7 +568,7 @@ API 只认后一句。刚开通的服务默认是**后付费**,它只能在火
| 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 | 18 / 0.8.0 | 策略见 [CHANGELOG.md](CHANGELOG.md) |
+| versionCode / versionName | 19 / 0.8.1 | 策略见 [CHANGELOG.md](CHANGELOG.md) |
| applicationId / namespace | `net.kuafuai.andee` | 从模板里没改,不影响功能 |
**运行库依赖**(`app/build.gradle`):
@@ -1038,7 +1038,7 @@ CLAUDE.md 给 AI 编码助手看的架构说明(英文)
随包分发的第三方组件清单在 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。再分发之前请先看:
**ML Kit 扫码 SDK 和 `play-services-*` 不是开源许可**,而且扫码模型是运行时从 Google 拉的。
-改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.8.0`**,故意停在
+改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.8.1`**,故意停在
pre-1.0:线上协议和构建开关都还在动。
## 相关文档
diff --git a/app/build.gradle b/app/build.gradle
index 36863a6..597d9b8 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -130,8 +130,8 @@ android {
applicationId "net.kuafuai.andee"
minSdk 30
targetSdk 34
- versionCode 18
- versionName "0.8.0"
+ versionCode 19
+ versionName "0.8.1"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
diff --git a/docs/releases/v0.8.1.md b/docs/releases/v0.8.1.md
new file mode 100644
index 0000000..d51eeb7
--- /dev/null
+++ b/docs/releases/v0.8.1.md
@@ -0,0 +1,224 @@
+# v0.8.1
+
+**A cuter Andee, and four fixes that came out of using it.**
+
+The face was retuned against the reference illustrations. The rest is the kind of thing that only shows up
+on a real device — a key that the running brain never saw, home gestures on the phone, and a voice
+handshake that failed silently.
+
+> **These binaries carry no credentials.** No CodeFlying key, no voice-provider key, and no Google key.
+> **You supply your own**: sign up from the link inside the app, then paste the key into
+> **Settings → Backend**. Starting is free and the free allowance is finite.
+>
+> Each package already points at the right server for its language — the English ones at
+> `myapp.codeflying.app`, the Chinese at `baas.kuafuai.net`. You do not choose this.
+>
+> **The macOS packages are signed with a local identity, not an Apple Developer ID**, so Gatekeeper
+> refuses the first launch. On macOS 15 the old "right-click → Open" trick no longer exists; see
+> **[Opening the Mac app](#opening-the-mac-app)**.
+
+## Highlights
+
+- **A new face for the default Andee.** Periwinkle body with a peach rim light, bigger and darker eyes
+ with two glints, rounder horns, finer meshes. It is the same character — the look's `name` is unchanged,
+ so if you had picked an image, nothing moves.
+- **Thinking no longer pushes the eyes off the ball.** The bigger eyes made the old drift values visible
+ as an error. The drift and the slow sway are now capped so the outer eye stays on the head; quick
+ actions are deliberately left uncapped.
+- **A key you save is used immediately**, on the phone. Before this, saving one from the self-check sheet
+ wrote the setting and changed nothing — the ball kept answering *"no key"* until the app was
+ restarted.
+- **Phone gestures and overlay transitions** are smoother, and a tap on the Mac that cannot reach the
+ voice service now tells you why instead of failing silently.
+
+## What's Changed
+
+### Changed
+
+- **The default face, retuned toward the reference illustrations.** A periwinkle body with a peach rim
+ light, bigger and darker eyes with two glints, eyes and cheeks raised (`eyeY 0.09 → 0.07`) with the
+ mouth left low, rounder horns, and finer meshes for the eyes, mouth, horns and props. Gloss drops
+ `0.22 → 0.05` and the rim light becomes fully mixed (`0.55 → 1.0`), which is what moves it from
+ plastic to matte.
+
+### Fixed
+
+- **Thinking no longer carries the bigger eyes past the edge of the head.** The thinking drift is now
+ `0.03` (was `0.075`) and the head turn it drives `0.04` (was `0.09`); the slow sway and the drift are
+ capped together at `0.10 rad` so the outer eye cannot roll off the sphere. A shake or a look around is
+ not capped — those are brief. Checked over 36 frames at `dp 420` and at the folded `dp 136`.
+- **A key saved from the self-check sheet reaches the running brain.** Measured on a device: v0.8.0
+ reinstalled at 14:30 built its brain with an empty key, self-check reported `brain:FAIL` at 14:30:34,
+ the key was saved at 14:31, and the first typed sentence at 14:33 still came back *"no key"*. The brain
+ reads that line from a config snapshot taken when it was constructed, and nothing re-read it. The
+ self-check page can appear while the service is already running, so the path that assumed "no service,
+ nothing to rebuild" was only true of one of its two entry points.
+- **Home gestures and overlay navigation on the phone**: navigation boundaries are covered, and a home
+ action that fails is logged instead of dropped.
+- **Overlay opening and closing**, and layout during keyboard transitions, do less work per frame.
+- **A refused voice handshake on the Mac reads as an error in the conversation** rather than a tap that
+ silently does nothing.
+- **Volcengine voice endpoint and resource defaults** show as hints in settings instead of looking like
+ something already filled in.
+
+### Documentation
+
+- **Volcengine voice needs an entitled resource, not just a key.** A newly opened service defaults to
+ post-paid and can only be used from Volcengine's own trial page — calls over the API are refused, so a
+ correct key in a filled-in field still dies at the handshake. The switch is on the console's **开通管理**
+ page. It is written down because both failure shapes surface as `ASR ws refused: …`, and neither
+ message points at that page. Two ASR resource ids this build can use are named in the README, and
+ version 2.0 is explicitly ruled out.
+
+## Download
+
+### English packages
+
+**Android** (Android 11 / API 30 or later). Take the one that matches your device's processor:
+
+| Label shown on the page | File name | Take it if |
+|---|---|---|
+| Andee 0.8.1 · Android-arm64-v8a | `andee-0.8.1-en-android-arm64-v8a.apk` | **any phone from the last several years** — almost everyone |
+| Andee 0.8.1 · Android-armeabi-v7a | `andee-0.8.1-en-android-armeabi-v7a.apk` | an older 32-bit device |
+| Andee 0.8.1 · Android-x86_64 | `andee-0.8.1-en-android-x86_64.apk` | an emulator on a computer |
+
+*Not sure? Take `arm64-v8a`. If it refuses to install because no architecture matches, try
+`armeabi-v7a` — the two do not conflict, and only one of them can be right.*
+
+**macOS** (macOS 14 or later). Not a universal binary — take the one matching your Mac's chip:
+
+| Label shown on the page | File name | Take it if |
+|---|---|---|
+| Andee 0.8.1 · Mac-Apple silicon | `andee-0.8.1-en-mac-arm64.dmg` | an Apple silicon Mac (M1 or later) — **most Macs** |
+| Andee 0.8.1 · Mac-Intel | `andee-0.8.1-en-mac-x64.dmg` | an Intel Mac |
+
+*To check: Apple menu → About This Mac. "Chip: Apple M1/M2/M3/M4" means Apple silicon; "Processor:
+Intel Core" means Intel.*
+
+### Chinese packages
+
+The Chinese packages are the `-zh-` files, and each displays a Chinese label on the Release page:
+
+| Label shown on the page | File name |
+|---|---|
+| Andee 0.8.1 中文版 · Android-arm64-v8a | `andee-0.8.1-zh-android-arm64-v8a.apk` |
+| Andee 0.8.1 中文版 · Android-armeabi-v7a | `andee-0.8.1-zh-android-armeabi-v7a.apk` |
+| Andee 0.8.1 中文版 · Android-x86_64 | `andee-0.8.1-zh-android-x86_64.apk` |
+| Andee 0.8.1 中文版 · Mac-Apple 芯片 | `andee-0.8.1-zh-mac-arm64.dmg` |
+| Andee 0.8.1 中文版 · Mac-Intel 芯片 | `andee-0.8.1-zh-mac-x64.dmg` |
+
+Which one to take is the same question as above. The only other difference is the server, which is
+already baked in.
+
+The file names are ASCII because GitHub deletes Han characters from release asset names, so the Chinese
+wording lives in the label where it survives — and the downloaded file name stays ASCII, which means it
+survives every filesystem it is copied onto as well.
+
+### Opening the Mac app
+
+The `.dmg`s are signed with a local identity, not an Apple Developer ID, so Gatekeeper refuses the first
+launch of a downloaded copy.
+
+⚠️ **On macOS 15 (Sequoia) and later, "right-click → Open" no longer works** — Apple removed that
+override, and most advice online still recommends it. The current route:
+
+1. Double-click the app. It will be refused. Dismiss the dialog.
+2. Open **System Settings → Privacy & Security** and scroll to **Security**.
+3. There is a line naming Andee as blocked, with an **Open Anyway** button beside it.
+4. Confirm, and authenticate.
+
+That button **only appears for about an hour** after the failed launch. If it is missing, launch the app
+again and go straight back to Settings.
+
+One more thing worth knowing: the app **inside** the mounted dmg carries no quarantine flag, so it may
+launch straight from the dmg — and then be blocked once you drag it to Applications, which does attach
+one. Both behaviours are normal; neither means a damaged download.
+
+### What you supply
+
+No package has a key. After installing, open **Settings → Backend** and either paste a CodeFlying key
+(sign up from the link in that panel) or switch to **on-device** and give it an OpenAI-compatible
+endpoint and model.
+
+**For voice, a key alone may not be enough.** If you use Volcengine, the service must be an *entitled*
+resource, not just an opened one — see
+[docs/getting-started.md](../getting-started.md). Android can also use the system voice instead, and
+without any voice it is silent but still works on screen.
+
+> **Would you rather not configure keys at all?** 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 new face was checked offscreen, not on a device.** The 36-frame sweep at `dp 420` and the folded
+ `dp 136` were rendered for this release, and this project has an offscreen ball renderer and an
+ assertion script alongside it — but **the face on real hardware has never been verified here**. The
+ eyes are 3D capsules under perspective projection, so a flat rendering cannot stand in for the real
+ thing, and measuring a still image has been wrong every time it was tried. Look at it on a device
+ before assuming it is right.
+- **What it keeps for itself is per device.** The one on your phone and the one on your Mac each have
+ their own record — their own self-description, their own cares, their own people. They do not share a
+ notebook. This is deliberate rather than pending: one individual does not live in two bodies, and it
+ avoids cross-device sync, conflicts and doubled budgets as a class of problem.
+- **Nothing verifies that a key is accepted by the server it is sent to.** These packages are checked for
+ the right server and the absence of credentials; whether a given CodeFlying key works against
+ `baas.kuafuai.net` versus `myapp.codeflying.app` has not been exercised end-to-end.
+- **The Mac still falls back silently when no server is configured.** Every package here carries one, so it
+ does not arise for these downloads — but a locally built app with an empty domain resolves to the local
+ backend and sends whatever key it has to `api.deepseek.com`, while the self-check reports "Configured".
+- **`docs/design/inner-drive.zh-CN.md` still opens with "草案,未实现"** although the classes it describes
+ are all present. That status line is the author's to change.
+- **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.
+- **A light generated page still fades in over a dark stage.** Carried from `v0.3.1`; the app's own
+ default has been light since `v0.4.1`.
+- **`assets/andee_key.txt` is tracked by git and is not in `.gitignore`.** It ships with a single
+ newline, which reads as empty. A key written into it would outrank every build setting.
+- Two issues from `v0.1.0` are **unchanged and untouched**: `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.
+
+**It keeps its own record now, and that record is on your device.** The notebook is encrypted with a
+key in the platform keystore; the wiki is plain files by design. Anything you would not want in a plain
+file should stay in the notebook side.
+
+## Install from source
+
+```bash
+git clone https://github.com/kuafuai/andee
+cd andee
+git checkout v0.8.1
+
+# one variant, by hand:
+./gradlew :app:assembleDebug -PdefaultLang=en -PcodeflyingDomain=myapp.codeflying.app -PcodeflyingSsl=true
+
+# or all ten files, the way the release was built:
+bash ~/.workbuddy/skills/andee-release-ship/scripts/build_variants.sh
+```
+
+`-PcodeflyingKey=` and `-PgoogleVoiceKey=` are refused on purpose — a published package carries no
+credential.
+
+There is a getting-started guide: **[docs/getting-started.md](../getting-started.md)**, and
+**[docs/getting-started.zh-CN.md](../getting-started.zh-CN.md)** in Chinese.
+
+**Upgrading:** `versionCode` moves `18 → 19`, so the Android package installs over v0.8.0 normally. The
+Mac app's version string follows the same number. Existing memory, notebook, todos and chat history are
+untouched; if you had picked one of the other faces, your choice is unaffected — only the default face
+changed.
+
+**Full Changelog**: https://github.com/kuafuai/andee/compare/v0.8.0...v0.8.1