edict

---

🎬 Demo

🐳 没有 OpenClaw？ 跑一行 docker run -p 7891:7891 cft0808/edict 即可体验完整看板 Demo（预置模拟数据）。

---

🤔 为什么是三省六部？

大多数 Multi-Agent 框架的套路是：

"来，你们几个 AI 自己聊，聊完把结果给我。"

然后你拿到一坨不知道经过了什么处理的结果，无法复现，无法审计，无法干预。

三省六部的思路完全不同 —— 我们用了一个在中国存在 1400 年的制度架构：

你 (皇上) → 太子 (分拣) → 中书省 (规划) → 门下省 (审议) → 尚书省 (派发) → 六部 (执行) → 回奏

这不是花哨的 metaphor，这是真正的分权制衡：

	CrewAI	MetaGPT	AutoGen	三省六部
审核机制	❌ 无	⚠️ 可选	⚠️ Human-in-loop	✅ 门下省专职审核 · 可封驳
实时看板	❌	❌	❌	✅ 军机处 Kanban + 时间线
任务干预	❌	❌	❌	✅ 叫停 / 取消 / 恢复
流转审计	⚠️	⚠️	❌	✅ 完整奏折存档
Agent 健康监控	❌	❌	❌	✅ 心跳 + 活跃度检测
热切换模型	❌	❌	❌	✅ 看板内一键切换 LLM
技能管理	❌	❌	❌	✅ 查看 / 添加 Skills
新闻聚合推送	❌	❌	❌	✅ 天下要闻 + 飞书推送
部署难度	中	高	中	低 · 一键安装 / Docker

核心差异：制度性审核 + 完全可观测 + 实时可干预

CrewAI 和 AutoGen 的 Agent 协作模式是 "做完就交"——没有人检查产出质量。就像一个公司没有 QA 部门，工程师写完代码直接上线。

三省六部的 门下省 专门干这件事：

• 📋 审查方案质量 —— 中书省的规划是否完备？子任务拆解是否合理？
• 🚫 封驳不合格的产出 —— 不是 warning，是直接打回重做
• 🔄 强制返工循环 —— 直到方案达标才放行

这不是可选的插件——它是架构的一部分。每一个旨意都必须经过门下省，没有例外。

这就是为什么三省六部能处理复杂任务而结果可靠：因为在送到执行层之前，有一个强制的质量关卡。1300 年前唐太宗就想明白了——不受制约的权力必然会出错。

---

✨ 功能全景

🏛️ 十二部制 Agent 架构

• 太子 消息分拣 —— 闲聊自动回复，旨意才建任务
• 三省（中书·门下·尚书）负责规划、审议、派发
• 七部（户·礼·兵·刑·工·吏 + 早朝官）负责专项执行
• 严格的权限矩阵 —— 谁能给谁发消息，白纸黑字
• 状态流转校验 —— kanban_update.py 强制合法转换路径，非法状态跳转被拒绝
• 每个 Agent 独立 Workspace · 独立 Skills · 独立模型
• 旨意数据清洗 —— 标题/备注自动剥离文件路径、元数据、无效前缀

📋 军机处看板（10 个功能面板）

📋 旨意看板 · Kanban

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

🔭 省部调度 · Monitor

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

📜 奏折阁 · Memorials

• 已完成旨意自动归档为奏折
• 五阶段时间线：圣旨→中书→门下→六部→回奏
• 一键复制为 Markdown
• 按状态筛选

📜 旨库 · Template Library

• 9 个预设圣旨模板
• 分类筛选 · 参数表单 · 预估时间和费用
• 预览旨意 → 一键下旨

👥 官员总览 · Officials

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

📰 天下要闻 · News

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

⚙️ 模型配置 · Models

• 每个 Agent 独立切换 LLM
• 应用后自动重启 Gateway（~5秒生效）

🛠️ 技能配置 · Skills

• 各省部已安装 Skills 一览
• 查看详情 + 添加新技能

💬 小任务 · Sessions

• OC-* 会话实时监控
• 来源渠道 · 心跳 · 消息预览

🎬 上朝仪式 · Ceremony

• 每日首次打开播放开场动画
• 今日统计 · 3.5秒自动消失

🏛️ 朝堂议政 · Court Discussion

• 多官员围绕议题展开部门视角讨论
• LLM 驱动的多角色辩论（各部依职责发表专业意见）
• 支持多轮推进 · 总结结论 · 保留讨论记录

---

🖼️ 截图

旨意看板

省部调度

任务流转详情

模型配置

技能配置

官员总览

会话记录

奏折归档

圣旨模板

天下要闻

上朝仪式

---

🚀 30 秒快速体验

Docker 一键启动

docker run -p 7891:7891 cft0808/sansheng-demo

打开 http://localhost:7891 即可体验军机处看板。

如果你在 x86/amd64 机器（如 Ubuntu、WSL2）上看到：

exec /usr/local/bin/python3: exec format error

这是因为镜像架构不匹配。请使用 --platform 参数：

docker run --platform linux/amd64 -p 7891:7891 cft0808/sansheng-demo

或使用 docker-compose（已内置 platform: linux/amd64）：

docker compose up

完整安装

前置条件

• OpenClaw 已安装
• Python 3.10+
• macOS / Linux

