Orchidea Director

Organization Scheduling & Silicon Staff Management Center
多智能体编排 · 任务分发 · 预算治理 · 实时监控

API 文档 • 架构设计 • 部署指南 • 用户手册 • Agent 手册

2026-11 能力更新（v1.2.0）

设计计划 API（Part Tree 中间状态序列）：POST/GET /design-plans 与阶段推进端点；未注册 planId 显式 404，跳级推进 409
证据门禁：verified 阶段必须携带 passed=true 的实测几何证据，drawing 阶段必须携带制品路径；产物原样透传不改写
Staff 模板：新增 design-planning 与 CAD endpoint 示例

2026-10 能力更新（v1.1.0）

三层 Agent 集群 605 个：L1 实名人员型 52、L2 知识 Worker 型 452（流程节点 398 + 场景协作 54）、L3 行业应用型 101，reportsTo 三层闭环
L3 行业应用 12 个子集群：销售域 33、交付域 34、服务域 34
FDE 六阶段：诊断 → 规划/网络分区 → 蓝图/建模/架构 → 配置/采集/路径 → UAT/联调/投资 → 移交/验收，覆盖 ITS / SMARTSYS / CONSULT 三条主流程
10 大场景协作矩阵：54 人次协作，含 SLA、端到端 KPI 与签字级成功标准
MCP 网关：自动扫描 apparatus 生成工具、按 playbook 增强描述、按 policy 做预算/ACL 门禁；stdio 13 个工具；上游聚合 archive/plex/nsaa/science；内置金蝶苍穹 MCP 鉴权

项目简介

Orchidea Director 是一个统一的多智能体编排系统，将组织调度与硅基员工管理整合在一个中心化平台中。系统采用科层命名体系，将 28 个功能模块组织为 6 大科层，覆盖从任务分发到预算治理的全生命周期。

核心能力

能力	描述
任务分发引擎	基于 Agent 技能和负载状态的智能任务分配
心跳监控	实时 Agent 健康检测与离线告警
预算治理	多维度成本追踪、支出控制、预算告警
审批工作流	碳基员工审批、策略合规、审计追踪
MCP 网关	标准化工具接口，支持 Claude、KIMI、Cursor 等外部 Agent
ERP 集成	金蝶、鼎捷、飞书等企业系统对接

架构概览

┌─────────────────────────────────────────────────────────────────────────┐
│                         Orchidea Director                               │
│                     组织调度与硅基员工管理中心                             │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌─────────────┐   ┌─────────────┐   ┌─────────────┐                   │
│  │   Bureau    │   │  Registry   │   │    Works    │                   │
│  │   指挥部     │   │   注册处    │   │    工坊     │                   │
│  │             │   │             │   │             │                   │
│  │  command    │   │   staff     │   │   smith     │  C1: CLI 锻造     │
│  │  dashboard  │   │  apparatus  │   │   scout     │  C2: 侦察引擎     │
│  │  console    │   │  playbook   │   │   pilot     │  C3: CDP 控制     │
│  │             │   │             │   │             │                   │
│  │  A1  A2  A3 │   │  B1  B2  B3 │   │  C1  C2  C3 │                   │
│  └──────┬──────┘   └──────┬──────┘   └──────┬──────┘                   │
│         │                 │                 │                          │
│  ┌──────┴──────┐   ┌──────┴──────┐   ┌──────┴──────┐                   │
│  │    Studio   │   │   Council   │   │    Bridge   │                   │
│  │   工作室    │   │    议会     │   │    桥梁     │                   │
│  │             │   │             │   │             │                   │
│  │  sandbox    │   │   budget    │   │  gateway    │  F1: MCP 网关     │
│  │   vault     │   │   audit     │   │  antenna    │  F2: 外部适配     │
│  │             │   │   policy    │   │   port      │  F3: ERP 接口     │
│  │  D1    D2   │   │  E1 E2 E3  │   │  F1 F2 F3   │                   │
│  └─────────────┘   └─────────────┘   └─────────────┘                   │
│                                                                         │
│  ┌──────────────────────────────────────────────────────────────────┐   │
│  │                    共享层 (Shared Layer)                          │   │
│  │  types.ts · tsconfig.json · docker-compose.yml · install.sh      │   │
│  └──────────────────────────────────────────────────────────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

快速开始 (5 分钟 Demo)

前置要求

Node.js >= 20.0.0
pnpm >= 9.0.0
Git

