用途:把用户提供的文章、讲稿、数据或参考图,整理成安静工整、逻辑清楚、信息密度高的 16:9 手写学术报告风 HTML 幻灯片,适合技术文章转演示、论文或产品原理讲解,并逐页导出 PNG。
主要能力:固定 16:9 无滚动;封面极简留白;正文每页回答一个问题并形成连续逻辑链;每页带简短讲稿备注;支持左右键、空格翻页和全屏。默认同时产出原版 HTML 与时间轴版 index-timeline.html,时间轴版按空格或点击逐条出现标题、框、箭头、文字行、图表,可自动连播,效果接近 Office PPT,且为内联单文件,可单独移动发送。
使用方式:读取 references/style-guide.md 复用视觉规范,从 templates/deck.html 复制新文件;字体固定 HanziPen SC,渲染环境缺字体须先安装,否则停止交付。视觉上背景淡暖白,主文字深蓝黑,蓝用于标题下划线、坐标轴、推导主线,玫红用于结论与警告,绿用于确认项,荧光黄与珊瑚粉少量使用;避免圆角卡片、阴影、渐变、装饰图标和照片背景。用 neat-annotations 手写箭头做短注释,长结论写在正文。图表优先 SVG 手绘。
检查与导出:先运行 python3 scripts/check_deck.py /absolute/path/to/index.html;再执行 scripts/render.sh /absolute/path/to/index.html all /absolute/path/to/png-output /absolute/path/to/Hanzipen.ttc 逐页导出,并实际查看确认中文字体、标注遮挡、表格密度、代码公式边界和结论框。生成时间轴版命令:python3 scripts/build_timeline.py "/absolute/path/to/deck/index.html" --out "/absolute/path/to/deck/index-timeline.html"。
限制:部分脚本细节、字体下载方式及非 macOS 环境行为暂未提供;内容页数建议 12 到 24 页,每页仅留 3 到 6 行关键文字。