🦞 龙虾集群
数据管理系统报告
版本：v1.0  |  2026-03-09
数据架构 · 操作规范 · 流向设计
🏠 Echo（秘书）出品  ·  🦞 will龙虾 审阅
一、数据分层架构
1

🔴 实时状态数据（热数据）

运行时持续更新，驱动巡检和告警

tools/task-monitor.json tools/lucky-state.json tools/echo-state.json
2

🟠 知识库（kb/）— 结构化知识

分类存储：articles / decisions / reports / meetings / people / projects

kb/articles/ kb/decisions/ kb/reports/ kb/meetings/
3

🟢 记忆系统 — 长期记忆

MEMORY.md（目录索引）+ memory/YYYY-MM-DD.md（日记）+ SESSION-STATE.md（WAL锚点）

MEMORY.md memory/2026-03-09.md memory/SESSION-STATE.md
4

🔵 配置数据 — 系统配置

Cron任务、API配置，修改需走config-guard.py

config/cron-jobs.json config/openclaw.json monitor-cron-id.txt
二、报告体系
📈

evolution/

进化时间线、成长记录、里程碑报告

🏗️

workflow/

架构设计、工作流程、系统规范

🛡️

skill-audit/

Skill评估报告、流水线设计

📚

learning/

深度学习报告、文章洞察总结

🔒

security/

安全审计、漏洞报告、风险评估

📁

misc/

临时报告、实验性内容

📋
格式规范： 所有报告一律 HTML 演示版（PPT级），带版本号  |  索引入口：kb/reports/INDEX.md
三、数据操作规范

⚙️ JSON配置修改流程（config-guard.py）

📂 备份原文件
→
✏️ 写入新内容
→
✅ JSON语法验证
→
🎉 完成
python3 tools/config-guard.py backup openclaw.json
python3 tools/config-guard.py write <路径> '<JSON内容>'
python3 tools/config-guard.py restore <路径> # 出问题时恢复

⏰ Cron修改规范（openclaw cron CLI）

openclaw cron add/edit/delete
→
同步 config/cron-jobs.json
→
git commit + push

🚫 禁止事项

❌ 禁止直接用 edit 工具修改任何 JSON 配置文件
❌ 禁止直接编辑 jobs.json（Gateway运行时会用内存覆盖，手动编辑无效甚至损坏）
✅ 所有配置修改必须走 config-guard.py 流程

四、数据流向图
🔴 实时状态流
📊 task-monitor.json
⏰ 巡检 cron
每3分钟
📱 Telegram 推送
🦞 Will 知晓
🟠 知识沉淀流
📰 kb/articles/
原始文章存档
💡 洞察提炼
B类/C类
📊 kb/reports/
HTML演示版
📋 INDEX.md
自动更新
🟢 记忆蒸馏流
📝 memory/daily
每日日记
🔄 每周蒸馏
22:30 cron
🧠 MEMORY.md
长期记忆索引
⚡ 上下文注入
新会话加载
五、版本历史 & v2.0计划
版本时间变更说明
v1.0 2026-03-09 初版，建立 kb/reports 六大分类体系，确立 HTML 演示版格式规范
📅 v2.0 计划

🤖 知识库自动向量化

当 kb/ 下文件数超过 200 时，自动触发向量化索引，支持语义搜索

📁 日报自动归档

每日汇报自动归档到 kb/reports/daily/，月底自动生成月度摘要

📊
报告元信息
报告文件
DATA-MANAGEMENT-v1.0.html
版本号
v1.0
生成时间
2026-03-09
存放路径
kb/reports/workflow/
作者
🏠 Echo（秘书）
审阅
🦞 will龙虾