架构剖析
深入 Familiars 的技术架构,逐节拆解。与「技术架构长视频」逐节对应:每节开头标注对应视频时间点(待录制)。 来源:仓库
ARCHITECTURE.md(官方架构文档),按主题切片为 10 篇方便阅读与检索。
阅读路径
| 篇 | 内容 | 来源章节 |
|---|---|---|
| 01-系统总览与前端 | 系统总览、Electron + Vue3 前端、前端↔Bridge 通信 | ARCHITECTURE §1–§2 |
| 02-Bridge 层 | FastAPI 桥、路由组织、SSE 事件泵、启动副作用顺序 | §3 |
| 03-Agent 管线 | 规划→执行→验证→合成→记忆、模型路由、工具系统架构 | §4 |
| 04-RAG 与记忆 | 对话树、记忆系统、为何不用向量数据库 | §5 |
| 05-持久化层 | SQLite 分层、文件树、迁移 | §6 |
| 06-主动决策与礼物 | Decider 本地小模型、礼物管线 | §7 |
| 07-数字人 | 多后端架构、VRAM 门控 | §8 |
| 08-安全与监控 | 安全模型、本地 Monitor、Daily Monitor、Cron/Todo/Reminder | §9–§10 |
| 09-生态(技能/Recipe/Broker/Flow) | 技能、配方、Broker/交换所、多 Agent Pipeline、流引擎 | §11 |
| 10-工程与附录 | 外部 Agent 适配、代码组织、构建运行、关键变更点 | §12–§15 |
阅读顺序建议
- 第一次读:01 → 03 → 04 → 05 → 08(先建立"前端→Agent→记忆→存储→安全"主线);
- 想深挖提前/推荐:02、06、07(Bridge / Decider / 数字人);
- 对生态开发感兴趣:09(技能/Recipe/Broker/Flow)→ 继续看 生态开发教程。
