Alongside · 人生管理系统

单用户、可插拔、能陪你用四年的个人系统。
内核只提供框架，能力全部由插件长出来 —— 详见 docs/adr/0002-插件协议.md。

Alongside 是一个单人自托管的个人工作台：窗口化的前端宿主 + 后端内核 + MCP 服务。
内核只管七件事——窗口 / 路由 / 鉴权 / 事件 / 数据 / 设置 / 扩展点；
日程、待办、习惯、理财、笔记、日记、健康、复盘……每一项能力都以插件形式长在内核之上。

在线 demo

想看它跑起来的样子？

演示机是常驻在跑的，但地址不公开挂 —— 需要的话，联系我获取（QQ 2868720251）。

拿到地址和口令后，你会看到一个能用的「毛坯房」：

• 点开桌面上的 「理财」 插件 —— 它内嵌着一个真实的 BeeCount 演示实例
  （独立演示账本、示范数据，不是任何人的真实账目，随便点）。
• 它是个 PWA：Chrome / Edge 打开后，地址栏会出现「安装」图标，
  点一下就能装成桌面/手机 App —— 单独窗口、断网也能开，像原生应用一样常驻。

（毛坯房、空数据，欢迎随便点。）

设计取向

• 一切皆插件：插件在 manifest.json 里声明自己的窗口、路由、权限与能力，内核机械地发现它们。
• MCP 是 AI 的正门：插件声明的能力会映射成 MCP 工具，外部 agent 可以像调用本地能力一样调用它们。
• 数据主权：所有数据在一个 data/ 目录里（SQLite + WAL），迁移 = 复制目录，备份 = 复制文件。

5 分钟上手

前置依赖

没有 make 也能用。 项目入口的真实实现是跨平台脚本 tools/task.py，
根目录 Makefile 只是它的薄壳。两条路行为完全一致：

make dev                     # 有 make 的机器
python tools/task.py dev     # 任何机器都能跑（推荐，含 Windows 无 make 的情况）

三条命令跑起来

python tools/task.py setup    # 1. 首次：建 venv + 装前后端依赖（会慢一点）
python tools/task.py dev      # 2. 同时起前端与后端
python tools/task.py verify   # 3. 交付前自检：lint + test + 构建

起来之后：

Ctrl+C 会把前后端一起停掉。

全部命令

目录结构

life/
├─ apps/web/                  # 前端宿主：只提供"窗"，不含业务
│  └─ src/kernel/             #   ★ 内核：窗口 / 坞 / 顶栏
│     ├─ plugins/             #   ★ 插件加载器
│     └─ slots/               #   ★ 扩展点定义
├─ services/api/              # 后端宿主：只提供"路由/鉴权/事件"，不含业务
│  ├─ main.py                 #   入口
│  ├─ core/                   #   配置/鉴权/日志/异常
│  ├─ db/                     #   内核级模型与迁移
│  └─ modules/<id>/           #   各插件的后端部分
├─ plugins/                   # 第三方插件投放目录
├─ services/bridge/           # 本机 Obsidian 桥
├─ contracts/                 # ★ 契约：插件 Schema / OpenAPI / 数据字典（改动需 RFC）
├─ deploy/                    # 镜像 / nginx / 证书 / 备份脚本
├─ docs/
│  ├─ adr/                    # 架构决策记录（含"被否决的方案 + 理由"）
│  ├─ issues/                 # 问题记录
│  ├─ specs/                  # 数据/接口规范
│  ├─ tutorials/              # 插件开发入门
│  └─ rfc/                    # 契约变更申请
├─ tools/task.py              # 项目唯一入口的真实实现
├─ docker-compose.yml         # 生产编排（两个服务，db 用卷不用容器）
└─ docker-compose.dev.yml     # 开发编排（可选，本机用不上）

我该先读哪份文档？

⚠️ 不要把整个仓库的文档从头读一遍。 读你需要的部分就够了 ——
长文档会让关键约束被稀释掉。

外部集成：我喜欢它，所以为它做了插件

Alongside 不重复造轮子。有些事别人已经做得很好 —— 那就为它们写一个插件，把它们接进来。

本仓库不包含以上任何项目的源码 —— 它们都是独立部署的。 由你自己安装（Docker / npm），
Alongside 只是通过公开接口接上话 —— 这既是干净的集成方式，也正是它们的许可所允许的。
版权与许可声明见 NOTICE。

