企业官网建设流程全解析

• AI 技能
• 人工智能

本文基于 skills/ppt-master/templates/decks/README.md 及仓库内两套真实 Deck 资源（中国电信、中汽研）撰写，旨在帮助开发者与 AI Agent 理解 Deck 模板的定位、design_spec.md契约、结构化 SVG 约束，以及从创建、校验到选择安装的完整工具链。

Deck 是 ppt-master 模板体系中"应用上下文 + 品牌身份 + 可复用结构"三位一体的资源类型，专门服务某一类反复出现的演示场景（如政企方案汇报、认证评测展示）。阅读本文后，你将掌握 Deck 与其他模板类型（Brand / Style / Layout）的边界、design_spec.md的完整字段语义、结构化 SVG 的 Master/Layout/Placeholder 元数据写法，以及svg_quality_checker.py、template_preview_pptx.py、register_template.py、apply_template.py等命令的实际用法。

一、Deck 模板的核心定位

在 skills/ppt-master/templates/README.md 中，四种可复用模板被定义为相互独立的类型，而非一条继承链上的不同阶段，每种类型各自持有不同片段：

Deck 的官方定义强调其"家族"属性：它描述资源本身，而不决定未来演示必须保留哪些页面或内容。一个 Deck 模板不是一份完成的成品演示，kind: deck也不意味着"镜像源 PPT"——最终由创建策略决定系统是全新创作，还是从已验证事实物化。

Deck 的行为轴（Axis）

其中replication_mode是理解 Deck 的关键开关：standard从任意通道证据全新创作紧凑型名册；fidelity需要 A/B 类页面证据，创作更宽泛的源对齐名册（每个保留的 Layout 对应一个 Slide 原型）；mirror仅允许.pptx类型 A 证据，将导入器输出原样发布为紧凑工作区，保留已验证的源身份与父子关系，但不合成缺失事实。该值是 AI 从自然语言意图加证据派生的，仓库明确规定"绝不要求用户选择这些标签"（见 skills/ppt-master/workflows/create-template.md Step 1）。

二、发现机制：decks_index.json

Deck 目录的 README不枚举任何 Deck，decks_index.json才是发现的唯一事实来源，映射关系为deck_id → { summary, canvas_format, page_count, primary_color }。索引摘要必须以"演示家族 + 预期结果"开头——视觉基调单独绝不能用于选择 Deck，必须打开其 Template Overview 判断适配度。

仓库当前登记的两条记录如实体现了这一约定：

{ "中国电信": { "summary": "中国电信政企数字化方案、转型规划与内部评审，用于说明方案并对齐决策和下一步；采用克制的红灰品牌视觉。", "canvas_format": "ppt169", "page_count": 5, "primary_color": "#C00000" }, "中汽研": { "summary": "中汽研认证展示、评测汇报与技术交流，用于建立可信理解并推进评审或合作；采用专业的深蓝工程视觉。", "canvas_format": "ppt169", "page_count": 5, "primary_color": "#004098" } }

注意两条摘要都把"面向什么场景、达成什么结果"放在首位，色彩描述仅作辅助。这与 skills/ppt-master/workflows/routing.md §7 的硬规则一致：发现只读四类*_index.json，绝不扫描类型目录来构造或补充目录；register_template.py是唯一写入索引的通道。

三、design_spec.md 契约：可移植元数据 + 包自有规则

Deck 的design_spec.md只承载"可移植元数据 + 包自有应用、身份与结构规则"，不包含通用 SVG 规则、间距库、字体比例带或规范占位符表（这些通用约束由 shared-standards-core.md 统一持有）。完整模板如下：

--- deck_id: <slug> kind: deck category: brand | general | scenario | government | special summary: <one-line recurring presentation family and intended outcome> primary_color: "#XXXXXX" canvas_format: ppt169 canvas_width: 1280 canvas_height: 720 canvas_viewbox: "0 0 1280 720" replication_mode: standard | fidelity | mirror native_structure_mode: structured page_count: <N> --- # [Template Name] — Design Specification ## I. Template Overview ## II. Color Scheme ## III. Typography # omit only when the shared default is used ## IV. Signature Design Elements ## V. Page Roster ## VI. Assets # omit when none ## VII. Placeholder Overrides # omit when none

