CortexOS

个人外部大脑操作系统 · 核心中枢 v5.8.0

【CortexOS · Codex 02】

CortexOS 是一套本地第一 (Local-first) 的多 Agent 协作架构。它将规则、意志、项目轨迹与跨会话记忆，持久化在你的本地磁盘之上。

🪐 宇宙图谱 (Project Map)

• CortexOS: 本地优先的 AI 记忆系统与多 Agent 协作中枢。
• AetherFleet: 实时、可视化、沉浸式的 AI Team 协作引擎。
• Prompt Lab: AI 影像工作流指南与创意参考库。
• nanobanana-plus: 强化型 Gemini 绘图扩展，支持逐调用模型切换。

⚔️ 核心架构：对抗混乱

在 AI 协作中，我们面临三大熵增：

1. 上下文易失：会话结束，规则即刻蒸发。
2. 多机协作失控：多模型并行时的状态冲突与重复劳动。
3. 项目记忆断裂：AI 对项目全局与历史进度缺乏稳定认知。

CortexOS 通过三层防御体系锁定秩序：

• docs/：至高协议层。沉淀法则、SOP 与公开文档。
• .memory/：运行态核心。存放助手私有日志、任务池、项目注册表。
• ~/Documents/memory/：永恒知识库。用户私人资产，通过 Obsidian MCP 实现跨项目语义召回。

💎 卓越能力

1. MCP 全能接口 (Universal Interface)

通过 mcp_server/server.py（Python 核心），专注于知识检索与规则分发：

• read_router()：读取大脑至高宪法。
• search_knowledge()：基于语义或全文检索永恒知识库。
• load_rule()：按需加载特定规则，节省上下文。
• log_task()：刻录每日操作轨迹，增强 Obsidian 协同。

💡 Fleet 调度说明: 运行态调度已迁移至独立的 AetherFleet 服务，实现“大脑”与“肢体”的物理解构。

📂 目录结构 (Directory Structure)

CortexOS/
├── docs/                    # 【协议层】宪法、规则、VitePress 站点库
│   ├── rules/               # 行为约束 (security, coding, habits)
│   ├── sops/                # 标准作业程序
│   └── ops/                 # 运维手册
├── .memory/                 # 【记忆层】助手私有运行态数据
│   ├── identity/            # 用户习惯与设备画像 (Local-only)
│   └── logs/                # 进化记忆轨迹
├── mcp_server/              # 【接口层】专注于知识检索与分发的 FastMCP 服务
├── scripts/                 # 【动力层】维护、检索与通知脚本
└── package.json             # 【基石】项目配置

🛠️ 快速冷启动

1. 激活大脑 (Start Brain MCP)

uv run mcp_server/server.py

2. 调度接入 (Fleet Access)

请确保同时运行 aetherfleet-engine 以获得完整的 Agent 状态感知能力。

---

📅 版本与演进

• 当前版本：v5.8.0（脑体物理解构 · 知识代谢协议落地）
• 变更日志：CHANGELOG.md

“不战而屈人之兵，善之善者也。CortexOS 让 AI 协作于无形，沉淀于有根。”