agents 插件市场中的 PPTX Deck Creation 插件基于坐标契约与 OOXML 只读审计的可编辑 PowerPoint 生成工作流【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents本篇技术指南以plugins/pptx-deck-creation插件的 README 为核心完整讲解 agents 插件市场中这套 PPTX 演示文稿生成体系的架构与用法它以「最终英寸坐标 JSON layout_tree 契约」取代隐式自动排版通过五个技能模块叙事上下文、幻灯片规格、视觉资产、参考演示分析、质量门禁协作从简报和源材料生成原生可编辑的 PowerPoint 文件。读完后你可以理解该插件的完整工作流、各技能模块的职责边界、layout_tree契约的字段结构以及内置 OOXML 校验脚本的安全限制与运行方式。插件定位任务专用的可编辑 PPTX 生成器根据 插件 READMEPPTX Deck Creation 的目标是「从简报和源材料创建可编辑、达到生产就绪水准的 PowerPoint 演示文稿」。它提供的核心能力包括一套面向商业叙事与设计上下文准备的预处理工作流以最终英寸inch坐标描述的layout_tree契约而非隐式自动布局原生可编辑的 PowerPoint 文本、形状、线条、表格、连接器和辅助图片对参考演示文稿和 OOXML 包的只读分析源幻灯片绝不被复制或修改几何geometry、可访问性accessibility、源血缘source lineage与 OOXML 包完整性四类检查。README 同时明确了该插件的边界Boundaries这些约束直接决定了它的工程形态只在用户明确要求 PPTX 时才创建一个小型的、任务专用的python-pptx构建脚本不附带通用渲染器renderer、不克隆模板、不依赖浏览器、不使用 MCP 服务器不需要任何凭据或在线服务配套的pptx-reference-deck-analysis技能提供安全的只读 OOXML 工具其可选本地依赖仅为defusedxml见 requirements.txt约束为defusedxml0.7,1任务级的高层提取可额外使用python-pptx。这套设计哲学的核心是「契约优先」布局坐标由规格文件显式声明并作为审计依据构建脚本只负责忠实映射坐标渲染结果永远可以被逐项比对验证。整体组件与六步工作流该插件在仓库中由一个 Agent 和五个技能模块组成组件路径职责Builder Agentagents/pptx-deck-creation-builder.md创建、修复、审计生产就绪可编辑 PPTX 的总控角色上下文准备skills/pptx-deck-context/SKILL.md商业叙事、源血缘、设计锁定幻灯片规格skills/pptx-slide-specification/SKILL.md编写坐标显式的 JSON 布局契约视觉资产skills/pptx-visual-assets/SKILL.md筛选与放置辅助图片、图标、图表参考演示分析skills/pptx-reference-deck-analysis/SKILL.md只读提取设计证据 安全 OOXML 检查质量门禁skills/pptx-quality-gates/SKILL.md交付前的几何、可访问性、血缘、包完整性校验Builder Agent 定义了不可协商的硬性规则参考演示必须保持只读每张幻灯片使用独立撰写的坐标显式布局只用原生对象承载标题、说明、标签、指标、表格、图表和流程图图片仅作辅助不虚构缺失的品牌、来源、许可证或可访问性事实遇到缺口要显式声明并请求决策生产级交付需同时保留规格、构建记录、源清单、审计报告和 PPTX 文件。Agent 的完整工作流分为六步确认受众、核心决策、源材料、幻灯片数量、语言和方向若未提供叙事框架请用户选择而不是默认准备叙事、源清单与设计上下文如提供了参考演示进行只读分析仅当高层提取无法确定所需事实时才深入检查其 OOXML 包编写完整 JSON 布局契约最终英寸 bbox、z-order、样式、阅读顺序和源引用只选择已批准的辅助视觉资产保留宽高比、来源与 alt 文本按需使用每份演示专属的脚本构建随后审计演示文稿修复规格或构建器并重跑检查直至通过或只剩已记录的例外。交付时若用户请求演示规格则返回严格 JSON否则报告产物路径、假设、审计状态与未决事项。pptx-deck-context叙事框架与设计锁定上下文技能 负责在编写任何坐标或 PPTX 对象之前完成准备工作拥有「商业叙事、源血缘、设计锁定」三项职责。其决策序列为确认受众、决策、幻灯片数量、语言、来源与品牌要求使用用户选定的叙事框架若未指定提供mckinsey、scqa、pyramid、mece、action-title、assertion-evidence、exec-summary-first或custom供选择不得静默代选为每个指标、引用、图表数值和事实性声明分配稳定的源 ID并规划source_ref选择有记录的设计方向优先用户品牌指南其次只读参考演示证据再次是 design-profiles.md 中可复用的设计档案在编写幻灯片之前把框架、假设、源清单、调色板、字体、间距和签名元素记录到summary。该技能还要求一张幻灯片只传达一个信息设计参考只作为「设计证据」而非内容或资产来源未经记录的许可证证据不得复制外部字体、图片、图标或 Logo设计信号必须翻译成显式的填充、字体、间距和 bbox不依赖任何自动布局引擎。设计档案参考 提供三个可复用的文档化档案档案适用场景设计信号fluent-ui-design-tokens企业级、微软风格演示克制的中性色、清晰层级、基于 token 的间距、小圆角primer-primitivesGitHub 与开发者向演示干净表面、强文本对比、功能性强调色、紧凑标签editorial-minimal高管叙事与研究类演示大量留白、高对比字体、有限调色板、单一视觉母题使用档案时必须记录档案 ID、来源 URL如适用、已知许可证信息和最终样式锁定并把锁定结果翻译为layout_tree中显式的颜色、填充、字体、分隔线、卡片壳和 bbox。pptx-slide-specificationlayout_tree 坐标契约这是整个插件的「真相来源」。幻灯片规格技能 明确要求把最终坐标直接写在layout_tree中——没有任何渲染器可以在审计之后决定摆放位置、缩小文本或推断布局。必需契约包括根 JSON 包含summary和slides每张幻灯片具有稳定id、消息导向的title、可访问性阅读顺序和完整的layout_tree布局树声明幻灯片尺寸、根分组、以 id 为键的分组与对象、最终英寸 bbox、样式、z-index 与分类每个有意义对象必须包含id、kind、role、classification、content、style、bbox、z_index生产级summary包含显式layout_policy安全边距、内容底边、页脚顶边、最小间隙和可访问性元数据。layout-contract.md 给出了紧凑的 JSON 示例完整继承如下{ summary: { layout_policy: { safe_margin: 0.5, content_bottom: 6.7, footer_top: 6.85, minimum_gap: 0.12 }, accessibility: { language: en-US, presentation_title: Quarterly operating review } }, slides: [{ id: s01_overview, title: Operating margin improves after the cost reset, accessibility: { reading_order: [title] }, layout_tree: { slide_size: { width: 13.333, height: 7.5 }, root_group_id: root, groups: { root: { id: root, role: slide, layout_mode: absolute, object_ids: [title], group_ids: [], bbox: { x: 0, y: 0, width: 13.333, height: 7.5 } } }, objects: { title: { id: title, kind: text, role: title, classification: content, content: { text: Operating margin improves after the cost reset }, style: { font_size: 30, color: #111827 }, bbox: { x: 0.75, y: 0.55, width: 10.8, height: 0.65 }, z_index: 2 } } } }] }其中layout_policy的四个参数以英寸为单位safe_margin安全边距、content_bottom内容区底边、footer_top页脚轨道顶边、minimum_gap对象间最小间隙。layout_tree强调它是「审计契约而非渲染提示」。编写规则方面使用稳定可读的 ID 与绝对分组尺寸必须为正数英寸常规内容保持在安全边距内、页脚轨道之上只有背景layout_design对象允许全出血使用原生text、shape、line、table、image对象支撑性视觉中的标签和数值要重建为原生对象有意义的图片必须有 alt 文本来源性声明必须记录source_ref内容文本不低于 9 pt先缩短文案、调整尺寸或拆分密集内容而不是缩小字号使用共享网格、一致的间隙、显式颜色与字号、有意的 z-order。对应的构建契约要求任务级构建脚本从空白版式blank slide layout出发用Inches(...)映射所有 bbox显式设置换行、禁用的自动缩放、文本内边距、锚点、对齐、字体、颜色、线条设置、图片宽高比和隐藏幻灯片状态并在添加对象前拒绝零或负几何值。同一参考文件还给出了问题修复的优先级顺序移动或调整 bbox、改变 z-order或拆分密集幻灯片缩短文案或扩大可用文本 bbox改变字号只是最后手段内容不得低于 9 pt重新构建并将实际对象边界与契约比对。pptx-visual-assets辅助视觉资产规则视觉资产技能 的立场是「资产服务于信息绝不压平或替代可编辑内容」。工作流为仅当资产确实提升理解时才选择类型图标、图片、SVG、图表或信息图放置前确认本地资产路径、来源、使用权利与简洁的 alt 文本以最终英寸 bbox、有意的 z-index 和content/layout_design分类添加资产保持宽高比确保没有资产覆盖可读文本或将必要信息锁死在图片里。关键规则包括图标需简单清晰并与文字标签搭配图注放在图片旁边而非叠加其上只有真正的干净矢量才能称为 SVG禁止把栅格图包进 SVG 冒充可编辑必要的标签、图例、数值和流程步骤必须用原生 PowerPoint 对象重建若权利、来源或合适资产不可得宁可省略资产并报告缺口也绝不把占位符当作完成的视觉交付。提供方或来源细节记录在源清单中聊天中不得请求密钥。pptx-reference-deck-analysis只读参考演示分析与 OOXML 工具参考演示分析技能 把参考 PPTX 视为「设计证据」绝不复制、克隆或修改源演示。按需实现的小任务级python-pptx脚本可捕获五类信息紧凑提示上下文幻灯片数量与尺寸、文本摘要、形状数量、样式、品牌信号、模板使用与布局节奏完整提取summary、幻灯片与只读layout_tree证据目录诊断每个演示一份结果加一份清单样式母版分析颜色、字体、尺寸分布、母版/版式使用与流式模式派生模板目录零基源索引、版式角色、可用区域、占位符、视觉结构与约束。当高层提取无法暴露原始主题、关系、备注、批注、动画、媒体、母版或版式时才使用内置 OOXML 工具。三个脚本的用法如下先按 requirements.txt 安装defusedxml# 1. 紧凑 JSON 报告幻灯片顺序、文本、主题 token、关系、备注、批注、动画、媒体 python scripts/inspect.py deck.pptx # 2. 包完整性校验畸形 XML、断裂内部关系、内容类型缺口、重复版式链接、孤儿部件 python scripts/validate_package.py deck.pptx --output report.json # 3. 仅在确实需要原始包证据时才解包 python scripts/unpack.py deck.pptx output-dir从 inspect.py 源码看inspect()函数读取ppt/presentation.xml与ppt/theme/theme1.xml提取主题的clrScheme颜色 token 与majorFont/minorFont字体名按sldId与presentation.xml.rels的关系解析逐页收集文本a:t节点拼接、spTree形状计数、隐藏状态show0以及过渡/定时信息其main()强制要求恰好一个参数即输入 PPTX 文件。这些脚本自带一组防御性限制值得重点关注。以 inspect.py 中定义的常量为例validate_package.py 与 unpack.py 使用完全相同的值MAX_MEMBERS 5_000包内成员数量上限MAX_MEMBER_SIZE 100 * 1024 * 1024单个成员最大 100 MBMAX_TOTAL_SIZE 512 * 1024 * 1024解包后总量上限 512 MBMAX_COMPRESSION_RATIO 1_000单成员解压/压缩比超过 1000 视为可疑。_validate_archive()会同时拒绝符号链接成员_workspace_path()要求解析后的路径必须位于当前工作区内否则抛出Path escapes the current workspace错误。unpack.py的_validate_members()更进一步逐成员校验解包目标不逃出输出目录、不得覆盖输入包本身并对输出目录中的*.xml/*.rels用defusedxml.minidom美化输出以便人工检查。validate_package.py 的validate()则对每个 XML/rels 部件做良构性解析检查[Content_Types].xml的 Default/Override 条目遍历所有.rels文件把内部关系目标按.rels属主解析相对路径拼接 normpath拒绝..逃逸目标缺失或不安全即记录internal_relationship错误并核对ppt/presentation.xml中声明的幻灯片与包内实际部件的一致性。安全规则总结绝不修改提供的演示或盲目拷贝包部件到新演示从受信任工作区运行脚本用defusedxml解析不可信 XML不启用实体扩展、DTD 加载或网络访问主题颜色在未对照 color scheme 完全解析前只当作 token 看待。pptx-quality-gates质量门禁与审计清单质量门禁技能 在交付前使用并把确定性失败一律视为修复工作而非例外。工作流为确认规格、构建器、PPTX、源清单与审计路径构建前应用审计清单重新打开 PPTX 比对幻灯片数、实际边界、隐藏幻灯片与请求几何生产级演示必须运行pptx-reference-deck-analysis/scripts/validate_package.py并保存 JSON 报告检查文档语言、幻灯片标题、有意义图片的 alt 文本、阅读顺序、表格表头与源引用若已有兼容渲染器则检查预览中的裁剪、字体回退、对比度、裁切与层级但不新增渲染器依赖修复后重建并重跑同一套检查。audit-checklist.md 给出完整清单。构建前共 10 项内容碰撞内容 bbox 不得重叠判定式为A.x B.x B.w B.x A.x A.w A.y B.y B.h B.y A.y A.h文本容量预判溢出时缩短、调整或拆分CJK/全角文本按每行字符数减半估算字号阶梯内容文本不低于 9 pt设计上下文summary.design_context必须指明样式锁定或已批准来源除非用户明确要求否则拒绝默认主题的朴素「标题加项目符号」输出布局策略内容处于安全边距内、页脚轨道之上只有layout_design允许全出血包含关系子对象在父分组内形状上文本尊重内边距表格列宽之和等于表格 bbox换行文本可容纳长表格拆分原生可编辑性标题、标签、数值、图表和解释保持原生对象图片仅起辅助作用血缘来源性声明具有可解析的源 ID、定位符、声明类型与验证状态正几何所有对象尺寸为正数构建前归一化线段端点。构建后 4 项重新打开包比对实际幻灯片数、边界、隐藏状态与规格检查可访问标题、语言、阅读顺序、alt 文本与表头运行 OOXML 包校验器修复畸形 XML、断裂关系、内容类型缺口与重复版式链接记录已接受的警告渲染器预览检查裁剪、字体回退、对比度、裁切、层级。通过标准零内容碰撞、零文本溢出、零越界内容、零非法正几何、零包完整性错误有意义的幻灯片内容必须保持为原生可编辑对象。任何被接受的例外必须记录幻灯片 ID、对象 ID、责任人、原因与复核日期。安装与使用方式在 agents 仓库多框架 agentic 插件市场为 Claude Code、Codex、Cursor、OpenCode、GitHub Copilot 与 Google Antigravity 提供统一 Markdown 源中该插件的安装方式与仓库其余插件一致参见仓库 README# Claude Code /plugin marketplace add wshobson/agents /plugin install pptx-deck-creation只安装其中技能而不安装完整插件时可直接使用 Agent Skills 安装器从仓库plugins/*/skills/读取# 例如只安装 OOXML 只读分析技能 gh skill install wshobson/agents pptx-reference-deck-analysis --agent claude-code npx skills add wshobson/agents --skill pptx-reference-deck-analysisCodex 与 Cursor 可通过各自市场注册表安装npx codex-marketplace add wshobson/agentsAntigravity 与 OpenCode 则走make generate 安装脚本的流程。技能自带脚本inspect.py、validate_package.py、unpack.py是纯 Python defusedxml无网络依赖可在本地工作区直接运行。小结PPTX Deck Creation 插件把「生成可编辑演示文稿」从一次性渲染问题转化为可审计的工程问题pptx-deck-context锁定叙事与设计pptx-slide-specification产出以英寸为单位的layout_tree审计契约pptx-visual-assets保证视觉资产只做辅助pptx-reference-deck-analysis以只读方式从参考演示提取设计证据并提供带防护上限的 OOXML 检查脚本pptx-quality-gates用构建前/后清单闭环验收。配合pptx-deck-creation-builderAgent 的六步工作流整套体系在无需浏览器、MCP 服务器、凭据或在线服务的前提下把几何、可访问性、源血缘与包完整性都变成可重复验证的交付标准。【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考