Edict：用三省六部制编排多 Agent 协作的开源系统

项目地址：https://github.com/cft0808/edict  协议：MIT  Stars：16,898  更新：2026-09-07

一、产品深度介绍

（一）它是什么

Edict 的自我定位非常直接：用 1300 多年前的帝国制度，重新设计了 AI 多 Agent 协作架构。作者认为，古人比现代不少 AI 框架更懂分权制衡——于是把这套理念落地成一个可运行的开源系统。

整套系统由 12 个 AI Agent 组成，包含 11 个业务角色与 1 个兼容历史 main 的角色。它们被编排为「三省六部」：太子负责消息分拣，中书省负责规划与拆解，门下省负责审议与封驳，尚书省负责派发与汇总，户部、礼部、兵部、刑部、工部、吏部六个部门并行执行，另有早朝官负责每日聚合。每个 Agent 拥有独立的 Workspace、独立的 Skills 与独立的模型配置，彼此之间通过严格的权限矩阵通信，谁能给谁发消息白纸黑字写死。

官方在 README 中给出了一个清晰的对比：相比 CrewAI，Edict 多了一层「制度性审核」（门下省封驳）；相比 AutoGen，Edict 多了一个「实时看板」（军机处看板）。换句话说，它不是一个单纯的 Agent 调用库，而是一套带流程管控与可观测性的协作框架。

（二）技术表现

Edict 的技术栈刻意追求「轻依赖、强可观测」，关键亮点如下：

• React 18 前端：TypeScript + Vite + Zustand 状态管理，共 13 个功能组件，提供军机处实时看板。
• 纯标准库后端：server.py 基于 http.server 实现，零第三方依赖，同时提供 API 与静态文件服务。
• EventBus 事件总线：基于 Redis Streams 的发布/订阅，实现服务间解耦通信。
• Outbox Relay：采用事务性 Outbox 模式，保障事件至少一次可靠投递。
• 状态机审计：严格的生命周期状态转换，配合完整审计日志（audit.py）。
• 并行调度引擎：Dispatch Worker 支持并行执行、指数退避重试与资源锁。
• DAG 编排器：Orchestrator 基于有向无环图做任务分解与依赖解析。
• 15 秒同步：数据自动刷新，看板带倒计时显示。
• 看板鉴权：auth.py 提供登录认证。
• 一键安装 / 一键启动：install.sh 自动配置，start.sh 一条命令拉起全部服务。
• systemd 生产部署：提供 edict.service，支持开机自启守护进程。
• 远程 Skills 生态：可从 GitHub / URL 一键导入能力，支持版本管理与 CLI / API / UI 三种方式。

二、主要功能特点与应用场景

Edict 的能力可以归纳为「十二 Agent 分工 + 军机处看板 + 远程技能生态」三块。看板是整个系统可观测性的核心，官方文档称之为军机处看板，包含 10 个功能面板加一个实时活动面板：

• 旨意看板 Kanban：按状态列展示全部任务，支持省部过滤、全文搜索、心跳徽章，以及叫停 / 取消 / 恢复操作。
• 省部调度 Monitor：可视化各状态任务数量、部门分布条形图与 Agent 健康卡片。
• 奏折阁 Memorials：已完成旨意自动归档为奏折，提供圣旨→中书→门下→六部→回奏五阶段时间线。
• 旨库 Template Library：9 个预设圣旨模板，带参数表单、预估时间与费用。
• 官员总览 Officials：Token 消耗排行榜、活跃度、完成数与会话统计。
• 天下要闻 News：每日自动采集科技财经资讯，支持订阅管理与飞书推送。
• 模型配置 Models：每个 Agent 独立切换 LLM，应用后自动重启 Gateway（约 5 秒生效）。
• 技能配置 Skills：一览各省部已装 Skills，并可添加新技能。
• 小任务 Sessions：OC-* 会话实时监控，含来源渠道、心跳与消息预览。
• 上朝仪式 Ceremony：每日首次打开播放开场动画与今日统计。
• 朝堂议政 Court Discussion：多官员围绕议题展开部门视角讨论，由 LLM 驱动多角色辩论。

在应用场景上，它适合：希望把多个专职 AI Agent 组织成稳定流水线的团队；需要任务审批与全程审计留痕的合规场景；以及想通过实时看板观察 Agent 思考过程、工具调用与返回结果的开发者与研究者。用户通过飞书、Telegram、Signal 给中书省「下旨」，即可触发整套流程。

三、如何安装与使用

Edict 依赖 OpenClaw 运行，前置条件为：已安装 OpenClaw、Python 3.10+、macOS 或 Linux。标准安装流程如下：

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

安装脚本会自动创建全量 Agent Workspace、写入各省部 SOUL.md、注册 Agent 与权限矩阵、符号链接统一数据目录、设置 Agent 间通信可见性，并同步 API Key 到所有 Agent。首次安装需先配置 API Key（openclaw agents add taizi），再重新运行 ./install.sh 同步到全部 Agent。

启动有两种方式：

# 方式 1：一键启动（推荐）
chmod +x start.sh && ./start.sh

