跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

基于三省六部制的 AI Agent 协作架构 Edict 框架

Edict 是基于三省六部制设计的 AI 多 Agent 协作框架，通过分权制衡实现任务规划、审核与执行分离。系统包含 12 个职责明确的 Agent 及军机处 Web 看板，提供严格通信权限矩阵和完整流转审计。基于 OpenClaw 运行时构建，采用 Python 后端与 React 前端，支持 Docker 一键部署。适用于需高质量、可审计输出的企业级任务场景。

beaabea发布于 2026/3/30更新于 2026/10/25108 浏览
基于三省六部制的 AI Agent 协作架构 Edict 框架

概述

三省六部·Edict 是一个基于中国古代官制设计的 AI 多 Agent 协作架构。它把唐朝以来运行了一千多年的三省六部制搬到了 AI 世界，创建了一套具有分权制衡、专职审核、完全可观测特性的 Agent 协作系统。

核心设计思想

问题：为什么大多数 Multi-Agent 框架不好用？

当前主流的多 Agent 框架（CrewAI、AutoGen、LangGraph）通常采用「自由对话」模式：

Agent A → "Hey, 你来处理这个"
Agent B → "好，我算一下"
Agent A → "结果是这样"

问题在于：

  • 不可控：Agent 之间聊什么你不知道
  • 不可复现：同样的输入，每次结果可能不同
  • 无法审计：不知道中间经历了什么
  • 难以干预：发现问题时已经晚了

解法：制度化协作

Edict 的思路是：「不要让他们自由发挥，而是要设计一套制度」。

三省六部制的核心是分权制衡：

皇上（用户） ↓ 下旨
太子（分拣） ↓ 传旨
中书省（规划） ↓ 提交审核
门下省（审议）← 可以封驳
尚书省（派发） ↓ 分配
六部（执行） ↓ 汇总
尚书省（回奏） ↓ 皇上（用户）

这条路线上，每一个环节都有明确的职责，不能越级沟通，必须经过审核。这就是制度。

架构详解

12 个 Agent 及其职责

部门Agent ID职责说明
太子taizi消息分拣判断是闲聊还是任务，闲聊直接回复，任务递交给中书省
中书省zhongshu规划中枢接旨后拆解为子任务，分配方案
门下省menxia审议把关审核中书省的方案，可以准奏或封驳（打回重做）
尚书省shangshu调度大脑派发任务，协调六部，汇总结果
户部hubu数据资源数据处理、报表、成本分析
礼部libu文档规范技术文档、API 文档
兵部bingbu工程实现代码开发、Bug 修复、代码审查
刑部xingbu安全合规安全扫描、合规检查
工部gongbu基础设施CI/CD、Docker、部署
吏部libu_hr人事管理Agent 注册、权限维护
早朝官zaochao
情报枢纽
每日新闻聚合、数据汇总

关键点：每个 Agent 有独立的 Workspace、独立的 Skills、可以独立配置 LLM 模型。

权限矩阵：严格的通信规则

不是谁想给谁发消息都可以。这张表定义了完整的权限：

From \ To    太子  中书   门下   尚书   户   礼   兵   刑   工   吏
太子          -     ✅     -      -      -   -   -   -   -   -
中书省        ✅     -     ✅     ✅     ✅   -   -   -   -   -
门下省        ✅     ✅     -     -      -   -   -   -   -   -
尚书省        ✅     ✅     ✅     -      ✅   ✅   ✅   ✅   ✅   ✅
六部 + 吏部   ✅     -     -     -      -   -   -   -   -   -
  • 太子只能->中书、门下
  • 中书->门下（必须审核）、尚书、户部
  • 门下只能->尚书
  • 尚书->所有六部 + 吏部
  • 六部之间、六部->其他部门（除尚书）均不可直接通信

这种设计避免了混乱的消息流，确保所有任务都经过审核。

任务状态机

待处理 → 中书规划中 → 门下审议中 → 已派发 → 执行中 → 待审查 → 已完成
↑ ↓ └── 封驳（打回重做） └── 阻塞 Blocked

