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、支持任意模型,记忆和密码绝不离开设备。

fix(copy): stop naming menu labels and a wizard that no longer exist

booboosui7d8649d1f9db
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a44e35a..955318e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,6 +27,44 @@ Until then, identify builds by the short commit hash they were built from. (Embe
## [Unreleased]
+### Fixed
+
+- **Four strings sent the user to a menu label that no longer exists — and one to a gesture that does
+ not open settings at all.** The settings card has been reorganised twice since these sentences were
+ written, and the sentences stayed behind, which is the worst kind of copy bug: the user follows the
+ instructions, finds nothing, and concludes the app is broken rather than the text.
+
+ - `check_detail_brain_key_missing`, `check_detail_brain_hub_missing` and `brain_no_key` all said
+ **⚙ → 「大脑」 / "Brain"**. The section header is `settings_section_brain`, which reads
+ **「后端」 / "Backend"** — there is no label containing 大脑 in the settings card at all. The
+ 火山 tab names use 大脑 only in prose ("the brain lives on a hub you run yourself"), never as a
+ destination.
+ - `check_detail_voice_key_missing` said **⚙ → 「语音(火山引擎)」 / "Speech (Volcengine)"** — a
+ section that no longer exists. The Volcengine rows were moved into 后端 → 本机, and
+ `settings_section_voice` / `settings_section_voice_key` are still in both string files but
+ referenced by nothing. The path is now the same **后端 → 本机** as the two brain keys, which is
+ where the field actually is.
+ - `brain_no_key` also said **"长按小球打开设置" / "long-press the ball, open settings"**.
+ `onLongPress` does not open settings; it calls `dispatcher.expand()`, which brings the full card
+ back. Settings is the ⚙ button in that card's control bar. The sentence now names both steps,
+ because the first one is genuinely required — the control bar only exists at full size.
+ - `check_detail_brain_hub_missing` gained the missing precondition: **「云端」 is hidden unless
+ 高级 →「显示云端选项」 is on.** `showHub` gates the tab in the picker, but `brainMode` does not
+ consult it, so a device can sit in hub mode with the tab that fixes it invisible — turn the
+ toggle on, pick 云端, turn it off again, and the self-check would have pointed at nothing.
+
+ Every label these strings now name was checked against its resource value rather than transcribed
+ from the sentence being replaced — which is how the one remaining error was caught: the English
+ label is **"Show cloud option"**, singular, and the first draft of this fix wrote it plural.
+- **Both READMEs promised a first-run wizard that no longer exists.** "The first run is a stepped
+ setup that walks you through both" / 「第一次启动会有一个分步引导」 — `8dac568` deleted the wizard
+ (`ui/FirstRunUi.kt`). A missing setup guide is indistinguishable from a broken install, so this
+ read as a bug report rather than as stale prose. Both now say what the app does instead: the
+ self-check runs on every start, the card names the missing key, and its button opens settings.
+- `README.md` named the Volcengine field as **火山 API key** — the Chinese label — while the English
+ build displays **Volcengine API key** (`settings_voice_api_key`). The Chinese README already had
+ this right; only the English file was pointing at a word that never appears on an English screen.
+
## [0.1.0] - 2026-10-09
The first tagged release. Because nothing was tagged before it, this section is the whole project
diff --git a/README.md b/README.md
index 23b7eaf..ec4d242 100644
--- a/README.md
+++ b/README.md
@@ -301,8 +301,8 @@ 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 the **火山 API key** field of the same **Backend → On-device** tab. Without it ASR and
-TTS fail during the WebSocket handshake, which surfaces as a **connect timeout** — the device looks
+API key, in the **Volcengine API key** field of the same **Backend → On-device** tab. Without it
+ASR and TTS fail during the WebSocket handshake, which surfaces as a **connect timeout** — the device looks
like it has a network problem when what it has is a blank field. Everything else still works; it is
just mute and deaf.
@@ -312,9 +312,10 @@ just mute and deaf.
> stocks, …) all go through one key, wrapped and billed by CodeFlying so you don't sign up for each
> provider yourself. The two keys above only apply to the **On-device** tab you configure yourself.
-You do not have to remember this: the first run is a stepped setup that walks you through both, and
-afterwards the **✓** button in the ball's control bar opens the self-check list, which says which of
-the two is missing and offers the button that fixes it.
+You do not have to remember this. Every time the assistant comes up it checks itself, and if either
+key is missing the card it puts up names what is missing — its button opens our settings, where both
+keys live under **Backend → On-device**. The **✓** button in the ball's control bar opens that same
+list whenever you want it.
**To hand someone an APK, sign a release build — not the debug one.** The release build type is the
minified one (`minifyEnabled` + `shrinkResources`), and that is most of what makes the APK small: the
diff --git a/README.zh-CN.md b/README.zh-CN.md
index fe537df..5acbb41 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -273,8 +273,8 @@ OpenAI 兼容端点(`llm_api_key`,默认 `https://api.deepseek.com`)。**
> (AI 图片/视频/音乐生成、地理位置、天气、PDF、搜索、新闻、股票……)都走同一把 Key,由 CodeFlying
> 统一封装并计费,免去你逐一申请密钥和维护账单的麻烦。上面两把 Key 只适用于你自己配置的**本机** tab。
-这些不用记:第一次启动会有一个分步引导,带你把这两样填好;之后球的控制条上的 **✓** 会打开自检
-清单,直接告诉你缺哪一个,并给出去处理的按钮。
+这些不用记。每次助手起来都会自检一遍,两把 Key 缺哪个,弹出来的卡上就会点名说清楚,卡上的按钮
+直接打开设置,Key 填在**后端 → 本机**。球的控制条上的 **✓** 则随时可以再打开这份清单。
**要拿 APK 给别人装,签一个 release 包,别发 debug 包。** release 才是压过的那版
(`minifyEnabled` + `shrinkResources`),体积小主要就小在这里——debug 包带的是没压过的 dex。
diff --git a/app/src/main/res/values-en/strings.xml b/app/src/main/res/values-en/strings.xml
index b473d62..140151a 100644
--- a/app/src/main/res/values-en/strings.xml
+++ b/app/src/main/res/values-en/strings.xml
@@ -344,7 +344,7 @@
<string name="call_default_scene">Call</string>
<!-- LocalBrain — display half only; see the comment on the Chinese side. -->
- <string name="brain_no_key">The on-device brain has no API key yet — long-press the ball, open settings and put a DeepSeek key in the Brain section.</string>
+ <string name="brain_no_key">The on-device brain has no API key yet. Long-press the ball to bring the card back, tap ⚙ in the control bar, and put the key in Backend → On-device → “DeepSeek Key”.</string>
<string name="brain_error">Something broke on my side: %1$s</string>
<string name="brain_error_402">The backend answered 402, which most likely means the account is out of balance. Open Settings → Backend to see which provider you are using, then top up on that provider\'s website and try again.</string>
<string name="brain_error_402_codeflying">The backend answered 402, which most likely means your CodeFlying balance has run out. Open CodeFlying.app in a computer browser, sign in, top up, and try again.</string>
@@ -407,8 +407,8 @@
<string name="check_detail_network_on">Online.</string>
<string name="check_detail_network_off">Offline. Speech recognition, speech synthesis and every model call go over the network.</string>
<string name="check_detail_brain_on">Configured.</string>
- <string name="check_detail_brain_hub_missing">Not set. The brain is set to the cloud, so the address of your own hub goes in ⚙ → “Brain” → “Hub URL”. Without it there is nowhere to send what you say: no answers, and nothing on screen moves. To have this device think for itself, switch the brain to “On-device” in the same place.</string>
- <string name="check_detail_brain_key_missing">Not set. The brain is set to run on this device, so open a DeepSeek account of your own and put the key in ⚙ → “Brain” → “DeepSeek Key”. Without it, what you say arrives and nothing can be answered or acted on.</string>
+ <string name="check_detail_brain_hub_missing">Not set. The brain is set to the cloud, so the address of your own hub goes in ⚙ → Backend → Cloud → “Hub URL”. The Cloud tab is hidden by default — if you cannot see it, turn on Advanced → “Show cloud option” first. Without it there is nowhere to send what you say: no answers, and nothing on screen moves. To have this device think for itself, pick “On-device” in the same row.</string>
+ <string name="check_detail_brain_key_missing">Not set. The brain is set to run on this device, so open a DeepSeek account of your own and put the key in ⚙ → Backend → On-device → “DeepSeek Key”. Without it, what you say arrives and nothing can be answered or acted on.</string>
<string name="check_detail_model_cloud">Cloud assistant — the model is not on this device.</string>
<string name="check_detail_model_no_key">No key yet. Fill one in and this becomes testable.</string>
<string name="check_detail_checking">Checking…</string>
@@ -445,7 +445,7 @@
<string name="check_detail_mic_on">Allowed.</string>
<string name="check_detail_mic_off">Not allowed. Tapping the ball does nothing at all — the failure that least resembles a permission problem.</string>
<string name="check_detail_voice_key_ok">Set. Recognition and synthesis use it to reach Volcengine.</string>
- <string name="check_detail_voice_key_missing">Not set. The source ships without a key — open a Volcengine Speech service of your own and put the key in ⚙ → “Speech (Volcengine)” → “Volcengine API key”. Without it, hearing and speaking cannot connect, and what you get back is a connection timeout that looks like a network fault. Everything else works.</string>
+ <string name="check_detail_voice_key_missing">Not set. The source ships without a key — open a Volcengine Speech service of your own and put the key in ⚙ → Backend → On-device → “Volcengine API key”. Without it, hearing and speaking cannot connect, and what you get back is a connection timeout that looks like a network fault. Everything else works.</string>
<string name="check_detail_voice_host_ok">%1$s is reachable.</string>
<string name="check_detail_voice_host_bad">Could not reach %1$s: %2$s. Both recognition and synthesis will time out.</string>
<string name="check_detail_wake_on">Taught, and it wakes while the screen is on.</string>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index d943b11..6f8dd06 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -411,7 +411,7 @@
tool or exception name through `%1$s`; that name is an identifier and
stays as it is in both languages.
-->
- <string name="brain_no_key">本地大脑还没配 API key —— 长按小球打开设置,把 DeepSeek 的 key 填进「大脑」那一栏。</string>
+ <string name="brain_no_key">本地大脑还没配 API key。长按小球把卡片展开,点控制条上的 ⚙ 打开设置,把 Key 填进「后端」→「本机」→「DeepSeek Key」。</string>
<string name="brain_error">我这边出错了:%1$s</string>
<string name="brain_error_402">后端服务返回了 402,多半是账户余额不足了。到「设置」→「后端」看看当前用的是哪家服务商,打开它的官网充值后再试。</string>
<string name="brain_error_402_codeflying">后端服务返回了 402,多半是 CodeFlying 账户余额不足了。用电脑浏览器打开 CodeFlying.net 登录后充值,再试一次。</string>
@@ -483,8 +483,8 @@
<string name="check_detail_network_on">已联网。</string>
<string name="check_detail_network_off">没联网。语音识别、语音合成、模型调用全都走网络。</string>
<string name="check_detail_brain_on">已配置。</string>
- <string name="check_detail_brain_hub_missing">还没填。现在用的是云端大脑,得把你自己搭的 Hub 地址填进 ⚙ →「大脑」→「Hub 地址」。没有它,你说的话没地方送,问了不会有回答,屏幕也不会动。想让这台设备自己想,就在同一处把大脑切成「本机」。</string>
- <string name="check_detail_brain_key_missing">还没填。现在用的是本机大脑,得你自己去 DeepSeek 开一个,把 Key 填进 ⚙ →「大脑」→「DeepSeek Key」。没有它,你说的话我收得到,却答不出、也动不了手。</string>
+ <string name="check_detail_brain_hub_missing">还没填。现在用的是云端大脑,得把你自己搭的 Hub 地址填进 ⚙ →「后端」→「云端」→「Hub 地址」。「云端」默认藏着,看不到就先去「高级」→「显示云端选项」把它打开。没有它,你说的话没地方送,问了不会有回答,屏幕也不会动。想让这台设备自己想,就在同一排把大脑切成「本机」。</string>
+ <string name="check_detail_brain_key_missing">还没填。现在用的是本机大脑,得你自己去 DeepSeek 开一个,把 Key 填进 ⚙ →「后端」→「本机」→「DeepSeek Key」。没有它,你说的话我收得到,却答不出、也动不了手。</string>
<string name="check_detail_model_cloud">云端大脑,模型不在这台设备上。</string>
<string name="check_detail_model_no_key">还没填 Key,填了才测得了。</string>
<string name="check_detail_checking">检查中…</string>
@@ -520,7 +520,7 @@
<string name="check_detail_mic_on">已允许。</string>
<string name="check_detail_mic_off">没允许。点球不会有任何反应 —— 这是最不像权限问题的一条。</string>
<string name="check_detail_voice_key_ok">已填。识别和合成用它连火山。</string>
- <string name="check_detail_voice_key_missing">还没填。源码里不带密钥,得你自己去火山引擎开一个语音服务,把 Key 填进 ⚙ →「语音(火山引擎)」→「火山 API Key」。没有它,听和说都连不上 —— 报出来的却是连接超时,看着像网络坏了。其余功能照常。</string>
+ <string name="check_detail_voice_key_missing">还没填。源码里不带密钥,得你自己去火山引擎开一个语音服务,把 Key 填进 ⚙ →「后端」→「本机」→「火山 API Key」。没有它,听和说都连不上 —— 报出来的却是连接超时,看着像网络坏了。其余功能照常。</string>
<string name="check_detail_voice_host_ok">%1$s 可达。</string>
<string name="check_detail_voice_host_bad">连不上 %1$s:%2$s。识别和合成都会超时。</string>
<string name="check_detail_wake_on">已录入,亮屏时喊得醒。</string>