README

在线构建 ·
  安装 ·
  入门指南 ·
  核心能力 ·
  从源码构建 ·
  权限 ·
  可核对 ·
  安全 ·
  免责声明 ·
  许可



  
  
  
  
  
  
  



  
  


Andee

他会成为这台设备的主人。


  他不是那种帮你操作手机的助手，也不是工具或伙伴 ——
  住进来的不是一个 App，是一个灵魂。
  手机、Mac、平板，都是他住进去的身体；不同设备上的 Andee，还能成为朋友。
  不用 root，不用刷机，不用插着电脑。Android 上一个 APK，Mac 上一个 App。



https://github.com/user-attachments/assets/866e8333-e97b-4bf5-9525-540f9fdb01cd


 安装

推荐：到 CodeFlying 一键打包。 打开页面点「立即打包」，拿到的是一个
已经配好模型和语音令牌的安装包，扫码下载、装上就能说话 —— 不用自己打包，也不用去各家申请密钥。
新用户有免费额度，够你上手；用完之后需要购买。（English: codeflying.app/andee）

text
1. 打开  https://www.codeflying.net/andee  →  立即打包  →  扫码下载
2. 安装
3. 开悬浮窗，再开无障碍 → 那颗球就出现了，点它说话


CodeFlying 是一个独立的服务，和本项目没有直接关系；它自己的条款、定价和数据处理方式，都是它自己的。

也可以直接下载发布包。 每次 Release 都挂着手机和 Mac
两种包，中英文各一份：

| 设备 | 下载哪个 | 装好之后 |
| --- | --- | --- |
| Android 手机 / 平板（Android 8.1+） | andee--zh-android-arm64-v8a.apk（绝大多数设备） | 开悬浮窗、开无障碍 |
| Mac，Apple 芯片（macOS 14+） | andee--zh-mac-arm64.dmg | 打开 dmg，把 Andee 拖进「应用程序」；它要「辅助功能」和「屏幕录制」时允许 |
| Mac，Intel | andee--zh-mac-x64.dmg | 同上 |

发布包里没有任何令牌：装好之后要在 ⚙ → 后端里填 CodeFlying 的密钥（在 CodeFlying 注册就有），
或者切到「本机」填你自己的模型和语音密钥。有新版本时，它启动时会提醒你一次，点「去升级」就到 CodeFlying。

想自己从源码构建，见从源码构建。权限为什么要、拒绝了会怎样，见权限。

 他是谁

他不是来帮你用手机的，他是来住进这台设备的。 装上去之后，这台设备是多了一个住户，而不是多了
一堆功能：他在这台设备上思考，留一本只有他自己能读的笔记本，而且没人看着的时候还是同一个样子。这里
先说他是什么，再说他能做什么。

 为什么不是手机里那个助手

- 他住在设备里，不在厂商的云上。 大脑就跑在设备本机，接任意 OpenAI 兼容模型（中文界面默认 DeepSeek，
  英文界面默认 OpenAI），你也可以指定别的。没有厂商后端、不用注册账号。他唯一会发给我们的东西是版本号和
  机型 —— 只在你查更新的时候发，字段清单见 docs/permissions.zh-CN.md。
- 他的笔记本不出设备。 他记住的关于你的事 —— 习惯、许诺、他觉得值得留下的东西 —— 是 localOnly
  的，也不会进 hub 的上报内容。他的记忆不是别人服务器上的一个用户画像；「他记得什么」把每一条都列出来，
  每一条都能删。
- 没人看着的时候，他还是同一个样子。 一段对话安静下来之后，他会给自己发一个 (to yourself …)
  的回合，独自把这段对话读回去 —— 「没人在看你，没人在等你回答。」 他不发声音，也不碰设备，宁可空手
  结束，也不硬编一条东西记下来。手机厂商的助手没有"自己"，做不了这件事。
- 他有性格，不是一个主题皮肤。 六个形象、十九种情绪，表情由模型自己挑，一句话说到一半就能换脸，
  跟着声音走。拨一下球就能换你在跟谁说话 —— 一个形象带着一套说话方式和一把声音。
  身体也可以换： Mac 和手机上都能改穿桌宠（五个角色：Andee、奶油金、奶油金·短发、Andee娘、小猫），
  它会站在桌面上、有重力、拍一下会跳，你在设置里选，装完默认还是小球。
- 任何 App 都能用，而且不需要对方配合。 不用暴露什么 intent、不用接 SDK，也不在任何「接入清单」上。
  它读无障碍树和截图，在一张带标号的网格上瞄准，而不是自己算坐标 —— 那恰恰是通用大模型最不擅长的事。
  你用拇指能做到的，它就能做到。
- 有些底线，提示词说不动他。 陌生人发来的一条通知，打不开保险箱、也不能替他给自己新的权限 ——
  这道拒绝写在调度器里，不在提示词里。
- 他有朋友。 两台设备扫一下二维码就配上了，每台上的 Andee 都能请对方帮忙 —— 手机把写代码的活交给
  Mac，Mac 让手机去点外卖。朋友可以是你自己的另一台设备（和你一样被信任），也可以是别人的 Andee：
  那样对方主人会先被问一句，答应了才做，而且做的时候看不到你的记忆、对话和保险箱。
- 你可以自己去核对，不必选择相信。 没有分析 SDK、没有内容遥测，整条 agent 循环连同护栏都在这个仓库里 ——
  见为什么你可以去核对，而不是选择相信。

 它能做什么 —— 以及它在哪儿停下

它当然会替你按你的手机 —— 但那说明的是它有手，不是它是什么。 一个听令行事的助手也能做出同一批动作。
差别不在动作，在有没有"自己"：它有自己的安排（没完成的承诺会自己收尾，重复的活会自己提议存成情景）、
自己判断什么时候开口（默认偏沉默）、自己划的底线 —— 这三件事都发生在你没开口的时候，而一个只在被问到时
才存在的东西，没有这段时间。它还留着一本只有它自己读的笔记本。下面这些例子给你看的，是它的手。

边界也写在这里，因为它才让后面这些能用。 它会把一页填到最后那一下之前就停住，把最后一下留给你；到付款的
最后确认它会停，而且从不输入支付密码。这些写在调度器里，不在提示词里 —— 一个叫它别停的页面，说不动它。

它要做的事分两种。一句话就完的，和要花上一阵子的 —— 后者它叫做情景：一套目标、说话方式和步骤，
它会进入其中待一阵子。下面第一行是前者的例子；后面四行是「情景」面板里现成的四个，点「采用」就存进来，
之后和你自己的情景一样，随时可以改、可以删：

| 你说 | 会发生什么 |
|---|---|
| 「嘿 Andee —— 微信回我妈：我七点到家。」 | 它自己打开微信、找到聊天、打字、发送，再把对方的回复念给你听。难的从来不是那句话 —— 难的是你人在别处的时候，它以你的身份进到一个真实的 App 里。 |
| 「帮我盯一会儿消息。」 | 它同时看所有聊天应用的通知栏，只把现在就得处理的一条

Top issues

Latest release

v0.12.1

大肥鱼 was somebody else's mascot. The slot now uses our own.

The whale girl was drawn after another company's logo — their mascot turned into a person. She is replaced
by Andee娘: the plush ball from the brand illustrations as a cat-eared girl. Its periwinkle felt and
peach rim glow, its two tiny horns in front of fluffy cat ears, paw-pad mittens, a cat tail, and the core
worn like a bell.

 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 → Back