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

booboosui31d093dc0848
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2227894..57437b6 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 **`4` / `"0.3.0"`**.
+- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`5` / `"0.3.1"`**.
- 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.
@@ -15,8 +15,7 @@ Notable changes to Andee. The format follows [Keep a Changelog](https://keepacha
frozen. The tool-schema contract a hub brain speaks has been rewritten repeatedly
(`net/ToolSchemas.kt` has been rewritten in every release so far), the `local.properties`
build flags that decide the first-install language, the thinking default and whether CodeFlying is
-compiled in have all been added since, and a saved scene is a shape that only appeared in this
-release. Each of those is something a user or a second implementation would have to rebuild against,
+compiled in have all been added since, and a saved scene is a shape that only appeared in `0.2.0`. Each of those is something a user or a second implementation would have to rebuild against,
so `0.x` is being honest that MINOR may break. The release that moves off `0` should be the one where
the wire contract is written down well enough that a second implementation could be built from it.
@@ -28,6 +27,136 @@ hash into `versionName` at build time would close this hole; it is not implement
## [Unreleased]
+## [0.3.1] - 2026-10-13
+
+**A patch release by decision, against this file's own definition.** The delta carries six `feat`
+commits and the versioning policy above says a new capability is MINOR; the maintainer chose PATCH
+deliberately. It is written down here rather than left for someone to reconstruct from the history,
+because a version number that disagrees with the policy is exactly the kind of thing that reads as an
+oversight later.
+
+### Added
+
+- **A day palette, alongside the night one.** The card had been one look — a translucent pane over a
+ blurred photograph, a bright hairline, pale type — and half the requests on top of it wanted the
+ opposite of those values. What blocked every one of them was that `Glass`'s colours were `const
+ val`s: inlined into their readers at compile time, and so unable to vary at runtime at all. They are
+ getters over a day and a night `Palette` now, **every name unchanged**, which is what let forty call
+ sites stay where they are. Night is what the app shipped with and is the default; day is the
+ inversion of it, with three values deliberately left alone because they name a position rather than
+ a colour — the well stays recessed, the thumb stays raised, and the sheen flips end for end, because
+ its job is a lit edge and the light does not come from below on either palette. A theme is a
+ process-global with one listener, shaped after `AppLocale` for the same reason: almost no UI here
+ lives in an Activity, so no system mechanism could reach a Service's overlays. The backdrop is the
+ same photograph, blurred once and veiled in whichever direction the palette needs — black down to
+ 0.22 at night (the original composite to the digit) and **white** up to 0.62 by day. One image, two
+ veils, no asset change. Four faults presented as a single element looking wrong and are the reason
+ this is one commit: `CardUi`'s colours lived in a companion object and were evaluated once at class
+ load, so the card kept whichever palette the process saw first *for the life of the process*; the
+ window's own chrome is built once and never hears about a change, which is what `applyPaletteToChrome`
+ is for; the row tints were cached; and the light card's dim greys could not survive being asked to
+ sit on a photograph.
+- **A "Looks & expressions" card in Settings**, showing every look and every expression on a ball of
+ its own. A look chip is saved on tap; an expression chip only previews.
+- **A generated page picks its own look.** Every page came back the same dark slate, and the reason
+ was not taste — it was a HOUSE STYLE block in the `show_html` description, ending in "use these
+ exact values, no others". Asking for a light page worked only because the block left itself a way
+ out, and that is a lever the user had to pull every single time. It could not have been fixed by
+ wiring the block to the theme: a tool description is a string and cannot branch on `Theme.night`, so
+ on a device switched to day the cards, the ball and the backdrop all went light and the one surface
+ the model composes stayed in the night palette. That fix was on the table and was turned down on
+ purpose — a page's look is the model's business, not ours. Two things stay, and neither is a matter
+ of taste: the `<meta viewport>`, because `HtmlActivity` sets `useWideViewPort` and a page without
+ one is laid out at desktop width and scaled down, and the ~110×44 px the ✕完成 pill occupies in the
+ top-right corner, because that pill is ours. **The cost is on the record**: for the small models this
+ runs against, that description was the only lever on page quality, and nothing enforces any more
+ that a generated page reads as part of Andee.
+- **The local LLM endpoint and model follow the UI language.** The 本机 tab's two LLM rows already had
+ a hint that doubled as the value a blank row resolves to, and both were hardcoded to DeepSeek —
+ self-consistent for a Chinese card and wrong for an English one. The cheapest possible fix, changing
+ only the hint text, is the worst version of it: the box would advertise `https://api.openai.com/v1`
+ and then, on a blank row, call `https://api.deepseek.com`. The hint is read exactly when a user is
+ deciding what to type, so a hint that lies about the fallback lies in the one place it will be
+ believed. Hint and fallback now come from one pair of resolvers keyed off `uiLanguage`: an English
+ card advertises and calls `https://api.openai.com/v1` + `gpt-4o-mini`, a Chinese card stays on
+ `https://api.deepseek.com` + `deepseek-flash`. CodeFlying is deliberately *not* switched by language,
+ because its model belongs to the hosted backend and an English build inventing `gpt-4o-mini` there
+ would name a model CodeFlying does not serve.
+- **Errand trips from the check card are handed to the page instead of made by it**, so the list
+ survives the trip. On the check *page* tapping a row's 处理 sent the user to Settings and coming back
+ landed on the list; from the check *card* the same three taps ended on the desktop with a ball in the
+ corner, because the card was closed and the assistant folded before the destination launched — which
+ does clear the screen, since an overlay outranks every Activity, but throws the list away: a window
+ gets no `onResume`, and the destination went out with `FLAG_ACTIVITY_NEW_TASK` into a task of its
+ own, so back from Settings had nowhere of ours to return to. `SelfCheckUi.onErrand` (was
+ `onYieldScreen`) now hands the host the Intent and lets the host say whether it can carry it.
+ `Fix.Grant` goes through the same door, so 允许 on 麦克风 / 弹出通知 stops ending on the launcher too.
+- **The prop-and-pose layer is on every look now**, not just Andee — stars, a heart, a shield, a sweat
+ bead, the sliced lid, and the idle life that lets a look wear its own expressions and nap while
+ nothing is happening. The argument for keeping it to one look was that the others had been tuned
+ without it; that is overruled, because a look that is not alive standing next to one that is reads as
+ the broken one. Switching it on for Imp needed a fix nothing at the call site would have hinted at:
+ the lid's eye mesh was cut at a fixed 0.38 and Imp ships a resting eye already cut at 0.48, so an
+ angry imp would have *opened* its eyes, in two moods, silently.
+- **Andee's horns stand higher**, fade to a peach tip and hang on two springs, so a wiggle or a turn
+ swings them and they ring out; the mood sets where they rest. While idle it now wears a short run of
+ safe faces and naps for under a minute instead of sleeping until touched — faces that report what the
+ device is doing, or that read as an alarm, are left out on purpose. Hands are a round palm, a thumb
+ and two capsule fingers, and the wink carries a floating heart instead of a hand, because a V, a
+ pointing finger and a thumbs-up were each tried and each misread at this size.
+
+### Changed
+
+- **Both READMEs lead with what it is.** They opened by showing what the thing *does* under a headline
+ that framed it as a phone upgrade. The H3, the hero and the lead now say what it *is* and what it can
+ *do* second, and the "why it is not the assistant already in your phone" section moved above the
+ examples, which are now explicitly what its hands look like. Two earlier drafts were self-defeating
+ and both were caught by reading them: one claimed "not a tool, not a companion" and then proved it
+ with a capability list, the other denied being an assistant that operates your phone while the whole
+ section below was exactly that. Neither is fixable with an adjective; the negations are now scoped to
+ a category, and the section opens with the axis that separates the two — its own schedule, notebook,
+ judgement about when to speak, and limits, all of which happen in the time you did **not** ask for
+ anything.
+- **The English README no longer contains a single Chinese character** (`\p{Han}` returns nothing): the
+ language badge, five look names, a dozen `([中文](…))` links, the `(中文)` markers on the CodeFlying
+ sites and a button quoted in Chinese. The Chinese README keeps its own language.
+
+### Fixed
+
+- **`POST_NOTIFICATIONS` was declared in the manifest since the beginning and never requested** — never
+ checked, never asked for, so on Android 13+ everything this app posts was dropped in silence: the
+ persistent notification that is the way back to it, and every reminder `Scheduler` fires. The
+ codebase half knew: `Scheduler` carries a comment blaming this permission for its own failure to
+ notify, and nothing anywhere tested the claim. The row that looked like it covered this does not —
+ 通知使用权 is the notification *listener*, which can be granted and green while every notification
+ the app sends disappears. Two things this needed beyond a catalog entry: `Perm.api`, because on
+ API 32 and below the permission does not exist and `checkSelfPermission` answers **denied** for
+ anything it does not know, so an ungated row would report a missing permission on every Android 12
+ device with no button and no way to fix it; and `SOLO_IDS`, because that set is a whitelist and a
+ permission added by someone who never read it routes to handoff.
+- **Three documents still described things the code had stopped doing.** The data-flow table in both
+ `DISCLAIMER`s and both `permissions` documents named `api.deepseek.com` as the default destination
+ for the conversation, with no mention of the language dependency added in this release — so an
+ English reader was told their data goes somewhere it does not. `CLAUDE.md` still called the
+ `show_html` house style "the one deliberate exception" to the single-palette rule, two paragraphs
+ after the same file recorded that the house style had been removed; there is no exception now. And
+ the `POST_NOTIFICATIONS` row in the permission table said only that a reminder would not arrive,
+ which undersold it: refusing also kills the notification that is the route back to screen control.
+
+### Removed
+
+- **The raised mitts are gone.** Andee's expressions were built around a pair of mitts raised at the
+ side — a fist under the chin for thinking, two fists up for celebrating, a hand on the belly for
+ resting — and every one of them read as a lump at the eighty dp the ball is actually drawn at, with
+ the parts sharing the body's own colour and material. Dropping them is the honest version of "this
+ does not work at this size": the ball keeps the paws it hangs off the screen edge with. No expression
+ collapses into CALM for it, because a mood is read through its own `Face` row and its body motion,
+ neither of which ever came from the pose table. Two leftovers are deliberate and both say so where
+ they live: WAVE keeps its fan of motion strokes with no hand to fan off them, and HOLDING keeps an
+ empty row, because the signboard it waits behind is a real card in the ball's own window.
+- **The `show_html` house style**, along with the `LocalPrompt` §7 sentence that pointed at it and then
+ asserted "that style is what you look like". Both were describing the prescribed look being removed.
+
## [0.3.0] - 2026-10-12
The release where the assistant stops living inside the accessibility service. Everything else here
diff --git a/CLAUDE.md b/CLAUDE.md
index 9404ec6..4ae2e66 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -408,7 +408,7 @@ Nothing here animates for decoration — each one answers a question the user wo
- `expand` / `collapse` say the rows that just vanished were folded away, not deleted. The brain section flips both halves *simultaneously* rather than in sequence, so the card's total height barely moves while one block shrinks and the other grows.
- The language swap cross-fades (`fadeOut` → rebuild → `fadeIn`) — same run-once backstop, same reason.
-**Everything else the user sees takes the same palette**, so there is one place to change a colour: the unfolded card and its scrollback (`FloatingWindowUi`, `HistoryListView`), the assistant's own dialogs (`CardUi`), the camera and page chrome (`CameraChrome`, `HtmlActivity`) and `Theme.Body.Fullscreen`'s window background. The one deliberate exception is the `show_html` house style in `ToolSchemas` — that is prose handed to the brain about the page *it* composes, not our chrome.
+**Everything else the user sees takes the same palette**, so there is one place to change a colour: the unfolded card and its scrollback (`FloatingWindowUi`, `HistoryListView`), the assistant's own dialogs (`CardUi`), the camera and page chrome (`CameraChrome`, `HtmlActivity`) and `Theme.Body.Fullscreen`'s window background. There used to be exactly one deliberate exception — the `show_html` house style in `ToolSchemas` — and it is gone: that description now prescribes nothing about how a page looks, so the palette is the only place a colour is decided anywhere in this app.
Four things about that spread are not cosmetic:
diff --git a/DISCLAIMER.md b/DISCLAIMER.md
index 6fa4365..59628b0 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) | **Volcengine / ByteDance cloud** | `openspeech.bytedance.com` |
-| The conversation, **and every tool result** | The "brain" you configured | `brain=local` (the out-of-box default) → `api.deepseek.com`; in hub mode, your own `hub_url` |
+| 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 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.3.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.3.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 a97d42f..621d27e 100644
--- a/DISCLAIMER.zh-CN.md
+++ b/DISCLAIMER.zh-CN.md
@@ -34,7 +34,7 @@
| 什么数据 | 去哪 | 默认 |
|---|---|---|
| 你说的话(语音识别)、它说的话(语音合成) | **火山引擎(字节跳动)云端** | `openspeech.bytedance.com` |
-| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | `brain=local`(开箱默认)→ `api.deepseek.com`;hub 模式下走你自己的 `hub_url` |
+| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | `brain=local`(开箱默认)→ 中文界面走 `api.deepseek.com`、英文界面走 `api.openai.com`;hub 模式下走你自己的 `hub_url` |
| 私人笔记本(`Notebook`:它记住的你、以及它答应过的事) | **只在本机** | 不进 hub 载荷,不外发 |
| **版本自检**:当前版本号、手机型号 / 品牌 / 系统版本、界面语言、一个随机安装 ID | **维护者自己的一台服务器**(不是第三方) | 首次启动一次,以及在自检页点「重新检查」时一次;同一 IP 每天最多 10 次 |
@@ -45,7 +45,7 @@
**因此"本机模式"不等于"本地处理"** —— 本机模式只是把大脑从 hub 换成了你填的那个服务商。它没有让数据留在设备上,一个字都没有。
所以:
-- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.3.0"。
+- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.3.1"。
- 「您的数据不会离开设备」——**不成立,而且不要说**。
## 3. 它真的能做什么(以下都不是危言耸听,是代码里的现状)
diff --git a/README.md b/README.md
index 5524cc1..1ea992a 100644
--- a/README.md
+++ b/README.md
@@ -549,7 +549,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 | 4 / 0.3.0 | see [CHANGELOG.md](CHANGELOG.md) for the policy |
+| versionCode / versionName | 5 / 0.3.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`):
@@ -972,7 +972,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.3.0`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.
+**`v0.3.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 84f99d4..645a17d 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -398,7 +398,7 @@ OpenAI 兼容端点(`llm_api_key`,中文界面默认 `https://api.deepseek.c
| 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 | 4 / 0.3.0 | 策略见 [CHANGELOG.md](CHANGELOG.md) |
+| versionCode / versionName | 5 / 0.3.1 | 策略见 [CHANGELOG.md](CHANGELOG.md) |
| applicationId / namespace | `net.kuafuai.andee` | 从模板里没改,不影响功能 |
**运行库依赖**(`app/build.gradle`):
@@ -856,7 +856,7 @@ CLAUDE.md 给 AI 编码助手看的架构说明(英文)
随包分发的第三方组件清单在 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。再分发之前请先看:
**ML Kit 扫码 SDK 和 `play-services-*` 不是开源许可**,而且扫码模型是运行时从 Google 拉的。
-改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.3.0`**,故意停在
+改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.3.1`**,故意停在
pre-1.0:线上协议和构建开关都还在动。
## 相关文档
diff --git a/app/build.gradle b/app/build.gradle
index 593f3ce..bf71cf2 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -34,8 +34,8 @@ android {
applicationId "net.kuafuai.andee"
minSdk 30
targetSdk 34
- versionCode 4
- versionName "0.3.0"
+ versionCode 5
+ versionName "0.3.1"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
diff --git a/docs/permissions.md b/docs/permissions.md
index 3a0725b..60489c1 100644
--- a/docs/permissions.md
+++ b/docs/permissions.md
@@ -51,7 +51,7 @@ The "What you get" column is the copy the app actually shows (`dev_perm_feature_
| Write calendar<br>`WRITE_CALENDAR` | Write calendar (add events) | `add_calendar_event` | Cannot record events |
| Camera<br>`CAMERA` | Sight (identify objects / scan codes) | `camera_turn` / `scan_code` | Those two stop working |
| Installed apps<br>`QUERY_ALL_PACKAGES` | Know which apps are installed | `list_installed_apps` / `launch_app` | Cannot open a named app |
-| Notifications<br>`POST_NOTIFICATIONS` | Remind you on time | Due-task reminders | No reminder at the due time, **but the task is not lost** |
+| Notifications<br>`POST_NOTIFICATIONS` | Remind you on time, **and the persistent notification** | Due-task reminders, and the way back to the assistant when accessibility is revoked | **Nothing the app posts appears at all** — no reminder at the due time, and no persistent notification, which is also the route back to screen control. The task is not lost |
| Boot<br>`RECEIVE_BOOT_COMPLETED` | Tasks survive a reboot | Rebuilding the `AlarmManager` alarms | After a reboot, due tasks stop reminding |
| Battery optimisation exemption<br>`REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` | Reminders arrive on time | Task scheduling | With the screen off, reminders arrive late |
| Write secure settings<br>`WRITE_SECURE_SETTINGS` | Switch the input method, for the spare typing route | Prerequisite for the ADBKeyboard fallback | Nothing on Android 13 and above — typing goes through the accessibility input method. On Android 12 and below, **`type_text` fails outright**, and tells you exactly why. It will not pretend to succeed |
@@ -103,7 +103,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) | **Volcengine (ByteDance) cloud** | `openspeech.bytedance.com` |
-| Conversation content, **and every tool result** | The "brain" **you** configured | `brain=local` (the out-of-box default) → `api.deepseek.com`; in hub mode, your own `hub_url` |
+| 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` |
| 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 |
diff --git a/docs/permissions.zh-CN.md b/docs/permissions.zh-CN.md
index 3922d9a..683a806 100644
--- a/docs/permissions.zh-CN.md
+++ b/docs/permissions.zh-CN.md
@@ -51,7 +51,7 @@
| 写日历<br>`WRITE_CALENDAR` | 写日历(记日程) | `add_calendar_event` | 记不了日程 |
| 摄像头<br>`CAMERA` | 看(拍照识物 / 扫码) | `camera_turn` / `scan_code` | 这两条用不了 |
| 应用列表<br>`QUERY_ALL_PACKAGES` | 知道装了哪些应用 | `list_installed_apps` / `launch_app` | 打不开指定应用 |
-| 通知栏<br>`POST_NOTIFICATIONS` | 到点提醒你 | 待办到期的提醒 | 到点不提醒,**但待办不会丢** |
+| 通知栏<br>`POST_NOTIFICATIONS` | 到点提醒你,**以及那条常驻通知** | 待办到期的提醒,以及无障碍被撤销后回来的路 | **应用发出的通知一条都不会出现** —— 到点不提醒,也没有那条常驻通知,而它同时是接回屏幕操作的入口。待办不会丢 |
| 开机自启<br>`RECEIVE_BOOT_COMPLETED` | 重启后待办还在 | 重建 `AlarmManager` 闹钟 | 重启后待办不再提醒 |
| 电池优化豁免<br>`REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` | 到点提醒准时 | 待办定时 | 息屏状态下提醒会迟到 |
| 改系统设置<br>`WRITE_SECURE_SETTINGS` | 换输入法(备用打字通道用) | ADBKeyboard 兜底通道的前置步骤 | Android 13 及以上没影响 —— 打字走的是无障碍输入法。Android 12 及以下则 **`type_text` 直接失败**,并明确告诉你失败原因,不会假装成功 |
@@ -103,7 +103,7 @@ Andee 有一个保险箱(`config/Vault.kt`),用来存你自己填进去的
| 什么数据 | 去哪 | 默认值 |
|---|---|---|
| 语音识别(你说的话)、语音合成(他说的) | **火山引擎(字节跳动)云端** | `openspeech.bytedance.com` |
-| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | `brain=local`(开箱默认)→ `api.deepseek.com`;hub 模式下走你自己的 `hub_url` |
+| 对话内容,**以及全部工具返回结果** | 你配置的"大脑" | `brain=local`(开箱默认)→ 中文界面走 `api.deepseek.com`、英文界面走 `api.openai.com`;hub 模式下走你自己的 `hub_url` |
| 私人笔记本(`config/Notebook.kt`:记住的你、答应过的事) | **只在本机** | 是 `localOnly`,不进 hub 载荷 |
| **版本自检**:当前版本号、手机型号 / 品牌 / 系统版本、界面语言、一个随机安装 ID | **维护者自己的一台服务器**(不是第三方) | 首次启动一次,以及在自检页点「重新检查」时一次;同一 IP 每天最多 10 次 |
diff --git a/docs/releases/v0.3.1.md b/docs/releases/v0.3.1.md
new file mode 100644
index 0000000..ac53613
--- /dev/null
+++ b/docs/releases/v0.3.1.md
@@ -0,0 +1,165 @@
+# v0.3.1
+
+**A patch release by decision, against the project's own definition.** The delta carries six `feat`
+commits and [CHANGELOG.md](../../CHANGELOG.md#versioning-policy) says a new capability is MINOR, so
+the policy would have made this `0.4.0`. It is recorded rather than left for someone to reconstruct
+from the history, because a version number that disagrees with its own policy is the kind of thing
+that 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.
+
+## Highlights
+
+- **The card has a day palette now**, alongside the night one it always had. What blocked it was that
+ `Glass`'s colours were `const val`s — inlined at compile time, unable to vary at runtime at all.
+ They are getters over a day and a night `Palette`, every name unchanged, which is what let forty
+ call sites stay where they are. The backdrop is one photograph with two veils, so there is no asset
+ change.
+- **A "Looks & expressions" card in Settings**, showing every look and every expression on a ball of
+ its own. Look chips save on tap; expression chips only preview.
+- **The local LLM endpoint and model follow the UI language.** An English card advertises *and calls*
+ `https://api.openai.com/v1` + `gpt-4o-mini`; a Chinese card stays on `https://api.deepseek.com` +
+ `deepseek-flash`. Hint and fallback come from one resolver, so the box cannot advertise one endpoint
+ and silently call another.
+- **A generated page picks its own look.** The prescribed HOUSE STYLE block is gone from the
+ `show_html` description. Expect a wider spread of looks.
+- **`POST_NOTIFICATIONS` is actually requested now.** It had been declared in the manifest since the
+ beginning and mentioned by no Kotlin file, so on Android 13+ everything the app posted was dropped
+ in silence — including the persistent notification that is the way back to it.
+- **Tapping 处理 in the check card no longer throws the list away.** The trip to Settings is handed to
+ the page, which is in the task the destination lands in and gets a resume callback on the way back.
+
+## What's Changed
+
+### Added
+
+- **A day and a night palette** (`ui/Theme.kt`). Night is the default and the values the app already
+ shipped with; day is the inversion, with three values deliberately left alone because they name a
+ position rather than a colour — the well stays recessed, the thumb stays raised, and the sheen flips
+ end for end. A theme is a process-global with one listener, shaped after `AppLocale`, because almost
+ no UI here lives in an Activity and no system mechanism could reach a Service's overlays. The
+ backdrop is blurred once and veiled in whichever direction the palette needs — black down to 0.22 at
+ night (the original composite to the digit), **white** up to 0.62 by day.
+- **A "Looks & expressions" card in Settings** (`ui/ExpressionsUi.kt`).
+- **The local LLM endpoint and model follow `uiLanguage`**, from one pair of resolvers. CodeFlying is
+ deliberately *not* switched by language: its model belongs to the hosted backend, and an English
+ build inventing `gpt-4o-mini` at that endpoint would name a model CodeFlying does not serve.
+- **Errand trips from the check card are handed to `SelfCheckActivity.showForErrand`** rather than made
+ by the card. `Fix.Grant` goes through the same door, so 允许 on 麦克风 / 弹出通知 stops ending on the
+ launcher as well.
+- **Every look gets the prop-and-pose layer**, not just Andee — stars, a heart, a shield, a sweat bead,
+ the sliced lid, and an idle life that lets a look wear its own expressions and nap while nothing is
+ happening. A look that is not alive standing next to one that is reads as the broken one.
+- **Andee's horns stand higher and hang on two springs**, so a wiggle or a turn swings them; the mood
+ sets where they rest. It wears a short run of safe faces while idle and naps for under a minute
+ instead of sleeping until touched. Hands are a round palm, a thumb and two capsule fingers, and the
+ wink carries a floating heart instead of a hand — a V, a pointing finger and a thumbs-up were each
+ tried and each misread at this size.
+
+### Changed
+
+- **Both READMEs lead with what it is**, and the "why it is not the assistant already in your phone"
+ section moved above the examples. Two earlier drafts were self-defeating and both were caught by
+ reading them: one claimed "not a tool, not a companion" and then proved it with a capability list,
+ the other denied being an assistant that operates your phone while the whole section below was
+ exactly that. The negations are now scoped to a category and the section opens with the axis that
+ separates the two.
+- **The English README no longer contains a single Chinese character** — `\p{Han}` returns nothing. The
+ language badge, five look names, a dozen `([中文](…))` links and the `(中文)` markers on the
+ CodeFlying sites were all changed. The Chinese README keeps its own language.
+
+### Fixed
+
+- **`POST_NOTIFICATIONS` was declared and never requested.** On Android 13+ that silently dropped every
+ notification this app posts: the persistent notification that is the route back to screen control,
+ and every reminder `Scheduler` fires. The codebase half knew — `Scheduler` carries a comment blaming
+ this permission for its own failure to notify, and nothing tested the claim. The row that looked like
+ it covered this (通知使用权) is the notification *listener*, which can be granted and green while
+ every notification the app sends disappears. Two things were needed beyond a catalog entry: on API 32
+ and below the permission does not exist and `checkSelfPermission` answers **denied** for anything it
+ does not know, so the entry is skipped rather than answered; and it is named in `SOLO_IDS`, because
+ that set is a whitelist whose default would have handed it to `ask_user`.
+- **The check card's 处理 no longer ends on the desktop.** The card was closed and the assistant folded
+ before the destination launched, so a window — which gets no `onResume` — lost the list, and the
+ destination went out with `FLAG_ACTIVITY_NEW_TASK` into a task of its own, leaving nowhere of ours to
+ return to. Verified on the tablet (Mi Pad 5, `.dbg` package).
+- **Four documents corrected.** The data-flow table in both `DISCLAIMER`s and both `permissions`
+ documents named `api.deepseek.com` as the default destination for the conversation with no mention of
+ the language dependency added in this release — so an English reader was told their data goes
+ somewhere it does not. `CLAUDE.md` still called the `show_html` house style "the one deliberate
+ exception" to the single-palette rule, two paragraphs after the same file recorded that the house
+ style had been removed. And the `POST_NOTIFICATIONS` row said only that a reminder would not arrive,
+ which undersold it.
+
+### Removed
+
+- **The raised mitts.** Andee's expressions were built around a pair of mitts raised at the side — a
+ fist under the chin, two fists up for celebrating, a hand on the belly for resting — and every one
+ read as a lump at the eighty dp the ball is actually drawn at, with the parts sharing the body's own
+ colour and material. The ball keeps the paws it hangs off the screen edge with. No expression
+ collapses into CALM for it: a mood is read through its own `Face` row and its body motion, neither of
+ which ever came from the pose table.
+- **The `show_html` house style**, and the `LocalPrompt` §7 sentence that pointed at it and then
+ asserted "that style is what you look like".
+
+## Known issues
+
+- **A light generated page fades in over a dark stage.** `TextPage`, `TracePage`, `Theme.Body.Fullscreen`'s
+ window background and `HtmlActivity`'s WebView backdrop are all still dark, so the page's own palette
+ and the surface it arrives on do not agree. The flash is **not verified on a device** — what was run
+ is `:app:compileDebugKotlin`.
+- **The READMEs enumerate five looks under a "six looks" heading.** Six is right (`andee`, `bajie`,
+ `cream`, `imp`, `rabbit`, `bear`); the five named are the ones other than the default. Which five to
+ name is the maintainer's call rather than a fact to be guessed at, so it was left.
+- **The microphone promotion has still not been on a device.** The body's foreground-service start path
+ was exercised in this release (the errand verification above required a running assistant), but
+ `promoteForMicrophone` specifically was not.
+- **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`, `v0.2.0` and `v0.3.0`; 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 `kft_` 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.
+- **`settleRecheck`'s retry is reasoned from the code path, not measured.** Writing the notification
+ listener into `enabled_notification_listeners` does not stick, so the "granted but not bound" state
+ cannot be manufactured from adb.
+- 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
+
+Android 11+ (`minSdk 30`), arm64-v8a for anything bought in the last several years. There is no binary
+in this release; build one:
+
+```bash
+git clone https://github.com/kuafuai/andee
+cd andee
+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 ⚙.
+
+**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
+or model, this release **re-points them to OpenAI** — `https://api.openai.com/v1` and `gpt-4o-mini`.
+That is the one behaviour change here that can move your data somewhere new; a saved value is never
+touched, and CodeFlying is deliberately not switched by language.
+
+**Full Changelog**: https://github.com/kuafuai/andee/compare/v0.3.0...v0.3.1