🦞 龙虾集群 · 数据管理系统 v3.0
文件即状态 · 零数据库
2026-03-30
🚫
零数据库
无 DB / 无 MQ / 无 Redis
核心理念：所有集群状态 = 文件系统中的 JSON / Markdown / 目录结构
文件即状态 — 核心设计
💡 设计原则
所有状态持久化在文件系统，不依赖内存 / 数据库 / 消息队列。
进程崩溃、机器重启后，从文件读取即可恢复全部上下文。
✅ 可版本控制（Git）
每次状态变更天然形成 commit 历史，可追溯、可回滚、可审计。
✅ 可跨设备（git pull / push）
MacBook Air 和 Mac Studio 之间通过 Git 仓库同步，无需额外基础设施。
✅ 可人工检查
所有状态文件都是 JSON / Markdown，人类可直接打开阅读、修改、调试。
✅ 零运维
无需维护数据库连接、消息队列进程、缓存过期策略。文件系统是唯一依赖。
对比传统架构：无 PostgreSQL / 无 Redis / 无 RabbitMQ / 无 Docker — 只有文件
任务目录结构
tasks/
├── task-index.json
├── .template/
└── T-YYYYMMDD-NNN/
├── brief.md
├── progress.md
├── distill.md
├── supervisor-cron-id.txt
├── .alert-count
├── hong-zhong/
│ └── plan.md
├── bai-ban/
│ └── review-result.md
└── output/
task-index.json
中央注册表，记录所有任务的 ID、状态、负责 Soul、创建时间
brief.md
任务描述 + 验收标准，骰子创建任务时写入，全程不修改
progress.md
追加式日志，每个参与者向底部写入带时间戳的进展记录
消息总线（bus/inbox）
bus/inbox/
├── hong-zhong/
├── bai-ban/
└── main/
📨 消息命名格式
MSG-{task_id}-{type}.json
示例：MSG-T-20260330-001-plan-ready.json
🔑 轻量指针设计
消息只传 task_id，不传任务内容。
接收方根据 task_id 到对应任务目录自取所需文件。
📬 处理流程
Soul 启动时扫描自己的 inbox → 读取消息 → 处理 → 删除已处理消息文件
🛡️ 可靠性
消息 = 文件。未处理 = 文件存在。已处理 = 文件删除。无需 ACK 协议。
骰子派任务
→
写入 brief.md
任务目录
→
投递 MSG 到 inbox
→
红中读取 inbox
→
到任务目录取 brief
知识库结构
知识库/
├── 报告/
│ ├── 最新/
│ ├── 测试/
│ ├── 设计/
│ └── 归档/
├── 决策/
├── 文章/
└── 项目/
📊
报告/最新/
实时有效的
HTML 幻灯片报告
可外网访问
🧪
报告/测试/
功能测试报告
路由判断验证
集成测试结果
📦
报告/归档/
历史版本快照
版本演进记录
旧版报告
外网访问：
myopenclaw.pages.dev
← git push 自动触发 Cloudflare Pages 部署
跨设备同步
🔄 Git 仓库 = 状态同步通道
所有状态文件通过 Git 仓库在多台设备间同步。
无需自建同步服务、无需云数据库、无需实时通信协议。
🚀 会话启动同步
每次会话开始自动执行 git-sync.sh
流程：git pull → 执行任务 → git add → git commit → git push
⚔️ 冲突解决策略
优先保留远端（accept-theirs）
原因：远端通常是更新的状态，本地修改可从任务目录重新生成
Mac Studio
骰子1号
→
git push
→
GitHub 仓库
中央状态源
→
git pull
→
MacBook Air
骰子2号
同步内容
tasks/ 任务目录
bus/inbox/ 消息
知识库/ 报告与决策
同步频率
会话开始：git pull
任务完成：git push
定期：cron 每 30 分钟
可靠性保障
Git 天然去重
commit 历史可回溯
冲突时保留远端