pptx-posters

pptx-posters 是一个用于创建和审计可编辑科研海报的技能，输出为无宏的 PowerPoint（.pptx）文件。它仅依据作者已批准的本地内容与素材生成单页海报，不依赖 HTML 转换、外部模板、图像生成服务、API 密钥、环境文件或网络请求。

用途该技能适用于请求的源文件或交付物为可编辑 PowerPoint 海报的场景。若海报请求未明确指定格式，不应仅因 PowerPoint 可用而路由至此。版本 2.0 从严格的本地 JSON 生成真正的单页 .pptx。

主要能力

从严格本地 JSON 生成单页 .pptx。
提供严格的清单校验、素材审计、配色检查、导出规划、PPTX 生成、包安全检查与布局检查等命令行工具。
生成器创建全新空白演示文稿，使用原生标题占位符、文本框与本地图片，保持图片宽高比，禁用文本自动缩小，按批准顺序添加元素，写入替代文本与语言，不嵌入字体、音视频、OLE、ActiveX 或链接。
包检查器读取有界 ZIP 元数据与选定 XML，不提取成员或打开/执行演示文稿，拒绝非 .pptx 扩展名、宏/VBA、ActiveX、自定义 UI、OLE、嵌入、可执行与二进制部件、外部关系、不安全 ZIP 路径、符号链接、加密、超大扩展与过高压缩比、畸形或含实体的 XML、缺失内部关系目标。

使用方式安装依赖（在技能目录中）： uv venv uv pip install "python-pptx==1.0.2" "Pillow==12.3.0" "lxml==6.1.1" 生成需要精确版本：python-pptx==1.0.2、Pillow==12.3.0、lxml==6.1.1。所有 CLI 使用惰性可选导入，因此 python -B scripts/<tool>.py --help 无需这些包即可运行。使用 -B 避免字节码产物。

建立布局前的要求：分别记录物理裁切宽高与方向、每边出血、裁切内安全边距、PowerPoint 画布宽高、统一物理画板/画布打印比例、会议最大尺寸与交付格式、打印机裁切/出血/边距/缩放/色彩模式/打样要求、最终输出字体与栅格 DPI 阈值（标注为启发式或绑定确切来源）、所需字体、工作站可用性、嵌入许可与替换/打样工作流。没有通用海报尺寸。Microsoft 当前限制每个自定义 PowerPoint 尺寸为 1–56 英寸，且所有幻灯片使用同一尺寸。若物理画板更大，仅在打印机确认缩放时使用比例画布。阅读 references/poster_layout_design.md。

构建清单：复制 assets/poster_manifest_template.json 到项目。模板在解决所有替换标记、错误确认与草稿批准前故意无效。遵循 references/manifest_spec.md 与 references/poster_content_guide.md。清单要求：文档元数据、每个元素与每个素材的确切来源 ID；每个来源 author_verified: true；每个元素与素材 author_approved: true；本地 PNG/JPEG 路径与小写 SHA-256 哈希；每个可选图片的确切出处与许可/权限；批准的替代文本及需要时绑定来源的原生长描述；显式阅读顺序与设计矩形；每个本地二维码图片的可见确切回退 URL/文本；确认的会议/打印机规则；声明的 sRGB 对比对与冗余数据编码；批准绑定到规范清单内容。

在所有非批准字段通过后获取内容哈希： python -B scripts/validate_manifest.py poster.json
--print-content-hash 将该确切清单与哈希交给作者。然后设置 approval.status 为 approved，记录批准者与带偏移的时间戳，并复制哈希。任何非批准编辑都会使批准失效。

校验已批准清单与本地素材： python -B scripts/validate_manifest.py poster.json

