PPTX 视觉素材治理指南：为可编辑 PPTX 幻灯片选择与放置图标、图片、SVG、图表与信息图

PPTX 视觉素材治理指南为可编辑 PPTX 幻灯片选择与放置图标、图片、SVG、图表与信息图【免费下载链接】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插件中的pptx-visual-assets技能Skill为主体系统讲解在可编辑 PPTX 幻灯片生产流程中如何选择、验证与放置辅助性视觉素材从素材类型判定、来源与版权核查到基于英寸 bbox 的精确放置、z-index 层级控制以及素材服务于信息、绝不替代原生内容这一核心纪律。读者学完后将掌握一套可直接落地的视觉素材放置流程、判定规则与质量红线能够在 pptx-deck-creation 插件 的 spec-first 工作流中产出既专业美观又保持完全可编辑的演示文稿。一、技能定位素材是支持而非替代pptx-visual-assets技能的开篇即给出其存在前提Use visual assets to support a slides message, never to flatten or replace editable content.这句话是整个技能的灵魂。在pptx-deck-creation插件所定义的可编辑、生产级 PowerPoint 交付边界内插件 README 明确承诺提供 Native editable PowerPoint text, shapes, lines, tables, connectors, and supporting images——即文本、形状、线条、表格、连接符以及作为支持的图片。可见图片及图标、SVG、图表、信息图从一开始就被限定为supporting角色标题、说明、标签、指标、表格、图表与示意图必须使用原生 PowerPoint 对象承载图片只负责增强表达、辅助理解不得把关键信息拍扁进一张图里从而牺牲可编辑性、可检索性与无障碍性。这与构建器 Agent 的硬性规则一脉相承pptx-deck-creation-builder.md 中同样写明 Use native objects for titles, explanations, labels, metrics, tables, charts, and diagrams. Images are supporting visuals only. 可以推断该技能正是这条全局纪律在素材放置环节的具体执行细则。二、四步工作流从判定到放置SKILL.md将素材处理收敛为清晰的四步流程任何一次素材引入都必须依次走过第 1 步仅在提升理解时选择素材类型可选素材类型共五种icon图标、image图片、SVG、diagram图表、infographic信息图。选择标准是是否提升理解improves comprehension而非页面是否太素。若素材不能帮助受众更快、更准地理解信息就不应该被引入。第 2 步放置前确认四项元信息本地路径local asset path素材在文件系统中的确切位置来源source素材出处来源 URL 或提供方使用权限usage rights是否允许在此场景使用简洁的替代文本concise alt text无障碍描述。这四项信息在放置之前就必须确认完毕而不是放置之后再补。这与技能规则中Record provider or source details in the source manifest记录到 source manifest 中的要求衔接。第 3 步带精确几何的放置放置时必须给出三个关键参数最终英寸 bboxfinal inch bbox以英寸为单位的最终边界框对应layout_tree契约中每个对象的bbox字段有意的 z-indexdeliberate z-index明确的层叠顺序分类classification归入content内容或layout_design布局设计。这些参数并非随意的实现细节而是pptx-slide-specification技能的硬性契约。在 布局契约示例 中可以看到layout_tree中每个对象都要求携带id、kind、role、classification、content、style、bbox、z_index八个字段其中classification直接决定对象是否可出血full bleed——规范要求只有背景layout_design对象可以全出血普通内容必须保持在安全边距内、页脚轨道之上见 pptx-slide-specification/SKILL.md。第 4 步放置后校验保持宽高比preserve aspect ratio不得随意拉伸变形不得遮挡可读文本任何素材不得覆盖可读文字不得把关键信息锁死在图片里如果一张图承载了观众必须看到的数据或结论就必须用原生对象重建这些信息。四步流程形成一个闭环判定 → 核验 → 精确放置 → 校验。后文将逐一展开每一条背后的规则与依据。三、六条放置规则详解规则 1图标必须简单、可读并与文字标签并排Use simple, legible icons alongside text labels.图标的价值在于快速识别。复杂花哨的图标在 0.5 英寸的占位内往往无法辨认反而制造认知负担。图标应与文字标签并排alongside出现形成图形 文字的互补而不是让图标孤零零地自证含义。规则 2说明文字放在图片旁边而不是压在图片上Place captions beside images rather than over them.说明文字叠压在图片上会同时伤害两件事文字的可读性背景图案干扰与图片的完整性。正确做法是在图片相邻的空间放置说明文字。这与 asset-guidance.md 的 Placement 章节完全一致Put a caption in adjacent space, not over the image. 这也意味着在规划layout_tree时要为图片和说明文字分别预留独立的 bbox而不是共用一个区域。规则 3只使用真 SVG严禁栅格图套 SVG 冒充矢量Use true SVG sources only when they are clean vectors; never wrap a raster image in SVG and call it editable.SVG 的价值在于可缩放、可编辑的矢量。如果一张 PNG 只是被塞进一个svg包装里那么它仍然是栅格图——放大依然会糊、信息依然无法以文本形式被检索。这种伪 SVG绝不能标注为可编辑视觉。判断标准很直接该 SVG 内部是否是干净的路径、形状等矢量指令凡是承载了必须可读的文字、图例、数值的内容都应改用原生 PowerPoint 对象重建。规则 4关键标签、图例、数值与流程步骤必须用原生对象重建Recreate essential labels, legends, values, and process steps with native PowerPoint objects.这是绝不 flatten 内容原则在具体对象类型上的展开。即使引入了一张信息图或参考图表其承载的关键信息也必须以原生 text / shape / line / table 对象的形式重建到幻灯片上。这样观众可以选中并阅读每一个数字与标签屏幕阅读器可以通过阅读顺序访问这些信息对齐 pptx-quality-gates 中的无障碍检查信息可以被修订、翻译、更新而不必重新出图。在 asset-guidance.md 的 SVG constraints 与 Infographics 两节中这一要求被重复强调Recreate essential text, legend entries, metric values, and process labels with native PowerPoint objects以及recreate their essential information as native objects。规则 5权限不明或素材不可得时宁可省略并上报缺口绝不占位If rights, provenance, or a suitable asset are unavailable, omit the asset and report the gap. Never add a placeholder as a finished visual.这条规则同时约束了两个错误倾向硬塞没有合适的素材也要凑一个——禁止占位用 image placeholder 之类的占位框充当最终视觉——同样禁止。正确动作是省略素材并明确上报缺口report the gap。这与构建器 Agent 的规则 Do not invent missing brand, source, license, or accessibility facts. State the gap and request a decision. 完全同构——不知道的事实就如实申报请用户决策而不是自行编造。规则 6来源必须记入 source manifest机密绝不在对话中出现Record provider or source details in the source manifest. Never request secrets in chat.每一条素材的提供方 / 来源信息都要记录进 source manifest来源清单。在 asset-guidance.md 的 Provenance 一节中要求记录四项本地路径、来源 URL 或提供方、使用权限、简洁 alt textIf rights are unknown, do not use it权限不明即不用。同时Never request secrets in chat 意味着素材获取过程中涉及的任何凭据都不应通过对话传递——需要保密的信息走受控渠道而非聊天明文。四、来源管理与版权红线Provenance 四要素references/asset-guidance.md将素材的溯源Provenance作为放置的第一前置条件。引入任何外部素材前必须先记录溯源要素要求依据出处本地路径素材在构建环境中的确切位置可被构建脚本引用asset-guidance.md / SKILL.md 工作流第 2 步来源 URL 或提供方能回溯到出处支撑授权核查asset-guidance.md使用权限明确可用权限未知 不用asset-guidance.md If rights are unknown, do not use it简洁 alt text放置时即写入供无障碍与质量门禁检查SKILL.md 工作流第 2 步这一要求与 pptx-deck-context 的设计纪律相互呼应——该技能要求 Do not copy external fonts, images, icons, or logos without recorded licensing evidence未经记录的许可证据不得复制外部字体、图片、图标或 Logo。也就是说素材的版权核验从叙事与设计准备阶段就已开始视觉素材技能是在放置环节做最终把关。五、与 layout_tree 契约的衔接bbox、z-index 与 classificationpptx-visual-assets的放置规则不是孤立约定而是直接对应 layout-contract.md 中的 JSON 契约。以下面这个契约片段为例可以直观看到素材对象在layout_tree中的形态{ 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 } } } }] }对照此契约素材对象应遵循以下映射关系final inch bbox→ 对象上的bbox字段单位英寸正值且不越界。pptx-slide-specification明确要求 Reject zero or negative geometry before adding an object加入对象前拒绝零或负几何。deliberate z-index→z_index字段。放置素材时要保证素材低于可读文字的 z 值从而不遮挡文字。asset-guidance.md 原文Keep visual assets below overlapping readable text in z-order.classification→classification字段取值content或layout_design。背景装饰类素材可归为layout_design从而允许全出血承载信息的素材归为content必须待在安全边距内。此外构建契约要求任务本地构建器从空白版式出发以Inches(...)映射全部 bbox并显式设置图片宽高比image aspect ratio、隐藏幻灯片状态等见 pptx-slide-specification/SKILL.md 的 Build contract。可见放置素材最终落到构建器对image对象的显式参数设置而非依赖自动布局引擎的推断。六、空间约束素材不得挤占剩余空间asset-guidance.md 的 Placement 部分还给出了一条容易被忽略的空间守恒规则If an asset produces zero or negative remaining space, omit it and repair the layout.即如果引入素材后幻灯片剩余空间变为零甚至为负那么宁可舍弃该素材并修复布局也不要压缩其他内容去硬塞。这保证了版面始终有呼吸感也直接支持 layout-contract.md 中layout_policy.minimum_gap最小间距这类参数的成立——间距与留白是契约的一部分不是可牺牲项。七、质量门禁与验证素材如何被审计素材放置完成后交付前的审计由pptx-quality-gates技能接管。该技能在验证阶段会检查详见 pptx-quality-gates/SKILL.md有意义图片的 alt text对应素材技能要求的concise alt text缺失或空泛会被视为缺陷阅读顺序reading order确保标题、正文与图片说明的可访问顺序合理零内容碰撞zero content collisions任何素材不得与文本或其他对象发生重叠冲突图片是支持而非替代通过审计确认 meaningful slide content must remain native editable objects; images support rather than replace it。同时生产级交付还会运行 validate_package.py 对 OOXML 包做完整性校验成员数量、成员大小、总解压大小、压缩比、符号链接、关系完整性等并输出 JSON 报告。这些检查保证了含图片的最终.pptx是一个结构合法、可被 PowerPoint 正常打开的包而不是只看着像的产物。八、素材类型速查与决策清单将全篇规则浓缩为一张决策表便于在实际放置时逐项对照检查项判定要点违规时的正确动作类型选择图标/图片/SVG/图表/信息图是否提升理解不能提升就放弃引入溯源本地路径、来源、使用权限、alt text 四项齐全权限未知 → 不用信息缺失 → 记录缺口并上报真实矢量SVG 内部是干净矢量指令非栅格套壳拒绝伪 SVG改用原生对象重建关键信息标签、图例、数值、流程步骤已用原生对象重建补建原生对象勿让信息锁死在图中几何放置bbox 为英寸正值、宽高比保持、z-index 低于文字修复 bbox / z 顺序空间引入后剩余空间不为零或负省略素材并修复布局占位符是否有占位框冒充成品视觉删除占位上报缺口记录来源与提供方已写入 source manifest补录 manifest九、总结一条可执行的核心纪律pptx-visual-assets技能的全部内容可以归结为一句话视觉素材是用来支持幻灯片信息传达的永远不能用来替代可编辑内容。围绕这句话它给出了从类型判定、来源核验、精确几何放置英寸 bbox z-index classification、宽高比保持、空间守恒到权限不明即弃用、缺口如实上报的完整执行链路并与插件内的 layout 契约、质量门禁 和 OOXML 包校验 形成相互咬合的治理体系。在实际项目中使用时只需沿着本指南第八节的决策清单逐项核对即可保证每一次素材放置都同时满足信息可编辑、来源可追溯、布局无碰撞、包结构合法。这就是在 spec-first 的可编辑 PPTX 生产流程中让美观与可编辑不再冲突的关键所在。【免费下载链接】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），仅供参考