---

name: sn-ppt-standard description: 仅在 sn-ppt-entry 与 sn-ppt-story 已准备绝对 DECK_DIR 和 outline.md 后使用；生成每页独立 HTML（1600×900）、渲染 PNG、逐页讲稿、present.html，并按 static_postprocess 选择生成由 Standard 自有 exporter 转换的 PPTX。present.html 始终是必交付产物，缺失即技术故障，不得交付；static_postprocess 含 pptx 时 PPTX 同为必交付产物（缺一即技术故障），且只能由 Standard 自有 exporter 生成；仅当用户明确要求只要 HTML（static_postprocess 为 []）时，PPTX 才可不交付。

sn-ppt-standard

把本文件当作路线图，不要当作需要一次背完的规范全集。只读取已准备任务的 Entry/Story 交接、该路径要求的 reference 和职责卡。

Box-Agent 兼容入口

当当前 harness 暴露 sub_agent、inspect_images、generate_image、bash 等 Box-Agent 原生工具时，开始任何制作动作前必须完整读取 references/box-agent-tool-contract.md。该契约只覆盖工具名称、参数、脚本路径、委派方式和权限边界；本文件及各职责卡的事实、设计、质量和交付标准仍然有效。委派任何角色时，都要在 task 中显式要求其先读取同一契约与自己的 subagents/<role>.md。

Hermes 环境等效工具

Hermes 不暴露 Box-Agent 工具名，但提供等价能力。在 Hermes 宿主中，正文下文中出现的 bash / inspect_images / generate_image / sub_agent 调用一律按下表翻译后执行， 且无须读取 references/box-agent-tool-contract.md（该契约仅用于 Box-Agent harness）：

| Box-Agent 写法（正文） | Hermes 等效工具 | 翻译要点 | | --- | --- | --- | | bash(command, timeout) | terminal(command, timeout) | 参数直接对应；Hermes 专属参数（workdir/pty）按需使用 | | inspect_images(image_paths=[...], instruction=..., strategy="native") | vision_analyze(image_url=<单张路径>, question=<instruction>) | 每张图一次调用；strategy 参数 Hermes 无，忽略 | | generate_image(prompt, output_path, size, watermark=false) | image_generate(prompt, aspect_ratio=<按尺寸取>) | 无 output_path，生成后回读返回路径验证落盘 | | sub_agent(title, task, required_tools, write_scope, budget) | delegate_task(goal=<task>, context=<背景>) | 用 Hermes 参数形态；自包含 task、语言合同、绝对路径与产物双读验证的要求不变 |

委派仍要求子任务自包含、携带语言合同与职责卡绝对路径，并用 read_file / search_files 验证声明的产物；正文的阶段划分、质量标准与交付要求不因宿主变化而放宽。

Entry / Story 输入契约（最高优先级）

本 Skill 不接收裸 query，不自行创建任务目录。只接受绝对 DECK_DIR，且必须存在 task_pack.json、info_pack.json 和 outline.md。 choices.output 必须为 static_html，且 ppt_mode 必须为 standard。开始和恢复时重新读取磁盘上的 outline.md；不得自行 Research、重复解析材料、改写 outline、增删页面、重排页序或新增事实。输入不满足时返回 Entry。

1. 所有模式共享的合同

1.1 Orchestrator 的职责与边界

Orchestrator 只负责：读取 Entry/Story 交接、规划、委派、合并、验收和确定性收尾。

• 可写：plan/、base.css、知识汇总和构建产物。
• 不直接写：slides/slide_NN.html；页面由 Slide 或 Review 修改。
• 不伪装工具能力，不把计划动作写成已完成动作。
• 每个 subagent 必须有显式 label；失败、超时或未自然收尾的结果不得当成完成品。
• sub_agent(title, task, skills, required_tools, files, write_scope, budget) 负责委派；其返回的结构化 contract、artifact paths 与 handoff_path 是父级交接真相，Orchestrator 不读取子 Agent 的 messages.json、tool_log.json 或 system/tool 快照来轮询进度。父级负责通过 inspect_images 完成视觉检查，以及通过 bash、render、build 和 export 完成确定性收尾。

1.2 角色

| 角色 | 数量与时机 | 唯一职责 | | --- | --- | --- | | Image | 按素材量并行 | 获取或生成位图素材，返回实际路径 | | Slide | 新建或复杂编辑时按设计亲缘页组并行 | 只制作/重做自己的页组并完成组内像素闭环 | | Review | 首次验收 1 个，修复后最多复验 2 次；简单编辑时也是执行者 | 先诊断、后集中修复、批量重渲和最终讲稿收口 |