生成前审计素材与配色： python -B scripts/inventory_images.py poster.json
--output poster.assets.json python -B scripts/check_palette.py poster.json
--output poster.palette.json python -B scripts/plan_export.py poster.json
--output poster.export-plan.json 有效 DPI 是像素除以最终放置英寸，而非图像元数据 DPI。清单完全解码有界图像并阻止 EXIF/XMP/注释与嵌入文本/应用元数据；离线剥离这些，然后重新哈希并重新批准素材。对比度使用 WCAG 2.2 sRGB 数学；将这些值应用于物理海报是设计目标，而非独立合规声明。保留颜色冗余标签、标记、形状、图案或线型。若打印机要求 CMYK，计划会阻止打印就绪，直到存在打印机批准的转换/配置文件与打样。不要声称原生 PowerPoint PDF 符合 CMYK。阅读 references/poster_design_principles.md。

生成 PPTX（使用新输出路径）： python -B scripts/generate_poster.py poster.json
--output poster.pptx
--report poster.generation.json 生成会创建新空白演示文稿，从不加载用户模板；在添加内容前设置批准画布；使用一个原生标题占位符、原生文本框与本地图片；以 contain 拟合保持图片宽高比；禁用文本自动缩小；按批准阅读顺序添加元素；将批准的图片替代描述与显式文本语言写入 PresentationML；不嵌入字体、音频、视频、OLE、ActiveX、链接或其他媒体；移除默认打印机设置二进制数据并规范化包时间戳；在替代文本补丁前后检查包；拒绝重叠、越界形状、最终字号/DPI 过低、不安全包与已存在目标。它渲染确切清单文本，不撰写、总结、研究或更正科学内容。

运行最终技术审计： python -B scripts/inspect_pptx.py poster.pptx
--output poster.package.json python -B scripts/check_layout.py poster.pptx
--manifest poster.json
--output poster.layout.json

手动 PowerPoint 与无障碍门：自动化无法认证无障碍、文本渲染或科学准确性。在完全修补的 PowerPoint 中：仅打开生成且技术干净的文件；运行 Review > Check Accessibility；检查阅读顺序窗格与对象名称；审查每个替代文本与原生长描述；测试键盘与屏幕阅读器导航；确认字体已安装/许可，检查嵌入选择、替换、字形、公式、溢出、对比度与所有边缘；验证颜色从不是唯一编码；测试每个二维码及其可见回退 URL/文本；获得作者对所有内容与引用的签字。Microsoft 的 18 pt 幻灯片建议不是通用海报最小值。使用清单标注依据与打样在最终物理输出评估字号。

导出与打印：使用批准的导出计划。需要 PDF 时，从已审查的 PowerPoint 使用 Standard/高打印质量导出，而非 Minimum size。独立验证 PDF：页面/画板尺寸、方向、裁切与出血；如需要单页输出；字体、裁剪、字形、公式与图像重采样；标签、阅读顺序、替代文本、语言与链接；RGB/CMYK 转换与物理色彩打样；会议命名、文件大小与上传规则。打印缩小比例打样并获得打印机要求的打样。任何更改后重新运行所有检查。使用 assets/poster_quality_checklist.md 进行发布签字。

适用场景适用于需要可编辑 PowerPoint 科研海报、且作者已提供确切内容与本地素材、会议与打印要求已确认的场景。

限制

不适用于未明确指定 PowerPoint 的海报请求。
任何声明、数字、引用、作者、单位、资助声明、图片、许可或二维码目标未解决时停止。
当前会议与打印机要求未确认时停止。
作者批准未绑定当前清单内容哈希时停止。
素材为远程、位于清单目录之外、未哈希或未批准时停止。
输入为 .pptm、含宏/外部关系/OLE/嵌入文件或不可信模板时停止。
请求的工作流需要自动打开或执行 PowerPoint 时停止。
脚本报告包、布局、DPI、对比度或输出计划阻塞时停止。
绝不编造缺失材料或留下看似合理的占位符。草稿失败关闭。
自动化无法认证无障碍、文本渲染或科学准确性。
不声称原生 PowerPoint PDF 符合 CMYK。
版本特定细节可能过时，需对照已安装版本的官方文档确认。

技能介绍