ppt-master 的 IBM 品牌身份预设解析：从 Carbon Blue 设计规范到可执行的 design_spec

• AI 技能
• 人工智能

本文面向希望在 AI 生成 PPT 时复刻 IBM 式企业视觉身份的开发者与使用者，讲解 ppt-master 仓库中skills/ppt-master/templates/brands/ibm/templates/design_spec.md这一「身份型」模板的完整结构：它如何用一份无 SVG 页面的轻量 Markdown 规范锁定颜色、字体、Logo、语气与图标风格，又如何在 Strategist 规划、Executor 构图、register_template.py校验的整条流水线中被消费。读完本文，你将掌握品牌身份预设（Brand preset）的字段语义、事实来源（provenance）规则，以及如何让 AI 生成的 deck 在「形似 IBM 却不冒充 IBM」的边界内保持专业克制。

一、定位：Brand 是「只拥有身份」的一类模板

在 ppt-master 的模板体系中，可复用模板被划分为brand/style/layout/deck四种相互独立的 kind，各自拥有不同的内容段（segment）。仓库根目录 templates/README.md 中的对照表说明了这种「正交」关系：

IBM 预设正是brand类的代表。它不携带任何*.svg页面原型，也不声明 Master/Layout/Placeholder 拓扑，只提供一个「身份契约」。文档开头的一句提示点明了这一设计：

Identity-only preset. No SVG page roster — pages are composed freely under these constraints.

翻译过来就是：页面构图完全自由，但必须在以下身份约束内进行。这一边界被 create-brand.md 的「Hard rule — identity only」显式固化：brand 只拥有颜色、字体、Logo、语气、图标风格——没有画布、间距系统、页面清单、SVG 原型或预览 PPTX。

二、Frontmatter：注册与发现的第一道事实

design_spec.md以 YAML frontmatter 开头，这是register_template.py读取注册条目、发现索引收录该模板的关键数据：

brand_id: ibm kind: brand summary: IBM-style enterprise identity — Carbon blue on a disciplined gray scale for hybrid cloud, AI, and enterprise consulting decks primary_color: "#0F62FE"

四个字段恰好对应 register_template.py 中定义的_BRAND_ALLOWED_FRONTMATTER_FIELDS = {"brand_id", "kind", "summary", "primary_color"}。从源码可见，brand 校验（_validate_brand_spec）会强制要求：

• brand_id非空，且在 library 作用域下必须与目录名一致（declared_id != expected_template_id即报错）；
• kind必须是brand；
• summary非空；
• primary_color必须匹配#RRGGBB格式，并且必须与正文## II. Color Scheme表格中primary行的色值完全一致（源码第 633–640 行的比对逻辑）；
• 正文必须依次包含 I–VI 六个必需章节（_BRAND_REQUIRED_SECTIONS），且不得出现Page Roster与Signature Design Elements两个被禁止的章节（_BRAND_FORBIDDEN_SECTIONS）——这是「brand 无页面结构」的机器级保障。

frontmatter 中的summary与primary_color会被写入 brands_index.json，成为聊天发现与 Stage-1 模板选择的唯一检索来源（routing.md §7 规定发现只读四个*_index.json，绝不扫描目录）。IBM 在索引中的条目为：

"ibm": { "summary": "IBM-style enterprise identity — Carbon blue on a disciplined gray scale for hybrid cloud, AI, and enterprise consulting decks", "primary_color": "#0F62FE" }

注册与重建索引的命令在 register_template.py 的 docstring 中给出：

python3 skills/ppt-master/scripts/register_template.py ibm --kind brand # 注册（library 作用域） python3 skills/ppt-master/scripts/register_template.py ibm --kind brand --dry-run # 仅预览校验结果 python3 skills/ppt-master/scripts/register_template.py --rebuild-all --kind brand # 整体重建索引

三、I. Brand Overview：场景、语气与来源边界

这里值得注意的是一以贯之的「事实来源纪律」。文档把来源区分为fact（官方事实）与approx（近似惯例）两类，并明确警告：只有 primary 是fact，其余每行都是approx，代表演示惯例而非官方 token。这与 create-brand.md 中定义的三种来源标签一脉相承——fact（官方资产或手册中的字面值）、user（用户在任意载体中明确写出的值）、approx（目测或观察模式）——并配套一条硬规则：绝不把估算值、演示惯例或观察到的中性色升级为官方事实，也绝不凭空发明一套语义化的 success/warning/error 配色。

四、II. Color Scheme：Carbon Blue 的六角色色谱

文档随后给出了一条关键的使用哲学，值得原样保留：

Blue 60 在该系统中被定义为「交互色」，用于按钮、链接与焦点态，而非装饰性品牌填充。在幻灯片上保持这种精神：把它用在决定性的标记与结构性强调上，而不是大面积染色。因为它读起来像链接色，避免把不可交互的正文设置成这个颜色。

