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

docs(release): v0.3.1 ships a debug APK as a stopgap

booboosui5ea63ecbd307
diff --git a/README.md b/README.md
index 1ea992a..8f7ef67 100644
--- a/README.md
+++ b/README.md
@@ -292,6 +292,13 @@ started, and once it runs out, tokens are purchased.
4. Grant Overlay, then Accessibility → the ball appears
```
+Or take the middle route — **a bare debug APK is attached to the
+[latest release](https://github.com/kuafuai/andee/releases/latest)**. That skips building it yourself,
+but **not** the token setup: no keys are configured, it comes up in English, and CodeFlying is off, so
+you put your own model and voice keys in under ⚙ → **Backend → On-device** before it can do anything.
+It is a stopgap for trying the thing rather than a distribution build; the release notes say why and
+what it costs.
+
To build it yourself instead:
> **Requirements**
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 645a17d..632afa9 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -254,6 +254,11 @@ Android。跟它要一个 Andee,它会交给你一个**已经配好令牌**的
4. 开悬浮窗,再开无障碍 → 那颗球就出现了
```
+还有中间那条路 —— **最新一次 [Release](https://github.com/kuafuai/andee/releases/latest) 上挂了一个裸的
+debug 包**。它省掉的是「自己打包」,**省不掉「配令牌」**:包里没有任何密钥、默认英文、CodeFlying 关闭,
+所以你得自己在 ⚙ → **后端 → 本机** 里填上模型和语音的密钥,它才能干活。它是**拿来试用的过渡包,不是
+分发包** —— 为什么、以及代价是什么,发版说明里写清了。
+
想自己编译的话:
> **环境要求**
diff --git a/docs/releases/v0.3.1.md b/docs/releases/v0.3.1.md
index ac53613..1d1b098 100644
--- a/docs/releases/v0.3.1.md
+++ b/docs/releases/v0.3.1.md
@@ -6,10 +6,13 @@ the policy would have made this `0.4.0`. It is recorded rather than left for som
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.
+> **This release carries an APK — the `debug` build, as a stopgap.** 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. Rather than ship nothing
+> while that decision is still open, the attached APK is the debug variant: signed with the standard
+> Android debug certificate, and it installs as-is. It is `debuggable`, it is larger than a signed
+> release build, and it is **bare** — no keys, English, CodeFlying off. See **[Download](#download)**
+> for the two keys you will have to supply yourself before it can do anything.
## Highlights
@@ -131,6 +134,58 @@ that reads as an oversight later.
`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`).
+## Download
+
+Android 11+ (`minSdk 30`). The APK is **per-ABI** (`splits` in `app/build.gradle`), so pick the file
+that matches your device:
+
+| File | Take it if |
+|---|---|
+| `andee-0.3.1-debug-arm64-v8a.apk` | anything bought in the last several years — **this is the one for almost everyone** |
+| `andee-0.3.1-debug-armeabi-v7a.apk` | an older 32-bit device |
+| `andee-0.3.1-debug-x86_64.apk` | an emulator |
+
+### This build is deliberately bare
+
+It is built from source with nothing configured — **verified against the generated `BuildConfig`, not
+assumed**:
+
+- `CODEFLYING_ENABLED` is `false`, and both `CODEFLYING_KEY` and `CODEFLYING_DOMAIN` are empty, so
+ **CodeFlying is not available in this build** and nothing is pre-wired to a hosted backend.
+- `DEFAULT_LANG` is `en`: a device that has never picked a language comes up in **English**.
+- The thinking default is off.
+
+### The two keys you have to supply yourself
+
+**The assistant cannot do anything until you give it two keys.** Open **⚙ → Backend → On-device** and
+fill in:
+
+1. **The model key (LLM)** — an OpenAI-compatible endpoint plus a model name. On an English UI these
+ default to `https://api.openai.com/v1` and `gpt-4o-mini`; a Chinese UI defaults to
+ `https://api.deepseek.com` and `deepseek-flash`.
+2. **The voice key (Volcengine)** — speech recognition and synthesis. Optional: without it the
+ assistant is silent but still works on screen.
+
+Then, in this order: grant **Overlay** → enable **Accessibility** → tap the ball. Until the keys are
+in, the card the assistant puts up will name what is missing — that is the self-check working, not a
+fault.
+
+> **Would you rather not configure keys at all?** Then this APK is the wrong door. Use the one-click
+> page instead — **[codeflying.net/andee](https://www.codeflying.net/andee)** (mainland China) or
+> **[codeflying.app/andee](https://www.codeflying.app/andee)** (everywhere else). 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.
+
+### Why a debug build, when the README says not to hand one out
+
+Because the alternative, today, is no binary at all. The README's advice still stands for anything you
+*distribute*: a debug APK is `debuggable`, and its certificate is the **shared Android debug key** —
+so it cannot install over a release-signed build, which means moving from this to a signed release
+takes an uninstall, and an uninstall takes the notebook and the vault with it. Use this to try the
+thing, not to hand it to someone who will depend on it.
+
## Before you install
Read **[DISCLAIMER.md](../../DISCLAIMER.md)** and
@@ -139,10 +194,10 @@ notification access, SMS and call log, and it can complete a payment by tapping.
that path is Android's `FLAG_SECURE`; the prompt-level checks on risky actions are instructions to the
model, not enforcement.
-## Install
+## Install from source
-Android 11+ (`minSdk 30`), arm64-v8a for anything bought in the last several years. There is no binary
-in this release; build one:
+If you would rather build it yourself — or need a *signed* release build, which is what you should
+actually distribute:
```bash
git clone https://github.com/kuafuai/andee
@@ -151,10 +206,12 @@ 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 ⚙.
+To reproduce the attached build exactly, leave `local.properties` with no `CODEFLYING_*` keys and
+`DEFAULT_LANG=en`; that is the whole configuration, and nothing is passed on the command line.
+
+`assembleRelease` needs your own keystore — the repo has none, so it produces an unsigned APK that
+will not install until you sign it. Full from-scratch setup, including the JDK traps, is in the
+README's **Provisioning** section.
**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