CortexOS

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

�CortexOS · Codex 02】

CortexOS �仅仅是一个 AI 界�，它是一套尊享级 (Aureate) 的本地第一 (Local-first) �作架构。它将规则��志�项目轨迹与跨会�记忆，如�金线般编织在你的本地�盘之上。

� 宇宙图谱 (Project Map)

• CortexOS: 本地优先的 AI 记忆系统与多 Agent å��作中枢。
• Prompt Lab: AI å½±åƒ�工作æµ�指å�—与创æ„�å�‚考库。
• nanobanana-plus: 强化型 Gemini 绘图扩展，支æŒ�é€�调用模型切æ�¢ã€‚
• Bloom: 专注长文书写的 Typora 主题，承载é�™è°§çš„排版艺术。

⚔� 核心架构：对抗混乱

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

1. 上下文易失：会�结�，规则�刻蒸�。
2. **多机�作失控**：多模型并行时的状�冲�与��劳动。
3. **项目记忆断裂**：AI 对项目全局与历�进度缺�稳定认知。

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

• docs/：**至高å��议层**。沉淀法则ã€�SOP 与公开文档。
• .memory/：è¿�è¡Œæ€�核心。存放助手ç§�有日志ã€�任务池ã€�项目注册表。
• ~/Documents/memory/：**æ°¸æ�’知识库**。用户ç§�人资产，通过 Obsidian MCP 实现跨项目语义å�¬å›žã€‚

💎 �越能力

1. MCP 全能接� (Universal Interface)

通过 mcp_server/server.py（Python 核心），暴露 12 个原å­�级工具，定义了 Agent 进入大脑的唯一路径：

• read_router()：读å�–至高宪法。
• get_fleet_status()：俯瞰舰队实时æ€�势。
• fleet_claim()：仪å¼�感满满的开工登记。
• log_task()：刻录æ¯�æ—¥æ“�作轨迹。

2. AI Team 舰队编排

实现多 Agent 并行时的“告警�拦截�机制，支�队长平滑移交。

• 视觉驱动：集æˆ� FleetDashboard 实时看æ�¿ã€‚
• å°�龙虾 (Lobster) 深度集æˆ�：完美å��å�Œå¼ºå�•å…µ Agent，将其执行力纳入中枢管ç�†ã€‚

3. 项目自动激活

AI Team 进入任�路径时，系统会自动执行「身份审计�与「项目注册�：

• 自动生æˆ� command-center.md 指挥中心。
• 刷新最近触达 Agentã€�任务进度与资æº�映射。

📂 目录结构 (Directory Structure)

CortexOS/
├── docs/                    # ��议层】宪法�规则�VitePress 站点库
│   ├── rules/               # 行为约� (security, coding, habits)
│   ├── sops/                # 标准作业程�
│   └── team/                # AI Team ���端入�
├── .memory/                 # �记忆层】助手�有�行�数�
│   ├── logs/                # 进化记忆轨迹
│   ├── sqlite/              # AI Team 核心数�库 (ai-team.db)
│   ├── projects/            # 项目注册中心与索引
│   └── tasks/               # 任务池书案
├── mcp_server/              # �接�层】基于 FastMCP 的 Python �务端
├── scripts/                 # �动力层】Actions, Tools, Maintenance 脚本
└── package.json             # �基石】项目�置与脚本入�

🛠� 快速冷�动

1. 激活中枢 (Start MCP)

uv run mcp_server/server.py

2. 仪�化�动 (Local Team)

通过一�整�命令唤醒本地指挥系统：

pnpm run team:local

此命令将自动：�始化数�库 -> �动 Bridge -> �行 VitePress -> 打开看�。

3. 挂牌入驻 (Fleet Claim)

pnpm fleet:claim --workspace "$PWD" --task "任务�述" --agent Codex --role 执行层

---

📅 版本与演进

