realchendahuang/FlareMo
realchendahuang/FlareMo has 357 GitHub stars and 108 forks. GitHot measured 0 stars in 24 hours and +3 in 7 days. Last checked 2026-11-19 12:44 UTC. Last push 2026-11-11.
实测星标增长
- 24小时
- 0
- 7天
- +3
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
跑在 Cloudflare 上的 AI 原生第二大脑:零服务器、零运维,记录、任务与文章沉淀为你的知识库,也是 AI Agent 的长期记忆。 / An AI-native second brain on Cloudflare: zero servers, zero upkeep.
效率工具README.zh-CN.md
原文FlareMo 🔥
0 服务器 · 0 维护成本 · 24 小时全球边缘在线 · 数据绝对自主掌控
一个人用,是 AI 原生的第二大脑;一个团队用,是共享的知识库。
English • 简体中文 • 日本語 • Français • Español • 한국어 • Русский • العربية
| ☀️ 桌面端 · 浅色明亮 | 🌙 桌面端 · 深色沉浸 | 📱 移动端 · 极简随行 |
|---|---|---|
![]() |
![]() |
![]() |
| ✅ 待办、项目与回顾 | 📄 文章与发布 |
|---|---|
![]() |
![]() |
真实运行界面:支持深浅主题无缝切换与全功能移动端自适应。所有展示功能均已稳定接入后端,不放未实现的占位按钮。
💡 为什么选择 FlareMo
第二大脑一直是有门槛的:一台按月续费的 VPS、Docker、PostgreSQL、定时备份脚本,还有随时可能坏掉的那块硬盘。
FlareMo 想回答的是另一个问题:如果第二大脑根本不需要服务器,而且你的 AI Agent 可以直接在你的笔记上工作呢?
- AI 原生,不是事后外挂:提供笔记 MCP 端点与
flaremo-notesSkill,Claude、Cursor、Codex、ChatGPT、ZCode 可以搜索、读取和写入你自己的笔记。没有独立的 AI 记忆库,也没有第二本需要你打理的笔记本。 - 真正的 Serverless:代码与静态前端跑在离你最近的 Cloudflare Workers 边缘节点;D1 与 R2 承载记录、任务、文章与媒体,自带多地域持久化。
- 知识会生长:一条速记长成任务,任务长成文章,最后沉淀成可搜索、可关联的知识库。
- 一人安静,多人有用:默认私密;开启团队模式后多一个带角色与三级可见性的共享空间。
- 简约不简单:界面安静,每个控件都各有其位。
✨ 核心特性
1. 极速速记与沉浸式回顾
- 毫秒级捕捉:卡片式时间线,支持标签、Markdown/GFM,以及图片与音频附件预览。
- 记录与文章:输入框始终是一条快速记录(标签、最多 9 张图片、加粗、列表、待办);点「全屏书写」可以在全屏画布里继续写同一条记录。文章从「文章」页开始写。
- 笔记下的评论:类似微博,个人空间与团队空间的任意笔记都可评论。评论挂在原笔记下方,不进入时间线、搜索、统计、标签与回顾。
- 极速搜索:SQLite FTS5 全文索引,支持查询操作符(
has:attachment、is:pinned、before:YYYY-MM-DD、after:YYYY-MM-DD、in:timeline|archive|trash)。 - 语义「找一找」(向量搜索):Workers AI embedding 搭配 Vectorize 派生向量索引,按上下文语义召回;结果会对照 D1 二次校验权限,并无缝降级到 FTS5。
- 灵感激活:内置每日回顾(那年今日)、随机漫步(在标签与反向链接图中游走,附明信片式总结)和相关笔记推荐。
- 版本回溯:完整的版本差异对比,一键还原历史版本。
2. AI 读写你的笔记(MCP + Skill)
- 笔记 MCP:
/mcp提供笔记的列表、搜索、读取、创建、修改与删除,使用可撤销的memos_pat_令牌鉴权。 - 一个 Skill:
skills/flaremo-notes教会每个 Agent 先搜索再写入、保留你的原文,并返回它改动的笔记 ID。 - 没有独立记忆:Agent 按需读取你的笔记,不会在后台把内容抽取成第二个账本。
3. 待办与项目
- 给笔记排期:为笔记选定日期与项目,其中每条未勾选的待办都会成为一项任务。在笔记里或待办页勾选完成,两边双向同步。
- 一个待办页:
/projects以按天分组的列表呈现今天、未来 7 天与全部任务,你的项目则以看板呈现(跨状态列拖拽、优先级、手动排序)。每个列表都有快速添加行。 - 个人私有、可撤销删除:任务为单人私有资源;删除先进回收站,可随时还原,到期后自动清理。
4. 提醒与时间维度
- 在阅读处显示角标:已排期的笔记在卡片上显示「待办 n/m · 日期 · 项目」,每日回顾开头即列出今天的待办。
- 时间维度一目了然:explorer 首页将迷你月历与逾期/今日提醒并排呈现,到期事项不会藏在看板后面。
- 到期与逾期提醒:每日任务在站内发出「今天到期」与逾期通知,并可选开启浏览器 Web Push。排期精确到天,不提供按钟点的闹钟提醒。
5. 团队空间与三级可见性
- 分享,而非协作:团队空间是成员之间互相发布笔记并评论的地方。在团队输入框中输入
@username会自动补全并通知被提及的人;点开通知直接跳到原笔记的评论处。 - 角色治理:
owner、admin、member三种角色。管理员通过一次性激活链接邀请成员(成员自主设置密码;管理员经手不到任何明文凭据)。 - 三档可见性:
- 🔒 私密:仅作者本人可见。
- 👥 团队可见:对有效团队成员只读共享。
- 🌐 全网公开:通过限时分享链接匿名只读访问。
- 安全移除:移除成员会触发可靠的后台清理,清除其私有数据,同时保留团队与公开笔记。
- 读者席位:可发放带有效期的只读席位(客座读者、课程学员、客户交付)。席位到期自动失效(凭证解析时 fail-closed,无需定时任务);可在成员页管理,也可用个人访问令牌(PAT)调用
PUT /api/app/admin/team/reader按邮箱开通(见docs/team-mode.md)。
6. 离线优先与 PWA 体验
- 可安装 PWA:一键安装到 macOS、Windows、iOS 或 Android 主屏幕,原生 App 级体验。
- 可靠的离线同步:草稿即刻本地保存。离线提交与上传进入待同步队列,恢复网络后自动重放。
- 实时语音输入:点输入框的麦克风按钮,边说边把语音实时转成文字(ASR)写进草稿。
7. 坚固的 Better Auth 应用安全
- Better Auth 驱动:浏览器使用 HttpOnly、
SameSite=LaxCookie 会话;脚本与 MCP 使用可撤销的memos_pat_个人访问令牌。 - 严格的 Origin 防护:状态变更请求强制精确校验 Origin 白名单。Cloudflare Access 仍可作为可选的外层防线。
8. 数据永远是你的
- 一键全量导出:记录、附件、任务、项目、文章与分享关系打包成一份文件,随时离线归档。
- 导入不留半截数据:支持跳过与复制两种冲突策略;导入失败整批回滚,不会留下残缺数据集。
- 从别的工具搬过来:自带转换脚本,把旧工具的导出包转成 FlareMo 导入包,时间戳、标签、置顶与可见性保留(迁移指南)。
- 按协议开放:
/api/v1兼容层 + 可撤销 Personal Access Token,另有 MCP 端点接入 AI 工具链;具体覆盖范围以兼容矩阵为准。
9. 插件系统:卡片即插件
- 五张内置卡片:素白、日签、票根、明信片,以及自绘 canvas 的邮戳演示卡。
- 商店与管理:浏览目录、一键安装(SHA-256 校验)、启用/停用、排序、设默认、隐藏——全部在账户设置里完成。官方目录见 flaremo.app/plugins。
- 可上传:管理员可安装本地插件包——它只存在于该实例上,永不外传。
- 可创作:
pnpm plugin:new生成脚手架,pnpm plugin:check用与实例安装时完全相同的规则校验,pnpm plugins:build出包。document 卡是纯 JSON 排版,sandbox 卡写你自己的 HTML/CSS/JS。详见插件指南。 - 默认安全:卡片跑在不透明源沙箱里,无任何网络访问;社区与品牌插件包默认关闭,管理员显式启用才可用。
📊 Cloudflare 免费额度到底有多慷慨?
很多人以为「免费」等于「严重缩水」。对以文字为主的个人知识库来说,Cloudflare 的免费配额几乎取之不尽:
| 资源 | 免费配额 | 对应容量 | 实际使用寿命 |
|---|---|---|---|
| Cloudflare D1 | 5 GB 数据库 | 约 250 万条 纯文本笔记 | 每天写 100 条也要 68 年 才能写满 |
| Cloudflare R2 | 10 GB 存储 | 约 5,000–10,000 张 照片 / 80 小时 语音 | 0 出口流量费用;公开分享不会触发带宽账单 |
| Cloudflare Workers | 慷慨的免费请求额度 | 全球 300+ 边缘节点 | 全球毫秒级响应,没有冷启动 |
🥊 对比:Cloudflare 原生 vs 家用 NAS vs 传统 VPS
| 维度 | Cloudflare 原生(FlareMo) | 家用 NAS / 小主机 | 传统 VPS |
|---|---|---|---|
| 数据持久性 | 企业级多地域副本,零硬件故障风险 | 单盘损坏或断电即可导致全量数据损失 | 依赖手动快照与备份例程 |
| 维护成本 | 零:无系统补丁、无 Docker compose、无数据库维护 | 系统更新、Docker 维护、SMART 磁盘告警、路由器配置 | 内核升级、安全补丁、看门狗守护进程 |
| 访问延迟 | 全球边缘 CDN,任意位置均低于 100ms | 需自建 DDNS / frp / Tailscale 隧道,受家庭上行带宽制约 | 依赖单一云地域,跨境延迟高 |
| SSL 与域名 | 自动 HTTPS 与自定义域名绑定 | 手动签发证书、配置反向代理 | Nginx / Caddy 配置与 Let's Encrypt 续期维护 |
| 资金成本 | 免费额度内 0 元/月 | 硬件前期投入高 + 持续电费 | 持续支付按月/按年的服务器与带宽账单 |
🚀 5 分钟极速部署
方式一:一键部署到 Cloudflare
按钮流程会把仓库克隆到你的 GitHub 账号,并自动创建 D1、R2、Queues 与 Vectorize 资源。首次部署后,请按 docs/deploy.md 设置 FLAREMO_PUBLIC_URL 与密钥。若首次尝试报 "Github API Limit Exceeded",等待几分钟重试即可。
方式二:GitHub Action(自托管 fork)
先把 docs/templates/workflows/deploy-cloudflare.yml 复制到 fork 的 .github/workflows/,再到 Actions 里手动运行 Deploy to Cloudflare:创建 Cloudflare 资源、发布 Worker、同步认证密钥。push 不会自动发布。步骤见 docs/github-action-deploy.md。
方式三:让 AI Agent 替你部署(推荐)
把仓库交给一个能执行终端命令的 AI Agent(如 Claude Code、Cursor Agent、Codex),并附上 docs/agent-deploy.md:
"请按照 docs/agent-deploy.md 的指引,帮我把 FlareMo 部署到我的 Cloudflare 账号。"
方式四:手动 3 步部署
1. 创建 Cloudflare 资源
pnpm exec wrangler whoami
pnpm exec wrangler d1 create flaremo
pnpm exec wrangler r2 bucket create flaremo-attachments
也可以改用 pnpm provision:remote:自动创建缺失的 D1 / R2 / Queue / Vectorize 资源,并把 D1 的 database_id 写入 wrangler.jsonc。它是幂等的——已存在的资源会跳过。
2. 配置设置与密钥
cp wrangler.jsonc.example wrangler.jsonc
填入生成的 database_id,并将 FLAREMO_PUBLIC_URL 设置为你的生产域名。然后写入密钥:
pnpm exec wrangler secret put BETTER_AUTH_SECRET --config ./wrangler.jsonc
pnpm exec wrangler secret put FLAREMO_BOOTSTRAP_SECRET --config ./wrangler.jsonc
3. 部署
pnpm deploy:dry-run
pnpm deploy
(完整 pnpm verify 门禁只在维护者明确要求时运行。)
访问你的生产域名下的 /setup,输入 FLAREMO_BOOTSTRAP_SECRET 即可初始化 Owner 账号。
详细指南:部署指南 · GitHub Action 部署 · 更新指南。
🧱 架构与技术栈
flowchart LR
Browser["FlareMo Web UI (React 19 / PWA)"] --> Worker["Cloudflare Worker"]
Clients["Scripts / MCP"] --> Worker
Worker --> Auth["Better Auth (Session / PAT)"]
Worker --> D1["Cloudflare D1 (Notes / Relations / Settings)"]
Access["Cloudflare Access (Optional Outer Perimeter)"] -.-> Worker
Worker --> R2["Cloudflare R2 (Attachments & Exports)"]
Worker --> Assets["Workers Static Assets"]
- 运行时:Cloudflare Workers
- 前端:React 19, Vite, TanStack Router, Tailwind CSS 4, Radix UI
- 数据库:Cloudflare D1, Drizzle ORM
- 存储:Cloudflare R2
- 认证:Better Auth(HttpOnly Cookie 会话 + 可撤销
memos_pat_) - AI 与搜索:Workers AI, Vectorize, SQLite FTS5
- 插件:槽位式扩展平台(规范、指南);插件包存于 R2,沙箱卡片无网络访问
🌟 Star History
如果你觉得 FlareMo 对你有帮助,欢迎点亮右上角的 Star ⭐️,你的支持是项目持续迭代的最大动力!
📄 开源许可证
本项目基于 GNU AGPL-3.0 协议开源。允许自托管部署、修改与学习使用;若以网络服务(SaaS)形式对外提供修改版本,须按 AGPL-3.0 条款开源修改后的源代码。 Copyright (c) 2026 realchendahuang.




