核心能力
Technical Presentation & Article Generator 是一款面向复杂技术项目与学术论文的自动化内容生成技能，能够将源码、配置文件与论文内容转化为两种核心交付物：
1. Reveal.js 单文件 HTML 演示文稿：自包含、可直接浏览器运行的技术幻灯片，支持 LaTeX 公式（MathJax/KaTeX）、代码高亮（highlight.js）、架构图（Mermaid.js）及演讲备注（speaker notes）。
2. Markdown 深度技术文章：遵循 "What-Why-How-Code" 五步法，强调设计动机而非堆砌概念，表格驱动参数对比，公式与代码变量名严格对齐。
显著优点
- 工程严谨性：强制要求所有技术细节（参数值、张量 shape、公式）必须源自源码而非推测，避免"幻觉式解读"。
- 可视化优先：Mermaid 流程图与 Matplotlib 架构图生成规则完善（如
FancyBboxPatch比例内边距、禁用set_aspect('equal')等），解决中文渲染与布局溢出痛点。 - AI 模型专项优化：独创训练/推理双轨分离呈现机制（蓝色主题 vs 绿色主题），强制对比表区分
model.train()与model.eval()的行为差异，避免混为一谈。 - 交互体验：演讲备注采用对话风格解释"为什么"而非"是什么"，支持代码行级高亮与 shape 标注（如
(B,C,T) → (B,2C,1)）。
潜在局限
- 输入依赖重：需用户提供完整的项目源码、配置文件或论文全文，碎片化信息无法生成高质量输出。
- Mermaid 兼容性：复杂流程图在 Reveal.js 隐藏 slide 中可能渲染异常，需手动触发
slidechanged事件重绘。 - 字体环境敏感：Matplotlib 中文输出依赖系统预装字体（Arial Unicode MS / Heiti TC），跨平台一致性需额外配置。
- 非通用设计：针对技术演示场景深度优化，不适合商业路演、教学课件等非技术语境。
适合人群
- 技术演讲者：需要将开源项目转化为会议分享 slides 的工程师、研究员。
- 技术写作者：撰写架构解析、源码走读类博客的开发者。
- 算法工程师：快速整理模型训练-推理流程、生成团队内部技术文档。
常规风险
- 信息泄露：处理企业私有代码时需脱敏，避免核心参数与业务逻辑外泄。
- 学术规范：生成论文 presentation 时需核实引用格式，避免自动生成的公式符号与原文不一致导致误解。
- 浏览器兼容性：Reveal.js 高级特性（如 speaker view）在旧版浏览器可能受限，建议指定 Chrome/Edge 环境。