838997125/tang-political-system

⚔️ 大唐政治体制 · Tang Political System

基于三省六部架构的 AI 多 Agent 协作系统 · Windows 优化版

10 个 AI Agent 组成三省六部：中书省分拣规划、门下省审核封驳、尚书省派发、六部+吏部并行执行。比 CrewAI 多一层制度性审核，比 AutoGen 多一个实时看板。

本项目基于 cft0808/edict (三省六部) 修改，专注于 Windows 兼容性优化

🏛️ 架构 · 📋 看板功能 · 📚 架构文档 · English · 参与贡献

📖 推荐优先阅读： 项目背景介绍 (中文) · Project Background (English)

---

📖 项目背景介绍（推荐阅读）

首次使用本项目？建议先阅读背景文档，了解设计理念和历史渊源。

核心观点：我们将中国唐代（618-907年）延续1400年的三省六部制政治体制，转化为现代AI多智能体协作系统的治理框架。这不是简单的文化包装，而是对分权制衡、层层把关、流程化治理这一古老智慧的现代化演绎。

---

🤔 为什么是三省六部？

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

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

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

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

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

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

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

---

✨ 功能全景

🏛️ 十部制 Agent 架构

• 三省（中书·门下·尚书）负责规划、审议、派发
• 七部（户·礼·兵·刑·工·吏 + 早朝官）负责专项执行
• 严格的权限矩阵 —— 谁能给谁发消息，白纸黑字
• 每个 Agent 独立 Workspace · 独立 Skills · 独立模型
• 旨意数据清洗 —— 标题/备注自动剥离文件路径、元数据、无效前缀

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

---

🖼️ 截图

旨意看板

---

🚀 快速部署

🤖 方式一：让龙虾帮你部署（推荐，最简单）

---

🔗 与现有 Agent 集成

如果你已有 OpenClaw Agent（如 main），可以通过激活词与 Tang Political System 集成：

在 main 的 SOUL.md 中添加：

## Tang Political System 激活规则

### 皇帝专属（转发给 zhongshu）
激活词：朕、圣旨、下旨、传旨、口谕

### 部门直调（转发给对应部门）
中书省、门下省、尚书省、户部、礼部、兵部、刑部、工部、吏部、早朝官

### 功能直达
军机处/看板、奏折、上朝、退朝

### 快捷指令
宣 + 部门名

配置权限：

"main": {
  "subagents": {
    "allowAgents": ["emperor",
            "zhongshu",
            "menxia",
            "shangshu",
            "hubu",
            "libu",
            "bingbu",
            "xingbu",
            "gongbu",
            "libu_hr",
            "zaochao"]
  }
}

工作流程：

用户消息 → main 检测激活词 → 转发给 zhongshu → 中书省规划 → 六部执行

示例：

• "朕要做一个竞品分析" → main → zhongshu → 三省六部流程
• "普通消息" → main 直接处理

---

🧠 智能 Agent 配置（自动检测）

install.ps1 脚本会自动检测你的 OpenClaw 配置，并智能集成 Tang Political System：

单 Agent 配置

场景： 你的 OpenClaw 只有 0 或 1 个 agent

脚本行为：

1. 创建 main agent（如果不存在）
2. Workspace 指向你的默认工作空间（agents.defaults.workspace）
3. AgentDir 指向 $OC_HOME\agents\main\agent
4. 配置权限：

   {
     "id": "main",
     "workspace": "C:\\Users\\\\.openclaw\\workspace",
     "agentDir": "C:\\Users\\\\.openclaw\\agents\\main\\agent",
     "subagents": {
       "allowAgents": ["emperor",
               "zhongshu",
               "menxia",
               "shangshu",
               "hubu",
               "libu",
               "bingbu",
               "xingbu",
               "gongbu",
               "libu_hr",
               "zaochao"]
     }
   }
   

5. 写入 SOUL.md： 自动添加 Tang Political System 激活规则

优势： 保持你现有的 workspace 和配置，零迁移成本

多 Agent 配置

场景： 你的 OpenClaw 已有多个 agents

脚本行为：

1. 选择第一个 agent 作为 Tang Political System 的入口
2. 添加调用权限：

   {
     "subagents": {
       "allowAgents": ["emperor",
               "zhongshu",
               "menxia",
               "shangshu",
               "hubu",
               "libu",
               "bingbu",
               "xingbu",
               "gongbu",
               "libu_hr",
               "zaochao"]
     }
   }
   