字段语义与取值

• deck_id：库工作区 ID（<slug>），必须与库目录名一致；create-deck.md §4 校验这一一致性。
• category：发现分类，取brand/general/scenario/government/special之一；两套内置资源均为brand。
• summary：一行描述"反复出现的演示家族 + 预期结果"，禁止只写视觉基调。
• primary_color：品牌主色，须为#RRGGBB，且要与 Color Scheme 中主色行、SVG 实际填充一致。
• canvas_*：画布格式（ppt169）、像素宽高（1280×720）与viewBox；从源码看两套 Deck 都还带source_canvas_width/height与source_viewbox字段，用于记录 PPTX/SVG 支撑模板的源画布事实。
• replication_mode：机器溯源字段，记录工作区如何产生，不是用户选择。
• native_structure_mode：固定为structured，声明该工作区带有明确的 Master/Layout/Placeholder 契约。

章节内容规则

Template Overview是描述性应用上下文——家族、目标受众/结果、交付与阅读假设、代表性角色。规则要求它"当源支持相关用途时足够宽泛，又要具体到能帮助 Strategist 理解资源"。Page Roster列出每个 SVG 的 Master/Layout 身份、角色、视觉特征、可复用槽位与容量，绝不标记页面为 required/optional/repeatable，也绝不标记内容为 fixed/replaceable/example-only——哪些原型被采用、以何种顺序出现，是下游 Strategist 的规划决策。每新增一个额外的 authored Master，就是一组独立可复用的设计家族（源码 templates/README.md 明确禁止"每 Layout 一个 Master"或组织性重复）。

四、真实 Deck 实例：中国电信与中汽研

中国电信（fidelity 创作）

• 应用上下文：政企数字化方案、转型规划、内部评审与客户汇报；受众为政企决策者、项目干系人与内部评审者；以会议讲解为主，同时需会后流转复核。
• 色彩体系：电信红#C00000（页眉胶囊、编号、强调）、银灰#D9D9D9（页眉结构带）、面板灰#F8FAFC（内容承载区）、石墨#111827（标题）、柔和灰#6B7280（辅助说明）、白#FFFFFF。
• 字体栈：中文"Microsoft YaHei", "PingFang SC", Arial, sans-serif；拉丁Arial, "Microsoft YaHei", sans-serif。仅使用常见系统字体，Windows 优先微软雅黑、macOS 回退苹方，不依赖额外字体安装。
• 两个 Master 家族：China Telecom Brand（服务封面、章节、收尾，统一承载白底、顶部红线、底部品牌飘带与英文标识）；China Telecom Content（服务目录与正文，统一承载红灰页眉、横向品牌标识与页脚分隔线）。

Page Roster完整记录了 5 个原型与其 PowerPoint picker 名称：

其images/目录维护了 6 个品牌资产：logo.png、header_brand.png、footer_ribbon.png、slogan_red.png、skyline_bg.png、top_emblem.png，各自标注了用途（封面/章节/结束页标识、页眉标识、底部飘带、品牌卡片口号、城市线稿等）。

中汽研（fidelity 创作）

• 应用上下文：产品认证展示、评测汇报、技术推广和业务来访；受众为客户、技术评审者、合作伙伴与来访团队；现场讲解为主，允许会后独立阅读。
• 色彩体系：CATARC 蓝#004098（深色页面背景、章节编号块、结构线）、深蓝#003B82（封面背景）、面板灰#F8FAFC、边框灰#E0E0E0、主文本#333333、白#FFFFFF。
• 两个 Master 家族：CATARC Dark（封面、章节、收尾，深蓝背景 + 上下结构线，封面不继承圆形几何，章节/结束页保留低透明度圆形）；CATARC Light（目录与正文，白底 + 方形章节号 + 页眉 Logo + 分隔线 + 底部蓝线）。

