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、支持任意模型,记忆和密码绝不离开设备。
docs(readme): speak to the English reader, and log what the docs changed
booboosui5efa9e810829
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex fcadd52..46d82ce 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -121,11 +121,28 @@ build time would close this hole; it is not implemented yet.)*this* project to). It is now described in its own terms first — **a general platform where youdescribe the app you want and it develops and publishes it** — followed by one plain sentence:**a separate service with no direct relationship to this project**, its own terms, pricing and data- handling. Same treatment in `## Using Andee` / `## 三种使用方式` and the Chinese- `## 从哪里开始看` table, so the three places it appears do not disagree. The practical guidance is+ handling. Same treatment in `## Using Andee` / `## 三种使用方式`; the Chinese `## 从哪里开始看`+ table carried it too, and has since been removed (see *Removed*). The practical guidance isunchanged (still the shortest path; still an APK you have to install; the free token allowance isstill finite and then paid), because none of that was wrong — only the implied ownership was.+- **The English README now addresses an English reader — in its examples and in the panel names it+ points at.** Two different faults with one symptom: a reader concluding the page is not for them.+ The examples were the Chinese ones with the words swapped (`WeChat`, `Taobao`, `JD`), and an+ example is precisely what a reader uses to judge whether something is addressed to them. They are+ now `WhatsApp`, `Amazon` and `eBay` — WhatsApp rather than a platform-native messenger because this+ runs on Android only, and naming an iOS-only one would be a false claim rather than a foreign one.+ Two of the scene examples needed rewriting rather than substituting: "look after my WeChat" is+ 帮我看着微信 carried across word for word, which is not a sentence English builds. Separately, the+ panel names were the Chinese labels, so a reader on an English device was being told to look for+ **产物** — a word their screen does not have. They now use the labels `values-en/` actually ships:+ **Scenes**, **Made for you**, **What it remembers**, **Voice API key**.+ The **measured** passage keeps every fact. Xiaomi Pad 5, MIUI, WeChat 8.0.78 and the 219-node count+ are what was observed, and changing the app name there to make the prose consistent would be+ inventing a measurement. Only its framing moved: it opened on WeChat, which a non-Chinese reader+ reads as someone else's app having someone else's problem, so it now opens on the general+ behaviour and names WeChat as the one we happened to measure.+### Removed- `brain/andee-system-prompt.md` — an unused mirror of the cloud brain's prompt. It had no runtime@@ -134,6 +151,14 @@ build time would close this hole; it is not implemented yet.)`git show <rev>:brain/andee-system-prompt.md`.- `dog/NRF24_Dongle/README.md` reference in the README — the dongle firmware is not in thisrepository and never was. The README now says so.+- The `## 从哪里开始看` section in `README.zh-CN.md`, heading included. Its visible content was three+ rows announcing that the demo video and the screenshots do not exist yet, which tells a reader+ nothing they cannot see for themselves. The heading went too: once the table was gone the section+ held nothing but an HTML comment, and a heading over nothing renders as exactly that. Every+ pointer to it went as well — the nav anchor, the header comment, and the sentence above. In its+ place, a slot for the demo video sits directly under the hero in both language files, and the+ asset checklist moved down beside the contributors block, which is where the English file already+ kept it.### Known issuesdiff --git a/README.md b/README.mdindex 2b60cdf..151a008 100644--- a/README.md+++ b/README.md@@ -49,17 +49,17 @@ it can do it.### Things you can just say-You are driving when your mother messages you. One hand on the wheel, eyes on the road:+You are driving when your mother texts you. One hand on the wheel, eyes on the road:-> *"Hey Andee — reply to Mom on WeChat: I'll be home by seven."*+> *"Hey Andee — reply to Mom on WhatsApp: I'll be home by seven."*-It opens WeChat, finds the chat, types, sends, and reads the answer back. Your hands never left the-wheel. **The hard part was never the sentence** — it is getting into a real app, as you, while you-are somewhere else. The rest of the list is the same job in other shapes:+It opens WhatsApp, finds your chat with Mom, types, sends, and reads the reply back. Your hands never+left the wheel. **The hard part was never the sentence** — it is getting into a real app, as you,+while you are somewhere else. The rest of the list is the same job in other shapes:| You say | What happens ||---|---|-| *"Find this cheaper on Taobao and JD."* | It walks both shops itself and comes back with a comparison page. |+| *"Find this cheaper on Amazon and eBay."* | It shops both sites itself and comes back with a comparison page. || *"Remind me to call the landlord at nine tomorrow."* | The alarm is set before it says "OK". At nine, it wakes up and tells you. || *"Record this meeting."* | It holds the mic for the hour, then hands you the minutes as a page. || *(a photo)* *"What's wrong with this plant?"* | Photos ride along with what you type; it looks and answers. |@@ -134,12 +134,12 @@ every fill on the ball as it happens.### Mind — it gets to know you**5. Scenes: ways of working it learns with you.** *(new)*-"Practice English with me", "look after my WeChat", "compare prices for me" — a scene is a goal, a-voice, rules and a routine it steps into for a while. They are **not shipped, they are learned**:+"Practice English with me", "keep an eye on my messages", "compare prices for me" — a scene is a goal,+a voice, rules and a routine it steps into for a while. They are **not shipped, they are learned**:after the same kind of session comes up a few times, it proposes one; nothing is saved until you say-yes. Enter one by saying so, from the 情景 panel, on a schedule, or automatically when you open an-app. A scene's own rules decide how much it does on its own — "reply to my WeChat for me" really-means it replies. While you are in one, a chip under the ball names it; its ✕ leaves it.+yes. Enter one by saying so, from the **Scenes** panel, on a schedule, or automatically when you+open an app. A scene's own rules decide how much it does on its own — "answer my messages for me"+really means it answers. While you are in one, a chip under the ball names it; its ✕ leaves it.**6. It reads your notifications before they interrupt you.** *(new)*A cheap, tool-less model call (~500 tokens, against ~22,000 for a full turn) classifies each one:@@ -154,7 +154,7 @@ test decides what gets written: *"next time I deal with them, would not knowingit wrong?"* The notebook is **private** — the tools are `localOnly` and filtered out of the hubpayload, so habits and promises never leave the device. On top of it sits a real scheduler, undera hard rule: the moment it says "I'll remind you", the task must already be set and confirmed. And it-is yours to read: **它记得的事** lists every memory and every scheduled task, each one deletable.+is yours to read: **What it remembers** lists every memory and every scheduled task — all deletable.**8. It behaves the same when nobody is watching.**After a conversation goes quiet the device sends a `(to yourself …)` turn — Andee reviewing the@@ -186,9 +186,9 @@ up to six photos — from the camera or the gallery — with or without words.**12. Answers you can keep.**Anything structured — a comparison, a plan, meeting minutes — comes back as a page it writes and-puts on screen. The **产物** panel keeps up to a hundred of them to reopen, delete, or revise by-just saying what should change. Ask it to record a meeting and it holds the microphone for the-hour, writing a verbatim transcript to disk as it goes, then turns it into minutes.+puts on screen. The **Made for you** panel keeps up to a hundred of them to reopen, delete, or+revise by just saying what should change. Ask it to record a meeting and it holds the microphone+for the hour, writing a verbatim transcript to disk as it goes, then turns it into minutes.### Body@@ -279,7 +279,7 @@ behind it falls back to something else. The ball does at least say so out loud,doing nothing.**2. The voice key — optional.** A [Volcengine Speech](https://www.volcengine.com/product/voice-tech)-API key, in 「语音密钥」 / *Voice API key*. Without it ASR and TTS fail during the WebSocket+API key, in the **Voice API key** field. Without it ASR and TTS fail during the WebSockethandshake, which surfaces as a **connect timeout** — the device looks like it has a network problemwhen what it has is a blank field. Everything else still works; it is just mute and deaf.@@ -304,8 +304,8 @@ There is no home screen. What exists:- **A floating ball.** The entire UI is `TYPE_APPLICATION_OVERLAY` layers added through`WindowManager` (`ui/FloatingWindowUi`). Unfolded, it is a full-screen card: the ball's face on- top, the conversation underneath, and a small control bar — **产物** (the pages it has made),- **情景** (its scenes), **✓** (self-check), **⚙** (settings). When it starts working another app it+ top, the conversation underneath, and a small control bar — **Made for you** (the pages it has+ made), **Scenes**, **✓** (self-check), **⚙** (settings). When it starts working another app itfolds itself into a ball in the corner and gets out of the way; tap to talk, long-press to unfold.- **The launcher icon opens two doors.** With the assistant running, it unfolds the card — exactlywhat a long-press on the ball does. With accessibility off, it shows the self-check card instead,@@ -386,10 +386,10 @@ report success and a filename.*Note:* most vendor ROMs **switch this grant off again** after every system update and everyforce-stop. That is ROM behaviour, and not something the app can prevent.-*WeChat (and other apps) sometimes show a blank screen to it.* Some apps hand **every**-accessibility client an empty placeholder instead of their real UI. This is not Andee's fault:-the system's own `uiautomator dump` gets the same blank page. Measured on a Xiaomi Pad 5 with-MIUI and WeChat 8.0.78, WeChat only shows its real UI tree when MIUI's hidden+*Some apps hand it a blank screen instead of their real UI.* They serve **every**+accessibility client an empty placeholder, not just Andee — and it is not Andee's fault:+the system's own `uiautomator dump` gets the same blank page. The one we measured is WeChat, on a+Xiaomi Pad 5 with MIUI and WeChat 8.0.78: it only shows its real UI tree when MIUI's hidden**`MiuiEnhanceTBService`** is enabled. That is a TalkBack companion service, and it has no switchin Settings. With it on, the same chat screen dumps 219 nodes. With it off, it dumps none. MIUIalso turns that service on and off by itself whenever Andee is re-bound (after a reinstall, a