FIS Architecture

核心定位

FIS (Federal Intelligence System) 是一个极简主义的多智能体工作流管理框架，采用激进的"文件优先"架构设计，将工作流状态管理与内容检索彻底分离。

核心用法

1. 票据驱动的工作流（零 Python）

• 核心机制：JSON 格式的任务票据（tickets）在 active/ 与 completed/ 目录间流转
• 角色体系：Coordinator → Worker → Reviewer → Archive 的标准流水线
• 并行模式：支持多 Worker 分片处理 + Aggregator 汇总

2. QMD 集成（内容管理）

• 所有 Markdown 知识文件放入 knowledge/ 目录即自动索引
• 通过 mcporter CLI 调用语义搜索，无需手动注册
• 替代了传统 FIS 3.1 的 memory_manager.py 和 skill_registry.py

3. 可选 Python 工具（`lib/` 目录）

• badge_generator_v7.py：像素风徽章生成器（需 Pillow、qrcode）
• fis_lifecycle.py：票据生命周期 CLI 助手
• 所有 Python 组件均为可选，核心工作流完全不依赖

显著优点

| 维度 | 优势 |

|------|------|

| **极简性** | 零服务、零数据库、100% 文件驱动，Git 友好 |

| **可审计性** | JSON 票据完整记录任务生命周期，便于追溯 |

| **架构清晰** | FIS 管流程，QMD 管内容，职责边界明确 |

| **低门槛** | 基础使用无需 Python，降低部署成本 |

| **扩展性** | 通过 `resources` 字段可声明式控制权限 |

潜在缺点与局限

• 功能边界严格：移除了 3.1 版本的内存管理、技能注册表、死锁检测等模块，重度依赖 QMD 的能力
• mcporter 强制依赖：QMD 搜索需要外部 CLI 工具，非纯文件方案
• 权限控制较粗：resources 字段为声明式，无运行时强制沙箱
• 生态锁定：深度绑定 OpenClaw/QMD 生态，迁移成本较高
• Badge 生成依赖 Pillow：视觉功能需要 Python 图像库

适合人群

• 多智能体系统开发者：需要标准化 SubAgent 生命周期管理
• 追求可审计性的团队：JSON 票据天然适合版本控制与合规审查
• OpenClaw/QMD 用户：已在使用该生态，希望补充工作流管理能力
• 极简主义偏好者：反感重量级框架，追求"够用即可"的架构

常规风险

1. 权限误配置：resources 字段若未审慎设置，可能导致过度授权
2. QMD 单点依赖：核心检索能力完全依赖外部服务，需关注可用性
3. 票据目录权限：文件系统权限问题可能导致工作流中断
4. 版本迁移：3.1 → 3.2 的组件移除需手动适配旧有工作流

架构哲学

> "Quality over Quantity" —— 移除 QMD 已提供的功能，只保留 FIS 独有的工作流能力。