企业官网建设流程全解析

EditDeck 是一条从需求文本直达 PPT 图片、标准pptx与可编辑pptx的端到端 AI 流水线。当你想控制整套 PPT 的视觉风格时，它提供了风格描述与风格参考图两种输入模式。本文讲清两者的底层原理、适用场景与实战用法，帮你一套模板气质贯穿所有页面。

先认识 EditDeck：一条从需求到 PPT 的流水线

在动手调风格之前，先理解 EditDeck 的工作方式。它把做 PPT 的零散步骤收拢成一条连续链路：

• 从自然语言需求出发，自动生成结构化的大纲和逐页内容
• 批量渲染每一页视觉稿，并打包成普通pptx
• 可继续基于生成结果，重建真正可编辑的pptx
• 用统一YAML配置管理文本模型、图片模型、可编辑链路

理解这一点很关键：风格不是某一页的属性，而是整套 PPT 的"视觉 DNA"。EditDeck 会把你的风格输入转写成一段跨页复用的风格说明，锁定到每一页，从而保证 6 页、10 页看起来都是"同一个家族"，而不是各画各的。

两种风格输入模式：风格描述 vs 风格参考图

EditDeck 的风格输入只有两个入口，且二者互斥、只能二选一——这个约束在代码里是硬性校验的：

风格描述 与 风格模板图 互斥，请二选一。

对应 app/pipeline.py 的校验逻辑，同时在 CLI 入口 app/cli.py 也做了重复检查。下面分别拆解。

风格描述：用文字定义视觉基调

你只需写一段话描述想要的感觉，例如：

16:9 深色科技风，蓝青主色，高对比可读性，标题厚重正文克制

EditDeck 并不会把这句话直接丢给生图模型。它先由一个"顶级视觉策略顾问"角色把这段话扩写成一段超详细、可复现、可跨页复用的风格说明，重点展开整体气质、版式骨架、栅格与留白、背景系统、色彩关系、卡片/面板样式、图标语言、图表外观、阴影质感、视觉锚点与禁用项。

这套扩写逻辑在 app/pipeline.py 中定义。核心思想是：

• 重点描写非内容部分的风格样式，而不是页面文案
• 详细到足以让模型仅凭这段说明，就复现出气质统一的图片
• 明确哪些特征必须始终一致、哪些只能有限变化

💡 一句话描述 + 自动扩写 = 你不需要写长篇提示词，就能获得稳定一致的风格。

风格参考图：用一张图锁定整套母版

如果你手头已有一张心仪的 PPT 页面（比如从别处保存的样板），直接把它作为风格参考图上传即可。

EditDeck 会由"高级视觉分析师"解析这张图，输出超详细的中文风格说明，并且重点识别非内容部分的风格样式，而不是照抄图片里的文字。它会特别指出：

• 哪些视觉特征是这套风格最不可丢失的核心特征
• 哪些变化会破坏一致性
• 整套 PPT 可复用的"视觉 DNA"是什么

参考图模式的解析逻辑见 app/pipeline.py。

更关键的是，生成每一页时，参考图会被视为整套 PPT 的"母版锁定源"——它锁定背景系统、标题系统、色彩角色与容器语法，优先级最高。文字风格说明只是对参考图的补充，不得覆盖、弱化或重写参考图本身。这套"母版锁定"规则在 app/pipeline.py 中定义：

把风格参考图视为整套 PPT 的母版锁定源， 优先锁定背景系统、标题系统、色彩角色与容器语法。

双模式的核心机制：风格 DNA 如何贯穿每一页

无论走哪种模式，EditDeck 都会先产出一份风格 DNA（style_prompt），再为每一页生成独立的出图提示词。整个过程有一条贯穿始终的"硬约束"：

必须严格继承给定的风格 DNA；风格一致性优先级高于单页的新鲜感和局部创意发挥。允许布局按页型变化，但不允许风格家族和组件语言发生断裂。

换句话说，你可以让第 1 页是痛点、第 4 页是流程图、第 6 页是路线图——布局可以变，但背景、配色、卡片样式、图标语言必须保持同一套视觉家族。这正是"精准控制"的精髓：内容自由，风格锁定。

实操指南：Web 与 CLI 两种用法

EditDeck 同一套风格能力同时提供 Web 与 CLI 入口，运行时参数可以覆盖配置文件。

方式一：Web 工作台

启动 Web 服务后，在页面里填写即可：

uvicorn webapp.main:app --host 0.0.0.0 --port 8000 --reload

打开http://127.0.0.1:8000/，你会看到两个风格输入框（见 webapp/static/index.html）：

• 风格描述（文本框）：填文字描述，留空则自动推断风格
• 风格参考图（文件上传）：上传本地图片，提交时自动转成 base64 交给后端解析

两个入口二选一——前端提交时会校验互斥关系。上传参考图后，页面还会实时显示生成进度。

方式二：CLI 命令行

用参数直接指定风格，两种模式对应的参数分别是--style-description与--style-template（定义见 app/cli.py）。

风格描述模式：

python -m app.cli generate "做一份 AI 客服知识库升级方案" \ --style-description "16:9 深色科技风，蓝青主色，高对比可读性" \ --export-mode both

风格参考图模式：

python -m app.cli generate "做一份 AI 客服知识库升级方案" \ --style-template ./my_style_reference.png \ --export-mode both

⚠️ 注意：--style-description与--style-template不能同时传，否则会报互斥错误。

实战案例：风格描述模式的实际效果

下面两个案例都来自项目内置的 Showcase，展示风格描述如何把一句话变成整套统一视觉。

案例 A：企业级深色科技风

风格描述强调"深海军蓝、冷青蓝、电光蓝为主色，玻璃质感面板，中轴对齐与模块化网格"。生成的 6 页保持了统一的蓝色家族与发光描边语言：

案例 B：学术商务风（红蓝配色）

换一段风格描述为"学术商务风，微软红蓝主色，顶部标题栏 + 左侧纵向时间轴"，整套 PPT 立刻切换成另一套视觉家族，但内部依旧高度统一。这证明：改风格只改"DNA"，不改内容框架。

两种模式怎么选：一张对照表

简单结论：有样板图用参考图，只有感觉用文字描述。两者都无法覆盖需求时，EditDeck 还会根据"需求本身"自动反推一套合适的风格 DNA 作为兜底。

常见问题与调优技巧

Q：为什么同时填了文字和图片却报错？因为两种模式互斥。请只保留其中一项，详见 app/pipeline.py 的校验。

Q：想让风格更"像"参考图，怎么办？参考图模式下，参考图本就是最高优先级母版。若还原度不够，可换一张信息更全、风格特征更明显的样板页（含背景、标题区、卡片），让模型有足够特征可提取。

Q：想让风格更稳、不漂移？EditDeck 已在每页出图时把"风格一致性"设为硬约束。若个别页仍偏色，可在风格描述里补充"禁用项"（如"避免大面积紫色""避免赛博朋克式杂乱"），显式收窄变化空间。

Q：风格描述要不要写得很长？不用。给一句清晰的基调描述即可，EditDeck 会自动扩写。但关键修饰词（配色、气质、禁用项）建议明确，效果更可控。

Q：配置文件在哪改模型？统一入口为 config/app.yaml，完整字段说明见 config/README.md。临时切换模型可优先用 CLI / Web 参数覆盖，不必改主配置。

小结：EditDeck 把"PPT 风格"从玄学变成了可控工程——用风格描述给出方向，用风格参考图锁定母版，风格 DNA 自动贯穿每一页。选对模式、给足关键修饰词，你就能稳定得到一套气质统一、可直接编辑的演示文稿。