这条约束非常实用：在 AI 生成的 deck 中，#0F62FE应作为「决定性强调」出现（标题强调、关键数字、可交互 CTA 暗示），而不是作为整页背景。文档同时强调，图表与状态语义色应由每个 deck 自行选择，不要把杜撰的 success/warning/error 三色组固化为品牌身份——这与register_template.py校验「颜色行来源必须为 fact/approx/user」的规则互相印证。

在流水线层面，这个色表会被 Strategist 的 strategist.md §e 消费：当品牌身份被确认安装后，六个颜色角色（background / secondary_bg / primary / accent / secondary_accent / body_text）会被重复锁定，open 角色才能变化；#525252这类次级文本与#E0E0E0分界线还会派生出标准的secondary_text与divider中性色，写入spec_lock.md colors。

五、III. Typography：不打包字体、不自动嵌入的务实默认

文档中的注释点明了这一行的来源与边界：

IBM 维护自己的开源字体家族，但本预设既不打包也不假设其已安装。PPT Master 不会在 PowerPoint 中自动嵌入字体，也不跟随 CSS 字体尾链。上表是默认的 Windows/Office 导出值；只有用户确认目标机已安装某个字体后，才可以替换。

这背后有两条工程事实：其一，Arial, "Microsoft YaHei", sans-serif是「拉丁 + 东亚（中文）」双栈，正好对应 executor-base.md §5 的规则——导出时取栈中第一个拉丁字体和第一个中文字体；其二，executor-base.md §5 明确规定「每个 font-family 栈只能指向交付目标上已安装或已获批的字体」，因此预设刻意选择通用字体而非 IBM 专属的 Plex 家族，正是为了在「未安装」时依然可导出、可编辑。若确实需要 IBM Plex 效果，正确做法是：用户确认目标机安装后，再在文档的 Typography 表中显式替换——这符合「只允许替换为用户确认的、目标机已安装的字体」的约束。

六、IV. Logo：none与「绝不」

• 文件：none
• 用法：never

这是整套预设中最严格的边界。文档明确指出：

没有捆绑任何 Logo 资产。IBM 的标志是受保护的商标，条纹式 wordmark 在没有官方素材的情况下重绘或缩放会严重劣化。当必须出现呈现实体时，用 deck 自己的排版设置为可编辑文本；或将官方提供的资产安装到本工作区的images/目录并在此添加使用规则。捆绑图标库中含有一个单色的simple-icons/ibm符号，仅用于真实的品牌识别场景（如合作伙伴或生态名录）——它是符号，不是官方 lockup。绝不明示或暗示关联、赞助、背书或认证。

仓库中确实存在该符号：skills/ppt-master/templates/icons/simple-icons/ibm.svg，这是一个viewBox="0 0 24 24"的单色路径图标。结合 templates/icons/README.md 可知，simple-icons是品牌徽标库（3,675 个真实公司/产品标记），其定位是「品牌识别」而非装饰：只在内容确实需要公司/产品/服务标记时准备（客户或合作伙伴 Logo、技术栈图标、页脚社交句柄），绝不能当作缺失通用图标的替补或装饰用途。在 IBM 预设的语境下，这条规则被进一步收紧为「symbol only, not the official lockup」——即使用该符号也仅代表生态关系，不构成官方标识。

七、V. Voice & Tone：正式、克制、证据驱动

• 正式度：formal
• 人称：we / you（英文），我们 / 您（中文）
• Emoji：禁止
• 缩写：首次出现先拼全称

文档补充说明这是「根据这类 deck 通常使用的语域推导出的演示惯例，而非官方品牌 token」，并要求：架构声明必须绑定具名组件与版本，把「当前具备的能力」与「路线图上的规划」区分开。这条纪律在 Executor 的内容边界上同样有落点——executor-base.md §3 要求Fact ID必须从sources/*.facts.json解析并保持原值，Data class: scenario的数据必须打上「情景数据」可见标签，避免让编造的数字看起来像事实。

八、VI. Icon Style：统一的描边家族

• 偏好：stroke（描边）

演示惯例，非官方品牌 token。优先使用如tabler-outline这样一致的描边家族，全 deck 保持同一个家族，且只在图标能澄清某个角色、状态或关系时才使用。

这与 templates/icons/README.md 的硬规则一致：一个 deck 至多选择一个主样式库，tabler-outline是唯一的描边风格库（5,138 个图标，viewBox="0 0 24 24"，默认描边宽 2）；若选中描边库，还需在spec_lock.md icons中锁定全 deck 统一的stroke_width（可选1.5/2/3，默认2）。executor-base.md §4 给出了用法示例：

<use>赞分享