三省六部制工作流 - harness

eff8888/chinese_flow_v1

1 Stars 116 次浏览 eff8888 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "chinese-flow": {
      "args": [
        "-m",
        "mcp_server.server"
      ],
      "command": "python",
      "description": "Three Departments Six Ministries workflow MCP server",
      "disabled": false,
      "env": {
        "PYTHONPATH": "/absolute/path/to/chinese-flow"
      }
    }
  }
}

服务介绍

三省六部制工作流（chinese-flow）MCP 服务器

简介

这是一个完整的三省六部制 AI 协作工作流 MCP（Model Context Protocol）服务器包。

三省六部制是一个基于中国古代官制设计的 AI 任务协同执行框架，通过 14 个独立的部门角色（皇帝、宰相、六部、三省、翰林院等）的协作、审核、制衡机制，确保复杂任务的有序执行、质量可控、全程可追溯。

设计目标：零配置、支持 WorkBuddy + OpenCode 双平台、一键部署。

下载地址

https://gitee.com/eff8888/chinese_flow

核心理念

多角色分工：14 个独立部门各司其职，相互制衡
完整审计链：每一步操作都有历史记录，不可篡改
回退机制：任何阶段发现问题，可按预设规则回退
评分体系：16x16 部门间交叉评分矩阵，量化协作质量
知识沉淀：翰林院知识图谱自动累积经验，越用越聪明

快速开始

前置条件

Python 3.8+
pip install mcp pydantic

方式一：一键部署（推荐）

# 进入项目目录
cd chinese-flow

# 部署到 WorkBuddy
python deploy.py -t workbuddy

# 或部署到 OpenCode
python deploy.py -t opencode

# 或同时部署到两者
python deploy.py -t all

方式二：手动 MCP 配置

在 ~/.workbuddy/mcp.json（WorkBuddy）或 .vscode/mcp.json（OpenCode）中添加：

{
  "mcpServers": {
    "chinese-flow": {
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "env": { "PYTHONPATH": "/path/to/chinese-flow" },
      "description": "三省六部制工作流MCP服务",
      "disabled": false
    }
  }
}

目录结构

chinese-flow/
├── LICENSE                   # MIT 开源协议
├── README.md                 # 本文件
├── DEPLOYMENT.md             # 详细部署文档
├── deploy.py                 # 一键部署脚本
├── mcp_server/
│   ├── server.py             # 主服务器（MCP 工具注册）
│   ├── flow_guard.py         # FlowGuard 流程守卫
│   ├── flow_state.py         # 状态机持久化
│   ├── flow_models.py        # 数据模型
│   ├── flow_history.py       # 历史事件追溯
│   ├── mcp_extensions.py     # 权限/路由/评分矩阵
│   ├── hanlin_academy.py     # 翰林院知识管理
│   ├── eea_engine.py         # 隐式执行记忆链
│   ├── requirements.txt      # Python 依赖
│   └── data/
│       └── hanlin_kg.json    # 知识图谱
├── opencode_template/
│   ├── opencode.json         # OpenCode 项目配置
│   ├── mcp.json              # MCP 配置模板
│   └── agents/               # Agent 角色定义
│       ├── emperor.md        # 皇帝
│       ├── prime_minister.md # 宰相
│       └── ...               # 其他部门
├── workflow_data/            # 工作流运行时数据
├── flow_history/             # 历史事件存储
└── core_data/                # 核心运行时数据

MCP 工具列表

系统提供 3 个 MCP 工具入口 + 30+ 个内部函数：

公开 MCP 工具

工具名	说明
`workflow_get_department`	获取部门职责信息
`workflow_desc`	查询函数目录
`workflow_dispatch`	统一函数调用入口
`workflow_set_route`	设置路由流程
`workflow_receive_decree`	部门领旨

内部函数（通过 `workflow_dispatch` 调用）

分类	函数
流程管理	`workflow_flow_init`, `workflow_flow_advance`, `workflow_flow_state`, `workflow_flow_complete`, `workflow_process`
路由管理	`workflow_get_next_dept`, `workflow_mark_step_complete`, `workflow_get_route_status`, `workflow_trigger_fallback`, `workflow_get_route_history`
评分矩阵	`workflow_submit_matrix_score`, `workflow_get_score_matrix`, `workflow_get_score_summary`
翰林院	`hanlin_list_knowledge`, `hanlin_request_knowledge`, `hanlin_store_decree`
小黑板	`prime_blackboard_read`, `prime_blackboard_write`, `prime_blackboard_write_update`, `prime_blackboard_delete`, `prime_blackboard_clear`
圣旨	`workflow_issue_decree`, `workflow_get_decree`, `workflow_imperial_decree`
工作流哲学	`get_workflow_philosophy`
元指令	`get_meta_instructions`
帮助	`workflow_help`

标准工作流（16 步）

皇帝 → 翰林院(Phase 0) → 宰相 → 尚书省 → 中书省 → 门下省
→ 礼部(预评估) → 刑部 → 吏部 → 工部 → 兵部 → 户部
→ 史官 → 翰林院_沉淀(知识沉淀) → 礼部(终评) → 皇帝(终审)

也支持简化的 7 步流程（simple_fix）：皇帝 → 宰相 → 工部 → 兵部 → 户部 → 史官 → 皇帝

环境变量

变量名	说明	默认值
`CHINESE_FLOW_FLOW_DATA_DIR`	流程状态数据目录	`{project}/mcp_server/flow_data`
`CHINESE_FLOW_REPORT_DIR`	报告输出目录	`{project}/agent_work`
`CHINESE_FLOW_BASE_DATA_DIR`	工作流数据目录	`{project}/workflow_data`
`CHINESE_FLOW_KG_FILE`	知识图谱文件路径	`{project}/mcp_server/data/hanlin_kg.json`
`CHINESE_FLOW_EEA_DIR`	EEA 引擎数据目录	`{project}/mcp_server/eea`

授权信息

开源协议: MIT License — 详见 LICENSE（英文）和 LICENSE_CN（中英双语）

技术特性

✅ 双平台支持（WorkBuddy + OpenCode）
✅ 无敏感数据（已移除所有 API Key、本地绝对路径、内部项目名称）
✅ 自动路径适配（部署脚本自动配置 PYTHONPATH）
✅ AST 安全求值器（禁止 eval/exec，防注入）
✅ 崩溃恢复（JSON 快照 + WAL 写前日志 + 检查点）
✅ 防篡改校验（SHA-256 checksum）
✅ 可配置路径（所有路径通过环境变量可覆盖）
✅ MIT 开源协议

许可证

本项目基于 MIT 许可证开源。详见 LICENSE 文件。

版本: v1.1 | 基于三省六部制工作流架构

查看源码项目主页