安装

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

安装脚本自动完成：

• ✅ 创建全量 Agent Workspace（含太子/吏部/早朝，兼容历史 main）
• ✅ 写入各省部 SOUL.md（角色人格 + 工作流规则 + 数据清洗规范）
• ✅ 注册 Agent 及权限矩阵到 openclaw.json
• ✅ 符号链接统一数据（各 Workspace 的 data/scripts → 项目目录，确保数据一致）
• ✅ 设置 Agent 间通信可见性（sessions.visibility all，解决消息不可达问题）
• ✅ 同步 API Key 到所有 Agent（自动从已配置的 Agent 复制）
• ✅ 构建 React 前端（需 Node.js 18+，如未安装则跳过）
• ✅ 初始化数据目录 + 首次数据同步（含官员统计）
• ✅ 重启 Gateway 使配置生效

⚠️ 首次安装：需先配置 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 服务
sudo cp edict.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable edict
sudo systemctl start edict

# 或使用管理脚本
bash edict.sh start    # 启动
bash edict.sh status   # 查看状态
bash edict.sh restart  # 重启
bash edict.sh stop     # 停止

💡 看板即开即用：server.py 内嵌 dashboard/dashboard.html，Docker 镜像包含预构建的 React 前端

💡 详细教程请看 Getting Started 指南

---

🏛️ 架构

                           ┌───────────────────────────────────┐
                           │          👑 皇上（你）              │
                           │     Feishu · Telegram · Signal     │
                           └─────────────────┬─────────────────┘
                                             │ 下旨
                           ┌─────────────────▼─────────────────┐
                           │          � 太子 (taizi)            │
                           │    分拣：闲聊直接回 / 旨意建任务      │
                           └─────────────────┬─────────────────┘
                                             │ 传旨
                           ┌─────────────────▼─────────────────┐
                           │          📜 中书省 (zhongshu)       │
                           │       接旨 → 规划 → 拆解子任务       │
                           └─────────────────┬─────────────────┘
                                             │ 提交审核
                           ┌─────────────────▼─────────────────┐
                           │          🔍 门下省 (menxia)         │
                           │       审议方案 → 准奏 / 封驳 🚫      │
                           └─────────────────┬─────────────────┘
                                             │ 准奏 ✅
                           ┌─────────────────▼─────────────────┐
                           │          📮 尚书省 (shangshu)       │
                           │     派发任务 → 协调六部 → 汇总回奏    │
                           └───┬──────┬──────┬──────┬──────┬───┘
                               │      │      │      │      │
                         ┌─────▼┐ ┌───▼───┐ ┌▼─────┐ ┌───▼─┐ ┌▼─────┐
                         │💰 户部│ │📝 礼部│ │⚔️ 兵部│ │⚖️ 刑部│ │🔧 工部│
                         │ 数据  │ │ 文档  │ │ 工程  │ │ 合规  │ │ 基建  │
                         └──────┘ └──────┘ └──────┘ └─────┘ └──────┘
                                                               ┌──────┐
                                                               │📋 吏部│
                                                               │ 人事  │
                                                               └──────┘

各省部职责

部门	Agent ID	职责	擅长领域
� 太子	taizi	消息分拣、需求整理	闲聊识别、旨意提炼、标题概括
📜 中书省	zhongshu	接旨、规划、拆解	需求理解、任务分解、方案设计
🔍 门下省	menxia	审议、把关、封驳	质量评审、风险识别、标准把控
📮 尚书省	shangshu	派发、协调、汇总	任务调度、进度跟踪、结果整合
💰 户部	hubu	数据、资源、核算	数据处理、报表生成、成本分析
📝 礼部	libu	文档、规范、报告	技术文档、API 文档、规范制定
⚔️ 兵部	bingbu	代码、算法、巡检	功能开发、Bug 修复、代码审查
⚖️ 刑部	xingbu	安全、合规、审计	安全扫描、合规检查、红线管控
🔧 工部	gongbu	CI/CD、部署、工具	Docker 配置、流水线、自动化
📋 吏部	libu_hr	人事、Agent 管理	Agent 注册、权限维护、培训
🌅 早朝官	zaochao	每日早朝、新闻聚合	定时播报、数据汇总

权限矩阵

不是想发就能发 —— 真正的分权制衡

From ↓ \ To →	太子	中书	门下	尚书	户	礼	兵	刑	工	吏
太子	—	✅
中书省	✅	—	✅	✅
门下省		✅	—	✅
尚书省		✅	✅	—	✅	✅	✅	✅	✅	✅
六部+吏部				✅

任务状态流转

皇上 → 太子分拣 → 中书规划 → 门下审议 → 已派发 → 执行中 → 待审查 → ✅ 已完成
                      ↑          │                              │
                      └──── 封驳 ─┘                    阻塞 Blocked

⚡ 状态转换受保护：kanban_update.py 内置 _VALID_TRANSITIONS 状态机校验， 非法跳转（如 Doing→Taizi）会被拒绝并记录日志，确保流程不可绕过。

🔄 异步事件驱动：服务间通过 Redis Streams EventBus 解耦通信，Outbox Relay 保障事件可靠投递。 所有状态变更自动写入审计日志（audit.py），支持完整追溯。

---

📁 项目结构