---
name: edge-presentation-docs
description: edge_collector PPT/汇报材料编写与处理规范。用于把方案设计、部署方案、测试结果、故障复盘、AI/本地模型方案、协议适配方案整理成汇报型 PPT 或演示大纲，并可读取、检查、转换已有 .pptx。
---

# edge_collector 汇报材料处理

## 适用场景

- 方案汇报。
- 项目进展汇报。
- 故障复盘汇报。
- 部署上线说明。
- 本地模型或 AI 功能方案展示。
- 协议适配方案展示。

## 默认结构

```text
1. 背景与目标
2. 当前现状/问题
3. 方案总览
4. 核心设计或流程
5. 实施计划
6. 验证结果
7. 风险与对策
8. 下一步
```

## 设计口径

- 面向工业网关和云边协同场景，风格稳重、清晰、克制。
- 优先用流程图、架构图、对比表，而不是大段文字。
- 一页只表达一个核心结论。
- 保留必要证据：截图、日志摘要、测试结果、关键指标。
- 不展示密钥、密码、真实 Token。

## 内容转换

从 Markdown 方案转 PPT 时：

- 每个二级标题通常对应 1 页或 1 组页。
- 长表格改成摘要表 + 附录。
- 命令行只保留关键命令和结果，不放完整日志。
- 复杂架构图优先使用 `edge-svg-diagram` 生成 SVG 后嵌入。

## 读取 PPTX

提取文本：

```bash
python3 -m markitdown input.pptx > output.md
```

没有 `markitdown` 时，先说明无法直接提取，改用 LibreOffice 或解包 XML。

检查结构：

```bash
unzip -l input.pptx | rg "ppt/slides/slide|ppt/media|ppt/theme"
```

## 交付检查

- 标题是否能单独表达结论。
- 字体和颜色是否统一。
- 截图是否清晰。
- 图表文字是否不截断。
- 每页是否有明确层级。
- 是否隐藏内部 AI 配置、密钥和调试信息。