ppt-master Web 图片来源与内联署名Attribution执行规范executor-web-image 权限分支全解析【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master本指南聚焦 ppt-master 中 Web 图片来源Status: Sourced与衍生图的内联署名执行分支executor-web-image.md。你将在本文掌握如何依据image_sources.json的license_tier判定每张 Web 图片在幻灯片上的署名策略如何在所撰写的 SVG 中渲染可读、无歧义绑定到具体资产的署名以及svg_quality_checker.py如何逐文件校验作者与许可证、阻断缺失署名的导出。1. 分支定位条件性执行权Conditional Executor Authority在 ppt-master 的执行器Executor权限体系中executor-web-image.md是加载于executor-image.md之后的一个条件分支conditional branch专门授予 Executor 对Web 来源图片及其已制备衍生图进行内联署名inline attribution的执行权。上游依赖executor-image.md图片状态处理、放置与裁剪契约与 image-searcher.mdWeb 图片获取路径的角色手册。触发条件任何被放置且状态为Status: Sourced的图片或文件名中携带一份被复制进来的image_sources.json记录的衍生图。Quick 流程使用同一份清单manifest且不进行交互。从 executor-image.md 的状态处理表可以看出该分支是 Web 图片状态的下游消费者Sourced由 Image_Searcher 获取与Generated由 Image_Generator 生成且由清单背书两类资产都要求读取image_sources.json获取署名信息并加载 executor-web-image 分支。换言之来源记录一旦建立署名义务就自动落在 Executor 的 SVG 撰写阶段。2. 核心契约license_tier驱动的署名动作本分支的**契约Contract**非常明确查找filename对应的清单条目并依据license_tier采取动作——清单是署名的唯一事实来源single source of credits且署名必须在您撰写的 SVG 中渲染绝不能通过后处理post-processing或导出阶段补加。license_tier本页动作no-attribution仅image无署名attribution-requiredimage 可见的内联署名保留该资产的原作者、来源/提供商、以及 CC BY / CC BY-SA 许可信息manual仅image—— 用户提供的--from-url替换图其权利与署名责任由用户承担三种层级与 image-searcher.md §1 的许可层级纪律一一对应层级对应许可页内署名no-attributionCC0、Public Domain、Pexels License、Pixabay Content License无attribution-requiredCC BY、CC BY-SA页内内联text署名manual用户直接选定 URL 或采纳页图片许可未核验无——权利与署名责任在用户值得强调的是manual层级只允许--from-url直接替换或采纳页包图片绝不允许来源未知的提供商结果被归入manual。下游消费者Executor、校验器只读取license_tier从不自行解释原始许可字符串。3. 从清单到署名attribution_text 与压缩语法3.1 以attribution_text为起点Executor 的署名工作从清单的attribution_text字段起步。该字段由image_search.py写入清单时通过 provider_common.py 的build_attribution_text生成其规范格式为filename — title by author, via Provider, license: name (url)空字段会被优雅省略。例如team.jpg — Untitled via Openverse — license: CC0 (...)team.jpg — Sunset by Jane Doe via Wikimedia Commons — license: CC BY-SA 4.0 (...)3.2 允许压缩但不得丢失必需事实当来源保持清晰时文件名与完整 URL 可以去掉但作者与许可必须保留以便校验器能将署名与资产绑定。压缩语法示例来自 image-searcher.md §7team.jpg — Untitled via Openverse — license: CC0 (...)→via Openverse / CC0team.jpg — Sunset by Jane Doe via Wikimedia Commons — license: CC BY-SA 4.0 (...)→© Jane Doe / Wikimedia / CC BY-SA 4.0注意manual条目在清单中attribution_text为空见 image_search.py 中license_tier: manual时写入attribution_text: 因为其署名责任在用户。3.3 版式自由度与底线署名的大小、位置、颜色、逐图 vs 合并处理、标签、以及任何对比度遮罩/渐变都属于 Executor 的裁量范围per-image versus combined treatment、labels、contrast scrim/gradient前提是署名可读readable署名与对应资产无歧义地绑定unambiguously bound。4. 校验闭环svg_quality_checker.py的强制约束本分支给出明确的红线svg_quality_checker.py会在以下场景报错errors缺少图片专属的作者 许可署名——一个通用的 CC token 不能覆盖多张图片文件image_sources.json清单不可读缺少逐文件来源记录per-file provenance。这些错误必须在后处理或 Quick 导出之前修复。同时切勿把署名重复塞进演讲者备注speaker notes或其他产物中——署名只存在于 SVG 页面。4.1 校验器的真实实现证据在 checker.py 的_check_sourced_image_attribution中可以看到该契约的落地逻辑加载images/image_sources.json清单不可读则直接追加Invalid image source manifest: ...错误收集 SVG 内可见文本块_visible_svg_text_blocks会展开use引用并剔除隐藏/非视觉内容与被引用的图片 basename仅处理attribution_required或license_tier attribution-required且被 SVG 引用的条目从清单取author与license_name据此推导许可 tokenCC BY-SA或CC BY校验规则同一可见文本块中必须同时包含作者名大小写不敏感与许可 token否则报错Missing image-specific inline attribution for sourced image ...——这正是一个通用 CC token 无法覆盖多个文件的代码级体现。4.2 清单级别的来源一致性检查同一文件 checker.py 还执行项目级来源校验合法license_tier集合固定为{no-attribution, attribution-required, manual}出现其他值报sourced_image_invalid_license_tierSourced图片必须能在清单中找到条目sourced_image_missing_provenance除manual外attribution_text不得为空sourced_image_missing_attribution_textattribution-required条目的author不得为空sourced_image_missing_author。5. 触发与数据流从 Image_Searcher 到 SVG结合 executor-image.md 与 image-searcher.mdWeb 图片的完整数据流如下获取Image_Searcher通过 image_search.py 在开放许可提供商Pexels → Pixabay → Openverse → Wikimedia均为默认链中检索只下载一份许可已清license-cleared的原始图片到project/images/记录每次成功下载都会向images/image_sources.json追加或替换一条以filename为键的记录包含provider、license_name、license_url、license_tier、author、attribution_text、实测width/height、selection_method等见 image.md 的image_sources.json格式示例触发分支任何被放置的Sourced图片触发 executor-web-image 分支渲染署名Executor 读取清单依据license_tier决定是否在 SVG 中加入可见署名校验svg_quality_checker.py对每个引用 attribution-required 图片的 SVG 页面验证作者 许可成对出现任何缺失都会阻断后处理与 Quick 导出。如果图片在image_treat.py中生成了非破坏性 PNG 衍生图只要源文件名存在于images/image_sources.json新记录会**继承该法律来源provenance**并记录derived_from与有序treatments——这正是本分支放置的衍生图其文件名携带复制来的image_sources.json记录所指的场景。6. 实战自查清单在撰写或评审 Web 图片来源的幻灯片时按以下顺序自查触发识别本页是否有Sourced图片或带清单记录的衍生图有则加载本分支层级判定查image_sources.json中该filename的license_tierno-attribution/manual→ 仅imageattribution-required→ 必须加可见署名署名内容以attribution_text为起点可压缩文件名与 URL但作者 许可CC BY / CC BY-SA必须保留且与具体资产一一绑定版式落地大小、位置、颜色、合并/逐图、遮罩均自由裁量但保证可读性与无歧义绑定校验通过运行svg_quality_checker.py确认无Missing image-specific inline attribution类错误同时确认清单可读、逐文件来源记录齐全唯一性署名只出现在 SVG 中不要写入演讲者备注或其他产物。7. 相关参考文档executor-web-image.md——本文主题文档条件性署名执行分支executor-image.md——上游图片状态处理分支状态表、裁剪策略、硬规则image-searcher.md——Web 图片获取角色手册许可层级、查询翻译、署名契约 §7image.md——image_search.py参数表、批量运行器与image_sources.json完整格式checker.py——署名校验与来源一致性检查的实现provider_common.py——attribution_text规范字符串的生成实现【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考