其目录页延续"数字 + 双竖线"的行式导航并保留右侧独立object槽位；内容 carrier 从槽位 bounds 左上角开始，封面/章节/结束页等短焦点内容允许在完整 bounds 内居中——这与 pptx-structure-interface.md §2 的槽位容量规则互为印证。

五、结构化 SVG 契约：Master / Layout / Placeholder 元数据

Deck 工作区的每个 SVG 都是符合 pptx-structure-interface.md §2 的完整 Slide 预览：{{...}}是创作词汇，data-pptx-placeholder*是原生契约。以中国电信01_cover.svg为例，可见完整的声明模式：

<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" ><deck_workspace>/ ├── templates/ # design_spec.md + 原型 SVG（本类型必有） ├── images/ # 可选位图；SVG 用 href="../images/<name>" ├── icons/imported/ # 可选导入矢量，唯一规范副本 └── exports/ # 可选评审证据：<deck_id>_template_preview.pptx

库范围（默认）写入skills/ppt-master/templates/decks/<deck_id>/并更新索引；项目范围使用初始化的projects/<name>/根，不注册。规范文件命名上，库根保持templates/design_spec.md（目录名承载 kind 与 id），项目根共享一个扁平templates/并按 kind 保留design_spec.<kind>.<id>.md，二者形态绝不混用。

创建命令链

Deck 创建统一从 create-template.md 进入，它派发且仅派发一个子工作流——create-deck.md。流程为：参考包摄入与分析 → 基于事实的简报提案 → 用户确认门 → 预检 + 调用子工作流 → 校验 → 原型评审轮 → 评审 PPTX → 注册索引。[TEMPLATE_BRIEF_CONFIRMED]未发出前禁止写入任何最终文件。

源类型决定可选策略：.pptx（类型 A）支持standard/fidelity/mirror，先用pptx_template_import.py建立导入工作区；SVG 资产（类型 B）仅支持standard/fidelity；图片、文本/文档/网站、无材料（类型 C/D/E）各自仅支持standard。mirror唯一合法路径是类型 A，通过导入器输出经 mirror publication 工具链（mirror_template_materialize.py）发布。

创建完成后的校验与评审命令（库范围）：

python3 skills/ppt-master/scripts/svg_quality_checker.py "<template_source>" --template-mode --canonical-authoring --format <canvas_format> python3 skills/ppt-master/scripts/template_preview_pptx.py "<authoring_workspace>" # exports/<deck_id>_template_preview.pptx python3 skills/ppt-master/scripts/template_preview_pptx.py "<authoring_workspace>" --native-charts-and-tables -o "<...>_native.pptx" python3 skills/ppt-master/scripts/register_template.py <deck_id> --kind deck --dry-run # 先试运行 python3 skills/ppt-master/scripts/register_template.py <deck_id> --kind deck # 通过后注册

工具行为详见 template-tools.md：