• 当å‰�版本：v5.8.0（规则系统收å�£ · MCP Python 化）
• **å�˜æ›´æ—¥å¿—**：CHANGELOG.md
• 视觉规范：Aureate Aesthetic

“ä¸�战而屈人之兵，善之善者也。CortexOS 让 AI å��作于无形，沉淀于有根。â€� ¡Œæ€�分层

现在文档与�行�已�分开：

• docs/ å�ªæ‰¿è½½ DOC
• docs/team/ 是 AI Team 本地独立大é�¢æ�¿å…¥å�£
• .memory/ 承载真实è¿�行数æ�®ï¼Œä¸�å†�和文档混写

目录结构

CortexOS/
├── docs/                    # 文档�规则�VitePress 站点
├── .memory/                 # �烛�有�行记忆
│   ├── logs/                # �日日志
│   ├── tasks/               # 任务池
│   ├── projects/            # 项目索引
│   └── plans/projects/      # �项目指挥中心
├── mcp_server/              # MCP Server 实现
├── scripts/actions/         # fleet / project registry 等动作脚本
└── scripts/tools/           # �步�扫��治�脚本

快速接入

1. �动 MCP Server

uv run /你的物�路径/CortexOS/mcp_server/server.py

AI Team 本地状æ€�库会在 bridge å�¯åŠ¨æ—¶è‡ªåŠ¨åˆ�始化，ä¸�需è¦�先手动执行 pnpm run team:db:init。 AI Team 页é�¢å�ªåœ¨æœ¬åœ°å�¯åŠ¨æ–‡æ¡£ç«™æ—¶æ˜¾ç¤ºï¼Œè¿�è¡Œæ€�æ•°æ�®ä¸�会å�‘布到线上文档站。

1.5 一�命令�动本地 AI Team

pnpm run team:local

它会自动：

• å�¯åŠ¨æœ¬åœ° bridge
• å�¯åŠ¨å¸¦æœ¬åœ°è�œå�•çš„ VitePress
• 直接打开 /CortexOS/team/

用户ä¸�需è¦�å†�å�•ç‹¬ç�†è§£ fleet:bridgeã€�team:db:init 或文档站å�¯åŠ¨ç»†èŠ‚。

2. 在客户端挂载外脑

{
  "mcpServers": {
    "cortexos-brain": {
      "command": "uv",
      "args": ["run", "/你的物�路径/CortexOS/mcp_server/server.py"]
    }
  }
}

3. 让 AI Team 自动登记项目

pnpm fleet:claim --workspace "$PWD" --task "开始开�" --agent Codex --alias Codex --role �端

或手动补录：

pnpm projects:sync --workspace "$PWD" --agent Codex --role �端 --task "补录项目"

当�版本与�布信�

• 当å‰�文档版本：v5.7.0
• å�˜æ›´è®°å½•ï¼šCHANGELOG.md
• Git 版本标签：v5.7.0

适用场景

• ä½ å�Œæ—¶ä½¿ç”¨å¤šä¸ª AI 客户端，需è¦�共享统一规则与记忆
• 你手头有多个项目，希望 AI 进入项目时自动知é�“自己在哪ã€�å�šè¿‡ä»€ä¹ˆã€�接下æ�¥å�šä»€ä¹ˆ
• 你希望日志ã€�任务ã€�项目索引都è�½åœ¨æœ¬åœ°ï¼Œå�¯å®¡è®¡ã€�å�¯è¿�移ã€�å�¯æ�¢å¤�
• ä½ å·²ç»�在用å°�龙虾这类强å�•å…µ Agent，但想把它å�‡çº§æˆ�带项目记忆和å��å�Œèƒ½åŠ›çš„工作体系

约�

• 秘钥ä¸�入仓库，统一外置
• 项目索引属于è¿�è¡Œæ€�，ä¸�是长期知识正文
• Agent ä¸�能跳过 fleet_claim 直接改核心文件
• 文档å�˜æ›´ã€�版本å�˜æ›´ã€�标签å�‘布è¦�ä¿�æŒ�一致