3. 更新 SOUL.md： 在第一个 agent 的 SOUL.md 中追加激活规则

优势： 不破坏现有 agents，只增强第一个 agent 的能力

配置检测逻辑

# 脚本内部逻辑
$agentsList = $cfg.agents.list
$agentCount = $agentsList.Count

if ($agentCount -le 1) {
    # 单 Agent 模式
    $ConfigMode = "SINGLE"
    # 创建或配置 main agent
} else {
    # 多 Agent 模式
    $ConfigMode = "MULTI"
    # 配置第一个 agent
}

Tang Political System 激活规则

安装完成后，你的 main/第一个 agent 会自动获得以下能力：

---

📦 方式二：手动安装

• Windows 10/11 (64位)
• Python 3.9+ ⚠️ 安装时勾选 “Add Python to PATH”
• Node.js 18+ (可选，用于构建前端)
• OpenClaw CLI 已安装并初始化 (安装指南)
• PowerShell 5.1+ 或 PowerShell 7+

安装依赖

# 安装 Python 依赖
pip install psutil

注意：文档中的 `` 表示你下载项目的目录路径，请根据实际路径替换。 例如：D:\tools\Tang-Political-System 或 C:\Users\YourName\Projects\Tang-Political-System

运行安装脚本

💡 提示：`` 是你克隆项目的目录，例如 D:\tools\Tang-Political-System 或 C:\Users\YourName\Projects\Tang-Political-System

直接使用 PowerShell

# 进入项目目录（将  替换为你的实际路径）
cd 

# 执行安装脚本（需要管理员权限）
.\install.ps1

安装脚本自动完成：

• ✅ 创建 10 个 Agent Workspace（三省/六部/吏部/早朝官）
• ✅ 写入各省部 SOUL.md（角色人格 + 工作流规则）
• ✅ 注册 Agent 及权限矩阵到 openclaw.json
• ✅ 初始化数据目录
• ✅ 执行首次数据同步
• ✅ 重启 Gateway

启动系统

💡 提示：以下命令需要在项目目录 `` 中执行

方式一：后台启动（推荐）

使用 scripts\start-background.ps1 脚本在后台启动所有服务，不占用前台窗口：

# 进入项目目录
cd 

# 后台启动所有服务
.\start_server.ps1

# 查看日志
Get-Content logs\dashboard_server.log -Tail 20

# 停止所有服务
.\stop_server.ps1

方式二：分别启动

如果需要分别控制两个服务，可以手动启动：

# 进入项目目录
cd 

# 终端 1：启动数据刷新循环（保持运行）
.\scripts\run_loop.ps1

# 终端 2：启动看板服务器（保持运行）
python dashboard\server.py

访问看板

启动成功后，打开浏览器访问：http://127.0.0.1:7891

如果端口 7891 被占用，可以在 .env 文件中修改 DASHBOARD_PORT

⚠️ 故障排查

📖 查看完整故障排查指南

卸载

如需卸载 Tang Political System：

# 运行卸载脚本
.\uninstall.ps1

# 或使用参数
.\uninstall.ps1 -Force         # 跳过确认提示
.\uninstall.ps1 -KeepBackup    # 保留备份文件

卸载脚本会：

• 从 openclaw.json 中移除添加的 10 个 Agent
• 可选择恢复安装前的配置备份
• 删除工作空间目录
• 重启 Gateway

更多 Windows 安装细节请看 Windows 安装指南。

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

💡 详细教程请看 Getting Started 指南

---

🏛️ 架构

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

各省部职责

权限矩阵

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

权限说明：

• 中书省：唯一调度中枢，可提交门下省审议，可直接派发尚书省执行
• 门下省：审议后准奏→派发尚书省执行，封驳→返回中书省重规划
• 尚书省：可协调六部执行，封驳时可返回门下省，完成后回传中书省
• 六部+吏部：仅可回传尚书省，不可跨部门直接通信

任务状态流转

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

---

📁 项目结构

