用途:将 Markdown 长文形式的规格、实现计划、ADR(架构决策记录)、头脑风暴和决策文档,转成单文件 HTML 幻灯片,让内容更易被阅读和理解。
主要能力:生成自包含 HTML 演示文稿,无网络依赖。内置 deck 引擎支持方向键/空格/PgUp/PgDn/Home/End 导航、O 键总览网格、F 全屏、触摸滑动、可拖动进度条和 #n 哈希深链接。模板提供深色石板底配祖母绿强调色、流式排版、系统字体、等宽标签,以及像素风下划线、锯齿分隔线等视觉元素。提供终端、代码块、图表、选项网格、时间线、清单、台账、决策记录等组件。
使用方式:从 assets/template.html 复制模板并替换幻灯片内容,保持 style 和 script 块不变。先以幻灯片标题列出大纲,再依据 references/components.md 编写各页。更新标题页和品牌标识,按需添加分隔页和附录页。本地直接打开文件,远程(SSH)环境可运行:python3 -m http.server 8080 --bind 0.0.0.0 --directory <dir>。
适用场景:技术规格、实现计划、ADR、头脑风暴和决策文档。建议 6–15 页,每页一个观点,优先展示成果物而非描述,连续页避免同一版式,结论写在标题中,验收标准和后续行动用清单呈现。
限制:代码超过 18 行、表格超过 6 行需拆分或移至附录;不引入 CDN、网页字体、外部图片或 Mermaid 等外部渲染器;不支持构建步骤;无语法高亮库,长代码保持无高亮。其余细节资料暂未提供。