架构

Cortex 如何工作

Cortex 是一个将 OpenCode 集成为代理运行时（本地服务器）的 VS Code 扩展。Cortex 在你自己的编辑器中增加 IDE 层——聊天面板、本地代码库上下文、Policy Brain，以及类似 Cursor/Windsurf 的工作流。模型来自你的 OpenCode 订阅。

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  VS Code UI  │ ←→  │ Cortex Ext.  │ ←→  │  OpenCode    │
│  (Sidebar +  │     │ (TypeScript) │     │  (Server)    │
│   Inline)    │     │              │     │              │
└──────────────┘     └──────────────┘     └──────┬───────┘
                                                  │
                                          ┌───────▼───────┐
                                          │ OpenCode      │
                                          │ models        │
                                          │ (your sub)    │
                                          └───────────────┘

组件

• SidebarProvider — 管理聊天面板生命周期、路由、Parts→rows 时间线与 plan/build 模式
• OpenCode Client — 本地 OpenCode 服务器的 HTTP 客户端，含工具挂起看门狗与 SSE 状态
• Theme engine — 在聊天中应用 OpenCode Desktop 主题（GitHub 目录缓存、custom ~/.config/opencode/themes、follow tui.json）
• Policy Brain — 多层 rules/skills/memory/hooks 注入（T0–T3），兼容 Cursor + Cortex 加载器
• Context Service — 通过词法 + 嵌入搜索（hash 或 MiniLM）收集相关代码上下文；增量文件更新保持索引一致
• Inline Completion — 在编辑器中提供幽灵文本建议
• Plan Store — 管理带清单的已保存计划，用于 Plan→Build 工作流

Plan → Build 工作流

1. Plan 模式: Cortex 分析你的请求并创建带清单的结构化计划
2. 批准: 你审阅并批准计划
3. Build 模式: Cortex 逐步实现更改并更新清单