edict/
├── agents/                     # 9 个 Agent 的人格模板
│   ├── zhongshu/SOUL.md        # 中书省 · 规划中枢
│   ├── menxia/SOUL.md          # 门下省 · 审议把关
│   ├── shangshu/SOUL.md        # 尚书省 · 调度大脑
│   ├── hubu/SOUL.md            # 户部 · 数据资源
│   ├── libu/SOUL.md            # 礼部 · 文档规范
│   ├── bingbu/SOUL.md          # 兵部 · 工程实现
│   ├── xingbu/SOUL.md          # 刑部 · 合规审计
│   ├── gongbu/SOUL.md          # 工部 · 基础设施
│   ├── libu_hr/                # 吏部 · 人事管理
│   └── zaochao/SOUL.md         # 早朝官 · 情报枢纽
├── dashboard/
│   ├── dashboard.html          # 军机处看板（单文件 · 零依赖 · ~2500 行）
│   ├── dist/                   # React 前端构建产物（Docker 镜像内包含，本地可选）
│   └── server.py               # API 服务器（Python 标准库 · 零依赖 · ~1200 行）
├── scripts/
│   ├── run_loop.sh             # 数据刷新循环（每 15 秒）
│   ├── kanban_update.py        # 看板 CLI（含旨意数据清洗 + 标题校验）
│   ├── skill_manager.py        # Skill 管理工具（远程/本地 Skills 添加、更新、移除）
│   ├── sync_from_openclaw_runtime.py
│   ├── sync_agent_config.py
│   ├── sync_officials_stats.py
│   ├── fetch_morning_news.py
│   ├── refresh_live_data.py
│   ├── apply_model_changes.py
│   └── file_lock.py            # 文件锁（防多 Agent 并发写入）
├── tests/
│   └── test_e2e_kanban.py      # 端到端测试（17 个断言）
├── data/                       # 运行时数据（gitignored）
├── docs/
│   ├── task-dispatch-architecture.md  # 📚 详细架构文档：任务分发、流转、调度的完整设计（业务+技术）
│   ├── getting-started.md             # 快速上手指南
│   ├── wechat-article.md              # 微信文章
│   └── screenshots/                   # 功能截图（11 张）
├── install.sh                  # 一键安装脚本
├── CONTRIBUTING.md             # 贡献指南
└── LICENSE                     # MIT License

---

🎯 使用方法

向 AI 下旨

通过 Feishu / Telegram / Signal 给中书省发消息：

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

然后坐好，看戏：

1. 📜 中书省接旨，规划子任务分配方案
2. 🔍 门下省审议，通过 / 封驳打回重规划
3. 📮 尚书省准奏，派发给兵部 + 工部 + 礼部
4. ⚔️ 各部并行执行，进度实时可见
5. 📮 尚书省汇总结果，回奏给你

全程可在军机处看板实时监控，随时可以叫停、取消、恢复。

使用圣旨模板

看板 → 📜 旨库 → 选模板 → 填参数 → 下旨

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

自定义 Agent

编辑 agents//SOUL.md 即可修改 Agent 的人格、职责和输出规范。

增补 Skills（从网上连接）

三种方式添加 Skills：

1️⃣ 看板 UI（最简单）

看板 → 🔧 技能配置 → ➕ 添加远程 Skill
→ 输入 Agent + Skill 名称 + GitHub URL
→ 确认 → ✅ 完成

2️⃣ CLI 命令（最灵活）

# 从 GitHub 添加 code_review skill 到中书省
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 "代码审查技能"

# 一键导入官方 skills 库到指定 agents
python3 scripts/skill_manager.py import-official-hub \
  --agents zhongshu,menxia,shangshu,bingbu,xingbu

# 列出所有已添加的远程 skills
python3 scripts/skill_manager.py list-remote

# 更新某个 skill 到最新版本
python3 scripts/skill_manager.py update-remote \
  --agent zhongshu \
  --name code_review

3️⃣ API 请求（自动化集成）

# 添加远程 skill
curl -X POST http://localhost:7891/api/add-remote-skill \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "zhongshu",
    "skillName": "code_review",
    "sourceUrl": "https://raw.githubusercontent.com/...",
    "description": "代码审查"
  }'

# 查看所有远程 skills
curl http://localhost:7891/api/remote-skills-list

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

支持的 Skills：

• code_review — 代码审查（Python/JS/Go）
• api_design — API 设计审查
• security_audit — 安全审计
• data_analysis — 数据分析
• doc_generation — 文档生成
• test_framework — 测试框架设计

详见 🎓 远程 Skills 资源管理指南

---

🔧 技术亮点

---

� 深入了解

核心文档

