AgentOS 项目文档索引
最后更新: 2026-06-21 | 版本: 4.2.0
系统身份与规则（01_core/ → ~/.workbuddy/）
| 文件 |
说明 |
加载方式 |
| CONSTITUTION.md |
架构宪法（先读此文件） |
部署到 ~/.workbuddy/ 按需加载 |
| SOUL.md |
AI 行为规则、模式切换、安全边界 |
常驻 ~750 tokens/次 |
| IDENTITY.md |
系统身份、设备信息（从模板生成） |
常驻 |
| USER.md |
用户画像与偏好 |
常驻 |
| MAINTENANCE_GUIDE.md |
运维操作手册 |
按需查阅 |
| mcp.json |
MCP 服务配置（filesystem/memory/peekaboo） |
WorkBuddy 启动时加载 |
| VERSION |
版本唯一来源 |
所有文档以此为准 |
行为协议（03_knowledge/99_system/protocols/）
| 协议 |
触发场景 |
加载时机 |
| meta-thinking |
升维思考、本质追问 |
触发词激活 ~200 tokens |
| cross-domain |
跨界类比、新视角 |
触发词激活 |
| stuck-intervention |
卡壳暂停给选项 |
条件触发 |
| knowledge-review |
知识入库审查 |
触发词激活 |
技能（02_skills/）
当前活跃 7 个技能（4 个已归档，见 02_skills/_archived/README.md）：
| 技能 |
版本 |
说明 |
状态 |
| memory_manager |
1.2.0 |
五级记忆体 + 语义检索 |
✅ |
| inbox_refine |
1.0.0 |
收件箱 AI 分类归档 |
✅ |
| collect_to_inbox |
2.0.0 |
提交箱→收件箱归集 |
⚠️ 文档降级（代码未同步） |
| kb_manager |
1.1.0 |
知识库管理 |
✅ |
| matrix |
1.0.0 |
矩阵养号（实现在 05_tools/07_matrix/） |
✅ |
| sync_manager |
1.1.0 |
同步备份 |
✅ |
| peekaboo_controller |
1.0.0 |
macOS GUI 自动化（MCP） |
✅ |
Dashboard 看板
| 文档 |
路径 |
说明 |
| Dashboard README |
05_tools/10_dashboard/README.md |
看板架构、API、CMD_REGISTRY、前端调用规范（必读） |
| 五层架构审计 |
PLANS/AUDIT_5LAYER_REPORT.md |
所有视图的合规状态 |
| 命令传导统一治理 |
PLANS/COMMAND_UNIFICATION_PLAN.md |
2026-06-25 治理方案 |
工具（05_tools/）
| 工具 |
说明 |
调用方式 |
| 00_setup/agentos/ |
系统管理 CLI（init/check/backup/upgrade/…14 命令） |
命令行 |
| 00_setup/guardd/ |
联邦守护进程（9 模块，300 秒周期） |
launchd 自动 |
| 01_system/ |
系统诊断脚本（12 个 .py） |
agentos check / 手动 |
| 05_crawl/ |
内容采集（longcat + content-inspiration） |
手动 / API |
| 07_matrix/ |
矩阵养号（Camoufox 浏览器 + 12 个蓝图） |
mc CLI / Dashboard |
| 08_trae_agent/ |
Trae AI 编程助手 |
CLI |
| 09_ave/ |
视频工厂 |
CLI / API（8001 端口） |
| 10_dashboard/ |
监控面板（FastAPI 1521 行 + 15 插件） |
浏览器 :9988 |
联邦系统
| 文档 |
路径 |
| 联邦宪法 |
ORACLE.yaml |
| 联邦使用指南 |
FEDERATION_GUIDE.md |
| 联邦架构 |
03_knowledge/99_system/architecture/federated-multi-machine-architecture.md |
| 加载与检索架构 |
03_knowledge/99_system/architecture/loading-architecture.md |
| cross_machine 结构 |
04_memory/cross_machine/ |
| 守护进程源码 |
05_tools/00_setup/guardd/guardd.py（1166 行） |
架构全景
| 文档 |
路径 |
说明 |
| 架构宪法（先读此文件） |
CONSTITUTION.md（根目录，同时部署到 ~/.workbuddy/） |
总纲：硬规则 + 十二维全景 + 版本规则 + 开发决策流程 |
| 系统全景 |
99_system/AGENTOS-PANORAMA.md |
完整系统概述 |
| 联邦多机架构 |
03_knowledge/99_system/architecture/ |
技术架构设计 |
| 内容收集全链路 |
03_knowledge/99_system/pipelines/ |
采集→归档规范 |
| 记忆与知识体系 |
03_knowledge/99_system/architecture/ |
分层记忆设计 |
版本体系
版本唯一源：01_core/VERSION
| 组件 |
版本 |
| AgentOS 框架 |
4.2.0 |
| guardd 守护进程 |
2.3.0 |
| ORACLE schema |
1.0 |
版本规则：
- 大版本（X.0.0） — 核心框架或联邦架构升级
- 中版本（0.X.0） — 工具级增加或重大升级
- 小版本（0.0.X） — 配置小项目升级、bugfix
butubb
2112c1a870