复现已有算法

2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,70 @@
+---
+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 配置、密钥和调试信息。