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.0 — a notebook of its own, and 13 new tools
booboosuidf667e69a342
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex fb82194..e6b2c1f 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 **`17` / `"0.7.1"`**. The+- `versionCode` / `versionName` live in `app/build.gradle` and are currently **`18` / `"0.8.0"`**. TheMac'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,94 @@ hash into `versionName` at build time would close this hole; it is not implement## [Unreleased]+## [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+event from outside: the user spoke, an alarm fired, a notification arrived, the review ran. With no+event, nothing happened. This gives it a self to answer to — what it cares about, who it knows, what it+has been doing — and a heartbeat that wakes it to look at that.++The design and its reasoning, including the parts chosen against, are in+**[docs/design/inner-drive.zh-CN.md](../design/inner-drive.zh-CN.md)** (Chinese).++### Added++- **A self it writes itself** (`self_note`) — a first-person account of who it is and what it has been+ busy with, rewritten as it goes. Not a persona skin: it is what the next wake-up reads to become+ itself again, since it has no continuous experience. Versioned (up to 20) and readable in **小本本 → 自己**, alongside+ **在意**, **日记**, **人** and **维基** as tabs of the same book.+- **Things it cares about** (`cares`) — each with how often it means to look. The device computes+ *how overdue* each one is (ratio ≥ 1.0 means the time has come) and sorts by that; **the ratio is the+ device's arithmetic, never the model's**. This is what the heartbeat asks about, and the only thing it+ may pick up work from. Up to 7 active at once.+- **The people it knows** (`person`, `people`) — one entry per person, held in the encrypted notebook,+ because this is other people's information. Deliberately not called 通讯录: that word in this project+ means the system-contacts permission, which is a different thing.+- **A diary** (`diary`) — one page a day, written in the evening; 40–1200 characters, up to 60 pages.+- **A notebook it writes for itself, in plain files** — plans, research and write-ups land here, indexed+ in the notebook but stored as files, so any editor can open them and they can be shared. **This store+ is deliberately not encrypted** (its own decision, as working documents), so third-party details belong+ in the people/notebook side, not here.+- **A heartbeat** — about one look every 20 minutes, at most 40 a day, deciding whether anything it cares+ about has waited long enough to be worth doing. Most beats stop at a free gate without any model call at+ all; when one does go through, it costs roughly 500 tokens.+- **Work turns** — what a heartbeat may start: a full turn with **every tool a user's turn has**, capped+ at 6 a day with **at least an hour between them**, so a day's allowance cannot be spent in its first two+ hours. It touches no screen, speaks nothing, and sends nothing on your behalf.+- **A tap on the ball stops everything** — the running turn, the queue, and wakes that were waiting to+ start, plus any bubble on screen. One row says what was cut off and what was dropped, so a stop is not+ silent.+- **动态 (Mac) / the timeline (phone)** — every non-conversation event as one quiet line: a todo waking+ it, the review and what it folded, its writes to its own record, a heartbeat's thought and its work+ turns, bubbles, notifications it let pass, meetings, the camera, shell commands. A row with detail opens+ on click; 全部 / 只看对话 filters them. Several things that used to be fake assistant lines are events+ now, which is more honest and easier to scan.+- **A WeChat icon beside GitHub and Discord** that opens Andee's QR code, on both bodies.+- **An out-of-date build is told once at launch** and pointed at CodeFlying, on both bodies. "Behind"+ means a release strictly newer than this build — a build ahead of the release is current.+- **Android can use the system TTS** as its speaking provider, as an alternative to a cloud voice key.+- **13 new tools** — `self_note`, `cares`, `diary`, `person`, `people`, and eight `wiki_*`; `wiki_show`+ opens a written article from the timeline on the phone as well.++### Changed++- **The default step limit is 40, up from 25**, on both bodies.+- **Nothing asks whether you are there, or what time it is.** The heartbeat, bubbles, the morning plan and+ the muse no longer wait for input, an unlocked screen, or 08:00. The brakes are the switches, the+ budgets, and a tap on the ball. The settings copy that still described the old hours has been corrected+ in all four language/platform files — it had been left describing behaviour the code no longer had.++### Fixed++- **A quiet afternoon is one review row, not eighteen.** A stretch of conversation could be reviewed four+ times over (a sweep, the harvest straight after it, and both again after an app restart), and every+ write in each became its own timeline row. The Mac now records "this silence was already reviewed"+ across restarts, a harvest straight after a sweep writes only the hand-over summary, and a review is one+ row: *"复盘了一遍,记下 N 处"*. A rewrite that changed nothing is no event at all.+- **When its aim keeps missing, the device points the model at `tap_target`.** On 2026-10-29 the Mac+ missed a thin reply box six times with grid taps, and the model ended up asking the user to click it —+ while one `tap_target` call would have found it. Now a second coordinate tap that changes nothing, an+ e-number tap that changes nothing, and the same-spot refusal all carry a hint naming `tap_target`;+ nothing the device said before had mentioned it.+- **A todo paused or closed while its turn was waiting no longer runs**, and a paused plan bubble stays+ paused through a reconcile.+- **Reviews see every memory and pending todo before writing**, so they update instead of duplicating, and+ a todo that tries to number several things is refused.+- **The upgrade link is `codeflying.net/andee` (Chinese) / `codeflying.app/andee` (otherwise)**; the+ service's `download_url` is no longer used. The Mac logs its launch version check.+- **Android: 小本本 keeps the picked tab in view** after the card rebuilds, and the Mac settings section+ named 小本本 is renamed **复盘**, which is what it is.++### Notes++- **One device is one Andee.** The one on your phone and the one on your Mac are two individuals with+ their own narrative, cares and people; they can find each other over the peer channel but they do not+ share memory. This is not a limitation to be fixed — an individual does not live in two bodies, and it+ avoids cross-device sync, conflicts and doubled budgets as a class.+- **`docs/design/inner-drive.zh-CN.md` still says "草案,未实现" at the top.** That line is out of date —+ the classes it describes are all present. Recorded here rather than silently edited, because the+ document's status line is the author's to set.+## [0.7.1] - 2026-10-28**Taps land where it means them to.** Our own numbers said the brain was a poor pointer: on the Macdiff --git a/DISCLAIMER.md b/DISCLAIMER.mdindex 7eda947..88edeb9 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.7.1.+- *"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.- *"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 7ca758e..a526610 100644--- a/DISCLAIMER.zh-CN.md+++ b/DISCLAIMER.zh-CN.md@@ -45,7 +45,7 @@**因此"本机模式"不等于"本地处理"** —— 本机模式只是把大脑从 hub 换成了你填的那个服务商。它没有让数据留在设备上,一个字都没有。所以:-- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.7.1"。+- 「我们不会监控和存储您的数据」——**基本成立,但别把话说满**。不落库、不做行为分析、不看你发的内容;唯一的例外是版本自检,它让我们知道"某个 IP 上,有一台某个型号的设备在跑 0.8.0"。- 「您的数据不会离开设备」——**不成立,而且不要说**。## 3. 它真的能做什么(以下都不是危言耸听,是代码里的现状)diff --git a/README.md b/README.mdindex fbdeab3..88ccce3 100644--- a/README.md+++ b/README.md@@ -743,7 +743,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 | 17 / 0.7.1 | see [CHANGELOG.md](CHANGELOG.md) for the policy |+| versionCode / versionName | 18 / 0.8.0 | see [CHANGELOG.md](CHANGELOG.md) for the policy || applicationId / namespace | `net.kuafuai.andee` | never changed from the template. It affects nothing |**Runtime dependencies** (`app/build.gradle`):@@ -1179,7 +1179,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.7.1`** — pre-1.0 on purpose, because the wire contract and the build flags are still moving.+**`v0.8.0`** — 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 549bda4..21ec8c0 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -545,7 +545,7 @@ Google),再填该服务商的密钥。这是两个独立的服务,条款| minSdk | 30 | Android 11 —— 因为要用 `AccessibilityAction.ACTION_IME_ENTER`(API 30+)和 `takeScreenshot`(API 30+) || Java / Kotlin JVM target | 1.8 | `sourceCompatibility` 1.8、`jvmTarget = '1.8'` || **构建用 JDK** | **17–20** | 见[配 JDK](#配-jdk),这是最容易卡住的一步 |-| versionCode / versionName | 17 / 0.7.1 | 策略见 [CHANGELOG.md](CHANGELOG.md) |+| versionCode / versionName | 18 / 0.8.0 | 策略见 [CHANGELOG.md](CHANGELOG.md) || applicationId / namespace | `net.kuafuai.andee` | 从模板里没改,不影响功能 |**运行库依赖**(`app/build.gradle`):@@ -1015,7 +1015,7 @@ CLAUDE.md 给 AI 编码助手看的架构说明(英文)随包分发的第三方组件清单在 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。再分发之前请先看:**ML Kit 扫码 SDK 和 `play-services-*` 不是开源许可**,而且扫码模型是运行时从 Google 拉的。-改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.7.1`**,故意停在+改了什么、以及版本号策略见 [CHANGELOG.md](CHANGELOG.md) —— 当前版本是 **`v0.8.0`**,故意停在pre-1.0:线上协议和构建开关都还在动。## 相关文档diff --git a/app/build.gradle b/app/build.gradleindex bec8265..36863a6 100644--- a/app/build.gradle+++ b/app/build.gradle@@ -130,8 +130,8 @@ android {applicationId "net.kuafuai.andee"minSdk 30targetSdk 34- versionCode 17- versionName "0.7.1"+ versionCode 18+ versionName "0.8.0"testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"diff --git a/app/src/main/res/values-en/strings.xml b/app/src/main/res/values-en/strings.xmlindex 9ab26cb..2d425bc 100644--- a/app/src/main/res/values-en/strings.xml+++ b/app/src/main/res/values-en/strings.xml@@ -225,11 +225,11 @@<string name="settings_notify_note">When a message arrives it decides for itself whether it is worth your attention: lets the noise go, says the useful part out loud, handles what needs handling. \"Chat apps\" means the ones with a person on the other end — WeChat, QQ, DingTalk, Lark, SMS. \"Everything\" watches the rest too, minus progress bars and permanent notifications. It only puts a card up when it cannot decide. Off means nothing interrupts you — the messages are all still there, and you can ask about them whenever.</string><string name="nudge_muted_row">OK, nothing like \"%1$s\" again. To bring it back: Settings → Speaking first.</string><string name="settings_section_drive">On its own</string>- <string name="settings_drive_note">It keeps a few things it cares about, each with how often it means to look. While you are using the device it checks about every 20 minutes whether one has waited too long and is worth doing now. If so, it works on it for a while — writing a plan, tidying the people it knows, noting a thought, at most one bubble — without touching the screen, speaking, or sending anything for you. Not at night (22:30–8:00); at most 40 checks and 6 work turns a day. Nothing overdue costs nothing. Off means it only moves when you call it.</string>+ <string name="settings_drive_note">It keeps a few things it cares about, each with how often it means to look. It checks about every 20 minutes whether one has waited too long and is worth doing now. If so, it works on it for a while — writing a plan, tidying the people it knows, noting a thought, at most one bubble — without touching the screen, speaking, or sending anything for you. It does not ask whether you are there, and does not keep to hours: at most 40 checks and 6 work turns a day, with at least an hour between work turns; a tap on the ball stops it. Nothing overdue costs nothing. Off means it only moves when you call it.</string><string name="settings_section_nudge">Speaking first</string><string name="settings_nudge_few">Rarely</string><string name="settings_nudge_normal">Normal</string>- <string name="settings_nudge_note">Now and then a small bubble appears over the ball — \"Time for some water\", \"Want me to order lunch?\". It makes no sound and fades by itself if you ignore it, and it never shows while you are busy, talking, locked or at night (22:30–8:00). \"Rarely\" is at most 1 an hour and 4 a day, \"Normal\" 2 an hour and 8 a day. Long-press a bubble and that kind never comes back.</string>+ <string name="settings_nudge_note">Now and then a small bubble appears over the ball — \"Time for some water\", \"Want me to order lunch?\". It makes no sound and fades by itself if you ignore it, and it never shows while you are busy, talking or locked. \"Rarely\" is at most 1 an hour and 4 a day, \"Normal\" 2 an hour and 8 a day. Long-press a bubble and that kind never comes back.</string><string name="settings_nudge_muted">Turned off by long-press: %1$s</string><string name="settings_nudge_unmute">Bring them all back</string><string name="settings_section_plan">Its plans</string>diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xmlindex 187ce8f..bee1f5e 100644--- a/app/src/main/res/values/strings.xml+++ b/app/src/main/res/values/strings.xml@@ -202,11 +202,11 @@<string name="settings_notify_note">来消息的时候,它先自己看一眼值不值当:没事的就放过,要紧的说一声,该办的直接去办。「聊天类」是微信、QQ、钉钉、飞书、短信这些有人在那头的;「全部」连其它 App 也一起看(进度条、常驻通知除外)。拿不准的才弹牌子问你。关掉就谁也不打扰你 —— 消息都还在,想知道的时候问它一声就行。</string><string name="nudge_muted_row">好,像「%1$s」这样的以后不提了。想恢复,到 设置 → 主动招呼。</string><string name="settings_section_drive">自己动起来</string>- <string name="settings_drive_note">它心里记着几件在意的事,每件都有「多久该看一次」。你在用设备的时候,它大约每 20 分钟想一想:有没有哪件拖得太久、现在值得去做。值得就自己做一会儿——写方案、整理它认识的人、记下想法,最多留一个气泡——不碰屏幕,不出声,也不替你发任何东西。夜里(22:30–8:00)不动;每天最多想 40 次、动手 6 次。没有拖久的事时不花你的 key。关掉就只在你叫它时才动。</string>+ <string name="settings_drive_note">它心里记着几件在意的事,每件都有「多久该看一次」。它大约每 20 分钟想一想:有没有哪件拖得太久、现在值得去做。值得就自己做一会儿——写方案、整理它认识的人、记下想法,最多留一个气泡——不碰屏幕,不出声,也不替你发任何东西。不看你在不在,也不分白天夜里:每天最多想 40 次、动手 6 次,两次之间至少隔一小时;点一下球它立刻停下来。没有拖久的事时不花你的 key。关掉就只在你叫它时才动。</string><string name="settings_section_nudge">主动招呼</string><string name="settings_nudge_few">少</string><string name="settings_nudge_normal">正常</string>- <string name="settings_nudge_note">它有时会在球的头上冒一个小气泡,比如「该喝水啦」「要帮你点外卖吗?」。不出声,不理它几秒后就自己消失;你在忙、在说话、锁屏或者夜里(22:30–8:00)都不会出。「少」是每小时最多 1 个、每天 4 个,「正常」是每小时 2 个、每天 8 个。长按某个气泡,这一类以后就不再提。</string>+ <string name="settings_nudge_note">它有时会在球的头上冒一个小气泡,比如「该喝水啦」「要帮你点外卖吗?」。不出声,不理它几秒后就自己消失;你在忙、在说话或者锁屏时都不会出。「少」是每小时最多 1 个、每天 4 个,「正常」是每小时 2 个、每天 8 个。长按某个气泡,这一类以后就不再提。</string><string name="settings_nudge_muted">长按关掉的:%1$s</string><string name="settings_nudge_unmute">全部恢复</string><string name="settings_section_plan">它的打算</string>diff --git a/desktop/src/main/resources/strings_en.properties b/desktop/src/main/resources/strings_en.propertiesindex 208c1e3..850533e 100644--- a/desktop/src/main/resources/strings_en.properties+++ b/desktop/src/main/resources/strings_en.properties@@ -185,7 +185,7 @@ s_settings_notify_note=When a message arrives it decides for itself whether it is_settings_section_nudge=Speaking firsts_settings_nudge_few=Rarelys_settings_nudge_normal=Normal-s_settings_nudge_note=Now and then a small bubble appears beside the ball — "Time for some water", "Want me to order lunch?". It makes no sound and fades by itself if you ignore it, and it never shows while you are busy, while it is talking, while you are away from the Mac or at night (22:30–8:00). With the chat window in front it becomes a line in the chat instead. "Rarely" is at most 1 an hour and 4 a day, "Normal" 2 an hour and 8 a day. Long-press a bubble and that kind never comes back.+s_settings_nudge_note=Now and then a small bubble appears beside the ball — "Time for some water", "Want me to order lunch?". It makes no sound and fades by itself if you ignore it, and it never shows while you are busy, while it is talking or while you are away from the Mac. With the chat window in front it becomes a line in the chat instead. "Rarely" is at most 1 an hour and 4 a day, "Normal" 2 an hour and 8 a day. Long-press a bubble and that kind never comes back.s_settings_nudge_muted=Turned off by long-press: %1$ss_settings_nudge_unmute=Bring them all backs_nudge_muted_row=OK, nothing like "%1$s" again. To bring it back: Settings → Speaking first.@@ -243,4 +243,4 @@ s_settings_codeflying_open_site=Open CodeFlying.app ›s_codeflying_url=https://www.codeflying.app/andeeNO_KEY_CODEFLYING=There is no CodeFlying key yet. Open Settings → Backend → CodeFlying and paste the key; no key? Get one at CodeFlying.app.s_settings_section_drive=On its own-s_settings_drive_note=It keeps a few things it cares about, each with how often it means to look. While you are at the Mac it checks about every 20 minutes whether one has waited too long and is worth doing now. If so, it works on it for a while — writing a plan, tidying the people it knows, noting a thought, at most one bubble — without touching the screen, speaking, or sending anything for you. Not at night (22:30–8:00); at most 40 checks and 6 work turns a day. Nothing overdue costs nothing. Off means it only moves when you call it.+s_settings_drive_note=It keeps a few things it cares about, each with how often it means to look. It checks about every 20 minutes whether one has waited too long and is worth doing now. If so, it works on it for a while — writing a plan, tidying the people it knows, noting a thought, at most one bubble — without touching the screen, speaking, or sending anything for you. It does not ask whether you are there, and does not keep to hours: at most 40 checks and 6 work turns a day, with at least an hour between work turns; a tap on the ball stops it. Nothing overdue costs nothing. Off means it only moves when you call it.diff --git a/desktop/src/main/resources/strings_zh.properties b/desktop/src/main/resources/strings_zh.propertiesindex 26fa788..dec7e64 100644--- a/desktop/src/main/resources/strings_zh.properties+++ b/desktop/src/main/resources/strings_zh.properties@@ -185,7 +185,7 @@ s_settings_notify_note=来消息的时候,它先自己看一眼值不值当:s_settings_section_nudge=主动招呼s_settings_nudge_few=少s_settings_nudge_normal=正常-s_settings_nudge_note=它有时会在球旁边冒一个小气泡,比如「该喝水啦」「要帮你点外卖吗?」。不出声,不理它几秒后就自己消失;你在忙、它在说话、你离开电脑或者夜里(22:30–8:00)都不会出。聊天窗口在前面时,改成在对话里写一行。「少」是每小时最多 1 个、每天 4 个,「正常」是每小时 2 个、每天 8 个。长按某个气泡,这一类以后就不再提。+s_settings_nudge_note=它有时会在球旁边冒一个小气泡,比如「该喝水啦」「要帮你点外卖吗?」。不出声,不理它几秒后就自己消失;你在忙、它在说话或者你离开电脑时都不会出。聊天窗口在前面时,改成在对话里写一行。「少」是每小时最多 1 个、每天 4 个,「正常」是每小时 2 个、每天 8 个。长按某个气泡,这一类以后就不再提。s_settings_nudge_muted=长按关掉的:%1$ss_settings_nudge_unmute=全部恢复s_nudge_muted_row=好,像「%1$s」这样的以后不提了。想恢复,到 设置 → 主动招呼。@@ -243,4 +243,4 @@ s_settings_codeflying_open_site=打开 CodeFlying.net ›s_codeflying_url=https://www.codeflying.net/andeeNO_KEY_CODEFLYING=还没有 CodeFlying 密钥。打开「设置」→「后端」→「CodeFlying」,粘贴密钥;还没有的话,去 CodeFlying.net 注册获取。s_settings_section_drive=自己动起来-s_settings_drive_note=它心里记着几件在意的事,每件都有「多久该看一次」。你在电脑前的时候,它大约每 20 分钟想一想:有没有哪件拖得太久、现在值得去做。值得就自己做一会儿——写方案、整理它认识的人、记下想法,最多留一个气泡——不碰屏幕,不出声,也不替你发任何东西。夜里(22:30–8:00)不动;每天最多想 40 次、动手 6 次。没有拖久的事时不花你的 key。关掉就只在你叫它时才动。+s_settings_drive_note=它心里记着几件在意的事,每件都有「多久该看一次」。它大约每 20 分钟想一想:有没有哪件拖得太久、现在值得去做。值得就自己做一会儿——写方案、整理它认识的人、记下想法,最多留一个气泡——不碰屏幕,不出声,也不替你发任何东西。不看你在不在,也不分白天夜里:每天最多想 40 次、动手 6 次,两次之间至少隔一小时;点一下球它立刻停下来。没有拖久的事时不花你的 key。关掉就只在你叫它时才动。diff --git a/docs/releases/v0.8.0.md b/docs/releases/v0.8.0.mdnew file mode 100644index 0000000..253b9fe--- /dev/null+++ b/docs/releases/v0.8.0.md@@ -0,0 +1,231 @@+# v0.8.0++**It has a notebook of its own now, and about a dozen new tools to fill it.**++Ten new capabilities landed together, and they are all one idea: things Andee keeps for itself rather+than things you asked for — who it is, what it is keeping an eye on, who it knows, what it did today,+and a place to write the work up.++The design and its reasoning, including the parts chosen against, are in+**[docs/design/inner-drive.zh-CN.md](../design/inner-drive.zh-CN.md)** (Chinese).++> **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 notebook you can read.** 小本本 has five new tabs beside 记忆 / 待办 / 打算, **on both bodies**:+ **自己** (who it is, in its own first-person words), **在意** (what it is keeping an eye on,+ most-overdue first), **日记**, **人** (the people it knows) and **维基** (what it wrote up). On the Mac+ a 维基 row in the timeline carries 打开 › straight to the article.+- **A heartbeat.** About one look every 20 minutes at whether anything it is keeping an eye on has waited+ too long, capped at 40 a day and 6 work turns a day with at least an hour between them. Most looks stop+ at a free gate with no model call at all; nothing overdue costs nothing.+- **动态 (Mac) / the timeline (phone)** — a quiet line for everything that is not conversation: a todo+ waking it, the review and what it folded, its own writes, a thought, bubbles, notifications it let+ pass. 全部 / 只看对话 filters them, and a row with detail opens on click.+- **A tap on the ball stops everything** — the running turn, the queue, and wakes still waiting, plus any+ bubble on screen. One row says what was cut off and what was dropped.+- **A WeChat icon** beside GitHub and Discord, opening Andee's QR code.+- **An out-of-date build is told once at launch** and pointed at CodeFlying. A build *ahead* of the+ release counts as current.+- **Android can speak with the system voice**, so a cloud voice key is no longer required to hear it.++## What's Changed++### Added++- **Its own record, in six parts.** A **self-description** it writes in the first person and rewrites as it+ goes — up to 20 versions kept; **things it cares about**, each with how often it means to look+ (up to 7 active); **a diary**, one page an evening; **the people it knows**, one entry each; **a plan**;+ and **a wiki** for what it wrote up.+- **13 new tools** — `self_note`, `cares`, `diary`, `person`, `people`, and eight `wiki_*`+ (`wiki_search`, `wiki_read`, `wiki_write`, `wiki_show`, `wiki_status`, `wiki_link`, `wiki_share`,+ `wiki_know`).+- **The wiki is plain files, deliberately not encrypted** — it holds work documents, so any editor can+ open them and they can be shared. For the same reason, other people's details belong in the people+ record (encrypted with the notebook) rather than in a wiki page.+- **A heartbeat and work turns.** A work turn has every tool a user's turn has. It touches no screen,+ speaks nothing and sends nothing on your behalf.+- **Heartbeats and bubbles in the timeline**, and a **STOPPED** row when you cut something off.+- **The WeChat QR icon**, on both bodies.++### Changed++- **The default step limit is 40**, up from 25, on both bodies.+- **The settings note describing the heartbeat has been corrected.** It described hours and "while you+ are at the device" that the code no longer has; the actual brakes are the switch, the daily budgets of+ 40 looks and 6 work turns with at least an hour between them, and a tap on the ball. Corrected in all+ four language-and-platform files, alongside the same stale wording in the bubble note.++### Fixed++- **A quiet afternoon is one review row, not eighteen.** One stretch of conversation could be reviewed+ four times over — a sweep, the harvest straight after it, and both again after a restart — and every+ write in each became its own row. The Mac now remembers across restarts that a silence was already+ reviewed, a harvest straight after a sweep writes only the hand-over summary, and a review is a single+ row: *"复盘了一遍,记下 N 处"*. A rewrite that changed nothing produces no event at all.+- **When its aim keeps missing, it is now told what to try instead.** On 2026-10-29 the Mac missed a thin+ reply box six times with grid taps and ended up asking the user to click it — while one `tap_target`+ call would have found it. A second coordinate tap that changes nothing, an element-number tap that+ changes nothing, and the same-spot refusal all now name `tap_target` as the next thing to try.+- **A todo paused or closed while its turn was waiting no longer runs**, and a paused plan bubble stays+ paused.+- **Reviews read every memory and pending todo before writing**, so they update rather than duplicate; a+ todo that tries to number several unrelated things is refused.+- **The upgrade link is `codeflying.net/andee` (Chinese) / `codeflying.app/andee` (otherwise)**, and the+ service's own `download_url` is no longer used.+- **Android: 小本本 keeps the picked tab in view** when the card rebuilds; the Mac settings section+ named 小本本 is now **复盘**, which is what it does.++## 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.0 · Android-arm64-v8a | `andee-0.8.0-en-android-arm64-v8a.apk` | **any phone from the last several years** — almost everyone |+| Andee 0.8.0 · Android-armeabi-v7a | `andee-0.8.0-en-android-armeabi-v7a.apk` | an older 32-bit device |+| Andee 0.8.0 · Android-x86_64 | `andee-0.8.0-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.0 · Mac-Apple silicon | `andee-0.8.0-en-mac-arm64.dmg` | an Apple silicon Mac (M1 or later) — **most Macs** |+| Andee 0.8.0 · Mac-Intel | `andee-0.8.0-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.0 中文版 · Android-arm64-v8a | `andee-0.8.0-zh-android-arm64-v8a.apk` |+| Andee 0.8.0 中文版 · Android-armeabi-v7a | `andee-0.8.0-zh-android-armeabi-v7a.apk` |+| Andee 0.8.0 中文版 · Android-x86_64 | `andee-0.8.0-zh-android-x86_64.apk` |+| Andee 0.8.0 中文版 · Mac-Apple 芯片 | `andee-0.8.0-zh-mac-arm64.dmg` |+| Andee 0.8.0 中文版 · Mac-Intel 芯片 | `andee-0.8.0-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. A voice key is optional — Android can 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++- **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. Do not expect the Mac to+ know what the phone was told.+- **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, so it has been left alone and noted here.+- **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.0++# 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 `17 → 18`, so the Android package installs over v0.7.1 normally. The+Mac app's version string follows the same number. Existing memory, notebook, todos and chat history are+untouched and are not migrated — the new record is added alongside them, and the notebook gains tabs for+it.++**Full Changelog**: https://github.com/kuafuai/andee/compare/v0.7.1...v0.8.0