PPT Master SVG 图标库实战指南12,027 个图标的选型、同步、嵌入与风格规范【免费下载链接】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导读本文档基于 skills/ppt-master/templates/icons/README.md 展开系统讲解 PPT Master 内置 SVG 图标库chunk-filled、tabler-filled、tabler-outline、phosphor-duotone、simple-icons五套共 12,027 个图标的完整使用链路从库的选型与风格定位到用icon_sync.py把图标同步进项目再到在 SVG 中用data-icon占位符编写图标、由后处理管线在生成与导出时真正嵌入。读完本文你将掌握 PPT Master 中按项目准备图标 → 编写占位符 → 最终嵌入的标准工作流理解图标库的命名、颜色、尺寸、搜索与版权边界等硬性规则并能直接套用在design_spec、spec_lock与 SVG 排版的实战中。一、库全景五套库、四种风格、一套品牌标识图标库位于 skills/ppt-master/templates/icons/是该项目的全局图标仓库global library源码与模板作者不会直接引用它——图标必须先被同步进具体项目SVG 排版阶段只解析项目本地的图标池见后文逐项目图标目录。1.1 库总览表库风格数量仓库实测viewBox前缀视觉定位chunk-filled填充 · 紧凑厚重的 16px 剪影641主要为0 0 16 16chunk-filled/粗重、实心tabler-filled填充 · 贝塞尔平滑圆润轮廓1,0550 0 24 24tabler-filled/中等、亲和tabler-outline描边/线性默认 stroke-width 25,1380 0 24 24tabler-outline/轻盈、精致屏幕表现最佳细描边在打印/投影时易变弱phosphor-duotone双色调 · 全不透明度主形 同色 20% 背板1,5180 0 256 256phosphor-duotone/中等、有层次simple-icons品牌 Logo真实公司/产品标识3,6750 0 24 24simple-icons/单色剪影用fill上色仓库实测文件数与 README 声明一致chunk-filled641、tabler-filled1055、tabler-outline5138、phosphor-duotone1518、simple-icons3675合计 12,027 个。注意simple-icons不属于风格库它是品牌标识库其收录内容刻意异构Slack 的紫、GitHub 的猫形标只服务于品牌可辨识度不应被当作缺失通用图标时的替代品或装饰。1.2 版权与商标边界每个库的上游版本、许可证、署名要求与商标边界都记录在 skills/ppt-master/templates/icons/THIRD_PARTY_NOTICES.md快照日期2026-08-09。chunk-filledCHUNK IconsCC BY 4.0本地做了规范化——根尺寸统一为 24×24、硬编码黑色填充改为currentColor、移除 SVG Repo 包装元数据、保留历史本地文件名。tabler-filled/tabler-outlineTabler Icons v3.46.0MIT分别含 1 个与 8 个历史拼写别名如mood-confuzed、brand-adobe-after-effect。phosphor-duotonephosphor-icons/core2.1.1MIT6 个历史别名archive-box等上游-duotone文件名后缀在本地被移除。simple-iconsSimple Icons 16.28.0项目本体 CC0 1.0含 222 个兼容文件对应 12.4.0 快照但 CC0 不代表每个品牌图标都是 CC0品牌标识可能有独立的许可、使用准则或商标限制使用前必须核查上游元数据与品牌方指南仓库收录并不授予商标使用权。这些许可信息是项目事实的一部分PPT Master 自身的 MIT 许可只覆盖项目本身不替代第三方资产的许可与署名要求。二、逐项目图标目录icon_sync.py同步工作流图标库目录是全局库资源负责人Resource Owner须先按需把选中的图标复制到project/icons/lib/之后 SVG 排版阶段才能使用python3 skills/ppt-master/scripts/icon_sync.py project_path tabler-outline/home tabler-outline/bulb simple-icons/github2.1 命令行语义icon_sync.py 的用法为python3 scripts/icon_sync.py project_path lib/name [lib/name ...]每个图标参数必须是完整的库/名称形式名称缺失、或同一批次混用了四个风格库chunk-filled/tabler-filled/tabler-outline/phosphor-duotone时命令以非零退出码结束simple-icons可以与某一个风格库共存已经存在于项目中的名字如自定义图标计为已满足satisfied不算缺失同步成功的图标打印[OK] n icon(s) in project/icons:缺失的打印[MISSING]并附带该库下的搜索提示同时返回非零退出码。从源码看_split_name()icon_sync.py对标识符做严格校验必须恰好含一个/、库必须属于_SYNC_LIBRARIES集合、名称不得为空或包含路径分隔符防目录穿越。sync_icons()icon_sync.py逐项把global_dir/lib/name.svg复制到project/icons/lib/name.svg源不存在但项目内已有同名文件时视为已满足。混合风格库的拦截位于main()icon_sync.py一个选择批次中stylistic_libraries超过 1 个就报错退出——这正对应 README 中至多选一个主风格库的选型规则。2.2 项目图标池的边界project/icons/下同步来的文件构成已备好图标池与用户提供、自定义或导入的图标自由组合finalize_svg.py --only embed-icons、预览、校验与原生导出只解析这个池绝不直接读取全局templates/icons/也不接受裸图标名见 embed_icons.py 的文档注释。自定义图标把.svg丢进project/icons/lib/任意lib例如custom/再用data-iconlib/name引用。导入矢量create-template工作流保留imported/命名空间——矢量素材只在workspace/icons/imported/name.svg保留一份规范副本以data-iconimported/name引用绝不复制进templates/也不作为手工精选库使用。create-template的目录预检template-designer.md会检查icons/imported/等目的地是否冲突。带插图的图标是images/下的透明切片遵循executor-image.md的规则永远不放进icons/、不进 inventory、也不通过use>use>g transformtranslate(100, 200) scale(3) fill#0076A8 path d.../ /g源码级细节generate_icon_group缩放按scale width / 库基准尺寸计算基准尺寸由ICON_BASE_SIZES字典定义embed_icons.pychunk-filled16、tabler-filled24、tabler-outline24、phosphor-duotone256、simple-icons24、imported24。颜色剥离_extract_shape_elementsembed_icons.py会移除子元素上的独立fill/stroke/stroke-width让外层g统一控制颜色与线宽从而保证fill属性真正生效。变换优先级若占位符带有transform实时预览编辑器直接改写过矩阵则它优先于x/y组合避免重复放置。描边语义描边风格库生成fillnone strokecolor stroke-widthn填充风格库生成fillcolor。颜色解析resolve_icon_colorembed_icons.py对描边库优先取fill、回退到stroke最终兜底#000000。保留色资产data-icon-stylepreserve-color标记由extract_svg_assets.py盖上表示该素材保留源色与自然 viewBox 宽高比不参与单色重着色内联时其相对href会重写为目标 SVG 目录下的相对路径_rebase_preserve_asset_hrefsembed_icons.py。finalize_svg.py是统一入口python3 scripts/finalize_svg.py project_directory --only embed-icons只执行图标嵌入步骤该步骤同时被svg_to_pptx原生导出内存复用删除它会同时破坏svg_final/输出与原生 PPTX 导出见 finalize_svg.py 的架构说明完整流程见 svg-pipeline.md。embed_icons.py还提供--dry-run只预览不写盘与--verbose便于排查。四、图标检索方法论按可绘制对象搜索而非抽象概念4.1 精确基线名直接同步已知确切基名时直接用icon_sync.py即可缺失会非零退出并提示无需额外存在性检查icon_sync.py。4.2 不确定时只在所选库内搜索rg --files skills/ppt-master/templates/icons/tabler-outline -g *chart*.svg rg --files skills/ppt-master/templates/icons/simple-icons -g *github*.svgsimple-icons只用于真实品牌标识的搜索。4.3 两条硬规则Hard rule按可绘制对象搜索不要按抽象概念搜索。这些库存储的是能画出来的东西bulb、target、trending-up、alert-triangle所以idea、goal、growth、warning、innovation在多数库中一无所获——先把语义翻译成对象再搜。这是参考而非约束一个概念通常有多个合法对象最终按页面注册表与视觉风格从 deck 中选择。基名在四个风格库之间不可移植。例如alert-*存在于 tabler 系列但phosphor-duotone用的是warning-*chunk-filled的arrow-trend-*在tabler-outline里是trending-*。不要加载全量索引或枚举宽泛关键词族在窄结果中重新挑选并重复批处理直到干净绝不为缺失的通用图标切换风格库。空结果 → 在同一个库内换一个可绘制翻译再试多次仍空 → 让图表、排版或形状等其他载体承担该语义而不是硬凑一个不贴切的图标。五、风格规则从 deck 的视觉需求出发5.1 没有默认库读完来源材料后按 deck 的视觉需求选型紧凑剪影chunk-filledvs 圆润曲线tabler-filled/phosphor-duotonevs 开放描边tabler-outline视觉重量从厚重实心 → 中等实心 → 中等分层 → 轻盈描边递进。5.2 一次 deck 选择至多一个主风格库当该库缺少精确图标时在其内部取最接近的替代而不是引入另一个内置库。这属于目录选型规则不是禁止组合项目icons/中已有的资产——executor-base.md明确 Executor 可以跨命名空间、跨风格自由组合项目本地图标只是不能自行获取新图标或把全局可解析文件当作已备好素材executor-base.md。5.3 品牌标识例外simple-icons不是风格库不占上述至多一个的额度它的职责是品牌辨识Slack 的紫、GitHub 的猫刻意异构。只当内容确实需要公司/产品/服务标识时才准备它——客户或伙伴 Logo、架构图里的技术栈图标、页脚的社交账号句柄——绝不作为缺失通用图标的替代品也不用于装饰。六、完整实战链路与规范落点把以上规则串成一条可执行的生成链路选型读来源 → 确定 deck 的视觉风格 → 选一个主风格库chunk-filled/tabler-filled/tabler-outline/phosphor-duotone必要时附带simple-icons取真实品牌标。同步python3 skills/ppt-master/scripts/icon_sync.py project_path lib/name ...同一批次只含一个风格库自定义图标直接放入project/icons/lib/。排版SVG 中用use contenteditable="false">【免费下载链接】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），仅供参考