所有角色开工前完整读取自己的 subagents/<role>.md。任何选中的文件或章节出现截断提示时，续读到结束；未被路由命中的 reference 不读。

1.3 语言与能力

开始前锁定：

• response_language：过程与最终回复语言；
• deliverable_language：屏显、规划和讲稿语言；
• attachments、web、真实图片获取、图片生成、渲染、vision、写文件等能力状态。

默认采用用户 query 的主要语言；用户明确指定交付语言时单独覆盖。只能规划实际可用的能力。 inspect_images(image_paths=["/absolute/path/to/slide_NN.png"], instruction="复述第一眼焦点、阅读路径、主要视觉载体、溢出与裁切", strategy="native") 由当前角色使用；视觉判断、问题账本和看图后的回复使用 response_language，不得因模型默认语言切换，屏显原文与专有名词可保留原语言。

1.4 工作区真相源

task_pack.json
info_pack.json
outline.md
plan/design-brief.md
plan/deck.md
plan/slide_NN.md
base.css
assets/
slides/slide_NN.html
renders/slide_NN.png
speech.md
present.html   ← 必交付产物：由 `deck.py build` 生成，缺失即技术故障
`<DECK_DIR>/<DECK_ID>.pptx`   ← 必交付产物（`static_postprocess` 含 `pptx` 时）：只能由 `scripts/export_pptx/html_to_pptx.mjs` 生成

outline.md 是页面事实、页数、页序、标题、结论和内容关系的真相源；grounded-knowledge.md 仅是 Entry/Story 生成的研究汇总，Standard 只读，不得覆盖 outline.md。 design-brief.md 是视觉真相源； slide_NN.md 是页面内容合同； base.css 是全局设计系统； 最终判断必须基于最新 PNG，而不是只看 HTML。

1.5 Reference 路由

| 场景 | 读取 | | --- | --- | | 场景定调 | design-rules.md §T1–T3、§1–3 + 命中的主题节；design-styles.md 目录 + 一个风格家族 | | 全局与逐页规划 | planning-contract.md；每页只读 layout-patterns.md 对应页型 | | 编辑现有 deck | editing-contract.md | | Slide | 自己的逐页计划、base.css、quality-checklist.md“一、单页检查”与本页命中章节 | | Review | 完整读取 quality-checklist.md：先用“一、单页检查”核对视觉语义，再做“二、整套检查”和“三、可机核 lint 项” |

字体只在默认角色不足或场合敏感时读 fonts.md。不要在开工前扫描所有 design、style、layout、font 文档。

无论是否读取 fonts.md，中文眉签、部门名、页脚、来源和元数据都不得使用等宽字体或拉丁 ALL CAPS 的疏字距：使用 --font-sans / --font-serif，字距保持 0–0.03em。--font-mono、--tracking-caps、.is-latin-label 只用于纯拉丁技术标识、代码、坐标和真实编号。

同一句中文标题、结论或标签必须使用同一字体家族；强调词只通过颜色、字重、字号或下划线建立层级，禁止把其中几个字换成卡通、手写或另一套展示字体。全册字体家族总数 ≤ 3 且必须全册统一：同一角色在每页都用同一家族，不因页面题材临时换字体；严谨型收敛到 1–2 族。字体选择服从场景与 Style Lock——中文正文/表格/页脚/眉签一律 --font-sans（严谨衬线可 --font-serif），中文绝不放进 --font-mono（IBM Plex Mono 无中文字形，会回退成卡通体）；--font-mono 只服务纯拉丁代码、坐标、ID。playful、圆趣、手写和书法字体只有在主题与受众真正支持时启用（至多占那 3 族里的 1 个点缀位），并在对应元素加 .is-expressive-type 或 data-type-intent="expressive"，让渲染检查确认这是有意选择。

1.6 视觉媒介优先级

按内容选择媒介：

1. 真实人物、地点、产品、事件：真实照片；
2. 氛围、隐喻、故事场景、视觉主画面：生成图或高质量位图；
3. 数据：ECharts；
4. 大型流程、架构、机制、关系示意：Canvas 绘制几何 + HTML 文字层，或“无文字图片 + HTML 标注”；
5. SVG：仅用于 icon、logo、箭头、标记和小型装饰。

普通内容页只要存在人物、地点、产品、作品、活动、体验、自然/城市环境、故事场景或情绪画面等可见主体，优先让一张有分量的真实/生成位图成为主视觉，而不是用彩色块、图标或抽象线框替代。配图数量服从叙事，不机械凑数；但能够增加识别、证据、临场感或情绪价值的位图机会不得静默放弃。