1. 一键安装 (1 分钟)

# 克隆仓库
git clone <repository-url> orchidea-director
cd orchidea-director

# 运行安装脚本
bash install.sh

安装脚本将自动完成:

环境检测 (OS / Node.js / pnpm)
依赖安装 (pnpm install)
项目构建 (pnpm build)
目录结构创建 (~/.orchidea/director/)
全局命令注册 (director)

2. 启动服务 (1 分钟)

# 方式一: 直接启动
make dev

# 方式二: 分别启动
make dev-api      # API 服务 (端口 29990)
make dev-dash     # Dashboard (端口 29993)

3. 验证安装 (1 分钟)

# 健康检查
curl http://localhost:29990/health

# 预期响应:
# {
#   "success": true,
#   "data": {
#     "status": "healthy",
#     "uptime": 12.34,
#     "timestamp": "2024-01-15T10:30:00.000Z",
#     "version": "1.0.0"
#   }
# }

4. 创建第一个 Agent (1 分钟)

# 创建 Agent
curl -X POST http://localhost:29990/api/agents \
  -H "Content-Type: application/json" \
  -d '{
    "name": "scout-agent-01",
    "role": "worker",
    "skills": ["scout", "data-collection"],
    "maxConcurrentTasks": 3
  }'

5. 打开 Dashboard (1 分钟)

浏览器访问: http://localhost:29993

查看 Agent 列表和状态
监控任务执行情况
查看预算使用报表
处理审批请求

目录结构

orthidea-director/
├── logo.png                          # 品牌 Logo
├── icon.png                          # 品牌图标
├── package.json                      # 根级包配置 (workspaces)
├── tsconfig.json                     # TypeScript 全局配置
├── types.ts                          # 共享类型定义
├── docker-compose.yml                # Docker 全栈部署
├── Makefile                          # 常用命令
├── install.sh                        # 一键安装脚本
├── README.md                         # 项目介绍
├── ARCHITECTURE.md                   # 架构设计文档
├── API.md                            # API 接口文档
├── DEPLOYMENT.md                     # 部署指南
├── USER_GUIDE.md                     # 碳基员工手册
├── AGENT_GUIDE.md                    # 硅基员工手册
│
├── bureau/                           # 指挥部 (决策层)
│   ├── command/                      # A1: Command Center API + WebSocket
│   ├── dashboard/                    # A2: React + Express + PGLite 全栈指挥面板
│   │   ├── src/                      #     前端 SPA (Vite + React Router)
│   │   ├── src/server/               #     Express 后端 (独立数据库)
│   │   │   ├── server.ts             #     后端主服务 (端口 29993)
│   │   │   ├── db/                   #     PGLite 嵌入式数据库 (9 表)
│   │   │   ├── api/                  #     REST API (agents/tasks/budget/approvals)
│   │   │   ├── api/console.ts        #     CLI Web化: Console 控制台
│   │   │   ├── api/smith.ts          #     CLI Web化: Smith 铁匠铺
│   │   │   └── api/apparatus.ts      #     CLI Web化: Apparatus 器械市场
│   │   └── dist/                     #     前端构建产物
│   └── console/                      # A3: CLI 控制台
│
├── registry/                         # 注册处 (注册层)
│   ├── staff/                        # B1: 员工注册 (组织模板)
│   ├── apparatus/                    # B2: 器械注册 (CLI 包管理)
│   └── playbook/                     # B3: 剧本注册 (SKILL.md)
│
├── works/                            # 工坊 (执行层)
│   ├── smith/                        # C1: CLI 锻造流水线
│   ├── scout/                        # C2: 侦察引擎 + Chrome 扩展
│   └── pilot/                        # C3: CDP 控制 + 浏览器桥接
│
├── studio/                           # 工作室 (产出层)
│   ├── sandbox/                      # D1: 沙箱执行环境
│   └── vault/                        # D2: 制品归档与版本管理
│
├── council/                          # 议会 (治理层)
│   ├── budget/                       # E1: 预算追踪与分配
│   ├── audit/                        # E2: 审计日志与合规
│   └── policy/                       # E3: 审批策略与 RBAC
│
├── bridge/                           # 桥梁 (连接层)
│   ├── gateway/                      # F1: MCP 网关
│   ├── antenna/                      # F2: 外部 Agent 适配器
│   └── port/                         # F3: ERP 系统接口
│
├── scripts/                          # 工具脚本
│   ├── brand-check.sh                # 品牌合规检查
│   └── rename-check.sh               # 命名规范检查
│
└── tests/                            # 集成测试
    └── integration.test.ts           # 全链路集成测试

