企业官网建设流程全解析

ui-ux-pro-max-skill 幻灯片说服力文案公式指南：25 个公式、标题模式与 BM25 检索实操

【免费下载链接】ui-ux-pro-max-skillAn AI skill that provides design intelligence for building professional UI/UX across multiple platforms.项目地址: https://gitcode.com/gh_mirrors/ui/ui-ux-pro-max-skill

导读

本文围绕 ui-ux-pro-max-skill 开源项目中的幻灯片文案知识库 slides-copywriting-formulas.md 展开，系统讲解项目内置的 25 个说服力文案公式：从 PAS、AIDA、FAB 等核心公式的结构与模板，到"公式—幻灯片类型—情绪"的映射关系、三类标题撰写模式，再到基于 BM25 算法的命令行检索工具的使用与底层原理。读完本文，你将掌握为 Problem、Solution、CTA 等任意幻灯片类型快速挑选匹配文案公式的完整实战方法，并能直接运行项目中的search-slides.py完成情绪匹配检索与上下文感知推荐。

一、项目中的文案公式知识库定位

在 ui-ux-pro-max-skill 项目中，幻灯片（Slides）是内置设计能力之一。项目的设计技能入口 design/SKILL.md 将其描述为"Strategic HTML presentations with Chart.js, design tokens, copywriting formulas"，并建立了包含创建指南、布局模式、HTML 模板、文案公式、策略五份参考文档的知识库：

文案公式文档是整个幻灯片文案体系的速查手册，其内容与 design-system/data/slide-copy.csv 这一结构化数据表一一对应。从源码结构看，CSV 是检索引擎的数据源，而 Markdown 文档则是面向人工阅读的浓缩版；两者共同构成"人可读、机可查"的双轨知识库。在 cli/assets/skills/slides/references/copywriting-formulas.md 中还存在一份内容相同的副本，供独立的 slides 子技能使用。

二、25 个文案公式全景

slide-copy.csv收录了 25 个经过编排的文案公式，每个公式包含 8 个字段：id、formula_name、keywords、components、use_case、example_template、emotion_trigger、slide_type、source。完整清单如下：

这份数据表是后续检索工具的核心数据契约，formula_name与keywords列构成了 BM25 检索引擎的索引字段（详见第八节）。

三、五大核心公式详解

文档着重展开讲解了五个最常用的核心公式，每个公式都明确了使用场景（Use）、组成环节（Components）与可填空模板（Template）。

3.1 PAS（Problem-Agitate-Solution，问题—煽动—解决）

• 使用场景：Problem 幻灯片、痛点陈述
• 组成环节：Problem（问题）→ Agitate（煽动放大）→ Solution（解决方案）
• 可填空模板："[Pain point]? Every [time frame], [consequence]. [Solution] fixes this."

即"你在为 [痛点] 困扰吗？每过 [时间段]，就会造成 [后果]。而 [方案] 可以解决这个问题。"其情绪路径是"挫败→恐惧→释然"（Frustration→Fear→Relief），在slide-copy.csv中被标注为"最可靠"（most reliable）的问题页公式。项目幻灯片生成器 generate-slide.py 中的generate_problem_slide函数正是按此公式设计：先呈现"Marketing teams are drowning"式的大标题，再用三张卡片分别承载三个 Pain Point，最后在页脚落回公司信息——完整复刻了"问题→煽动→方案"的叙事节奏。

3.2 AIDA（Attention-Interest-Desire-Action，注意—兴趣—欲望—行动）

• 使用场景：CTA 页、收尾页
• 组成环节：Attention（吸引注意）→ Interest（激发兴趣）→ Desire（唤起欲望）→ Action（促成行动）
• 可填空模板："[Bold statement]. [Benefit detail]. [Social proof]. [CTA]."

即"一句大胆宣言。一个利益细节。一条社会证明。一个行动号召。"其情绪路径为"好奇→参与→渴望→紧迫"（Curiosity→Engagement→Want→Urgency），是 1898 年就存在的经典销售文案结构，在slide-copy.csv中被明确标记用于 Lead-gen CTA 和通用说服场景。

3.3 FAB（Features-Advantages-Benefits，功能—优势—利益）

• 使用场景：功能页、产品展示
• 组成环节：Feature（功能）→ Advantage（优势）→ Benefit（利益）
• 可填空模板："[Feature] lets you [advantage], so you can [benefit]."

即"[功能] 让你能够 [做到某事]，从而使你 [获得利益]。"情绪路径为"好奇→理解→渴望"（Curiosity→Understanding→Desire）。与 AIDA、PAS 不同，FAB 天然适合功能说明类页面，其对应的slide_type为 Feature slides。