**默认禁止把手写 SVG 当作 hero、半屏/全屏主视觉或大型示意图。**SVG 只承担小型辅助图形；复杂的非位图主视觉若确需程序化表达，优先使用 Canvas 几何 + HTML 文字层。只有用户明确要求矢量交付，或必须复用用户提供的准确矢量资产时才例外。详细实现见 design-rules.md §5 和 layout-patterns.md 的 Canvas diagram 章节。

2. 新建 PPT

阶段 0：解析任务

1. 读取 task_pack.json、info_pack.json 和当前磁盘 outline.md；页数、页序、标题、结论、事实与内容关系全部以 outline.md 为准，场景、受众、材料与 Research 路径以 task/info pack 为准。
2. 锁定语言、能力、附件清单和交付范围，不向用户追问非阻塞偏好，并在规划中显式记录合理假设。
3. static_html 新建流程不启动 Research 或 Material，只读取 Entry/Story 已生成的产物；若 required Research 报告缺失则返回 Entry，事实不足时不编造数字、不改写 Story，grounded-knowledge.md 仅作为生产汇总。

阶段 1：按需接地

Grounding gate

Entry/Story 产物交接后，Orchestrator 先校验 info_pack.json、Entry/Story 的 Research 报告和当前磁盘 outline.md；缺少必需报告时返回 Entry，不能在 Standard 内重新 Research、解析材料或改写事实。校验通过后再写唯一 plan/grounded-knowledge.md，并用 read_file 验证文件完整；完成前不得进入 design-brief.md、Style Lock 或逐页规划。文件只整理已交接的用户事实、外部核验、编排器假设、示意、冲突和未确认项，不添加无来源的新事实。

附件提供的是事实与可复用素材边界，不是默认设计上限。合并时同时整理材料里的可复用页图、内嵌图片、图表结构和品牌线索；随后在 design-brief.md 明确 material_visual_mode：facts-only、visual-reuse、style-reference 或用户明确要求的 faithful-restyle。对每张图片附件另写 attachment_visual_map，决定 must-show / reuse / reference-only / omit、上屏页与处理方式；论文整页视觉与页内命名 Figure 必须区分为 page-facsimile 和 figure-crop。这项判断独立于外部搜图/生图的 image_opportunity。除 faithful-restyle 外，不继承附件的小字号、密集表格、普通文档排版或低质量视觉；仍按听众、场合和叙事重新定调。

阶段 2：场景定调与 Style Lock

1. 按 Reference 路由读取视觉规则，不扫描全库。
2. 先锁定 scene_register（庄重汇报 / 编辑叙事 / 产品发布 / 教学解释 / 文化体验等）和一个明确的主风格；风格必须能解释“为什么适合这个受众、场合与内容”，不能只写抽象形容词，也不要把多个风格编号拼成折中套餐。允许借一种辅助 craft，但整册要能用一句视觉主张说清。
3. 写 plan/design-brief.md#Style Lock：
   • scene；
   • primary_style；
   • supporting_craft（最多一种）；
   • visual_thesis / signature_visual；
   • palette / typography / numeric_voice；
   • image_language / image_opportunity_map / composition_grammar；
   • background_system：先根据场景说明背景应偏“克制秩序”还是“氛围表达”，再定义一个贯穿内容页的 base_canvas_family 与允许变化的视觉状态（明度、色场、环境光、肌理、图片占比、密度和章节状态）；每种状态写清叙事用途、适用页面及进入/退出承接。学术、组会、合规、严肃评审等场景可以更安静，但仍需有排版和证据视觉；其他场景不要把整册同一纯色底当作安全默认。统一不等于全册同底色；变化也不能脱离同一画布家族；
   • motif_role：说明主题母题在哪些页作为主视觉、在哪些页只作次要线索、哪些页主动缺席。同一装饰母题不得承担封面、章节页和大多数内容页的主要视觉；一致性主要来自字体、颜色语义、图片处理和构图语法。技术注、坐标、场记、档案编号等只有在传递真实且有用的信息时才可成为母题，不能编造伪元数据营造“高级感”；
   • special_pages；
   • avoid；
   • spatial_rhythm：内容页如何铺开、呼吸页如何聚焦、峰值页在哪里；
   • special_page_system：封面、章节页、结尾页共享什么设计 DNA，各自用什么构图动作。
   • material_visual_mode（有附件时）：哪些只作为事实，哪些图片/图表可直接复用，哪些风格线索值得保留。
   • attachment_visual_map（有图片附件时）：原路径、must-show / reuse / reference-only / omit、material_asset_type、正式 asset 路径、上屏页、裁切/整图/抠图/调色与理由。论文 Figure N 必须记录 figure-crop 的来源页与边界，不能直接复用整页 PDF PNG。