• svg_quality_checker.py --template-mode：对目录内*.svg做全量校验，强制"名册 ↔ 已解析 Design Spec"一致性（孤儿或缺失文件即报错），要求每个 SVG 根声明一个输出 Master 与 Layout（零槽位 Layout 合法），拒绝普通<g>Master/Layout、嵌套结构标记、缺失槽位 bounds 以及无恰好一个兼容 carrier 的 carrier 绑定槽位；并校验跨页 Master 相等性与同 key Layout 原子/槽位相等性。另支持--slot-capacity-report只读容量报告。
• template_preview_pptx.py：直接消费templates/*.svg，编译声明的结构化 Master/Layout 契约为exports/<deck_id>_template_preview.pptx，回读验证每原型一页、Master/Layout 计数精确、Master 对应独立 Theme 部件、p14:creationId唯一等；创作模式用临时 SVG 副本替换简洁预览样本文字，源 SVG、carrier 排版、槽位元数据与 Layout 框架均不变。
• register_template.py：从templates/design_spec.mdfrontmatter（优先）或散文加实际 SVG 名册派生索引条目并更新decks_index.json；--rebuild-all可批量重建某 kind 索引。
• apply_template.py：生成侧安装工具，见下节。

Deck 校验（create-deck.md §4）还要求 spec 含deck_id、kind: deck、点名家族/结果的summary、primary_color、画布字段、replication_mode、native_structure_mode: structured、page_count；Template Overview、Color Scheme、Signature Design Elements、Page Roster 必须存在且描述性、事实性，条件章节与实际选择匹配。

七、选择与安装：routing 与 apply-template-workspace

Deck 的选择与安装遵循 routing.md §7 与 apply-template-workspace.md。

选择边界（§7）：默认 Generate 的 Step 3 只准备候选，Stage 1 在一次交互中确认沟通契约与"自由设计或模板使用"；显式提供的当前工作区根保留为 Stage-1 候选并初始化模板模式，仅在它是唯一提供根时预选；裸模板名/品牌名从绝不解析到本地路径或预选，一律按风格简报处理。发现只读四个*_index.json，绝不扫描类型目录。

安装（apply-template-workspace.md）：安装前对每个根运行共享包校验器：

python3 ${SKILL_DIR}/scripts/svg_quality_checker.py "<workspace_root>/templates" --template-mode --canonical-authoring

随后一次运行完成映射、溯源行、资产复制、冲突拒绝与完成回执：

python3 ${SKILL_DIR}/scripts/apply_template.py <project_path> --root <workspace_root> [--root <workspace_root> ...]

关键规则：库根的templates/design_spec.md安装为design_spec.<kind>.<id>.md，并在 H1 下前置恰好一行> **Installed from**: \` (library|explicit)溯源；每个规范下方写一次，绝不合并 spec 正文。安装是原子事务——先解析全部源/目标路径，枚举跨根联合映射，解决 Layout 覆盖 Deck 的优先级（被遮蔽名册不进入映射），写入前拒绝每个目标冲突与重复 kind。若存在confirm_ui/template_selection.json，安装前必须字节匹配。安装后消费边界硬规则：后续角色只读<project_path>/templates/` 与项目本地资源池，库/外部根仅作为安装输入。

规划消费：安装后的 Deck 由 strategist-template.md 规划。其中template_reuse_scope: layout表示复用 Master/Layout 系统与原型；template_adherence: strict要求每个结构化页面适配现有原型契约而不改变 Layout 身份或槽位拓扑；adaptive允许在所选 Master 下新增显式 Layout。规划时"模板大小是证据而非策略"——短模板可在内容适配时使用每个原型，20–30 页源也可能只贡献几页或重组为新序列；绝不推断所有页面必须保留。

八、常见误区与边界（结论）

1. Deck ≠ 成品演示：Deck 描述可复用资源，具体选页、重复、顺序与内容处理由当前项目的 Strategist 根据材料决定；kind: deck不意味着镜像源 PPT。
2. 完整 PPTX 不自动选择 Deck：仅身份稳定 → Brand；沟通方法与视觉方向要随资源迁移而无身份真相/原型/原生结构 → Style；结构品牌中立且应用下游定义 → Layout；结构承载身份或可复用场景/内容语义才 → Deck（routing.md §5）。
3. replication_mode 是机器溯源：standard/fidelity/mirror由 AI 从意图与证据派生，持久化供工具使用，绝不让用户选择。
4. 遗留契约绝不就地升级：不完整的结构化包必须通过 Create Template 建立独立新工作区，再作为精确根交给生成流程；自由设计、品牌-only、风格-only 生成保持pptx_structure.mode: flat。
5. 索引是唯一发现源：聊天中"有哪些模板"只能列出索引工作区路径，Stage 1 仍要求用户在自由设计/模板使用间做出显式选择。

如需深入其他类型，可对照阅读 styles/、layouts/、brands/ 三套资源与各自 README；Deck 的结构化 SVG 细节可在 pptx-structure-interface.md 中完整查阅。

• AI 技能
• 人工智能