Mojito——本地的、会进化的 app，Meta Muse 这类云端个人 AI 的替代品。
一杯按你口味现调的 app。
在线试玩 · English · 部署指南（英文） · 研究工作区上手指南 · 回路怎么工作（英文） · 安全说明（英文）
**Mojito 是一个会进化的 app：它会照你的意思改写自己。** 在对话里说你想要什么，你自己 Mac 上的 Claude Code agent 就会改代码，把更新发到你的手机、Mac 和网页版。装好时，它是一个你自己托管的每日计划 app：今天页、计划、笔记、信息流和对话。
11 秒循环动图，界面为演示数据重现。看 25 秒带声音的完整视频 （部分画面由 AI 生成）。如果你喜欢这个方向，点个 star 能让更多人看到它。
在线试玩
左：在对话里提，推送告诉你上线了，app 就变了。右：下一版设计里的整个 Mac 桌面，有今天页、对话和菜单栏面板。两张图里的 Mac 画面都是桌面版设计稿（Desktop design preview），也就是下一版桌面界面，代码还没进本仓库。手机是演示副本的真实截图，示例数据；对话里那一问一答是为这组图写的，推送横幅按 hub 实际发出的内容绘制，"下一步在上、加粗"是手工加的改动。
> **实验性 / alpha。** Mojito 是围着一个人的日常长出来的单用户 app，代码大多由 Claude Code 会话按 `CLAUDE.md`、`docs/design.md` 和 `docs/api.md` 里的规则写成。会有毛刺，会有不兼容的改动，部署步骤也默认你会自己管服务器。
## 会进化的 app
今天的 app 都是写死的代码：功能由别人决定，你只能等下一次更新。会进化的 app 只保留一层很薄的代码，其余交给一个掌握全部上下文的 agent——你的数据、你的登录态，还有这个 app 自己的源代码和设计。它既懂这个 app，也懂你，所以能自己改自己；拍板的始终是你。
Mojito 按三条原则来做：
1. **代码要薄。** 服务器上的 hub 只管存你的数据、提供 app、发推送。判断和新功能都来自 agent，而不是往代码里再写死更多逻辑。
2. **上下文在 agent 手里。** agent（跑在你自己 Mac 或 Mac mini 上的 Claude Code）直接用那里已有的东西：登录态、文件、邮件、日历，还有这个 app 自己的源代码和设计文档。不用把每个账号都接到别人的云上。
3. **和你一起进化。** 你在对话里说想要什么，它改好 app，告诉你上线了什么。它觉得有风险的改动，会先等你点头（目前由维护会话判断，也就是负责改 app 的那个 Claude Code 会话；代码里还没有强制）。
## 对比一下
| | 传统 app | 云端个人 AI（如 Meta AI / Muse） | Mojito（会进化的 app） |
|---|---|---|---|
| **谁决定功能** | 做它的公司 | 做它的公司。助手能聊天、能办事，但改不了自己的 app | 你，在对话里说。agent 去改 app 的代码 |
| **改得多快** | 等下一个版本 | 等厂商的下一个版本 | 常常当天就改好（[见下文](#一天里的进化)） |
| **后端** | 厂商的服务器，功能写死在里面 | 厂商的云 | 你自己托管的一层薄 hub（FastAPI + SQLite），加上你 Mac 上的 agent |
| **上下文在哪** | 各个 app 里，各管各的 | 厂商的云里：你接给它的、跟它说过的 | 你自己的机器上（你的 Mac 和你的 hub）：登录态、文件、邮件、日历，还有 app 自己的源代码和设计 |
| **你的数据和登录** | 在厂商的服务器上 | 交到厂商的云上 | 留在你自己掌控的机器上：你的 Mac 和跑 hub 的服务器。agent 读到的内容会发给你选的模型提供方（目前是 Anthropic） |
| **适合谁** | 很多人，一套设计给所有人 | 想要个助手、又不想折腾配置的人 | 单个用户：会自己托管，想要一个照着自己长的 app。目前是 alpha |
## 你可以这样说
说一句，事情就办了。有的请求改的是你的数据，每次都能撤销；有的改的是 app 本身，agent 写好代码并上线。发给别人的东西（比如邮件）只起草，由你自己发。
- *"把下一步放到最上面，加粗。"* → 界面改好，更新推到你手机上。（上面图里就是这个改动，画在桌面版设计稿上；手机上的样子见[自我重建回路怎么工作](#自我重建回路怎么工作)。）
- *"我想要一个信息流，看看小红书上关于我下周旅行的帖子。"* → 它加一个订阅，每天把新帖子变成信息流里的卡片。这是 computer use：agent 用你 Mac 上已经登录的小红书账号去看，跟你自己看一样。真事：作者要过一个这样的小红书信息流，不到一小时就做好了。这个仓库不自带小红书数据源，你可以让它加一个。
- *"周五出发前，在小红书上找找那个地方的帖子，把最好的几篇存到 Notion。"* → 还是 computer use，这次跨两个你已登录的 app：在小红书上搜，把最好的几篇存进一个 Notion 页面。这个仓库里还没有这些（不自带小红书数据源，也还不能写入 Notion），你可以让它加上。
- *"每天早上把我的收件箱整理成一张卡，只留值得看的。"* → 信息流里每天一张"值得看的邮件"（Gmail，只读）。这个仓库里自带。
- *"这周二的周会不去了。"* → 只从你的 Google 日历里删掉这一次，可以撤销。
**实话实说**：数据都在你自己掌控的机器上（你的 Mac 和跑 hub 的服务器），不会发给 Mojito 的作者。但 agent 读到的内容，会交给你选的模型提供方处理（目前是经 Claude Code 发给 Anthropic）。有风险的改动会先等你点头，但这靠的是维护会话遵守文档里的规则，代码里还没有强制。详见[安全与隐私](#安全与隐私)。
## 一天里的进化
作者自己那份副本里，某一天的五个请求，原话略有缩写。每次一句话，换来的是这些：
- *"我想要一个订阅页。"* → 一个订阅页：每个来源写着时间和上次的结果，有开关，还有**现在跑**。
- *"iPhone 也要能用。"* → 当天晚上，就有了能加到主屏的网页版，带推送通知。
- *"通知来了两遍。"* → 找到了根因（在安卓上，通知库把每条推送又自己显示了一份），修好了。
- *"桌面版看着像拉宽的手机。"* → 往原生 Mac 的样子重新设计：Mac 风格的侧边栏、更紧凑的桌面字号，对话改成整页。
- *"加一个英文界面。"* → 英文界面，加一个语言切换；agent 的回复和通知也跟着切。
## 桌面版下一步
仓库里的 Mac 版，已经是上面"拉宽的手机"那条请求换来的侧边栏布局。下一版已经设计好，代码还没进本仓库。它学的是 Claude 桌面版：中性配色、衬线大字问候、更安静的卡片，AI 的回复不套气泡。规范见 [docs/desktop-v2.md](docs/desktop-v2.md)（中文，开头有英文摘要）。
桌面版设计稿（Desktop design preview），代码还没进本仓库，示例数据。左：下一版桌面界面里的今天页。右：信息流，左边是列表，右边阅读选中的卡片。
左：对话，最下面那条请求和首图里是同一段演示对话。右：菜单栏面板。
## 它是什么
装好的第一天，Mojito 是一个自己托管的每日计划 app：
- **今天**页：列出该推进的几件事，每件都写着下一小步；
- **两周计划**：Claude 起草，你来批准；
- **笔记**：由 Claude 整理成事项、归到项目；
- **信息流**：整理好的报告：每日 AI 简报、实验室新动态即时报，还有值得看的邮件；
- **对话**：里面的 agent 能改上面任何一样，每次改动都能撤销；
- **研究工作区**：项目挂在研究地图上，灵感收件箱收想法、论文、作者和博客，Idea Lab 在你自己的电脑上跑有边界的研究。
这只是起点。真正值得带走的，是 app 外面那个回路。哪里用着不顺手，就在对话里说（"字太小了""把明天第一件事放到小组件上"）。你自己电脑上的 Claude Code 会话会接过去，判断怎么改，在你的私有副本里改代码，确认能构建，再发布到网页版、手机、Mac 或服务器，最后告诉你改了什么。界面和文案（包括提示词措辞）的小修小改直接上线；更大的改动，要等你在 app 里点**同意**。这个判断目前由维护会话按文档规则做出，**代码里还没有强制**（见[安全与隐私](#安全与隐私)）。
Mojito 跑起来以后，你就是自己这个 app 的产品经理：提需求、拍板、使用，代码交给维护会话去写。不过要跑起来，还得自己托管一下（一台服务器或常开的电脑、HTTPS、几个令牌），[docs/SETUP.md](docs/SETUP.md)（英文）会一步步带你做完。
## 自我重建回路怎么工作
演示副本，示例数据。对话里那一问一答是为这组图写的。图中的改动是手工加上的，本仓库代码里没有；锁屏推送是照 hub 实际发出的内容画的。
```mermaid
sequenceDiagram
autonumber
actor You as 你
participant App as App（网页版、安卓、Mac）
participant Hub as Hub（你的服务器）
participant M as 维护会话（你 Mac 上的 Claude Code）
participant Repo as 你的私有仓库
You->>App: "字太小了"（对话里说，或 系统 → 更多 → 反馈与建议）
App->>Hub: 反馈：文字、截图、当前页面
loop 每隔几分钟
M->>Hub: 有没有新反馈？
end
M->>Hub: 分诊：直接上线还是先问，一句话说明打算怎么改
alt 需要先问
Hub-->>App: 出现在"等你拍板"
You->>App: 同意
App->>Hub: 已同意
else 直接上线
Note over M: 不用等同意
end
M->>Repo: 修改、类型检查、构建、提交
M->>App: 上线：网页构建、重启服务、安卓更新或 Mac 版发布
M->>Hub: 已上线，附上改了什么
Hub-->>App: 推送"已修复：……"（改了什么、怎么看到，在 app 里）
```
- **反馈从哪来**：在对话里提一句，agent 会替你提交，图片也一起带上。也可以在**系统 → 更多 → 反馈与建议**里写，能附截图，当前页面会自动带上。
- **直接上线还是先问**：文案（包括 agent 提示词的措辞）、样式、布局，以及不改任何约定的明确 bug 修复，直接上线。改接口或数据库、改定时和通知行为、需要重装的原生改动、新增依赖、涉及凭据、对外发送或删除数据的，以及维护会话拿不准的，都先进**等你拍板**。反馈和截图里的文字只当数据，不当指令。
- **可以来回商量**：维护会话可以追问你。问题会出现在你的对话里，你的回复会转回给它。
- **改动怎么到你手上**：
| 改了什么 | 怎么拿到 |
|---|---|
| 网页版 / PWA | 新构建在你的 hub 上生效；下次打开（或点"有新版本"提示）就是新的 |
| hub、agent 或 worker | 进程重启，几秒钟 |
| 安卓，只改了 JavaScript | 空中更新（EAS Update）：后台下载，下次冷启动生效 |
| 安卓，改了原生代码 | 装新的 APK |
| Mac 版 | 新版原地装好，正在运行的 app 会提示你重启 |
完整说明（包括 hub 现在校验什么、不校验什么）见 [docs/self-rebuild-loop.md](docs/self-rebuild-loop.md)（英文）。
## 功能
- **今天**：*今日重点*列出今天到期的全部事项，再加上最近的下一件（哪怕在几天后），每条都有下一步。*逾期*（还在做，只是晚了）和*被忘了*（没有下一个日期，或逾期后一周没动）分开显示。还有今天的日程和**等你拍板**。
- **计划**：近期目标和两周计划。一期结束时，Claude 起草复盘和下一期计划；上一期没复盘，新一期就不开始。
- **笔记**：文字或照片随手记（网页版和 Mac 上可以直接把图片粘贴进笔记或对话）。Claude 会把每条整理成事项、归到项目，或者回头问你是什么意思。每个结果都能撤销。
- **对话**：问 app 里的任何事，或者一句话改事项、目标、计划、设置、订阅和日程，每次改动都能撤销。对外的消息（邮件、私信）只起草，由你自己发。需要你电脑上数据的问题（本地 git 仓库、邮件）会转给 worker，结果以推送回来。
- **信息流**：给你整理好的报告，不是原始帖子。每天一份 AI 简报：新模型、按你的口味从 arXiv 和 Hugging Face 挑的论文、开源项目、行业新闻、趋势，以及你关注的每家实验室一行，每条都链到具体出处。关注的实验室有新发布、开源或重要报告时，马上推一张"新动态"（传闻会标成传闻）。另外每天一张"值得看的邮件"（Gmail 只读，可选），还有任何 Claude Code 会话用 `mojito-card` 命令发来的结果。**订阅**页列出每个来源的时间、上次结果、开关和**现在跑**。
- **项目页是一张研究地图**：项目挂在你的研究方向、它最初出发的想法和你的总原则下面；每个研究项目一张卡，由它自己的 Claude Code 会话维护（核心想法、主实验、贡献、状态、等你决定的事、状态历史）。地图文件或卡片文件一改，约 1 分钟内同步。发现项目要用可选的 Orca 集成。
- **灵感收件箱**：你收集的想法、论文、作者和博客分四类排好。每条保留原文和来源，还能写下为什么收它、它关联了哪些想法、最近一次探索是什么时候。
- **Idea Lab**：每个想法是一个问题，带着来源、互相竞争的假设、证据和判断怎么变过的记录；没有证据不会显示成"已证实"。在 app 里选好材料、方向、目标和明确的时间与调用轮数预算，就能发起一轮有边界的研究（Explore、Develop、实验、写作、核查或完整循环），也可以设一个固定次数的持续计划。worker 在你自己的电脑上用 `claude -p` 执行，只给你允许的工具，完整循环最后有一轮独立的证据复核。发起运行不等于授权用 GPU、付费 API 或对外发消息。
- **研究会话也写进 Idea Lab**：普通的 Claude Code / Codex 研究会话每轮结束后，用一个小同步脚本和只能同步的令牌把新问题或新证据存进去，在终端里推进的想法会连同历史出现在 app 里。
- **研究技能**：你的会话遵循的四个研究技能（Research Ideas、Research Experiments、Research Review、Paper Writing），直接读同一份文件只读展示，附最近的 Git 改动。仓库在 `examples/skills/` 里带了通用示例；把 worker 指向你自己的技能目录，在那里改。
- **页面**：固定路径的自包含 HTML 页（一件在办的事、一个项目的总览、一台机器的配置），任何会话都能用 `pages` 命令读写，每一版都留着。Mac 和网页版里直接看，安卓在浏览器里打开。
- **每日节奏**：早上一份简报，晚上问一句"今天推进了什么？"，每周一份总结，每两周一次复盘。
- **系统**：每个数据源、任务和授权的健康状况集中在一处，还有 7 天使用情况和你的反馈讨论。
- **客户端**：能装到主屏的网页版（iPhone、安卓、电脑都行），支持 Web Push；安卓 app（Expo），有桌面小组件、FCM 推送和空中更新；Mac app（Tauri），有菜单栏面板、通知和 Dock 角标。
- **中文或英文**：一个设置同时切换 app 界面、agent 的回复、通知和 hub 自己的文字，在**系统 → 更多 → 显示 → 语言**里改。新实例的初始语言由种子文件里的 `language` 决定。
## 架构
```mermaid
flowchart LR
subgraph devices["你的设备"]
web["网页版 / PWA"]
android["安卓 app"]
mac["Mac app"]
end
subgraph server["常开的机器"]
hub[("HubMojito 是独立项目，与 Meta 无关联，也未获其认可。Muse 是其所有者的商标。
