cloud
71 lines
1.8 KiB
Markdown
71 lines
1.8 KiB
Markdown
---
|
|
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 配置、密钥和调试信息。
|