# Aethon 全功能演示指南（Demo Guide）

> 面向演示者/售前/实施顾问的一站式演示手册：**演示数据全景 + 全功能演示剧本 + 常见问题**。
> 覆盖平台全部 6 大模块、80+ 功能视图、5 大智能体与 MCP 开放能力。
> 产品介绍与营销资料见 [PRODUCT_INTRO.md](PRODUCT_INTRO.md) 与 [../site/index.html](../site/index.html)；快速上手见 [QUICKSTART.md](QUICKSTART.md)。

---

## 目录

- [1. 演示准备](#1-演示准备)
- [2. 演示数据全景（每个功能页对应哪些 demo 数据）](#2-演示数据全景每个功能页对应哪些-demo-数据)
- [3. 十五分钟全功能演示剧本](#3-十五分钟全功能演示剧本)
- [4. 逐模块深度演示脚本](#4-逐模块深度演示脚本)
- [5. AI 能力演示（智能体 / Copilot / 预测维护 / MCP）](#5-ai-能力演示智能体--copilot--预测维护--mcp)
- [6. 低代码 / 设计器演示](#6-低代码--设计器演示)
- [7. 演示后数据复位](#7-演示后数据复位)
- [8. 常见问题与兜底](#8-常见问题与兜底)

---

## 1. 演示准备

### 1.1 启动环境

```bash
# 后端（Python 3.11+）
cd backend
pip install -r requirements.txt
python -m uvicorn app.main:app --host 0.0.0.0 --port 8200

# 前端（Node 18+）
cd frontend
npm install
npm run dev
```

访问 `http://localhost:3000`。

> 首次启动自动建表 + 写入**全量演示数据**（两个租户各一份），并启动工厂模拟器（每 45s 滚动更新 OEE/遥测）。健康检查：`http://localhost:8200/health`。

### 1.2 演示账号

| 账号 | 密码 | 租户 | 角色 | 用途 |
|------|------|------|------|------|
| `admin` | 由 `AETHON_ADMIN_PASSWORD` 设置 | DEFAULT | Admin | **主演示账号**，全部模块 + 低代码/设计器种子页面 |
| `demo` | 由管理员单独设置 | DEMO | Supervisor | 备用演示账号（独立数据租户） |

> 数据按租户隔离：登录后只能看到本租户数据。建议演示全程使用 `admin`（DEFAULT 租户种子最全，含报表/大屏/低代码演示页面）。

### 1.3 可选：启用真实 LLM

```bash
# backend/.env 追加：
AETHON_LLM_API_KEY=sk-xxxx
AETHON_LLM_BASE_URL=https://api.deepseek.com/
AETHON_LLM_MODEL=deepseek-chat
```

- 配置后：Copilot / 巡检 / 编排走 `toolchain` 引擎（真实工具调用 + LLM 推理）。
- 未配置：自动降级为规则引擎（仍用实时数据回答，只是不"思考"）。**无 LLM 也能完成全部功能演示。**

---

## 2. 演示数据全景（每个功能页对应哪些 demo 数据）

系统启动自动为 **DEFAULT / DEMO** 两租户各写入一份演示数据。下表列出每个功能视图对应的演示数据，供演示者"点到即有效果"。

> 数据来源：`backend/app/main.py`（用户/角色/租户/初始工厂）+ `backend/app/seed_data.py`（34+ 组 seed 函数）+ `backend/app/api/flux_pages_routes.py`（低代码/报表/大屏种子页面，访问时自动写入）。

### ① 总览（overview）

| 视图 | 入口 | 演示数据 |
|------|------|----------|
| 总览 Overview | `#/overview` | 17 台设备 + 60 条生产记录 → OEE/可用率/性能/质量、进行中工单、告警、安灯、低库存 KPI |
| 待办中心 Todo Center | `#/todo_center` | 5 条 AgentAction（2 条待审批）+ 3 条告警 + 5 条通知 + 1 条审批流任务 |
| 车间大屏 Shop Board | `#/shop_board` | 设备状态/停机/安灯/今日产量聚合（`/api/board/overview`），15s 自动刷新 |
| 执行看板 Executive OEE | `#/executive` | 设备级 OEE 排名 + 趋势 |
| 在线表格 Online Grid | `#/online_grid` | 支持 7 个实体 Excel 模板在线编辑/校验/提交 |

### ② 设计器（designer / 低代码）

| 视图 | 入口 | 演示数据 |
|------|------|----------|
| 表单设计器 Form Designer | `#/form_designer` | 拖拽表单建模（表单、字段、校验、发布） |
| 低代码页面 Low-Code Pages | `#/amis_forms` | 12 个种子页面（表单 + 数据页），含"低代码表单"分组 |
| 数据页设计器 Data Page Designer | `#/data_page_designer` | 基于 12 个报表数据集拖拽建 CRUD/看板页 |
| 大屏设计器 Big Screen Designer | `#/big_screen_designer` | 内置"车间总览"模板，KPI/图表/表格/告警/时钟组件拖拽 |
| 大屏看板 Big Screen Runtime | `#/big_screen_runtime` | 已发布大屏实时渲染；`/screen?key=` 独立投屏 |
| Excel 工作台 Excel Workbench | `#/excel_workbench` | 7 实体模板下载/导入/校验/导出，文件监听导入 |
| 报表设计器 Report Designer | `#/report_designer` | 3 个中文演示报表（订单日报/质检/库存），中国式报表（大标题+表头+明细+页脚） |
| 报表运行时 Report Runtime | `#/report_runtime` | 演示报表只读渲染 + xlsx/csv 导出 |
| 业务对象录入 BO Entry | `#/bo_workbench` | 领料单 2 张 + 报工单 3 张 + 返工单 2 张（header+明细），BO 复合表单 |
| 实体管理 Entity Admin | `#/entity_admin` | 10 类实体元数据 + 通用 CRUD |
| 字段标签 Field Labels | `#/field_labels` | 字段中英文标签字典（可新增覆盖） |
| 状态机配置 Status Machine | `#/status_machine` | 5 类状态机（工单/订单/CAPA/NCR/客户订单）+ 线性流转 |
| 工作流 Workflow | `#/workflow` | CAPA 审批流 + 采购订单审批流（定义 + 1 个运行实例 + 1 个待办任务） |

### ③ 生产运营（operations）

| 视图 | 入口 | 演示数据 |
|------|------|----------|
| 订单 Orders | `#/orders` | 5 个生产订单（3 Submitted + 2 Draft）|
| 客户订单 Customer Orders | `#/customer_orders` | 3 张客户订单（发货/部分/待处理）+ 交期风险评估 + 3 条批量导入记录 |
| 工单 Work Orders | `#/workorders` | 5+ 张工单（含 MRP 演示工单）+ 工序执行状态机 |
| APS 排程 | `#/aps` | 1 个周排程 + 5 个任务（甘特/负载/冲突/产能）|
| 工序成本 Phase Costing | `#/workorder_phases` | 3 个工序阶段（含成本：人工/设备/材料/外协）|
| 工艺路线 Process Routes | `#/process_routes` | 3 条路线（R001 含 V1/V2 版本树、7 工序、材料消耗、关键工序）|
| 工序库/工位 Process Library | `#/process_std` | 14 个标准工序 + 13 个工位/工作中心 |
| 领料单 Material Issue | `#/material_issue` | 2 张（header+明细，关联工单/库存）|
| 报工单 Prod Report | `#/production_report` | 3 张（完成/合格/不良数量，状态 Confirmed）|
| 返工单 Rework Order | `#/rework_order` | 2 张（关联 NCR，返工/报废处置）|
| 批次追踪 Lot Tracking | `#/lots` | 3 个批次（原料/加工/成品阶段）|
| 序列号追溯 Serial & Trace | `#/tracking` | 5 个追踪物料 + 追溯事件 + 追溯链路（父子/消耗）|
| 供应商 Suppliers | `#/suppliers` | 5 家供应商 + 评估打分 |
| AI RFQ 报价 | `#/rfq` | 1 个 RFQ 包（含 2 个解析附件）+ 1 个报价（2 行）+ 成本估算 |
| 采购订单 Purchase Orders | `#/purchase_orders` | 4+2 张 PO（收讫/部分/草稿/待发运/待检验）+ 明细行 |
| 收货检验 Receiving | `#/receiving` | 1 张待检验收货单 + 1 张已收货 PO |
| 物料主数据 Parts | `#/parts` | 8 个物料（自制/外购/原料/五金）|
| BOM | `#/bom` | 齿轮箱总成 3 级 BOM（齿轮→轴承/圆钢，轴→42CrMo）|
| MRP | `#/mrp` | 1 次 MRP 运行 + 6 需求 + 3 动作（下达工单/采购/催货）|
| 库存 Inventory | `#/inventory` | 13 项库存 + 出入库流水 + 低库存告警 |
| 仓储 WMS | `#/wms` | 6 个库位（原料/组件/成品/待检/发货）+ 盘点 2 次（进行中/已排程）+ 库存流水 |
| 质检 Quality | `#/quality` | 15 条质检记录（含高于 10% 不良率的批次→触发质量智能体）|
| SPC 控制 | `#/spc` | 3 个 SPC 参数 + 180 条测量/租户（含漂移/超差点）+ Xbar-R 图 + CPK |
| NCR 不合格品 | `#/ncr` | 3 张 NCR（返工/退货/报废，2 开 1 关）|
| CAPA | `#/capa` | 3 条 CAPA（已关闭/验证中/实施中）|
| 安灯 Andon | `#/andon` | 4 次呼叫（关闭/响应/开启，含紧急）|
| SOP | `#/sop` | 5 份 SOP（中英文，含安全注意事项、步骤）|
| 设备点检 Point Check | `#/equipment_check` | 3 台设备 × 6 项检查标准 + 每台 3 条历史记录（含异常）|
| 报废原因 Scrap Reasons | `#/scrap_reasons` | 13 个原因码（材料/设备/刀具/操作/工程/来料…）|
| 设备 Machines | `#/machines` | 17 台（CNC-01/02、ASSEMBLY-01、QC-01 + APS 13 台）+ 生产记录/停机/点检/遥测 |
| 模具库 Molds | `#/molds` | 5 套模具（注塑×2/冲压×2/拉伸×1，寿命/已用/换模时间/状态）|
| 状态/原因 Status & Reasons | `#/machine_status` | 4 个设备状态 + 7 个停机原因码 |
| 维护 Maintenance | `#/cmms` | 6 条维护任务（预防/预测/纠正/检验，含超期项）|
| 停机 Downtime | `#/downtime` | 2 条停机记录（主轴过热保护停机等）+ 原因分布 |
| 排班 Shifts | `#/shifts` | 20 条班次数据（目标/实际产出）|
| 告警 Alerts | `#/alerts` | 6 条告警（含未解决）|
| 布局 Factory Layout | `#/layout` | 4 个布局节点（设备坐标/区域）|

### ④ 分析（analytics）

| 视图 | 入口 | 演示数据 |
|------|------|----------|
| 数据分析 Analytics | `#/analytics` | 31 个读模型聚合：OEE/产量/质量/库存/维护/停机/供应链/排班/财务/趋势 |
| 报表 Reports | `#/reports` | OEE/质检/库存/维护/停机/生产等预置报表 + xlsx 导出 |
| 图表组件 Chart Kit | `#/chart_kit` | 图表组件画廊（趋势/柱/饼/散点/甘特等）|

### ⑤ 智能平台（ai）

| 视图 | 入口 | 演示数据 |
|------|------|----------|
| AI 洞察 AI Insights | `#/ai` | 3 条 AI 推荐 + 风险聚合 |
| AI 助手 Copilot | `#/copilot` | 会话式取数（15 制造工具）；试问「工厂整体状况如何？」|
| AI 推荐 Recommendations | `#/recommendations` | 3 条推荐（预测维护/补货/质量改进，可确认/解决/忽略）|
| IoT 遥测 | `#/iot` | 4 台设备 PLC 遥测（转速/进给/负载/温度/振动/功率/运行时间）|
| 智能体 Agents | `#/agents` | 5 大 Agent（维护/质量/补货/升级/良率）+ 动作审批 |
| Agent 授权 Authz | `#/authorization` | 2 条授权边界（维护自主 / 补货人工审批）|
| 预测维护 Predictive | `#/predictive` | 设备健康评分 + 风险因素 + 异常检测（隔离森林）+ 剩余寿命 |
| 约束引擎 Constraints | `#/constraints` | 2 条规则集（SPC 上下限 / 设备负载 ≤95%）|

### ⑥ 平台管理（system）

| 视图 | 入口 | 演示数据 |
|------|------|----------|
| 用户 Users | `#/users` | admin/demo 用户 + 5 角色 |
| 设置 Settings | `#/settings` | 租户配置（套餐/模块/品牌）|
| 审计日志 Audit Log | `#/audit_log` | 5 条审计记录（登录/建单/审批/库存/告警）|
| 事件日志 Event Log | `#/event_log` | 5 类领域事件（状态变更/质检/库存/智能体/告警）|

### ⑦ 移动端（mobile-h5，Vue3 + PWA）

- 登录、任务列表（QR 扫码/报工）、报表、考勤（围栏/打卡）、消息、领导驾驶舱（报表+审批）、扫码追溯。

---

## 3. 十五分钟全功能演示剧本

按产品六大模块走一遍，覆盖大部分功能。每步注明"看什么 + 数据来自哪里"。

### 第 1 站 · 总览（3 分钟）

1. 登录 `admin` → 落在**总览**：解释 KPI——OEE、可用率、性能、质量（数据来自 17 台设备 + 60 条生产记录）。
2. 切到 **车间大屏**（`#/shop_board`）：全屏暗色实时大屏，展示设备状态/停机/安灯/今日产量，15s 自动刷新（工厂模拟器驱动）。
3. 切到 **执行看板**（`#/executive`）：设备 OEE 排名与趋势。
4. 打开 **待办中心**（`#/todo_center`）：待审批 AgentAction、告警、通知、审批任务——这是"AI 提出、人来审批"的入口。

### 第 2 站 · 生产运营（4 分钟）

5. **订单**：5 张订单（3 提交/2 草稿）→ 选中提交单查看批次与工单。
6. **客户订单**：3 张 + 交期风险看板（风险由 `order_risk_service` 计算）。
7. **APS 排程**：选中周排程点**生成**→ 甘特图、负载图、冲突检测、产能分析；可**下发**生成工单。
8. **工艺路线**：R001 查看 V1→V2 版本树（优化版缩短总节拍），7 道工序含材料消耗。
9. **BOM / 物料**：齿轮箱 3 级 BOM 展开（爆炸）。
10. **MRP**：查看缺料清单，对动作点**应用**→ 自动生成采购订单/工单。
11. **库存 / WMS**：出入库流水、库位、循环盘点。

### 第 3 站 · 质量（2 分钟）

12. **质检**：15 条记录，选中一条看不良明细。
13. **SPC**：参数控制图（Xbar-R）+ CPK，有漂移与超差点（`quality_monitor` 会触发安灯/CAPA）。
14. **NCR**：3 张不合格品单 → 处置（返工/退货/报废）→ 关联 **CAPA**。

### 第 4 站 · 智能平台（3 分钟）

15. **AI 助手（Copilot）**：输入「工厂整体状况如何？」/「库存状态」→ 自动调用工具取数回答。
16. **智能体**：点击**运行巡检**（`/api/agents/run`）→ 5 大 Agent 产出动作 → 动作进入授权流程（Auto 或人工审批）。
17. **Copilot 辅助驾驶**（新增）：`POST /api/demo/drive/ai` → 一句话让 Copilot 备单/提交/下达/开工（auto 自主），报工完工转人工审批 → 待办中心一键批准 → 事件/审计日志看留痕。
18. **预测维护**：设备健康评分 + 风险因素（含 IoT 温度/振动/负载）+ 异常检测 + 剩余寿命。
19. **Agent 授权**：维护动作自主执行、补货需人工审批——解释 AI 治理边界。
20. **IoT**：设备遥测实时曲线。

### 第 5 站 · 低代码与设计器（2 分钟）

20. **报表设计器**：打开"生产订单日报"演示报表 → 报表运行时预览 + 导出 xlsx。
21. **大屏设计器**：打开"车间总览"模板 → 大屏运行时 → `/screen?key=` 独立投屏。
22. **表单设计器 / 低代码页面**：演示拖拽表单与数据页。

### 第 6 站 · 系统（1 分钟）

23. **审计日志 / 事件日志**：系统操作留痕。
24. **用户 / 设置**：角色权限与租户配置。

> 全程约 15 分钟。按需跳过低代码站（第 5 站）即可压到 12 分钟。

---

## 4. 逐模块深度演示脚本

> 面向需要深讲某个模块的场合（如客户侧重质量或设备）。每个剧本都是独立的，可单独演示。

### 4.1 质量合规演示（15 分钟）

1. **质检记录**（`#/quality`）：查看不合格批次（不良率 >10%）。
2. **SPC 控制**（`#/spc`）：Xbar-R 图看到漂移 → 解释 `quality_monitor` 自动触发安灯 + CAPA。
3. **安灯**（`#/andon`）：查看自动/人工呼叫。
4. **NCR**（`#/ncr`）：打开 NCR → 处置（Rework/Return/Scrap）→ 一键**生成 CAPA**。
5. **CAPA**（`#/capa`）：原因分析 → 纠正/预防措施 → 效果验证 → 关闭。走完整 8D 闭环。
6. **SOP**（`#/sop`）：标准作业指导书（中英文，含安全）。
7. **报废原因**（`#/scrap_reasons`）：结构化原因码目录。
8. **追溯**（`#/tracking`）：从成品反查原料（序列号 + 追溯链路）。
9. **设备点检**（`#/equipment_check`）：日/周点检标准与记录。

### 4.2 计划排程演示（12 分钟）

1. **客户订单**（`#/customer_orders`）：查看交期风险。
2. **生产订单**（`#/orders`）：提交 → 派生工单。
3. **APS**（`#/aps`）：生成排程 → 甘特/负载/冲突/产能 → 下发生成工单。
4. **工单**（`#/workorders`）：查看派工与工序执行。
5. **MRP**（`#/mrp`）：净需求运算 → 动作应用（采购/工单/催货）。
6. **采购订单 / 收货**（`#/purchase_orders` / `#/receiving`）：PO 状态机（草稿→审批→发送→收货）→ 待检验收货单 → 检验入库。

### 4.3 设备与维护演示（10 分钟）

1. **设备**（`#/machines`）：设备台账 + 详情（生产记录/停机/点检/遥测）。
2. **IoT**（`#/iot`）：CNC-02 温度/振动超阈值（演示数据刻意设置）。
3. **预测维护**（`#/predictive`）：设备健康评分 + 风险 + 异常检测（隔离森林）+ RUL。
4. **维护**（`#/cmms`）：维护任务列表（含超期项）→ 新建/完成。
5. **停机**（`#/downtime`）：停机原因分布。
6. **模具库**（`#/molds`）：模具寿命/已用模次 → 发起换模 → 完成换模（冲次累加）。
7. **排班**（`#/shifts`）：班次目标/实际产出。
8. **布局**（`#/layout`）：车间设备布局图。

### 4.4 AI 智能体深度演示（15 分钟）

1. **AI 助手**（`#/copilot`）：连续提问（OEE→库存→质量→维护），展示工具调用。
2. **Copilot 辅助驾驶**（`POST /api/demo/drive/ai`）：一句话备单→提交→**APS 排产**→下达→开工（auto 自主执行）；报工完工（require_human 转人工审批）→ 待办中心一键批准 → 四件闭环落地。
3. **风险分级讲解**（`#/authorization`）：auto / advise / require_human 三档如何判定（置信度阈值 + 边界配置），现场调 `auto_execute_actions` 改档位。
4. **智能体**（`#/agents`）：运行巡检 → 5 大 Agent 动作（维护/质量/补货/升级/良率）。
5. **动作审批**：Approved 自动执行（如建维护任务）；Proposed 转人工审批。
6. **Agent 授权**（`#/authorization`）：修改授权边界（如把补货改为自动）→ 演示动作自动执行。
7. **全程留痕**（`#/event_log` / `#/audit_log`）：byoe.llm.response / tool.call / agent.turn 事件 + AgentAction decided_by（llm:copilot）可追责回放。
8. **反馈闭环**：对动作打有效/无效 → 授权阈值自适应调整。
9. **预测维护**（`#/predictive`）：演示数据刻意让 CNC-02 高风险 → 自动生成预测维护任务。
10. **AI 推荐**（`#/recommendations`）：确认/解决/忽略推荐。

### 4.5 低代码平台深度演示（15 分钟）

1. **表单设计器**（`#/form_designer`）：拖拽创建"请假申请"表单 → 发布 → 出现在低代码页面。
2. **数据页设计器**（`#/data_page_designer`）：基于数据集创建 CRUD 页。
3. **报表设计器**（`#/report_designer`）：修改演示报表单元格 → 预览 → 导出 xlsx/csv。
4. **大屏设计器**（`#/big_screen_designer`）：拖拽 KPI/图表 → 发布 → 独立投屏 `/screen?key=`。
5. **Excel 工作台**（`#/excel_workbench`）：下载物料模板 → 在线表格编辑 → 校验 → 提交。
6. **工作流**（`#/workflow`）：创建审批流 → 发起实例 → 审批通过（含 SLA 监控与 AI 审批建议）。

---

## 5. AI 能力演示（智能体 / Copilot / 预测维护 / MCP）

### 5.0 Copilot 辅助驾驶（AI 治理演示，阶段 0/1 能力）

> 新增演示场景：`POST /api/demo/drive/ai`（Copilot 辅助驾驶）。
> 与 `POST /api/demo/drive`（一键驾驶）的区别：前者经 **execute_production 工具 + 授权边界 + 风险分级** 执行，
> 后者直接调领域服务。二者复用同一套真实领域能力。

```bash
# 预跑辅助驾驶，生成治理留痕（AgentAction + BYOE 事件）
curl -X POST http://localhost:8200/api/demo/drive/ai \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"qty": 60, "llm": true}'
```

演示剧本（8 步，逐步讲解）：
1. **Copilot 收到指令**：用户说「把 CO-… 投产，排产开工并安排质检」
2. **C1 备单**（auto 自主执行）：客户订单 → 生产订单，`decided_by=auto:{边界}:llm:copilot`
3. **C2 提交**（auto）：Draft → Submitted
4. **C3 APS 排产**（Copilot 触发排产引擎）：有限产能排程（机器日历/工序节拍/模具约束）→ 甘特/负载/冲突
5. **C4 下达**（auto）：生产订单 → 工单 + 工艺路线快照
6. **C5 开工**（auto）：Pending → In Progress
7. **C6 报工完工**（**require_human 治理闸门**）：未批准不执行，工单保持 In Progress
8. **C7 人工一键批准** → 立即执行四件闭环（收成品/反冲/追溯/质检任务）
9. **C8 全程留痕**：待办中心 / 事件日志 / 审计日志可完整回放

配套界面（截图相册「AI 辅助驾驶」分组）：
- Copilot 会话 `#/copilot` · 待办中心 `#/todo_center` · 智能体 `#/agents`
- Agent 授权 `#/authorization`（auto/advise/require_human 边界）
- APS 排程 `#/aps`（C3 排产甘特/负载/冲突）
- 事件日志 `#/event_log`（byoe.llm.response / byoe.tool.call / byoe.agent.turn）
- 审计日志 `#/audit_log`

全能力覆盖：六大模块 85 视图 + Skills/MCP/BYOE 架构的完整截图/图文证据见 `../site/capability-map.html`。

### 5.1 Copilot 推荐问题

| 问题（中文） | 对应工具 | 预期回答要点 |
|--------------|----------|--------------|
| 工厂整体状况如何？ | get_factory_overview | OEE、订单、库存、质量、停机、维护快照 |
| OEE 是多少？哪台设备最好？ | query_oee | 综合 OEE + 最佳设备 |
| 库存状态怎么样？ | query_inventory | 库存总值、低库存清单 |
| 最近质检合格率？ | query_quality | 合格率 + 缺陷分布 |
| 有没有停机？原因是什么？ | query_downtime | 停机事件 + 原因分布 |
| 设备健康有什么风险？ | query_machine_health | 风险评分 + 健康分 + 遥测因素 |
| 给我一个建议 | propose_action | 基于授权边界产出动作 |

### 5.2 智能体动作触发条件（演示数据刻意构造）

| Agent | 触发条件 | 演示数据 |
|-------|----------|----------|
| 维护 Maintenance | 预防性维护到期 | MT-* 超期任务、CNC-02 高温 |
| 质量 Quality | 不良率 > 10% | 质检记录不良批次 |
| 补货 Reorder | 库存 < 再订货点 | TP-001 刀具低库存 |
| 升级 Escalation | 设备停机 | CNC-02 主轴过热保护停机 |
| 良率 Yield | 良率 < 90% | 活塞 A-100 良率数据 |

### 5.3 MCP 输出（外部智能体驱动）

```bash
# 嵌入模式（JWT + 租户）：POST /api/mcp/messages
# 独立 HTTP：python -m app.mcp_server --http --port 8230
# stdio（BYOE/Claude/Cursor）：python -m app.mcp_server
```

- 27 个制造工具暴露给外部智能体（OEE/生产/库存/质量/停机/维护/健康/优先级/遥测/SPC/安灯/排班/知识检索/动作提案/执行/设计/MRP/建工单/预填/财务）。
- 资源：`aethon://factory/overview`、`aethon://agents/roster`。

---

## 6. 低代码 / 设计器演示

- 报表种子：`demo_order_daily`（生产订单日报）、`demo_quality_yield`（质检良率）、`demo_inventory_value`（库存金额）、`demo_downtime_crosstab`（停机交叉表）——均在"报表设计器/运行时"可见。
- 大屏种子：`demo_bs_oee` / `demo_bs_quality` / `demo_bs_production` / `demo_bs_inventory`（OEE/质量/生产/库存 4 块车间大屏）——含 KPI 指标/图表/告警安灯/实时时钟组件。
- 低代码表单种子：`SEED_PAGES`（表单页）自动出现在"低代码表单"分组。
- 独立投屏：`/screen?key=<page_key>`（无外壳纯大屏，可全屏）。

> 种子页面归属 DEFAULT 租户，随代码更新自动刷新（`demo_*` 前缀每次覆盖）。用户自定义页面永不覆盖。

---

## 7. 演示后数据复位

工厂模拟器每 45s 会滚动更新设备状态/生产记录/遥测。若演示数据被破坏（如误删），复位方式：

```bash
# 方式一：删除数据库后重启（自动重建全量演示数据）
cd backend
rm aethon.db          # 生产环境请用正式备份恢复，勿直接删除
python -m uvicorn app.main:app --port 8200

# 方式二：仅重跑种子（开发期）
python -c "from app.database import SessionLocal; from app.seed_data import seed_all; from app.tenancy import set_current_tenant; db=SessionLocal(); [seed_all(db,t,set_current_tenant(t)) for t in ('DEFAULT','DEMO')]; db.close(); print('reseeded')"
```

---

## 8. 常见问题与兜底

| 现象 | 处理 |
|------|------|
| 页面空数据 | 确认登录 DEFAULT 租户（admin）；演示数据首次启动自动写入 |
| 低代码/报表/大屏页面没出现 | 刷新该页面（访问 `#/amis_forms` 或 `#/report_runtime` 会触发种子写入）|
| Copilot 回答像模板 | 未配置 LLM key，走规则引擎；配置后自动升级为工具调用 |
| 智能体没产出动作 | 运行 `#/agents` 的"运行巡检"；规则引擎同样可用 |
| 大屏不投屏 | 使用 `/screen?key=<page_key>` 独立路由 |
| 端口占用 | 后端 8200、前端 3000、MCP 8230 可改 |
| 移动端打不开 | 参考 `mobile-h5/README.md`，`NEXT_PUBLIC_API_URL` 指向后端 |

---

> 配套资料：产品介绍 [PRODUCT_INTRO.md](PRODUCT_INTRO.md) · 快速上手 [QUICKSTART.md](QUICKSTART.md) · 用户手册 [USER_GUIDE.md](USER_GUIDE.md) · 部署 [DEPLOYMENT.md](DEPLOYMENT.md) · AI 深度 [AI_AGENT_GUIDE.md](AI_AGENT_GUIDE.md)
