内容
# 🌌 星座 (Seiza)
[](https://github.com/SabilMurti/Seiza/actions)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
> **原生 TypeScript AI 编排引擎与 MCP 服务器，搭配实时 Bento 网页仪表盘。**
星座（Seiza）作为高性能执行层，供人工智能架构师代理（如 Antigravity IDE 和 Oh My Pi）使用，通过 OpenAI 兼容的端点（例如 **9Router**）协调专门的自主子代理（*规划器*、*编码器*、*评审员*、*侦察员*、*图书管理员*、*测试员*、*设计师*、*安全员*），并使用并行 DAG 执行、多代理共识验证、沙盒和交互式人机协作（HITL）授权。
---
```mermaid
graph TD
Parent[Antigravity IDE / Oh My Pi Agent] <-->|MCP Stdio Protocol| Server[Seiza MCP Stdio Server]
Server <-->|Real-Time REST Task Sync| Daemon[Seiza HTTP Dashboard Daemon]
Server <-->|Native Engine| Core[DAG Scheduler & Engine]
Core -->|Topological Sort| DAGRunner[DAG Parallel Runner]
DAGRunner -->|Parallel Spawns| Runner[Sub-Agent Execution Loop]
Runner <-->|LLM / Streaming API| Router[9Router Model Router & Fallback]
Runner <-->|Coder/Reviewer Dialogue| Consensus[Consensus Manager]
Runner <-->|Isolated Commands| Sandbox[Sandbox Layer]
Runner <-->|Proxy MCP Tools| Bridge[MCP Bridge Server]
Bridge <-->|FTS5 Memory & Graph| Amneshia[Amneshia Memory Hub]
Bridge <-->|Code Discovery| CodebaseMCP[Codebase Memory MCP]
Daemon <-->|SSE & REST API| Dashboard[React 18 + Vite Bento Dashboard]
```
---
## ✨ 核心功能
- ⚡ **基于 DAG 的并行编排**：自动将复杂的编码提示分解为拓扑依赖图，并在非依赖步骤中并行执行。
- 🤝 **多代理 peer 评审（共识引擎）**：强制执行自动编码器-评审员对话循环，以在应用更改前验证差异和安全性。
- 🔄 **实时跨进程任务同步**：通过 `POST /api/tasks/sync` 和 SSE 流同步独立 Stdio MCP 进程和 HTTP 守护进程之间的任务执行状态。
- 🛡️ **动态模型路由器和自动故障转移**：与 9Router 守护进程集成。自动重试失败的模型（404/429/5xx），采用零停机时间指数退避故障转移策略。
- 🌉 **通用下游 MCP 桥接器**：无缝桥接 **Amneshia** （SQLite FTS5 长期记忆中心）、**Codebase Memory MCP** 和 **Context7** 等工具。
- 🔒 **人机协作（HITL）**：拦截包含 `#butuh-manusia` 的破坏性命令或任务，在通过 Bento 网页仪表盘批准之前暂停执行。
- 📊 **实时 Bento 网页仪表盘**：使用实时 DAG 图、SSE 流日志、代理指令编辑器和令牌计数器的高级 React 18 + Tailwind UI。
- 💾 **上下文膨胀盾**：将完整的子代理执行轨迹记录到本地 SQLite (`sessions.db`)，同时向父代理返回简洁的抽象。
---
## ⚡ 快速入门
### 1. 标准 MCP 服务器设置（Stdio 模式）
将 Seiza 添加到您的 MCP 配置文件 (`mcp_config.json` 或 `~/.omp/agent/config.yml`）：
```json
{
"mcpServers": {
"seiza": {
"command": "wsl.exe",
"args": [
"-e",
"env",
"PATH=/home/murtix/.local/share/fnm/node-versions/v24.18.0/installation/bin:/usr/bin:/bin",
"/home/murtix/.local/share/fnm/node-versions/v24.18.0/installation/bin/seiza"
]
}
}
}
```
### 2. 独立 HTTP 服务器和网页仪表盘
在端口 `3456` 上启用网页仪表盘，运行服务器：
```bash
seiza --http --port 3456
```
或在后台守护进程模式下运行：
```bash
seiza --http --daemon
```
在 `http://localhost:3456` 打开浏览器，访问 Seiza 网页仪表盘。
---
## 🛠️ MCP 工具参考
Seiza 通过标准 MCP 传输协议向父代理公开以下工具：
| 工具名称 | 描述 | 关键参数 |
| :--- | :--- | :--- |
| `run_seiza_task` | 使用拓扑 DAG 调度和子代理循环执行复杂任务。 | `prompt`, `model`, `cwd`, `dag`, `skills` |
| `run_single_agent` | 直接运行目标自主子代理。 | `agentName`, `prompt`, `model`, `cwd`, `skills` |
| `list_seiza_agents` | 列出所有可用的代理配置文件和 frontmatter 规格。 | *(无)* |
| `list_seiza_models` | 获取可用的 9Router 模型和当前角色分配。 | *(无)* |
| `get_task_status` | 检索活动或已完成的任务的实时执行状态。 | `taskId`（可选） |
| `list_seiza_skills` | 返回 `./skills` 或 `~/.seiza/skills` 中安装的所有技能。 | *(无)* |
| `install_seiza_skill` | 从 GitHub 或本地目录路径安装技能包。 | `source` |
| `list_bridge_tools` | 发现连接的下游桥接服务器公开的工具。 | `serverName`（可选） |
---
## 🔌 下游 MCP 桥接器集成
Seiza 可以将下游 MCP 服务器的工具直接代理到子代理执行循环：
- **Amneshia**：零外部 DB SQLite FTS5 长期记忆中心和知识图。
- **Codebase Memory MCP**：基于图的构造代码发现、Cypher 查询和跟踪路径。
- **Context7**：现代框架的官方最新文档引擎。
在仪表盘的 **Bridge** 标签或 `~/.seiza/config.json` 中动态管理桥接服务器。
---
## 💻 CLI 选项
```bash
seiza [选项]
选项：
-V, --version 输出版本号
--data-dir <路径> 自定义数据目录（默认： "~/.seiza"）
--http 启用 HTTP/SSE 服务器模式（默认： true）
--no-dashboard 禁用 HTTP 网页仪表盘服务器
-p, --port <数字> 端口号（默认： 3456）
-d, --daemon 在后台守护进程模式下运行服务器（默认： false）
-h, --help 显示命令帮助
```
---
## 🛠️ 开发与构建
```bash
# 安装根依赖项
npm install
# 类型检查并构建后端
npm test
npm run build
# 构建网页仪表盘
cd dashboard
npm install
npm run build
```
---
## 📄 许可证
MIT © Sabil Murti
