内容
# 上下文操作系统（v1.12.0）
> 面向自主AI代理的企业级智能层
上下文操作系统是一个TypeScript大型仓库，提供结构化的上下文基础设施——从工作区索引和向量搜索到多代理编排，并具有内置的弹性。该系统以三个npm包和一个空间仪表盘的形式发布。
---
## 快速入门
### 安装CLI
```bash
npm install -g @context-os/cli
```
### 初始化项目
```bash
context-os init my-project
```
### 连接AI代理（MCP）
在Cursor、Claude Desktop或VS Code设置中：
```bash
npx -y @context-os/mcp@latest
```
### 启动仪表盘
```bash
context-os dashboard
```
---
## 架构
一个TurboRepo根目录下的四个工作区：
| 软件包 | 描述 |
| :--- | :--- |
| `@context-os/core` | SQLite索引、向量搜索（sqlite-vec）、ML嵌入、tree-sitter解析、DI容器、事件总线、代理注册、编排、弹性 |
| `@context-os/cli` | 终端接口——项目脚手架、搜索、监视、仪表盘启动器 |
| `@context-os/mcp` | 模型上下文协议服务器——stdio和HTTP/SSE传输 |
| `workspace-dashboard` | React 19 + Three.js空间可视化（私有，未发布） |
### v2核心模块
| 模块 | 目的 |
| :--- | :--- |
| **服务容器** | 具有作用域解析和类型令牌的依赖注入 |
| **工作区事件总线** | 具有错误隔离处理器的类型事件 |
| **代理注册表** | 生命周期管理——注册、心跳、隔离、陈旧检测 |
| **消息总线** | 直接、广播和基于关联的消息传递，带有TTL |
| **任务图** | 具有比较和交换赋值的DAG验证任务依赖 |
| **任务调度器** | 具有冲突重试的依赖感知调度 |
| **冲突解决器** | 具有升级支持的读写锁 |
| **断路器** | 具有自动隔离的滑动窗口故障跟踪 |
| **审计日志** | Merkle链接的防篡改审计轨迹 |
---
## 开发
```bash
npm run build # Turbo：构建所有工作区
npm run test # Turbo：运行mocha测试（core/cli/mcp）
npm run link:all # 构建 + npm链接，用于本地开发
```
每个工作区：
```bash
cd workspace-dashboard && npm run dev # Vite开发服务器
cd workspace-cli && npm run watch # tsc监视
cd workspace-mcp && npm run mcp:stdio # 运行MCP服务器
```
运行单个测试：
```bash
cd packages/core && npx mocha dist/tests/container.test.js
```
---
## 功能矩阵
| 功能 | CLI | MCP | Core |
| :--- | :---: | :---: | :---: |
| 空间仪表盘（Aether HUD） | x | | |
| 实时监视服务 | x | | |
| 项目脚手架 | x | | |
| 每日日志 | x | x | |
| ADR跟踪 | x | x | |
| 工作区验证 | x | | |
| 全局搜索 | x | x | x |
| 多代理编排 | | | x |
| 断路器/弹性 | | | x |
| Merkle审计日志 | | | x |
---
## 版本和发布
所有四个`package.json`文件必须共享相同的版本。发布顺序：Core -> CLI -> MCP。由推送`v*`标签触发。CI在Node 22上运行。
---
## 文档
- [用户指南](./USER_GUIDE.md) — 入门和日常工作流程
- [CLI命令](./docs/cli.md) — 完整命令参考
- [架构](./docs/architecture.md) — 系统层和数据流
- [发布](./docs/publishing.md) — 构建和发布协议
- [v2升级计划](./docs/v2-upgrade-plan.md) — 多代理架构设计
---
## 📄 许可证
MIT © [Sairam Ugge](https://github.com/sairam0424)