4. 用户未指定风格时，按主题 × 受众 × 场合主动判断。没有 Style Lock 不进入规划；没有可见的 signature_visual 兑现页，也不把通用配色和字体清单当作完成定调。

image_language 先说明哪些颜色本身承担识别、证据或教学信息，再决定统一处理。人物、动物、植物、作品、产品、场地、实验输出等真实主体默认保留有意义的原始色彩；统一感优先来自选图、裁切、色温、局部色罩、边框与背景。只有用户明确要求黑白/双色调，或本册视觉主张确实依赖该处理且不会损害辨认与证据价值时，才使用整图灰阶或 duotone；“学术感”“高级感”“为了统一”本身不构成把整册真实图片去色的理由。对承担识别、证据或主视觉职责的图片，同时定义轻量 crop_contract：焦点、必须保留的主体部位/图内信息、允许裁掉的背景与推荐 fit；不能只写宽高比后让 Slide 猜裁切。

Style Lock 锁定的是视觉语言与判断边界，不是一套固定 HTML 模板，也不锁死每页几何。必须明确区分：

• 稳定语言：字体角色、颜色语义、间距节奏、背景语法、图片裁切/调色、图形语法与特殊页亲缘关系；
• 受控变化：每页主焦点、构图方向、媒介比例、信息密度、留白位置和章节状态；
• 禁止项：临时引入新字体、新配色、无主题装饰或复制上一页几何只换文案。

它应当像可执行的 Art Direction：足够具体，使不同 Slide 能做出同一世界里的页面；又保留足够空间，让每页按内容选择最佳构图。无需另建模板文件或共享装饰素材。

image_opportunity_map 必须先做一次与实现方式无关的“可见主体扫描”：这页有没有值得被看见的人物、场地、产品、作品、活动、体验场景、虚构角色或情绪主画面；先说明图片能增加的证据、识别、临场感或情绪价值，再选择真图、生成图或代码视觉。不得先偏爱 CSS/Canvas，再倒推“没有图片机会”。

当页面的核心内容是一组具名真实人物、主创、嘉宾或团队成员时，默认把“人物可识别”视为真实图片机会，并交给 Image 批量检索人物肖像、官方简介照、活动照或团队合影。“不应生成假真人”只意味着不能用生成肖像冒充本人，不能据此把该页改判为 image_opportunity: none。若只能可靠取得部分人物照片，优先采用一张可信团队/机构场景图配少量关键人物肖像，或降低人物数量并重组叙事；不得用身份不明的相似面孔补齐。只有经过真实检索仍无可辨认、可下载且适合上屏的素材，且图片不会增加识别价值时，才使用纯排印，并在计划中记录缺口与降级理由。

同样审视具名作品、软件/产品、制作流程与案例：可检索的官方画面、界面、幕后制作图、过程拆解、实物或现场照片通常比小图标和空卡片更能建立识别与可信度。每张普通内容页都应有一个与内容相称的主要视觉载体——真实/生成图片、图表、解释性 Canvas，或真正能独立成立的排印主视觉。边框、空面板、微型图标和装饰线不算主要视觉载体；纯排印只有在文字本身被有意放大、组织并形成明确焦点时才成立。增加配图不等于增加散点：优先一张有分量的主图或一组视觉口径一致的素材，让其他元素安静地服务它。

有附件时同样执行完整扫描：优先复用其中真正有信息价值且清晰的图片；附件没有实景、人物或品牌图，只说明“没有附件真图”，不等于“生成图会虚构所以禁止配图”。用于气氛、愿景、概念体验或非特定场景的生成图可以作为表达层使用，准确事实、数字和关系仍留在 HTML / 图表层。把事实保真与视觉想象分开，不把材料摘要机械搬成卡片墙。

图片附件不能只被“读懂后重画”而默认消失。用户明确要求根据某张图制作，或该图本身是唯一产品、人物、场地、作品、证据、前后对比或流程总图时，将其标为 must-show，至少在一页以可辨认的整图或忠实裁切出现；复杂流程图可以先用原图建立全貌，再用 Canvas/HTML 分步重绘。只有重复、无关、不可读或用户明确不希望展示时才 omit。image_opportunity: none 只表示不新增外部/生成位图，不能覆盖 attachment_visual_map。

