FDE · Field Delivery Engine
FDE 的完整现场工作台
从第一次 Gemba walk 到签字移交——覆盖软件/SaaS 与具身机器人/制造业两类场景。 18 阶段 SOP、10 个可执行合规 gate、10 个数据连接器、真实生产 KPI。
18
SOP 阶段（4 zones）
10
可执行 gate
10
数据连接器
CI
测试全绿
完整 SOP · 18 阶段 · 4 Zones
01Zone A
立项勘察
- qualification 问题框定
- site_survey Gemba
- stakeholder_map 双 sponsor
- success_criteria 契约化
Zone B
构建
- connect 数据接入
- corpus 语料锻造
- prototype 真实数据原型
- validate 验证
- deploy FAT/SAT
- eval 评估
Zone C
运营化
- slo_sla SLO+on-call
- runbook 应急手册
- monitoring 漂移检测
- change_mgmt 工会
- flywheel 飞轮产品化
Zone D
交接退场
- ops_handoff 运维移交
- knowledge_transfer 知识转移
- disengage 签字退场
10 个可执行合规 Gate（工业 overlay）
02Gate 是谓词，不是清单：清单记录"曾经查过"，随现实漂移单向腐化；gate 在每次推进时重新评估，过期 passed 不作数。--force 只豁免拦截、照常评估留痕，例外进入审计日志。
site_survey
现场勘察记录校验
success_criteria
双 sponsor + 可度量 done
fat_sat
FAT/SAT 验收签字
functional_safety
ISO 13849 / IEC 61508 / ISO 10218
conformity
CE / EU AI Act conformity
works_council
德国 BetrVG §87 工会共决
air_gap
air-gapped 部署清单
shift_handover
24/7 班次交接集成
slo
SLO + on-call 定义
handoff_signoff
移交包签字确认
10 个数据连接器
03CSV
通用兜底，冷启动
真实可用MySQL
关系库直连
真实可用MQTT-Sparkplug
工厂设备遥测
JSONL 可用MES (ISA-95)
工单/质量/停机
真实可用OPC UA
PLC tag 读取（asyncua 驱动）
真实可用ROS2 Bag
机器人轨迹回放
stubHistorian
时序历史库
真实可用Zammad
工单系统
真实可用Salesforce
CRM
真实可用Documents
PDF/Word/Excel/PPT 解析（agentscope.rag，延迟导入）
需 [agentscope]Ontology 语义层 · TBox + ABox
04TBox 双 Schema
fde-core（Skill/Connector/Engagement 等核心概念）+ mfg-overlay（ISA-95 制造业 overlay，imports 复用）
内置SKOS 概念体系
fde-corpus-taxonomy 双向集成：corpus 引擎按概念覆盖度选样本，skill 搜索概念扩展召回
内置SHACL-lite 校验
ONTO-* 错误码契约（domain/range、环引用、未声明前缀），校验失败即拦截
10 个错误码6 大功能模块
05Corpus Engine
脱敏→去重→质量门→覆盖度分析→缺口检测→针对性合成→报告。核心差异化：合成是补盲区不是凑数量。
Eval 评估
ticket 指标 + 制造业 KPI（OEE/MTBF/抓取率/碰撞率）+ bad case 挖掘 + 自动建议。
Deploy 部署
角色 Agent 真实装配：沙箱 workspace + 权限上下文（经 AgentState 注入）+ Toolkit 工具绑定 + SubAgentTemplate 蓝图，全部真实 AgentScope 2.0 API。→ 部署预检台
Flywheel 飞轮
概念事件→真实事件映射 + 语料回流 + 周度增量重训。
SOP 状态机
18 阶段推进/回滚，gate 不通过即拦截。
Web 控制台
交互式 engagement 仪表盘 + gate + forge + KPI + Agent 部署预检（/console#deploy）+ 本体库（/console#ontology）。
架构清单 · 四层 + 横切
06证据化建模见 docs/architecture-model/。
UI 层
CLI（Typer，全延迟导入）· Web 控制台（43 路由）· QwenPaw PawApp（18 路由 /api/fde-scope）· macOS App（DMG 双击即用，即本控制台）。
SOP 层
engagement/：18 阶段 · 4 zones · 10 个可执行 gate（advance 实时重评估）+ handoff；profiles/：ticket · manufacturing 场景选择器。
能力层
connectors · corpus · deploy · eval · flywheel · integrations · ontology · skills —— 核心数据管线，规则为底、LLM 可选增强。
横切层
llm.py（唯一 LLM 出口，失败回退规则路径）· config.py · templates/（Jinja 报告与 runbook）· paths.py（data_root 唯一路径解析）。
文件事实源
零数据库：.fde_scope/（engagements · skills · uploads）+ reports/；一律经 fsutil.atomic_write_text 原子写。
外部依赖（全可选）
AgentScope 2.0.x（extra，实测窗口 >=2.0.4.post1,<3；deploy 三支柱 + documents 延迟导入）· MiMo LLM（凭据仅环境变量）· QwenPaw 宿主。
工程最佳实践 · 七条不变式
07AGENTS.md 契约，由架构守护测试钉住。
1Gate 实时重评估
advance() 每次重评当前阶段全部 gate，过期通过不作数；强推也评估留痕。禁止缓存/短路。
2ID 服务端生成
SkillRecord.id / EngagementContext.id 由所属服务分配，外部输入永远不能指定。
3凭据只走环境变量
API key 不落 manifest / 报告 / engagement JSON / 日志。
4原子写盘
一切用户状态经 fsutil.atomic_write_text（临时文件 + os.replace），禁止裸 write_text。
5规则授权是唯一通道
build_toolkit 不打 is_read_only（上游 ≥2.0.5 read-only 先放行）；未匹配工具按模式回退 DEFAULT→ASK / DONT_ASK→DENY。
6实测版本窗口
pyproject 与 docs 逐字引用同一 agentscope specifier，放宽前逐版本真库跑测。
7Web 变更路由须过认证
新路由确认未被 auth 白名单误放；token 只从 FDE_SCOPE_API_TOKEN 环境变量读，不落文件/日志/响应。
验证锚点：make test · pytest tests/test_architecture_guard.py（6 项契约）· pytest -m agentscope（真库运行时）· ruff check + format --check · 架构证据模型 docs/architecture-model/architecture-map.md
制造业 KPI（虚构演示数据）
08OEE
设备综合效率0.724
世界级 ≥0.85
抓取成功率
pick success0.793
DexNet 基准 ~0.80
MTBF
平均无故障(h)39.8
越高越好
碰撞/干预率
per cycle1.08%
越低越好
快速上手
09CLI 命令行
# 安装（核心层零依赖）
pip install -e ".[dev]"
# 启动制造业 engagement
fde-scope engage init --customer aurora-motors --profile manufacturing
# 推进 SOP（gate 拦截）
fde-scope engage advance <id>
fde-scope gate check <id> --gate fat_sat
# 语料锻造 + KPI
fde-scope corpus --input alarm.jsonl --out r.html
fde-scope kpi <id> --samples station.jsonl
# 生成移交包
fde-scope handoff <id> --accept
pip install -e ".[dev]"
# 启动制造业 engagement
fde-scope engage init --customer aurora-motors --profile manufacturing
# 推进 SOP（gate 拦截）
fde-scope engage advance <id>
fde-scope gate check <id> --gate fat_sat
# 语料锻造 + KPI
fde-scope corpus --input alarm.jsonl --out r.html
fde-scope kpi <id> --samples station.jsonl
# 生成移交包
fde-scope handoff <id> --accept
Web 界面
# 启动交互控制台
pip install -e ".[web]"
fde-scope web
→ http://127.0.0.1:8080
# 控制台功能：
· 新建 engagement（选 profile）
· 18 阶段可视化 + gate 拦截
· CSV → 语料锻造（HTML 报告）
· KPI 计算（ticket / 制造业）
· 推进/回滚 SOP 状态机
· Agent 部署预检（/console#deploy）
pip install -e ".[web]"
fde-scope web
→ http://127.0.0.1:8080
# 控制台功能：
· 新建 engagement（选 profile）
· 18 阶段可视化 + gate 拦截
· CSV → 语料锻造（HTML 报告）
· KPI 计算（ticket / 制造业）
· 推进/回滚 SOP 状态机
· Agent 部署预检（/console#deploy）
两种场景
10ticket · 客服工单
CSV/Zammad/Salesforce/MySQL 接入。意图准确率、回复采纳率、升级率评估。无工业 gate。
完整可用
manufacturing · 具身机器人
OPC UA/MQTT/ROS2/MES/Historian 接入。OEE/MTBF/抓取率/碰撞率 + 6 个工业合规 gate。
核心可用 · 工业IO部分 stub