内容
# 工程操作系统
> AI辅助开发的工程学科 — 作为模型上下文协议服务器。
**AI辅助软件开发的治理层。** 工程操作系统是一套[模型上下文协议](https://modelcontextprotocol.io)（MCP）服务器，位于编码助手和代码库之间，强制执行成熟软件组织的工程学科 — 版本和依赖安全、幻觉检测、架构和安全审查、自动质量保证、性能分析、部署脚手架、机构记忆、多代理代码审查、自动补救和合规。
前提很简单：AI生成的代码中的大多数失败不是推理失败，而是**纪律**失败 — 过时的依赖、幻觉的API、泄露的秘密、未经审查的架构、缺失的测试。 工程操作系统使这种纪律自动化。
---
## 功能
每个功能都是一个独立的MCP服务器，可以单独运行或与其他服务器组合。每个工具在可能的情况下都是确定性和无副作用的，所有网络和文件系统访问都被注入 — 因此它们运行速度快且行为可预测。
| 领域 | 服务器 | 功能 | 工具 |
|--------|--------|--------------|-------|
| **知识** | `@seos/knowledge` | 验证npm注册表中的软件包版本（semver-range aware），评估依赖的废弃风险，检测已安装软件包中的幻觉API，并提供精选的堆栈配置文件。 | `check_versions`、`audit_dependency`、`verify_api`、`get_knowledge` |
| **架构** | `@seos/architecture` | 捕获规模需求，生成结构化的架构提案，审查设计规则，并记录架构决策记录。 | `intake_requirements`、`generate_architecture`、`review_design`、`write_adr` |
| **安全** | `@seos/security` | 秘密扫描与前端泄漏升级，实时CVE查找（通过[OSV.dev](https://osv.dev)），静态注入/XSS/eval检测和威胁建模。 | `scan_secrets`、`scan_dependencies`、`scan_code`、`threat_model` |
| **质量** | `@seos/qa` | 从文件的实际导出符号生成测试骨架，强制执行覆盖率阈值，并在测试运行之间检测回归。 | `generate_tests`、`check_coverage`、`detect_regressions` |
| **性能** | `@seos/performance` | 检测后端N+1查询和`SELECT *`，根据预算标记前端捆绑包过大，并运行分阶段负载模拟。 | `analyze_backend`、`analyze_frontend`、`simulate_load` |
| **运维** | `@seos/devops` | 生成部署基础设施（Dockerfile、CI管道、健康检查），可观察性脚手架（日志记录/指标/跟踪）和可靠性就绪检查。 | `generate_infra`、`generate_observability`、`check_reliability` |
| **记忆** | `@seos/memory` | 持久的机构记忆 — 决策、项目上下文和历史事件，在会话中存活，通过可交换的存储接口。 | `record_decision`、`query_decisions`、`set_context`、`get_context`、`record_history`、`search_history` |
| **审查** | `@seos/review-board` | 多代理审查委员会，每个代理投票批准/拒绝；只有当没有代理拒绝时，变更才被批准。可通过`ReviewAgent`接口扩展。 | `review_pr` |
| **补救** | `@seos/self-healing` | 将生产信号转化为修复：聚合日志/错误/指标为问题，假设根本原因，提出修复和回归测试，并打开拉取请求 — **绝不自行合并**。 | `ingest_signals`、`root_cause`、`propose_fix`、`create_pr` |
| **合规** | `@seos/compliance` | 检查系统是否符合SOC 2 / GDPR / HIPAA / PCI控制检查清单，并维护篡改证据的哈希链审计日志。 | `check_compliance`、`append_audit_log`、`verify_audit_log` |
## 要求
- **Node.js** 24 或更高版本
- **pnpm** 10 或更高版本
## 安装
```bash
git clone https://github.com/arslanmanzoorr/AISEOS engineering-os
cd engineering-os
pnpm install
pnpm -r build
```
## 连接到编码助手
工程操作系统通过stdio使用MCP，因此它与任何MCP-capable客户端（Claude Code、Claude Desktop等）一起工作。构建完成后，将所需的服务器添加到MCP配置中。启用所有服务器的完整配置：
```json
{
"mcpServers": {
"seos-knowledge": {
"command": "node",
"args": ["./packages/knowledge/dist/index.js"],
"env": { "SEOS_KNOWLEDGE_PATH": "./packages/knowledge/knowledge.json" }
},
"seos-architecture": {
"command": "node",
"args": ["./packages/architecture/dist/index.js"],
"env": { "SEOS_ADR_DIR": "./docs/adr" }
},
"seos-security": {
"command": "node",
"args": ["./packages/security/dist/index.js"]
},
"seos-qa": {
"command": "node",
"args": ["./packages/qa/dist/index.js"]
},
"seos-performance": {
"command": "node",
"args": ["./packages/performance/dist/index.js"]
},
"seos-devops": {
"command": "node",
"args": ["./packages/devops/dist/index.js"]
},
"seos-review-board": {
"command": "node",
"args": ["./packages/review-board/dist/index.js"]
},
"seos-self-healing": {
"command": "node",
"args": ["./packages/self-healing/dist/index.js"]
},
"seos-compliance": {
"command": "node",
"args": ["./packages/compliance/dist/index.js"]
},
"seos-memory": {
"command": "node",
"args": ["./packages/memory/dist/index.js"],
"env": { "SEOS_MEMORY_PATH": "./memory.json" }
}
}
}
```
您不需要启用所有服务器 — 每个服务器都独立运行。从`seos-knowledge`和`seos-security`开始，根据需要添加其他服务器。
## 配置
大多数服务器不需要配置。那些需要的服务器会读取一个单独的环境变量：
| 服务器 | 变量 | 默认值 | 用途 |
|--------|----------|---------|---------|
| `@seos/knowledge` | `SEOS_KNOWLEDGE_PATH` | `./knowledge.json`（二进制文件旁边） | 选定的堆栈配置文件的路径 |
| `@seos/architecture` | `SEOS_ADR_DIR` | `docs/adr` | 架构决策记录写入的目录 |
| `@seos/memory` | `SEOS_MEMORY_PATH` | `./memory.json`（二进制文件旁边） | 持久内存存储的路径 |
每个包的`README.md`文件都详细记录了其工具和选项。
## 配套工具
AISEOS专注于**治理**。它与本地开发循环中的快速**代码智能**服务器配合良好：
- **[codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)** 由 [DeusData](https://github.com/DeusData) （MIT）提供 — 在毫秒内将您的存储库索引到持久的知识图中，公开图搜索、调用路径跟踪、代码片段和架构查询。单个静态二进制文件，无运行时依赖项。
由于它读取您的**本地**代码库，因此在自己的机器上与AISEOS stdio服务器一起运行 — 将其添加到相同的MCP配置中：
```json
{
"mcpServers": {
"codebase-memory": { "command": "/path/to/codebase-memory-mcp" },
"seos-knowledge": { "command": "node", "args": ["./packages/knowledge/dist/index.js"] }
}
}
```
> 注意：codebase-memory-mcp在**本地**运行（它索引磁盘上的文件），因此它是本地AISEOS服务器的配套工具 — 不是托管网关的一部分，它无法访问您的代码。它是一个独立的项目；AISEOS只是推荐它。所有功劳归于DeusData。
## 设计原则
- **确定性基元，而不是模型调用。** 这些服务器通过透明的、可测试的规则强加结构并捕获已知的失败模式。助手进行开放式推理；工程操作系统使其诚实。
- **整个过程的依赖注入。** 网络和文件系统访问被注入，因此行为可预测，整个套件离线运行。
- **大声失败，从不发出虚假的“全部清除”。** 无法完成的检查报告错误，而不是默默地通过。
- **每个模块一个责任，每个服务器一个关注点。** 每个服务器都独立可安装、可测试和可替换。
## 项目结构
```
engineering-os/
├── packages/
│ ├── knowledge/ # 版本、依赖和API治理
│ ├── architecture/ # 架构提案和决策记录
│ ├── security/ # 秘密、CVE、静态分析、威胁建模
│ ├── qa/ # 测试生成、覆盖率、回归检测
│ ├── performance/ # 后端、前端和负载分析
│ ├── devops/ # 基础设施、可观察性、可靠性
│ ├── memory/ # 持久的决策、上下文和历史
│ ├── review-board/ # 多代理变更审查
│ ├── self-healing/ # 信号 → 根原因 → 修复 → 拉取请求
│ └── compliance/ # SOC2/GDPR/HIPAA/PCI检查和审计日志
└── docs/
└── adr/ # 架构决策记录
```
## 开发
```bash
pnpm -r build # 构建所有软件包
pnpm -r test # 运行完整的测试套件
pnpm --filter @seos/security test # 测试单个软件包
```
代码库是TypeScript（ESM，NodeNext），并使用Vitest进行测试。贡献遵循测试驱动开发：失败的测试、最小的实现、通过的测试。
## 许可证
MIT