9 种状态，每个状态转换都记录在案，形成完整的流转审计。

军机处看板：10 个功能面板

Edict 提供了一个名为「军机处」的 Web 看板（端口 7891），包含以下功能：

1. 旨意看板（Kanban）

任务按状态列展示，支持：

  • 省部过滤
  • 全文搜索
  • 心跳徽章（🟢活跃/🟡停滞/🔴告警）
  • 查看任务详情和完整流转链
  • 叫停 / 取消 / 恢复操作

2. 省部调度（Monitor）

  • 各状态任务数量可视化
  • 部门分布条形图
  • Agent 健康状态实时卡片

3. 奏折阁（Memorials）

  • 已完成任务自动归档
  • 五阶段时间线（圣旨→中书→门下→六部→回奏）
  • 一键复制为 Markdown

4. 旨库（Template Library）

9 个预设模板：周报生成、代码审查、API 设计、竞品分析、数据报告、博客文章、部署方案、邮件文案、站会摘要。

5. 官员总览（Officials）

  • Token 消耗排行榜
  • 活跃度、完成数、会话统计

6. 天下要闻（News）

  • 每日科技/财经资讯采集
  • 分类订阅 + 飞书推送

7-10. 其他功能

包括模型配置、技能配置、小任务监控、上朝仪式。

技术实现

后端：纯 Python 标准库

dashboard/server.py 基于 http.server，零依赖，同时提供 API 和静态文件服务。约 1200 行代码。

前端：React 18 + TypeScript + Vite + Zustand

13 个功能组件，完整的状态管理。Docker 镜像包含预构建版本。

数据同步

scripts/run_loop.sh 每 15 秒自动同步 OpenClaw 运行时数据到看板，显示倒计时。

Agent 配置

所有 Agent 的人格和工作流定义在 agents/<id>/SOUL.md，遵循 OpenClaw 的 SOUL.md 规范。

权限和路由

通过 openclaw.json 配置 Agent 之间的通信权限矩阵。Edict 的 install.sh 会自动写入这些配置。

与主流框架对比

特性CrewAIMetaGPTAutoGen三省六部
审核机制❌ 无⚠️ 可选⚠️ Human-in-loop✅ 专职门下省 · 可封驳
实时看板❌❌❌✅ Kanban + 时间线
任务干预❌❌❌✅ 叫停/取消/恢复
流转审计⚠️⚠️❌✅ 完整奏折存档
Agent 健康监控❌❌❌✅ 心跳 + 活跃度
热切换模型❌❌❌✅ 看板内一键切换
技能管理❌❌❌✅ 查看/添加 Skills
部署难度中高中低（Docker 一键）

核心差异：制度化 vs 自由协作。Edict 强调可观测、可干预、可审计。

快速体验

Docker（最快）

docker run -p 7891:7891 cft0808/edict

访问 http://localhost:7891。Docker 镜像包含预填充的演示数据。

注意：Windows 用户需要 WSL2 后端或 Docker Desktop with WSL2。

完整安装（需要 OpenClaw）

前置条件

  • OpenClaw 已安装并运行
  • Python 3.9+
  • Node.js 18+（可选，用于构建前端）
  • macOS 或 Linux（Windows 推荐 WSL2）

克隆并安装

git clone https://github.com/cft0808/edict.git
cd edict
chmod +x install.sh && ./install.sh

install.sh 会自动：

  • 创建 12 个 Agent 的 Workspace
  • 写入 SOUL.md（人格、工作流、数据清洗规则）
  • 注册 Agent 和权限矩阵到 openclaw.json
  • 构建 React 前端（如果有 Node.js）
  • 初始化数据目录
  • 重启 OpenClaw Gateway

启动服务

# 终端 1：数据刷新
bash scripts/run_loop.sh
# 终端 2：看板服务器
python3 dashboard/server.py

访问

http://localhost:7891

使用流程

1. 向 AI 下旨

通过 Feishu/Telegram/Signal 给中书省发送任务，例如：

帮我设计一个用户注册系统，要求：
1. RESTful API（FastAPI）
2. PostgreSQL 数据库
3. JWT 鉴权
4. 完整测试用例
5. 部署文档