技术栈

后端

技术	版本	用途
Node.js	>= 20	运行时
TypeScript	^5.4	类型系统
Express	^4.21	HTTP 服务器
Drizzle ORM	^0.38	数据库 ORM
PGlite	^0.2	嵌入式 PostgreSQL
ws	^8.18	WebSocket 通信
Zod	^3.24	数据校验
Commander	^12.1	CLI 框架

前端

技术	版本	用途
React	^18.2	UI 框架
Vite	^5.1	构建工具
Carbon Design System	^1.55	UI 组件库
Recharts	^2.12	数据可视化
D3	^7.9	自定义图表
Zustand	^4.5	状态管理

基础设施

技术	用途
Docker Compose	容器编排
PostgreSQL 16	关系数据库
MCP SDK	模型上下文协议
oclif	CLI 框架
Pino	结构化日志
Sentry	错误监控（可选）
Helmet	安全响应头
express-rate-limit	API 限流

端口映射

端口	服务	模块	说明
29990	Command API + WebSocket	`bureau/command`	核心 API 与实时通信
29991	Scout Daemon	`works/scout`	侦察引擎守护进程
29992	Pilot CDP + Bridge	`works/pilot`	浏览器控制桥接
29993	Dashboard (前端+后端+DB)	`bureau/dashboard`	全栈指挥面板 — 前端 SPA + Express 后端 + PGLite
29994	MCP Gateway	`bridge/gateway`	MCP 工具网关
5432	PostgreSQL	`postgres`	关系数据库

环境变量

变量名	默认值	说明
`NODE_ENV`	`development`	运行环境
`DATABASE_URL`	`postgresql://...`	数据库连接串（生产环境必填）
`ORCHIDEA_HOME`	`~/.orchidea/director`	数据主目录
`ORCHIDEA_ENV_FILE`	`.env`	环境变量文件路径
`API_PORT`	`29990`	API 服务端口
`WS_ENABLED`	`true`	WebSocket 开关
`HEARTBEAT_TIMEOUT_MS`	`60000`	心跳超时时间
`TASK_DISTRIBUTE_INTERVAL_MS`	`5000`	任务分发间隔
`ORCHIDEA_GATEWAY_PORT`	`29994`	MCP 网关端口
`LOG_LEVEL`	`info`	日志级别 (trace/debug/info/warn/error/fatal)
`SENTRY_DSN`	-	Sentry DSN（配置后启用错误监控）
`SENTRY_TRACES_SAMPLE_RATE`	`0.1`	Sentry 性能采样率
`DB_POOL_MAX`	`20`	数据库连接池最大值
`DB_IDLE_TIMEOUT_MS`	`30000`	连接池空闲超时
`DB_CONNECTION_TIMEOUT_MS`	`5000`	连接超时

开发指南

常用命令

# 安装依赖
make install

# 构建所有模块
make build

# 运行测试
make test

# 运行集成测试
make test-integ

# 代码检查
make lint

# 开发模式
make dev        # 同时启动 API + Dashboard
make dev-api    # 仅启动 API
make dev-dash   # 仅启动 Dashboard

# Docker 部署
make docker-up     # 启动
make docker-down   # 停止
make docker-logs   # 查看日志

# 合规检查
make brand-check    # 品牌合规
make rename-check   # 命名规范

添加新模块

在对应科层目录下创建模块文件夹
创建 package.json，使用 @orchidea/ 前缀
创建 tsconfig.json 继承根配置
创建 src/ 目录编写源码
在根 package.json workspaces 中确认包含

许可证

MIT

_{Orchidea Director - 让每一个硅基员工都被看见}

Orchidea Director

核心能力

技术优势

Orchidea Director

2026-11 能力更新（v1.2.0）

2026-10 能力更新（v1.1.0）

目录

项目简介

核心能力

架构概览

快速开始 (5 分钟 Demo)

前置要求

1. 一键安装 (1 分钟)

2. 启动服务 (1 分钟)

3. 验证安装 (1 分钟)

4. 创建第一个 Agent (1 分钟)

5. 打开 Dashboard (1 分钟)

目录结构

技术栈

后端

前端

基础设施

端口映射

环境变量

开发指南

常用命令

添加新模块

许可证