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导读本指南以pptx-deck-creation插件中pptx-visual-assets技能所引用的 asset-guidance.md 为骨架系统讲解在可编辑 PPTX 演示文稿中引入外部视觉资产图标、图片、SVG、图表、信息图时必须遵守的四类硬性约束来源溯源Provenance、版面放置Placement、SVG 使用边界与信息图处理原则。文章同时结合该插件内建技能、构建流程与审计检查清单说明这些约束如何落地为可执行的工作流。读完本文你将掌握一套可溯源、可审计、不破坏原生可编辑性的视觉资产放置规范并能在实际构建演示文稿时直接套用。一、asset-guidance 在插件中的定位在pptx-deck-creation插件中视觉资产处理被收敛为独立技能 pptx-visual-assets。该技能的描述明确限定其适用范围Use when selecting and placing approved supporting icons, images, SVGs, diagrams, or infographics in an editable PPTX deck.——即仅用于在可编辑 PPTX 中选取并放置已批准的辅助性图标、图片、SVG、图表或信息图。asset-guidance.md 正是该技能引用的底层参考文档见 SKILL.md 末尾See references/asset-guidance.md for licensing, placement, and SVG constraints.承载着三类核心约束许可与来源licensing、放置placement、SVG 边界。它服务于整个插件更上层的总体原则创建可编辑、可投产editable, production-ready的演示文稿标题、说明、标签、指标、表格、图表与图示必须使用原生 PowerPoint 对象图片只能是辅助性视觉supporting visual绝不能把关键信息锁死在图片里参见 pptx-deck-creation-builder.md 的Non-negotiable rules。二、来源溯源Provenance先证明可用再谈放置asset-guidance 的 Provenance 一节是放置任何外部资产的前置门槛原文要求在放置外部资产之前必须记录其本地路径local path、来源 URL 或提供方source URL or provider、使用权利usage rights以及简洁的替代文本concise alt text。其中包含三条硬性规则权利不明即弃用If rights are unknown, do not use it. 当资产的使用权无法确认时不允许使用该资产而不是先放上去再说。不得在对话中索要机密Never request secrets in chat. 来源凭证、授权密钥等敏感信息不得出现在聊天上下文中。留痕成档来源信息需要沉淀为可检索的记录。这一原则在技能层被进一步具体化。pptx-visual-assets的 Rules 规定若权利、溯源或合适资产不可得应当省略该资产并上报缺口且绝不允许将占位符当作成品视觉Never add a placeholder as a finished visual同时要求在来源清单source manifest中记录提供方或来源细节绝不在聊天中索取机密。构建者 Agentpptx-deck-creation-builder.md也有一条对应规则Do not invent missing brand, source, license, or accessibility facts. State the gap and request a decision.——不允许臆造缺失的品牌、来源、许可或无障碍信息而是要陈述缺口并请求决策。这意味着一套完整的资产准入链路找到候选资产 → 确认本地路径与来源核实使用权利权利不明则直接放弃编写简洁、语义准确的 alt text与无障碍要求衔接见下文审计清单第 12 条将来源信息写入 source manifest与构建记录build record一并归档对应构建者 Agent 的 Delivery 原则preserve the spec, build record, source manifest, audits, and PPTX together。三、版面放置Placementbbox、宽高比与 z 序Provenance 通过后资产进入放置阶段。asset-guidance 的 Placement 一节给出四条具体约束显式 bbox 且保持原生宽高比图片应放入显式的边界框explicit bbox并通过 fit自适应缩放或有意的 crop-to-fill裁切填充保持其原生宽高比而不是随意拉伸变形。图注放在相邻空间而非压在图上说明文字caption应置于图片旁的独立空间。z 序上视觉资产要低于重叠的可读文本即不得让图片覆盖文本。空间为负则省略并修复版式若某资产导致剩余空间为零或负值应省略该资产并修复布局而不是强行压缩排版。3.1 与 layout_tree 契约的对应关系显式 bbox 明确 z 序在插件中不是口头要求而是layout_tree审计契约的硬性字段。参考 layout-contract.md生成的 deck 以 JSON 根节点含summary与slides描述每个对象都携带以英寸为单位的bboxx、y、width、height、z_index以及classificationcontent或layout_design等字段。例如契约中的标题对象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 } }可见显式 bboxz 序分类三者正是layout_tree的一等公民字段。pptx-visual-assets的 Workflow 第 3 步也明确要求资产放置时必须给出最终英寸 bbox、刻意的 z-index并标注content或layout_design分类。3.2 与审计检查清单的衔接放置约束的验证落在 audit-checklist.md 中构建后必须逐条核验内容碰撞检查A.x B.x B.w B.x A.x A.w A.y B.y B.h B.y A.y A.h——内容 bbox 两两不得重叠这正是图注不压图、图片不压文字的几何化表达版面策略内容须保持在安全边距内并高于页脚轨道只有layout_design分类允许全出血full bleed——即普通图片不应越界覆盖文本区原生可编辑性标题、标签、数值、图表与解释必须是原生对象图片仅作支撑images are support only无障碍构建后需检查有意义的图片 alt textmeaningful-image alt text——这正是 Provenance 阶段编写 alt text 的验收环节。3.3 空间为负时的修复顺序省略资产并修复布局对应 layout-contract.md 中定义的 Repair order修复顺序先移动或调整 bbox 尺寸、改变 z 序或拆分过密的幻灯片其次缩短文案或扩大可用文本 bbox再次才考虑调整字号且内容字号绝不低于 9pt最后重建并对照契约比对实际对象边界。该顺序与图片让位于文本的放置原则完全一致——文本的可读性优先级高于装饰性视觉资产。四、SVG 约束向量源是可编辑的前提asset-guidance 的 SVG 约束一节点破了常见的伪可编辑陷阱Use a clean vector source for an editable visual. Do not wrap raster content in an SVG or claim it is editable.即只有干净的向量源才可作为可编辑视觉使用禁止把位图内容包进 SVG 并宣称其可编辑。对于 SVG 中承载的关键信息——必需文本essential text、图例条目legend entries、指标值metric values、流程标签process labels——必须用原生 PowerPoint 对象重新创建recreate。这对应插件的两条核心工程立场构建者 Agent 的规则Use native text, shapes, lines, tables, connectors, and images; never use a full-slide image as the slides meaningful content.以及Use native objects for titles, explanations, labels, metrics, tables, charts, and diagrams.pptx-visual-assets技能规则Use true SVG sources only when they are clean vectors; never wrap a raster image in SVG and call it editable.以及Recreate essential labels, legends, values, and process steps with native PowerPoint objects.背后逻辑很清晰PPTX 中可编辑指的是观众或后继者能在 PowerPoint 里直接改字、改数值、改标签。位图 SVG 只是把像素伪装成矢量外壳改动任何一处文本都等于重新制图因此它不满足可编辑交付物定义而真正的向量几何图形虽然可缩放不失真但其内的文本若未被重建为原生对象仍无法被搜索、朗读或编辑。审计清单第 12 条accessible titles、reading order、meaningful alt text正是对这一点的验收若关键信息仍在图片里无障碍与可编辑性审计即不通过。五、信息图Infographics辅助视觉 信息重建对生成式或外部提供的信息图asset-guidance 给出三条原则仅作辅助视觉Generated or externally supplied infographics are supporting visuals only——信息图无论来源如何都只能作为支撑性视觉存在不能替代原生内容对象。来源留档Keep their provenance with the build record——信息图的来源信息要与构建记录一同保存呼应 Provenance 一节的留痕要求。信息重建Recreate their essential information as native objects——其中的关键信息必须以原生对象形式重建即把信息图承载的结论、数据、流程翻译成原生文本、表格、图形而不是整图引用。这条原则与整个插件的设计哲学一脉相承参考 README.md插件交付的是原生可编辑的 PowerPoint 文本、形状、线条、表格、连接线与辅助图片Native editable PowerPoint text, shapes, lines, tables, connectors, and supporting images而非贴满整页截图的静态画册。信息图可以提升单页的信息吸收效率但它永远不能成为唯一的信息载体。六、把规范落进工作流从选取到审计的完整链路综合 asset-guidance 与pptx-visual-assets的 Workflow一套可执行的视觉资产处理链路如下选取仅在能提升理解力时选择对应资产类型——图标icon、图片image、SVG、图表diagram或信息图infographic准入确认本地路径、来源、使用权利与简洁 alt textProvenance 通过才继续否则省略并上报缺口放置以最终英寸 bbox、刻意 z-index 与content/layout_design分类落位保持宽高比检查无资产遮挡可读文本、无关键信息锁死在图片中重建SVG 与信息图中的文本、图例、指标值、流程步骤用原生 PowerPoint 对象重建审计对照 audit-checklist.md 执行碰撞检测、版式策略、原生可编辑性与无障碍检查归档将 speclayout_tree 契约、build record、source manifest、审计结果与 PPTX 一并交付构建者 Agent 的 Delivery 要求。整条链路中asset-guidance 管住资产能否用、怎么放、什么能用layout_tree契约管住放哪、多大多深、什么分类审计清单管住是否符合、是否可交付——三者共同把视觉资产不破坏可编辑性这一目标落实为可检查的工程规范。七、常见误区与核心结论最后梳理实践中最常见的四类误用对照 asset-guidance 逐条纠正误区正确做法依据来源不明的网络图片直接贴入记录本地路径、来源与使用权利权利不明则弃用Provenance 一节图注叠加在图片上、图片压住正文图注放相邻空间视觉资产 z 序低于可读文本空间不足则省略并修复版式Placement 一节把位图塞进 SVG 冒充可编辑矢量只用干净向量源文本、图例、数值、标签用原生对象重建SVG constraints 一节整页引用信息图当作内容信息图仅作辅助视觉关键信息以原生对象重建来源随构建记录归档Infographics 一节Asset guidance 的核心结论可以浓缩为一句话外部视觉资产在可编辑 PPTX 中永远是辅助而非主体其可用性取决于来源可溯、权利可证、信息可重建其放置必须显式化、不遮挡文本、不越界、不破坏布局。在agents24/agents仓库的pptx-deck-creation插件中这套约束已被编码进技能规则、layout_tree契约字段与审计清单可直接作为团队协作与自动化构建的验收标准使用。【免费下载链接】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），仅供参考 
长河君 · 2026/9/10 0:05:26 · 阅读 1.2k PPTX 可编辑演示文稿的视觉资产治理：来源溯源、版面放置与 SVG/信息图约束实践
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导读本指南以pptx-deck-creation插件中pptx-visual-assets技能所引用的 asset-guidance.md 为骨架系统讲解在可编辑 PPTX 演示文稿中引入外部视觉资产图标、图片、SVG、图表、信息图时必须遵守的四类硬性约束来源溯源Provenance、版面放置Placement、SVG 使用边界与信息图处理原则。文章同时结合该插件内建技能、构建流程与审计检查清单说明这些约束如何落地为可执行的工作流。读完本文你将掌握一套可溯源、可审计、不破坏原生可编辑性的视觉资产放置规范并能在实际构建演示文稿时直接套用。一、asset-guidance 在插件中的定位在pptx-deck-creation插件中视觉资产处理被收敛为独立技能 pptx-visual-assets。该技能的描述明确限定其适用范围Use when selecting and placing approved supporting icons, images, SVGs, diagrams, or infographics in an editable PPTX deck.——即仅用于在可编辑 PPTX 中选取并放置已批准的辅助性图标、图片、SVG、图表或信息图。asset-guidance.md 正是该技能引用的底层参考文档见 SKILL.md 末尾See references/asset-guidance.md for licensing, placement, and SVG constraints.承载着三类核心约束许可与来源licensing、放置placement、SVG 边界。它服务于整个插件更上层的总体原则创建可编辑、可投产editable, production-ready的演示文稿标题、说明、标签、指标、表格、图表与图示必须使用原生 PowerPoint 对象图片只能是辅助性视觉supporting visual绝不能把关键信息锁死在图片里参见 pptx-deck-creation-builder.md 的Non-negotiable rules。二、来源溯源Provenance先证明可用再谈放置asset-guidance 的 Provenance 一节是放置任何外部资产的前置门槛原文要求在放置外部资产之前必须记录其本地路径local path、来源 URL 或提供方source URL or provider、使用权利usage rights以及简洁的替代文本concise alt text。其中包含三条硬性规则权利不明即弃用If rights are unknown, do not use it. 当资产的使用权无法确认时不允许使用该资产而不是先放上去再说。不得在对话中索要机密Never request secrets in chat. 来源凭证、授权密钥等敏感信息不得出现在聊天上下文中。留痕成档来源信息需要沉淀为可检索的记录。这一原则在技能层被进一步具体化。pptx-visual-assets的 Rules 规定若权利、溯源或合适资产不可得应当省略该资产并上报缺口且绝不允许将占位符当作成品视觉Never add a placeholder as a finished visual同时要求在来源清单source manifest中记录提供方或来源细节绝不在聊天中索取机密。构建者 Agentpptx-deck-creation-builder.md也有一条对应规则Do not invent missing brand, source, license, or accessibility facts. State the gap and request a decision.——不允许臆造缺失的品牌、来源、许可或无障碍信息而是要陈述缺口并请求决策。这意味着一套完整的资产准入链路找到候选资产 → 确认本地路径与来源核实使用权利权利不明则直接放弃编写简洁、语义准确的 alt text与无障碍要求衔接见下文审计清单第 12 条将来源信息写入 source manifest与构建记录build record一并归档对应构建者 Agent 的 Delivery 原则preserve the spec, build record, source manifest, audits, and PPTX together。三、版面放置Placementbbox、宽高比与 z 序Provenance 通过后资产进入放置阶段。asset-guidance 的 Placement 一节给出四条具体约束显式 bbox 且保持原生宽高比图片应放入显式的边界框explicit bbox并通过 fit自适应缩放或有意的 crop-to-fill裁切填充保持其原生宽高比而不是随意拉伸变形。图注放在相邻空间而非压在图上说明文字caption应置于图片旁的独立空间。z 序上视觉资产要低于重叠的可读文本即不得让图片覆盖文本。空间为负则省略并修复版式若某资产导致剩余空间为零或负值应省略该资产并修复布局而不是强行压缩排版。3.1 与 layout_tree 契约的对应关系显式 bbox 明确 z 序在插件中不是口头要求而是layout_tree审计契约的硬性字段。参考 layout-contract.md生成的 deck 以 JSON 根节点含summary与slides描述每个对象都携带以英寸为单位的bboxx、y、width、height、z_index以及classificationcontent或layout_design等字段。例如契约中的标题对象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 } }可见显式 bboxz 序分类三者正是layout_tree的一等公民字段。pptx-visual-assets的 Workflow 第 3 步也明确要求资产放置时必须给出最终英寸 bbox、刻意的 z-index并标注content或layout_design分类。3.2 与审计检查清单的衔接放置约束的验证落在 audit-checklist.md 中构建后必须逐条核验内容碰撞检查A.x B.x B.w B.x A.x A.w A.y B.y B.h B.y A.y A.h——内容 bbox 两两不得重叠这正是图注不压图、图片不压文字的几何化表达版面策略内容须保持在安全边距内并高于页脚轨道只有layout_design分类允许全出血full bleed——即普通图片不应越界覆盖文本区原生可编辑性标题、标签、数值、图表与解释必须是原生对象图片仅作支撑images are support only无障碍构建后需检查有意义的图片 alt textmeaningful-image alt text——这正是 Provenance 阶段编写 alt text 的验收环节。3.3 空间为负时的修复顺序省略资产并修复布局对应 layout-contract.md 中定义的 Repair order修复顺序先移动或调整 bbox 尺寸、改变 z 序或拆分过密的幻灯片其次缩短文案或扩大可用文本 bbox再次才考虑调整字号且内容字号绝不低于 9pt最后重建并对照契约比对实际对象边界。该顺序与图片让位于文本的放置原则完全一致——文本的可读性优先级高于装饰性视觉资产。四、SVG 约束向量源是可编辑的前提asset-guidance 的 SVG 约束一节点破了常见的伪可编辑陷阱Use a clean vector source for an editable visual. Do not wrap raster content in an SVG or claim it is editable.即只有干净的向量源才可作为可编辑视觉使用禁止把位图内容包进 SVG 并宣称其可编辑。对于 SVG 中承载的关键信息——必需文本essential text、图例条目legend entries、指标值metric values、流程标签process labels——必须用原生 PowerPoint 对象重新创建recreate。这对应插件的两条核心工程立场构建者 Agent 的规则Use native text, shapes, lines, tables, connectors, and images; never use a full-slide image as the slides meaningful content.以及Use native objects for titles, explanations, labels, metrics, tables, charts, and diagrams.pptx-visual-assets技能规则Use true SVG sources only when they are clean vectors; never wrap a raster image in SVG and call it editable.以及Recreate essential labels, legends, values, and process steps with native PowerPoint objects.背后逻辑很清晰PPTX 中可编辑指的是观众或后继者能在 PowerPoint 里直接改字、改数值、改标签。位图 SVG 只是把像素伪装成矢量外壳改动任何一处文本都等于重新制图因此它不满足可编辑交付物定义而真正的向量几何图形虽然可缩放不失真但其内的文本若未被重建为原生对象仍无法被搜索、朗读或编辑。审计清单第 12 条accessible titles、reading order、meaningful alt text正是对这一点的验收若关键信息仍在图片里无障碍与可编辑性审计即不通过。五、信息图Infographics辅助视觉 信息重建对生成式或外部提供的信息图asset-guidance 给出三条原则仅作辅助视觉Generated or externally supplied infographics are supporting visuals only——信息图无论来源如何都只能作为支撑性视觉存在不能替代原生内容对象。来源留档Keep their provenance with the build record——信息图的来源信息要与构建记录一同保存呼应 Provenance 一节的留痕要求。信息重建Recreate their essential information as native objects——其中的关键信息必须以原生对象形式重建即把信息图承载的结论、数据、流程翻译成原生文本、表格、图形而不是整图引用。这条原则与整个插件的设计哲学一脉相承参考 README.md插件交付的是原生可编辑的 PowerPoint 文本、形状、线条、表格、连接线与辅助图片Native editable PowerPoint text, shapes, lines, tables, connectors, and supporting images而非贴满整页截图的静态画册。信息图可以提升单页的信息吸收效率但它永远不能成为唯一的信息载体。六、把规范落进工作流从选取到审计的完整链路综合 asset-guidance 与pptx-visual-assets的 Workflow一套可执行的视觉资产处理链路如下选取仅在能提升理解力时选择对应资产类型——图标icon、图片image、SVG、图表diagram或信息图infographic准入确认本地路径、来源、使用权利与简洁 alt textProvenance 通过才继续否则省略并上报缺口放置以最终英寸 bbox、刻意 z-index 与content/layout_design分类落位保持宽高比检查无资产遮挡可读文本、无关键信息锁死在图片中重建SVG 与信息图中的文本、图例、指标值、流程步骤用原生 PowerPoint 对象重建审计对照 audit-checklist.md 执行碰撞检测、版式策略、原生可编辑性与无障碍检查归档将 speclayout_tree 契约、build record、source manifest、审计结果与 PPTX 一并交付构建者 Agent 的 Delivery 要求。整条链路中asset-guidance 管住资产能否用、怎么放、什么能用layout_tree契约管住放哪、多大多深、什么分类审计清单管住是否符合、是否可交付——三者共同把视觉资产不破坏可编辑性这一目标落实为可检查的工程规范。七、常见误区与核心结论最后梳理实践中最常见的四类误用对照 asset-guidance 逐条纠正误区正确做法依据来源不明的网络图片直接贴入记录本地路径、来源与使用权利权利不明则弃用Provenance 一节图注叠加在图片上、图片压住正文图注放相邻空间视觉资产 z 序低于可读文本空间不足则省略并修复版式Placement 一节把位图塞进 SVG 冒充可编辑矢量只用干净向量源文本、图例、数值、标签用原生对象重建SVG constraints 一节整页引用信息图当作内容信息图仅作辅助视觉关键信息以原生对象重建来源随构建记录归档Infographics 一节Asset guidance 的核心结论可以浓缩为一句话外部视觉资产在可编辑 PPTX 中永远是辅助而非主体其可用性取决于来源可溯、权利可证、信息可重建其放置必须显式化、不遮挡文本、不越界、不破坏布局。在agents24/agents仓库的pptx-deck-creation插件中这套约束已被编码进技能规则、layout_tree契约字段与审计清单可直接作为团队协作与自动化构建的验收标准使用。【免费下载链接】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），仅供参考