这就是「一切皆插件」的样子。
我欣赏一个项目，就为它写一个插件，把它接进我自己的系统。
你也可以这么做 —— 为你喜欢的任何项目、任何 App、任何设备，搓一个属于你自己的插件。
连 AI agent 也一样：plugins/pi-agent/ 就是个例子，换一个 agent 只需换掉最下面那层桥接。
插件协议是公开的（docs/tutorials/plugin-dev-101.md），不必先问谁，也不必先得到允许。

记得给喜欢的他们点star呐~

服务器端部署：本体之外的附属服务

Alongside 本体很轻 —— 一个 FastAPI 后端 + 一个静态前端，Python + Node 就能跑起来。
但它有几个插件是接别人的：一旦你要在服务器上把「理财」「智能体」真正用起来，
就得额外跑下面这些服务。

⚠️ 本仓库不含它们的源码 —— 它们由你自己安装（它们的许可也是这么要求的）。
这就是「一切皆插件」的代价，也是它的自由：你可以只装你要用的那几个。

一项都不装，系统照样能跑。 插件可以单独启用 / 禁用 / 卸载，内核不会因为你没装 pi 就启动失败 ——
你只想用日程 / 待办 / 习惯 / 笔记，那 python tools/task.py dev 就够了。

现成的片段就在 deploy/ 下：nginx/lifos.conf（含 location /api/ 三行与 BeeCount 同源反代）、
systemd/lifeos-api.service、Dockerfile.api / Dockerfile.web；逐步说明见 deploy/README.md。

设计边界（给使用者）

Alongside 是单人、自托管的个人系统，有些事是刻意不做的：

• 不做多用户：没有注册、没有权限组、没有邀请码 ——
  这是设计选择，不是还没做完。这里只有你和你自己的数据。
• 数据主权：所有数据在一个 data/ 目录里（SQLite + WAL），
  换机器 = 复制目录，离开 = 带走文件。
• 内核里不出现业务词汇：kernel/、core/ 下不写 calendar/todo/finance ——
  这是「一切皆插件」唯一能被机器验证的判据。

协作规则

本项目的开发由人与 AI agent 共同完成。仓库里既有写给人看的文档，也有写给 AI 的规则 ——
下面分开列，不混在一起。

通用约定（人 / AI 都遵守）

• 密钥只进 .env：绝不进代码、绝不进前端、绝不进 git；.env.example 只放占位符。
• 时间统一带时区：出入参 ISO8601（2026-09-15T08:00:00+08:00），库里存 UTC。
• 颜色只走设计令牌：不写死色值，主题才能整体切换。
• 契约优先：contracts/**、manifest.json、数据字典是接口，改动走 docs/rfc/。
• 插件之间不直接 import：只走 ① 事件总线 ② 对方公开的 API ③ 扩展点 —— 插件才能各自独立启用 / 禁用 / 卸载。

给 AI 协作者的附加规则

本仓库的 AI 协作者（Claude / Cursor / 各类 agent）工作时必须遵守；
违反任何一条，工作视为未完成。

人类贡献者请读 docs/adr/0002-插件协议.md 与 contracts/README.md。

• 契约已冻结：不许自己改 contracts/**、manifest.json、数据字典 —— 要改，先走 docs/rfc/。
• 不许从零发明：项目里已有现成的骨架，照着用最省力、省时，质量也稳；当然，愿意自己弄一套更优的架构也可以，但请先把设计说清楚、跟大家对齐。
• 不许越界：不碰别人的目录与领地；需要对方改，去 docs/issues/ 写卡。
• 不许报假 done：做不完就报 partial 并说清卡在哪；拿 mock 冒充真实数据直接判不通过。

完整规则见 docs/adr/0002-插件协议.md。

数据在哪

全部在 data/ 一个目录里（SQLite + WAL）。

• 备份：sqlite3 data/lifos.db ".backup data/backups/lifos-<时间>.db"（不要直接 cp）
• 迁移：复制整个 data/ 目录即可
• data/ 已在 .gitignore 里，不会被提交

许可证

本项目采用 Apache License 2.0 许可。欢迎 fork、二次开发与商业使用，
保留版权与许可声明即可。

参与

不管你会不会写代码，都有入口。

想先了解为什么这么设计 → docs/adr/0001-技术栈选型.md
想写插件 → docs/adr/0002-插件协议.md
详细规则见 CONTRIBUTING.md。

新手可以从哪开始

• 文档里看不懂的地方 → 改了它（最好的入门任务）
• 补一个插件的示例（docs/示例/）
• 给现有插件补一条测试
• 报一个你用起来别扭的地方