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.mdindex 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** orAndroid 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://keepachafrozen. 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 wherethe 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-12The release where the assistant stops living inside the accessibility service. Everything else herediff --git a/CLAUDE.md b/CLAUDE.mdindex 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.mdindex 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.mdindex 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.mdindex 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 documentsdiff --git a/README.zh-CN.md b/README.zh-CN.mdindex 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.gradleindex 593f3ce..bf71cf2 100644--- a/app/build.gradle+++ b/app/build.gradle@@ -34,8 +34,8 @@ android {applicationId "net.kuafuai.andee"minSdk 30targetSdk 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.mdindex 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.mdindex 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.mdnew file mode 100644index 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