2. 坐好，看戏

过程自动流转：

  1. 中书省：接旨，规划子任务分配方案
  2. 门下省：审议方案，通过或封驳（打回）
  3. 尚书省：准奏，派发给兵部 + 工部 + 礼部等
  4. 六部：并行执行，进度实时更新
  5. 尚书省：汇总结果，回奏给你

全程在军机处看板可视，随时可以叫停或调整。

3. 使用圣旨模板

看板 → 旨库 → 选择模板 → 填写参数 → 下旨。 适合标准化任务（周报、代码审查、API 设计等）。

4. 自定义 Agent

编辑 agents/<agent_id>/SOUL.md 即可修改人格、职责、输出规范。

5. 添加 Skills

方式一：看板 UI 看板 → 技能配置 → 添加远程 Skill → 输入 Agent、Skill 名称、GitHub URL → 确认

方式二：CLI

python3 scripts/skill_manager.py add-remote \
--agent zhongshu \
--name code_review \
--source https://raw.githubusercontent.com/openclaw-ai/skills-hub/main/code_review/Skill.md \
--description"代码审查技能"

方式三：API

curl -X POST http://localhost:7891/api/add-remote-skill \
-H"Content-Type: application/json" \
-d'{"agentId":"zhongshu","skillName":"code_review","sourceUrl":"...","description":"..."}'

官方 Skills Hub：https://github.com/openclaw-ai/skills-hub

项目结构

edict/
├── agents/           # 12 个 Agent 的人格模板
├── dashboard/        # 看板前端 + 后端服务器
├── scripts/          # 各种工具脚本（数据同步、技能管理、新闻采集等）
├── data/             # 运行时数据（gitignored）
├── docs/             # 详细文档
├── tests/            # 端到端测试（17 个断言）
├── install.sh        # 一键安装脚本
├── docker-compose.yml # Docker Compose 配置
└── README.md

文档资源

项目文档非常详细，强烈推荐阅读：

  1. 任务分发流转完整架构
    • 9500+ 字，必读
    • 详细讲解业务设计和技术实现
    • 9 大状态机、权限矩阵、4 阶段调度、Session JSONL 数据融合
    • 故障场景与恢复机制
  2. 远程 Skills 资源管理指南
    • 如何从 GitHub 添加 Skills
    • Skills 文件规范
    • 版本管理
  3. 快速上手指南
  4. ROADMAP.md
    • Phase 1 已完成（核心架构）
    • Phase 2 进行中（御批模式、功过簿、急递铺、国史馆）
    • Phase 3 规划（Docker Compose、移动端、ClawHub 上架）

真实案例

examples/ 目录包含完整的使用记录：

  • 竞品分析：分析 CrewAI vs AutoGen vs LangGraph
  • 代码审查：审查 FastAPI 安全性
  • 周报生成：工程团队周报

每个案例都包含：完整旨意 → 中书规划 → 门下审核 → 各部执行 → 最终奏折。

优缺点分析

✅ 优点

  1. 制度可靠：分权制衡 + 专职审核，输出质量可控
  2. 完全可观测：流转链完整记录，随时查看
  3. 实时干预：可以叫停、取消、恢复任务
  4. 架构清晰：Agent 职责明确，权限矩阵严格
  5. 部署简单：Docker 一键启动
  6. 生态完善：技能管理、新闻推送、模板库、看板一应俱全

⚠️ 注意点

  1. 依赖 OpenClaw：必须安装并运行 OpenClaw Gateway
  2. 平台限制：官方只支持 macOS/Linux，Windows 需 WSL2
  3. 学习成本：需要理解三省六部的概念和权限规则
  4. 灵活性较低：严格的通信限制可能不适合需要自由对话的场景
  5. 中文项目：文档和界面主要是中文，国际化有限

适用场景

Edict 适合：

  • 需要高质量、可审计输出的任务：技术方案设计、代码审查、安全评估
  • 企业环境：需要制度化管理、权限控制、流程追踪
  • 长期运行：作为团队工作流的一部分持续使用
  • 模型切换频繁：不同部门用不同 LLM（看板内一键切换）

