多范式决策引擎 · 可视化工作台

一个把多种计算/决策范式连成「可编排系统」的 Python 引擎，提供 Tkinter 桌面工作台 与 React + react-flow Web 编排编辑器 两种前端界面。所有范式由同一份 config.json 驱动，并通过编排层（事件总线 + 声明式绑定）协同工作。

特性

• 多范式引擎（纯标准库实现，零第三方依赖）：
  • 状态机 FSM / 层次状态机 HSM（嵌套子状态 · 历史 · 内部转移 · 声明式 Guard）
  • 行为树 Behavior Tree（Selector / Sequence / Parallel / 装饰器 / 服务节点）
  • 决策树 Decision Tree
  • 差分机 Difference Engine（巴贝奇有限差分 + 状态差量 / 响应式脏检查）
  • Petri 网 Petri Net（含抑制弧、优先级）
  • 马尔可夫链 Markov Chain
  • 规则引擎 Rule Engine（Rete 风格前向链 + 生产规则）
  • 决策表 Decision Table
  • LLM 智能体 LLM Agent（local / 可接后端）
• 编排层：事件总线（* 通配订阅）+ 声明式绑定（when 事件 → then 动作）， 把独立引擎连成系统，也是后续接入 LLM 的底座。
• 两种界面：
  • main.py —— Tkinter 可视化工作台（每个范式一个 Tab）。
  • web/server.py + web/webui —— React + @xyflow/react 编排可视化编辑器， 支持拖拽建节点、连线建绑定、单步驱动、运行轨迹，并持久化到 web/orchestrations.json。

目录结构

zhuangtaiji/
├── config.json              # 所有引擎与 demo 编排的配置（单一数据源）
├── main.py                  # Tkinter 工作台入口
├── CHANGELOG.md             # 版本更新日志（与注解 tag / Gitee Release 同源）
├── core/                    # 引擎内核（纯标准库）
│   ├── state_machine.py / hierarchical_state_machine.py
│   ├── behavior_tree.py / decision_tree.py / difference_engine.py
│   ├── petri_net.py / markov_chain.py / rule_engine.py
│   ├── engine_base.py       # Engine / EngineEvent / Graph 等契约
│   ├── engine_adapters.py   # 各引擎 -> 统一 Engine 接口
│   ├── orchestrator.py      # 事件总线 + Orchestrator（编排层）
│   ├── config.py            # 配置加载 + 分层 patches 叠加
│   ├── registries.py        # 守卫 / 动作 / 引擎 / 插件注册表（由内核 Context 承载）
│   ├── analysis.py / renderers.py / plugin.py / adapters_io.py
│   ├── plugins/             # 以插件形态接入的范式（decision_table / llm_agent）
│   ├── kernel/              # 内核：Context / effect / inject / 事件派发 / 分层装配
│   │   ├── context.py / disposable.py / events.py / loader.py / registry.py
│   │   └── fiber_model.json # 内核生命周期的自模型（用本项目状态机格式书写）
│   └── __init__.py          # 统一导出
├── ui/                      # Tkinter 工作台（入口 + 各功能 Tab）
│   ├── application.py / analysis_tab.py / visualization_tab.py
│   └── orchestrator_tab.py / plugin_tab.py
├── engine/
│   └── progress_bar.py      # Canvas 进度条组件（tkinter 延迟导入，便于无头测试）
├── tools/
│   ├── run_tests.py         # 测试与门禁统一入口
│   ├── kernel_demo.py       # 内核能力演示（七个真实痛点）
│   └── build_doc.mjs        # 方案文档构建：md → html（依赖 marked）
├── web/
│   ├── server.py            # 标准库 http.server 的 REST 后端 + 静态托管
│   ├── static/              # 兜底静态页（dist 缺失时使用）
│   ├── orchestrations.json  # 用户持久化的编排（自动生成，可删；不入库）
│   └── webui/               # 真正的 Vite + React + @xyflow/react 前端
│       ├── index.html / package.json / vite.config.js
│       ├── src/{main.jsx, App.jsx, EngineNode.jsx, api.js, index.css}
│       └── dist/            # npm run build 产物（由 server.py 托管；不入库）
├── test/                    # 全部测试（统一入口：python tools/run_tests.py）
│   ├── test_verify.py / test_enhancements.py / test_kernel.py
│   └── test_config_patches.py / test_ui_smoke.py / test_web_e2e.py
└── zhuangtaiji-Cordis内核重构方案.md   # 内核重构方案（同名 .html 由 build_doc.mjs 生成）

安装

Python 端

仅需 Python 3.8+ 标准库（tkinter 在 Windows 自带；Linux 需额外安装 python3-tk）。 无需 pip install 任何第三方包：

# 可选：确认依赖（项目本身无第三方依赖）
pip install -r requirements.txt

前端（Web 编辑器）

cd web/webui
npm install      # 安装 React / @xyflow/react / vite
npm run build    # 产出 dist/（server.py 直接托管）

运行

1. Tkinter 工作台

python main.py

2. Web 编排编辑器

# 确保已执行上述 npm run build
python web/server.py 8011
# 浏览器打开 http://localhost:8011/

8011 是本项目登记的端口（8000 已被电台面板占用）；也可显式换端口： python web/server.py <port>。

安全默认（2026-09-24 起）：服务默认只绑定 127.0.0.1（仅本机可访问）。 该服务没有鉴权且响应头 Access-Control-Allow-Origin: *，因此不要把它暴露到局域网/公网—— 否则同网段任何人都能读写删你的编排（PUT/DELETE/POST /api/orchestration/*）。 确有需要时显式打开并自担风险：python web/server.py 8011 --host 0.0.0.0 （等价的 ZHUANGTAIJI_HOST=0.0.0.0），并自行加防火墙或反向代理鉴权。

Web 端点的首页优先服务 web/webui/dist，缺失时回退 web/static。

3. 前端热更新开发模式（可选）

cd web/webui
npm run dev       # Vite dev server，默认 http://localhost:5173/

编排 REST API（web/server.py）

测试

推荐使用统一入口（自动处理导入路径，并把「环境缺依赖」与「代码失败」区分开）：

python tools/run_tests.py            # 跑全部测试
python tools/run_tests.py --list     # 只列出会被执行的测试
python tools/run_tests.py --verbose  # 打印每个测试的完整输出
python tools/run_tests.py kernel     # 只跑名字含 "kernel" 的测试

退出码 0 表示通过；ENV-SKIP 表示前置条件未就绪（缺 tkinter、缺前端 dist/ 等）， 不计为失败但会在汇总里显著提示。

也可以单独运行（需在项目根目录并设置 PYTHONPATH=.）：

PYTHONPATH=. python test/test_verify.py        # 原始功能回归
PYTHONPATH=. python test/test_enhancements.py  # P0~P3 增强覆盖
PYTHONPATH=. python test/test_kernel.py        # 内核断言 + 自举一致性（含 48 项）
PYTHONPATH=. python test/test_config_patches.py # 配置 patches 分层叠加
PYTHONPATH=. python test/test_ui_smoke.py      # Tkinter 界面冒烟（需带 tkinter 的解释器）
PYTHONPATH=. python test/test_web_e2e.py       # Web 端到端（需先 cd web/webui && npm run build）

配置

所有引擎与 demo 编排定义在 config.json，结构见文件内注释；编排层读取 orchestration 段（engines / bindings / start）。可视化编辑后保存为 web/orchestrations.json。

变更日志

各版本的改动、门禁实测与升级提示见 CHANGELOG.md。每个版本对应一个 注解 tag 与一个 Gitee Release，三者说明同源。