• 📖 任务分发流转完整架构 — 必读文档

  • 详细讲解三省六部如何处理复杂任务的业务设计和技术实现
  • 涵盖：9大任务状态机 / 权限矩阵 / 4阶段调度（重试→升级→回滚）/ Session JSONL数据融合
  • 包含完整的使用案例、API端点说明、CLI工具文档
  • 对标 CrewAI/AutoGen：为什么制度化>自由协作
  • 故障场景与恢复机制
  • 读这个文档会理解为什么三省六部这么强大（9500+ 字，30 分钟完整理解）

• 🎓 远程 Skills 资源管理指南 — Skills 生态

  • 从网上连接和增补 skills，支持 GitHub/Gitee/任意 HTTPS URL
  • 官方 Skills Hub 预设能力库
  • CLI 工具 + 看板 UI + Restful API
  • Skills 文件规范与安全防护
  • 支持版本管理和一键更新

• ⚡ Remote Skills 快速入门 — 5 分钟上手

  • 快速体验、CLI 命令、看板操作示例
  • 创建自己的 Skills 库
  • API 完整参考 + 常见问题

• 🚀 快速上手指南 — 新手入门

• 🤝 贡献指南 — 想参与贡献？从这里开始

---

🔧 常见问题排查

---

�🗺️ Roadmap

完整路线图及参与方式：ROADMAP.md

Phase 1 — 核心架构 ✅

• [x] 十部制 Agent 架构（中书省/门下省/尚书省 + 六部 + 吏部 + 早朝官）+ 权限矩阵
• [x] 军机处实时看板（10 个功能面板 + 实时活动面板）
• [x] 任务叫停 / 取消 / 恢复
• [x] 奏折系统（自动归档 + 五阶段时间线）
• [x] 圣旨模板库（9 个预设 + 参数表单）
• [x] 上朝仪式感动画
• [x] 天下要闻 + 飞书推送 + 订阅管理
• [x] 模型热切换 + 技能管理 + 技能添加
• [x] 官员总览 + Token 消耗统计
• [x] 小任务 / 会话监控
• [x] 中书省消息分拣（闲聊自动回复 / 旨意建任务）
• [x] 旨意数据清洗（路径/元数据/前缀自动剥离）
• [x] 重复任务防护 + 已完成任务保护
• [x] 端到端测试覆盖（17 个断言）
• [x] React 18 前端重构（TypeScript + Vite + Zustand · 13 组件）
• [x] Agent 思考过程可视化（实时 thinking / 工具调用 / 返回结果）
• [x] 前后端一体化部署（server.py 同时提供 API + 静态文件服务）

Phase 2 — 制度深化 🚧

• [ ] 御批模式（人工审批 + 一键准奏/封驳）
• [ ] 功过簿（Agent 绩效评分体系）
• [ ] 急递铺（Agent 间实时消息流可视化）
• [ ] 国史馆（知识库检索 + 引用溯源）

Phase 3 — 生态扩展

• [ ] Docker Compose + Demo 镜像
• [ ] Notion / Linear 适配器
• [ ] 年度大考（Agent 年度绩效报告）
• [ ] 移动端适配 + PWA
• [ ] ClawHub 上架

---

📂 案例

examples/ 目录收录了真实的端到端使用案例：

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

---

📚 文档索引

---

📜 项目来源

Tang Political System (大唐政治体制) 是基于 cft0808/edict (三省六部) 的衍生项目，专注于 Windows 系统兼容性优化和权限矩阵改进。

主要修改

• ✅ Windows 系统兼容性修复（文件锁、进程检测、安装脚本）
• ✅ Agent 权限矩阵优化（收紧门下省权限，强化中书省调度中枢地位）
• ✅ 移除太子角色，简化架构为 10 个 Agent
• ✅ 文档整理和合并

本项目

• GitHub: https://github.com/838997125/Tang-Political-System
• 作者: 838997125
• 许可证: MIT

原始项目

• GitHub: https://github.com/cft0808/edict
• 作者: cft0808
• 许可证: MIT

💡 Linux / macOS 用户: 直接使用原始项目 cft0808/edict 以获得完整体验。

---

📄 License

MIT · 本项目: 838997125/Tang-Political-System · 基于 cft0808/edict 修改

---

⚔️ 以古制御新技，以智慧驾驭 AI Governing AI with the wisdom of ancient empires