# 方式 2：分别启动
bash scripts/run_loop.sh &      # 数据刷新循环
python3 dashboard/server.py     # 看板服务器

# 浏览器打开
open http://127.0.0.1:7891

生产环境可用 systemd 部署：把 edict.service 复制到 /etc/systemd/system/，然后 enable 并 start；也可用管理脚本 bash edict.sh start/status/restart/stop 操作。看板服务器内嵌前端，Docker 镜像中包含预构建的 React 产物。

四、官方地址与获取方式

• GitHub 仓库：https://github.com/cft0808/edict
• 英文文档：仓库内 README_EN.md
• 日文文档：仓库内 README_JA.md
• 路线图：仓库内 ROADMAP.md
• 远程技能指南：docs/remote-skills-guide.md 与 docs/remote-skills-quickstart.md

项目以 MIT 协议开源，可直接 clone 源码部署；社区交流入口见 README 中的联系方式。Edict 依赖 OpenClaw 生态，使用前请先完成 OpenClaw 的初始化与 API Key 配置。

五、与同类方案对比

Edict 的差异化不在「能不能跑多 Agent」，而在于把「分权审核 + 流程管控 + 可视看板 + 审计留存」打包成开箱即用的制度层。如果你只想要一个轻量编排库，CrewAI / AutoGen 更轻；如果你想要可追溯、可审批、可观测的生产级协作，Edict 这类带「朝廷流程」的系统更合适。

六、核心机制深度解析

Edict 把一道「旨意」从下达到回奏拆成可被状态机校验的流水线。其底层由若干工程机制支撑：

• 权限矩阵：谁可以给谁发消息被显式声明，从机制上避免越权调用。
• 状态流转校验：kanban_update.py 强制合法转换路径，非法状态跳转被拒绝。
• 事件驱动：服务间通过 Redis Streams EventBus 解耦，Outbox Relay 保障事件可靠投递（至少一次语义）。
• 状态机审计：所有状态变更自动写入审计日志（audit.py），支持完整追溯。
• 并行调度与 DAG：Dispatch Worker 支持并行执行与指数退避重试，Orchestrator 用 DAG 解析任务依赖。
• 旨意数据清洗：标题与备注自动剥离文件路径、元数据与无效前缀。
• 防护机制：重复任务防护、已完成任务保护，避免重复派发与误改历史。

七、实用技巧

• 远程 Skills 一键导入：可在看板「技能配置」里添加远程 Skill，或用 CLI 从 GitHub 拉取，例如把 MiniMax 多模态 CLI 技能接入门下省；也支持 import-official-hub 批量导入默认技能。
• 模型热切换：看板「模型配置」里为每个 Agent 单独切 LLM，应用后 Gateway 约 5 秒自动重启生效，无需手动重启。
• 自定义 Skills Hub：通过环境变量 OPENCLAW_SKILLS_HUB_BASE 或 ~/.openclaw/skills-hub-url 指向自有源。
• 非标准 OpenClaw 路径：用 OPENCLAW_HOME 指定 OpenClaw 主目录，脚本会自动回退到 ~/.openclaw。
• 生产守护：用 edict.sh 管理脚本或 systemd 服务做开机自启与状态查看，比手动 nohup 更稳。

八、最新更新动态

Phase 1 — 核心架构（已全部完成 ✅）：包含十二部制 Agent 架构与权限矩阵、军机处实时看板（10 面板 + 实时活动）、任务叫停/取消/恢复、奏折系统与五阶段时间线、9 个圣旨模板、上朝仪式动画、天下要闻与飞书推送、模型热切换与技能管理、官员总览与 Token 统计、太子消息分拣、旨意数据清洗、重复任务防护、端到端测试（17 个断言）、React 18 前端重构，以及前后端一体化部署。

Phase 2 — 制度深化（进行中 🚧）：功过簿、EventBus、Outbox Relay、状态机审计、并行调度引擎、DAG 编排器、看板鉴权、一键启动与 systemd 部署已标记完成；御批模式（人工审批）、急递铺（Agent 间实时消息流可视化）、国史馆（知识库检索与引用溯源）仍在推进。

Phase 3 — 生态扩展：规划了 Docker Compose + Demo 镜像、Notion / Linear 适配器、年度大考、移动端 PWA 与 ClawHub 上架。

九、常见问题 FAQ

十、总结

Edict 的巧思在于：它没有发明新的 Agent 协议，而是把一种已经运行了上千年的「分权制衡」组织智慧，映射成可执行的 AI 协作架构。太子分拣、三省审议封驳、六部并行执行，再用军机处看板把全过程可视化、用状态机与审计日志把每一步留痕。对于想要「可追溯、可审批、可观测」的多 Agent 生产系统，这种带制度层的编排思路，比单纯把几个 Agent 串成对话更有韧性。如果你正在评估 CrewAI / AutoGen 之外的另一种范式，Edict 值得 clone 下来跑一遍。

在撰写本文的过程中，我主要参考了 Edict GitHub 仓库（cft0808/edict）的 README.md、README_EN.md、ROADMAP.md 与 docs 目录下的远程技能指南，以及 GitHub API 返回的公开仓库元数据。文中数据以官方公开信息为准，可能随版本更新而变化。