3.4 Cost of Inaction（不作为的代价）

• 使用场景：煽动页、制造紧迫感
• 组成环节：Status Quo（现状）→ Loss（损失）→ Time Decay（随时间衰减）
• 可填空模板："Without [solution], you're losing [amount] every [timeframe]."

即"如果没有 [方案]，你每 [时间段] 都在损失 [量化金额]。"情绪触发为"损失厌恶→紧迫"（Loss aversion→Urgency），属于损失厌恶心理学的典型应用。slide-copy.csv中该公式的完整模板给出了更强的量化表达："Every [timeframe] without [solution] costs you [quantified loss]. That's [larger number] per year."（每 [时间段] 缺少 [方案] 令你损失 [量化金额]，一年累计达 [更大数字]）。

3.5 Before-After-Bridge（前后对比—桥梁）

• 使用场景：转型故事、案例研究
• 组成环节：Before（之前）→ After（之后）→ Bridge（桥梁）
• 可填空模板："[Pain point before]. [Desired state after]. [Your solution] is the bridge."

即"[转型前的痛点]。[期望达成的状态]。[你的方案] 就是那座桥梁。"情绪路径为"痛苦→愉悦→路径"（Pain→Pleasure→Path），是文案写作中的经典结构，适合展示客户从旧状态到新状态的转变过程。

四、公式—幻灯片类型—情绪映射

文档给出了一张"该在哪种幻灯片上用哪个公式"的映射表，这张表同时揭示了文案公式与叙事情绪（Emotion）之间的对应关系：

情绪是贯穿整条链路的纽带：在 slide-layout-logic.csv 中，每种幻灯片目标（goal）同样绑定了一个情绪（emotion），例如problem→frustration→card-grid、cta→urgency→gradient-cta、agitation→fear→full-bleed-stat。也就是说，当你选定文案公式时，其情绪已被确定，进而可以继续推导布局模式、排版规格乃至配色方案——这正是项目"上下文感知"设计系统（Contextual Search）的立足点，详见第八节。

五、标题（Headline）撰写模式

除了完整公式，文档还提供了三类可直接套用的标题句式模板。

5.1 力量词模式（Power Words）

• "Stop [bad thing]"—— 停止某个坏事物
• "Get [desired result] in [timeframe]"—— 在限定时间内获得期望结果
• "The [adjective] way to [action]"—— 达成某事的某种方式
• "Why [audience] choose [product]"—— 为什么某类受众选择某产品
• "[Number] ways to [achieve goal]"—— 达成目标的 N 种方法（对应 Number List 公式）

5.2 对比模式（Contrast Patterns）

• "[Old way] is dead. Meet [new way]."—— 旧方式已死，认识新方式
• "Don't [bad action]. Instead, [good action]."—— 不要做某事，而是做某事
• "From [pain point] to [benefit]."—— 从痛点走向收益

5.3 社会证明模式（Social Proof Patterns）

• "[Number]+ [users/companies] trust [product]"—— 量化背书
• "Join [notable company] and [notable company]"—— 借势知名企业
• "As seen in [publication]"—— 媒体曝光背书

六、快速参考：按需求选公式

当面临具体写作需求时，可对照下面的速查表（来自文档的 Quick Reference 部分）：

七、命令行检索实操：search-slides.py的完整用法

文档给出的检索命令基于项目内的 search-slides.py，考虑到各 Agent 环境的挂载位置不同，实际执行时请以仓库内的真实路径为准：

# 按幻灯片类型查找公式（copy 域） python cli/assets/skills/design-system/scripts/search-slides.py "problem agitation" -d copy # 获取情绪匹配的公式 python cli/assets/skills/design-system/scripts/search-slides.py "urgency cta" -d copy

该 CLI 的能力远不止于此，从 search-slides.py 的参数定义看，它支持四个检索域与多种输出模式：

更实用的场景是上下文感知检索，例如在 9 页 Deck 的最后一页写 CTA、且前一页情绪为 frustration 时：

python cli/assets/skills/design-system/scripts/search-slides.py "cta" --context --position 9 --total 9 --prev-emotion frustration

输出将包含推断目标（Inferred Goal）、推荐布局（Layout）、排版规格（Typography）、配色方案（Color Treatment）、是否打破视觉模式（Pattern Break）、是否使用全出血背景（Full Bleed）以及动画类名（Animation），同时附带 copy 域的基础检索结果。

八、源码级原理：BM25 检索与数据契约

search-slides.py的检索逻辑全部落在 slide_search_core.py 中，核心机制值得深入理解。

8.1 copy 域的数据契约

在slide_search_core.py的CSV_CONFIG中，copy 域被配置为：