不适合：

  • 创意型任务：需要 Agent 自由讨论、头脑风暴的场景
  • 快速原型：设置权限矩阵可能太重
  • 单次性任务：杀鸡用牛刀

结语

三省六部制在中国运行了 1400 年，从隋唐到清末，历经无数王朝更迭，证明了一套好的制度设计比自由发挥更稳定。

Edict 把这个思想移植到了 AI Agent 世界。它的价值不在于技术有多新颖，而在于用制度解决问题。

如果你受够了 Agent「聊完就忘、结果不可控」的状态，想体验一下有审核、有流程、可干预的多 Agent 协作，可以试试 Edict。

链接

  • GitHub: https://github.com/cft0808/edict
  • Demo: docker run -p 7891:7891 cft0808/edict
  • 文档: https://github.com/cft0808/edict/blob/main/docs/
  • OpenClaw: https://openclaw.ai
  • Skills Hub: https://github.com/openclaw-ai/skills-hub

目录

  1. 概述
  2. 核心设计思想
  3. 问题：为什么大多数 Multi-Agent 框架不好用？
  4. 解法：制度化协作
  5. 架构详解
  6. 12 个 Agent 及其职责
  7. 权限矩阵：严格的通信规则
  8. 任务状态机
  9. 军机处看板：10 个功能面板
  10. 1. 旨意看板（Kanban）
  11. 2. 省部调度（Monitor）
  12. 3. 奏折阁（Memorials）
  13. 4. 旨库（Template Library）
  14. 5. 官员总览（Officials）
  15. 6. 天下要闻（News）
  16. 7-10. 其他功能
  17. 技术实现
  18. 后端：纯 Python 标准库
  19. 前端：React 18 + TypeScript + Vite + Zustand
  20. 数据同步
  21. Agent 配置
  22. 权限和路由
  23. 与主流框架对比
  24. 快速体验
  25. Docker（最快）
  26. 完整安装（需要 OpenClaw）
  27. 前置条件
  28. 克隆并安装
  29. 启动服务
  30. 终端 1：数据刷新
  31. 终端 2：看板服务器
  32. 访问
  33. 使用流程
  34. 1. 向 AI 下旨
  35. 2. 坐好，看戏
  36. 3. 使用圣旨模板
  37. 4. 自定义 Agent
  38. 5. 添加 Skills
  39. 项目结构
  40. 文档资源
  41. 真实案例
  42. 优缺点分析
  43. ✅ 优点
  44. ⚠️ 注意点
  45. 适用场景
  46. 结语
  47. 链接

更多推荐文章

查看全部
  • Transformer 算法核心架构与原理详解
  • C++ 指针与引用核心面试题详解
  • 大模型部署实战：使用 AnythingLLM 本地化运行 LLM
  • CentOS 系统定时执行 Python 邮件发送的五种方案
  • C++ 基础语法复习
  • JDK 核心哈希容器源码深度解析：HashMap、LinkedHashMap 等
  • Cline 集成 DeepSeek：开源 AI 编程助手助力终端与 Web 开发
  • Spring Boot 日志全方位指南：从入门到高级配置
  • AI产品经理面试指南：高频问题与核心能力解析
  • 鸿蒙金融理财全栈项目：生态合作与用户运营优化
  • HashCalculator 文件哈希批量计算工具使用指南
  • Llama-3.2-3B 实战：利用 Ollama 快速生成营销文案
  • H.265 网页播放：WebAssembly + FFmpeg 实现浏览器端硬解/软解方案
  • CATE 条件平均处理效应估计：五大方法原理详解与模拟数据实战
  • AD 域环境搭建指南
  • 使用 Git 上传超过限制的大文件至 GitHub
  • 全栈分页方案：MyBatisPlus 后端与 Thymeleaf 前端整合
  • VS Code Copilot 完整使用指南：从入门到进阶
  • 动态规划专题：回文串问题与区间 DP
  • 一次搭好，到处复用：政务智能体工作流导出导入实录

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online