真实对象的识别与证据、场景的临场感、人物与产品的可信度、故事与情绪的锚点，都属于有效配图机会。虚构人物、概念场景、未建成空间和风格化主视觉正是生成图的适用对象，不应因其不是真实对象而改用彩色方块、抽象符号或纯 CSS 占位。“CSS 更可控”“没有用户实拍”“担心 AI 生成错误”“为了风格统一”都不能单独成为 none 的理由；这些问题应通过真图/生成图分流、提示词约束、统一裁切与调色解决。只有当位图确实不增加听众价值，或会比图表、Canvas 或排印更含糊时，才选择 none。如果一册存在多个明显可见主体，却被整体判成无位图或仅封面一张图，在冻结计划前必须重做这次扫描。这里不设图片数量配额，也不为装饰而配图。

当搜图或生图能力可用时，整册全部 none 或只有封面一张图属于需要证明的异常，不是默认安全路线。数据、商业、技术、学术或代码题材也不能因此整册退回卡片墙：事实页可以用图表/Canvas，但封面、章节转场、案例、场景、愿景或结论中至少应选择两个真正能从图像获益的节点，给出可执行的搜索/生成 brief；短册则至少保证一个内容节点，而不只是封面。只有用户明确要求纯排印/纯图表，或逐页证明位图都会降低准确性与可读性时，才允许整册无位图，并在 plan/deck.md 写明逐页例外理由。这是防止误判的最低覆盖线，不是为了凑数；事实型真图与非证据性的氛围生成图必须明确分流。卡片、极简、学术、商务等风格描述不等于禁止位图，也不能作为免配图理由。只有用户原文明确要求“纯文字”“不要图片”或语义完全等价的限制时，才能把 explicit_user_request 作为图片豁免依据；不得根据风格标签自行推断用户拒绝图片。

可见主体扫描必须同步落盘为 plan/image-strategy.json，供生成流程在 Slide 委派前确定性验收。存在配图机会时写入 status: images_required、visible_subject_scan_complete: true 和完整的 image_opportunity_pages；整册无位图时必须写入 status: bitmap_exception、visible_subject_scan_complete: true、覆盖全部计划页的 reviewed_pages、不少于 20 字的 exception_reason，以及 explicit_user_request | pure_typography | pure_chart | wireframe | accuracy_critical 之一的 exception_basis。不能用自然语言总结替代该文件。

背景不等于一块纯色，也不等于每页随机换皮。学术、组会、合规、严肃评审等场景可用安静画布承托事实；产品、品牌、招商、文旅、文化、故事、课程导入、活动与大众传播等表达型场景，应主动考虑一层与主题相容的环境设计，而不是整册退回纯色：可以是有方向的柔和光场、局部光晕、低对比颗粒/网点/纸纹/地形等主题肌理、图片背景，或由 Image 统一生成的背景。光晕只有在能解释光源、主题和视觉焦点，且形状、位置与构图相关时才成立；标题后反射式复制的圆形模糊光斑仍属于无主题 glow。先确定贯穿普通内容页的基础画布家族，再选择少量相容手法形成背景语法。章节差异优先通过局部大色场、图片调色、条带或母题状态表达；只有章节页、hero、结尾或叙事确需整体换场时才更换整页画布，并在前一张或后一张保留颜色、肌理、图片处理或构图方向的承接。图片或生成背景必须进入 image_opportunity_map 与素材 brief，不能由 Slide 临时发明路径。避免出现数页突然像另一套 Deck、随后又无过渡切回，也避免把深藏青、霓虹蓝紫渐变或通用科技 glow 当作默认“高级感”。

后续主链只有一条：Style Lock → 全册计划 + prepare → Image 分片并行 → 素材路径一次回填 → Slide 页组并行 → Review 诊断/有限返修 → 讲稿同步 + build → Review 查看 build 后最终像素并返回合同。前一节点的真相源未冻结，不启动依赖它的下游；互不依赖的同层任务一次并行派出。build 可能裁剪字体、更新 base.css 并重渲全册，因此 build 前的 Vision 只能用于诊断，不能作为最终像素证据。

阶段 3：全局规划与字体前置

完整读取 references/planning-contract.md，然后按顺序：

若存在 materials/font-config.json，先读取一次并把其中 title/body/number/annotation 角色作为 Style Lock 的字体输入；用户上传字体优先于自动选型，未覆盖字符由交付字体包自动回退，禁止凭字体名改用未上传的本机字体。

1. 补全 design-brief.md；
2. 写 plan/deck.md；
3. 复制 base-template.css 为 base.css 并填写 token；
4. 一次写完全部 plan/slide_NN.md，每页附自己的 Reference route；
5. 在 plan/deck.md 定义 Production groups：全部过渡页为 dividers，封面与结尾为 bookends；内容页首先按制作方式与构图亲缘性分组，再考虑叙事连续，最后才考虑章节归属。一个组应共享同一种制作问题，而不是把 car