• 数据文件：slide-copy.csv
• 检索列（search_cols）：formula_name、keywords、use_case、emotion_trigger、slide_type
• 输出列（output_cols）：formula_name、keywords、components、use_case、example_template、emotion_trigger、slide_type、source

即检索时把每个公式的 5 个字段拼接成一份文档，输出时则返回 8 个字段的完整信息——这就是为什么文档中的公式模板（example_template）、情绪（emotion_trigger）、出处（source）都能被命令检索到并完整展示。

8.2 BM25 排序算法

slide_search_core.py内置了一个自实现的 BM25 排序器（slide_search_core.py），关键参数与行为：

• 默认超参数k1=1.5、b=0.75，是 BM25 的经典配置；
• tokenize将文本小写化、剔除标点，并过滤长度小于等于 2 的短词（如a、to），因此"problem agitation"、"urgency cta"这类查询会被正确分词；
• 评分采用标准的 BM25 公式：idf * tf * (k1+1) / (tf + k1*(1 - b + b*doc_len/avgdl))，IDF 使用平滑版本log((N - f + 0.5)/(f + 0.5) + 1)；
• 结果按得分降序返回，且只保留score > 0的条目。

8.3 域自动检测

若不带-d参数，detect_domain会根据关键词命中数自动判断检索域：例如查询中含headline、copy、formula、aida、pas、hook、cta、benefit、objection、proof、testimonial、urgency、scarcity等词时归入 copy 域；含chart、graph、bar、metrics、kpi等词时归入 chart 域；无法命中任何域时回退到strategy。

8.4 上下文感知增强

search_with_context是比普通检索更进一步的整体决策系统：它先执行全域 BM25 检索，再根据查询词推断幻灯片目标（如含cta或call to action则推断为 cta），随后联动查询：

• slide-layout-logic.csv —— 布局模式与视觉权重；
• slide-typography.csv —— 字号、字重对比、行高（例如cta-action的主标题为 64px、字重对比 700-500）；
• slide-color-logic.csv —— 按情绪映射的背景/文字/强调色；
• slide-backgrounds.csv —— 背景图类别与遮罩样式。

同时calculate_pattern_break与should_use_full_bleed两个函数会基于"1/3 与 2/3 位置打破视觉模式"（Duarte Sparkline 技巧）以及"高情绪节拍才使用全出血背景"的规则，给出叙事节奏建议。换言之，你只需描述"要写什么问题页/CTA 页"，系统就能连带给出文案公式、版式、排版、配色与动效的一揽子建议。

8.5 与 HTML 幻灯片生成的衔接

文案公式最终会落地为 HTML 幻灯片。generate-slide.py 提供了一组与公式一一对应的生成器：generate_problem_slide（PAS 三痛点卡片）、generate_solution_slide（FAB 功能清单）、generate_metrics_slide（Proof Stack 大数字）、generate_testimonial_slide（Social Proof 引言块）、generate_cta_slide（AIDA 收尾 CTA），并通过SLIDE_GENERATORS字典按type分发。所有样式强制引用设计令牌（design-tokens.css 中的 CSS 变量），不允许硬编码颜色、字体与间距，从而保证整副 Deck 的品牌一致性。

九、实战组合拳：从文案公式到完整幻灯片

结合以上全部机制，一条完整的实战路径可以归纳为：

1. 定位诉求：对照"公式—幻灯片类型—情绪"映射表或快速参考表，确定当前页的目标（如"制造紧迫感"→ Cost of Inaction / Scarcity）；
2. 检索公式：运行search-slides.py "urgency cta" -d copy获取公式结构、模板与情绪；若想获得布局/排版/配色联动建议，追加--context --position N --total M --prev-emotion X；
3. 套用模板：按返回的example_template填空（如"Without [solution], you're losing [amount] every [timeframe]."）；
4. 生成页面：使用 generate-slide.py 的对应生成器（--demo可先预览全类型 Demo Deck），所有视觉属性交由设计令牌统一管控；
5. 验证令牌合规：通过 html-token-validator.py（--type slides）校验生成的 HTML 未出现硬编码样式。

至此，从"一句文案"到"一页符合品牌规范、情绪节奏与版式规律的幻灯片"，整个链路都可以借助 ui-ux-pro-max-skill 项目内置的知识库与脚本完成。这也正是文案公式文档在设计系统中的真正价值：它不仅是 25 个句式的清单，更是驱动"文案→情绪→布局→排版→配色→动效"全链路决策的起点。

【免费下载链接】ui-ux-pro-max-skillAn AI skill that provides design intelligence for building professional UI/UX across multiple platforms.项目地址: https://gitcode.com/gh_mirrors/ui/ui-ux-pro-max-skill