企业官网建设流程全解析

• CLI
• AI 应用
• MCP 服务

Aurora Softedge 是 OfficeCLI morph-ppt 技能库（skills/morph-ppt/reference/styles/）中 52 套视觉风格之一，专为设计作品集、创意展示、艺术画廊类演示而设计。本文以 dark--aurora-softedge/style.md 为骨架，结合 morph-ppt 技能主文档、底层softedge属性的 C# 实现与绘制效果辅助类，完整讲解该风格的配色逻辑、分层柔边椭圆技法、软边公式，以及如何用officecliCLI 配合 Morph 过渡将其落成一个可交付的.pptx。

读完本文，你将掌握：Aurora Softedge 的配色与深度营造原理、softedge属性的取值规则与源码级换算、Morph 过渡下场景演员（scene actor）的命名与幽灵（ghost）纪律，以及一套可直接运行的构建与交付验收流程。

一、风格定位：什么场景适合 Aurora Softedge

Aurora Softedge 的核心定位是深色底 + 多层柔边椭圆 + 极光色系，在风格档案（style.md）中被概括为：

Aurora dark background with layered soft-edge ellipses. Innovative softedge technique creates depth through graduated blur.

• 适用场景：设计作品集（design portfolios）、创意展示（creative showcases）、艺术画廊（art galleries）
• 情绪基调：极光感（Aurora-like）、梦幻（dreamy）、艺术感（artistic）、神秘（mysterious）
• 整体色调：深色背景配柔和极光色（Dark with soft aurora colors）

在 reference/styles/INDEX.md 的风格索引中，dark--aurora-softedge被归入 Dark 色板组，在"Design / Architecture / Art"用途速查表与dark--liquid-flow、dark--editorial-story等风格并列推荐。值得注意的是，该风格在索引表中的主色十六进制列为-，表示其没有独立的build.sh演示脚本（其他风格通常通过build.sh提取 bg / fg / accent 三色），因此使用时需要从风格文档的设计哲学出发自行确定配色，而不是直接照抄坐标——这一点正是 INDEX.md L5-11 反复强调的："Learn the approach, do not copy the code"。

二、核心技法：分层柔边椭圆与渐变模糊

style.md 将设计技法归纳为三条：

1. 分层柔边椭圆：外层椭圆使用较大的柔边（softedge），内层椭圆保持锐利（sharp），形成对比。
2. 软边公式：基础椭圆的软边半径 =radius × 2.5pt（base ellipse softedge = radius × 2.5pt）。
3. 极光色板 + 渐变模糊：通过逐层模糊产生景深（graduated blur creates depth）。

这套"外层柔、内层锐"的分层思想并非该风格独有——同为深色组的 warm--bloom-academy/style.md 记录了同一套分层哲学（Layer 0 深层背景使用最大 softedge、Layer 1 中间层保持清晰对比）。可以理解为 morph-ppt 风格库中"有机柔边"一族的通用手法，Aurora Softedge 是其深色极光取向的代表。

softedge 属性的源码级实现

OfficeCLI 在形状与文本级别都支持softedge属性。以形状为例，PowerPointHandler.ShapeProperties.cs的合法属性清单（见 src/officecli/Handlers/Pptx/PowerPointHandler.ShapeProperties.cs）中同时包含：

• 形状级ApplySoftEdge(spPr, value)；
• 文本级ApplyTextSoftEdge(run, value)（作用于 run 的字符属性）。

其底层换算在 DrawingEffectsHelper.cs 的BuildSoftEdge中实现：

public static Drawing.SoftEdge BuildSoftEdge(string value) { var numStr = value.EndsWith("pt", StringComparison.OrdinalIgnoreCase) ? value[..^2].Trim() : value; if (!double.TryParse(numStr, System.Globalization.CultureInfo.InvariantCulture, out var radiusPt) || double.IsNaN(radiusPt) || double.IsInfinity(radiusPt) || radiusPt < 0) throw new ArgumentException($"Invalid 'softedge' value '{value}'. Expected a finite non-negative numeric radius in points."); return new Drawing.SoftEdge { Radius = (long)(radiusPt * EmuConverter.EmuPerPoint) }; }

从实现可以确认三点：

• softedge的合法输入是非负的数值半径（单位 pt），允许带pt后缀（如5pt）或不带；
• 内部统一换算为 EMU（EmuConverter.EmuPerPoint，即每磅 12700 个 EMU）写入 OOXML 的a:softEdge效果节点；
• 非法输入（NaN、无穷、负数）会抛出明确的参数异常，即--prop softedge=-1pt这样的写法会被 CLI 拒绝，而不是静默写入坏数据。

对应到 style.md 的公式"base ellipse softedge = radius × 2.5pt"：如果某个背景椭圆的半径约为 4cm，估算其视觉尺度后按公式取softedge=10pt（≈4cm × 2.5pt 的量级），内层锐利椭圆则不加 softedge 或取softedge=0pt，即可获得"外层弥散、内层清晰"的分层观感。

三、把风格接入 Morph：场景演员与极光景深

Aurora Softedge 的价值在 Morph 过渡下会放大——多层椭圆可以在相邻幻灯片间位移、缩放、改变透明度，营造"镜头平移"般的极光流动感。这需要先理解 morph-ppt 技能的两条核心机制（见 skills/morph-ppt/SKILL.md）：

1. 同名配对：PowerPoint 的 Morph 引擎靠相邻幻灯片间完全相同的name=来配对形状并插值其位置 / 尺寸 / 旋转 / 填充 / 透明度。名字不匹配 ⇒ 无动画、静默淡出。
2. 三前缀命名系统：

对于 Aurora Softedge，场景演员就是那些柔边椭圆本身：!!scene-aurora-large（外层大柔边椭圆）、!!scene-aurora-core（内层锐利小椭圆）这类命名能天然保持配对。

透明度的三段位（极光景深的关键）

pptx-design.md 为 morph 舞台风格定义了比基础 pptx 更紧的三档透明度规范，正好可以承载"极光层次"：

• ≤ 0.12：全片装饰（!!scene-grid、!!scene-band、角落点缀），绝不能与内容争夺视线；
• 0.3 – 0.6：数据衬底 / KPI 卡片填充，足够框定又能让数字突出；
• 0.8 – 1.0：仅限本身就是内容的!!actor-*（例如单条数据背后的光环、作为信息承载的品牌色条），每页至多 2 个，否则视觉杂乱。

应用到极光背景时：最外层的弥散大椭圆取opacity=0.1~0.15（全片装饰层），中层取0.3~0.5，内层锐利高光取0.6~0.8——三层叠加即形成"渐变模糊产生景深"的极光幕布。

四、实战构建：一个 Aurora Softedge 双页 Morph 示例

以下命令基于 morph-ppt 技能主文档的可运行配方（skills/morph-ppt/SKILL.md），套入 Aurora Softedge 的深色底 + 柔边椭圆技法。注意 shell 中!!必须单引号包裹，防止 bash/zsh 历史展开：

FILE="aurora-portfolio.pptx" officecli create "$FILE"; officecli open "$FILE" # Slide 1 —— 深色底 + 两层柔边极光椭圆 + 锐利核心 + 标题 officecli add "$FILE" / --type slide --prop layout=blank --prop background=0A0E27 officecli add "$FILE" /slide[1] --type shape --prop 'name=!!scene-aurora-large' --prop preset=ellipse \ --prop fill=6C63FF --prop opacity=0.12 --prop softedge=12pt \ --prop x=5cm --prop y=3cm --prop width=16cm --prop height=16cm officecli add "$FILE" /slide[1] --type shape --prop 'name=!!scene-aurora-mid' --prop preset=ellipse \ --prop fill=48E5C2 --prop opacity=0.35 --prop softedge=6pt \ --prop x=14cm --prop y=8cm --prop width=10cm --prop height=10cm officecli add "$FILE" /slide[1] --type shape --prop 'name=!!scene-aurora-core' --prop preset=ellipse \ --prop fill=CADCFC --prop opacity=0.6 --prop softedge=0pt \ --prop x=9cm --prop y=11cm --prop width=4cm --prop height=4cm officecli add "$FILE" /slide[1] --type shape --prop 'name=#s1-title' \ --prop text="Aurora Portfolio" --prop x=2cm --prop y=2cm --prop width=28cm --prop height=3cm \ --prop font=Montserrat --prop size=54 --prop bold=true --prop color=FFFFFF --prop align=center --prop fill=none # Slide 2 —— 应用 morph 过渡，极光椭圆集体位移 + 缩放（空间差异 ≥ 5cm），标题淡出 officecli add "$FILE" / --type slide --prop layout=blank --prop background=0A0E27 --prop transition=morph officecli add "$FILE" /slide[2] --type shape --prop 'name=!!scene-aurora-large' --prop preset=ellipse \ --prop fill=6C63FF --prop opacity=0.15 --prop softedge=12pt \ --prop x=20cm --prop y=2cm --prop width=18cm --prop height=18cm officecli add "$FILE" /slide[2] --type shape --prop 'name=!!scene-aurora-mid' --prop preset=ellipse \ --prop fill=48E5C2 --prop opacity=0.4 --prop softedge=6pt \ --prop x=3cm --prop y=14cm --prop width=12cm --prop height=12cm officecli add "$FILE" /slide[2] --type shape --prop 'name=#s2-body' \ --prop text="Selected works, 2024–2026" --prop x=2cm --prop y=8cm --prop width=30cm --prop height=2cm \ --prop font=Inter --prop size=20 --prop color=CADCFC --prop fill=none # ghost 掉第 1 页标题（@name= 路径在 morph 后依然可解析） officecli set "$FILE" "/slide[2]/shape[@name=#s1-title]" --prop x=36cm 2>/dev/null || true officecli close "$FILE"; officecli validate "$FILE"

要点回顾：

• 配对：!!scene-aurora-*三个名字在两张幻灯片上逐字节一致，Morph 才会对它们插值；#s1-title与#s2-body名字刻意不同，靠 cross-fade 过渡。
• ghost 位置：移出画布使用x=36cm（画布右缘 33.87cm 之外），切勿删除!!形状——删除会破坏配对导致动画消失。
• 空间差异：第 1→2 页三个椭圆位移均 ≥ 5cm，满足 morph-ppt 技能"至少 3 个配对形状、位移 ≥ 5cm 或旋转 ≥ 15° 或尺寸差 ≥ 30%"的运动底线。
• softedge取参：按 style.md 公式外层取最大（radius × 2.5pt量级，示例 12pt），中层递减（6pt），内层锐利（0pt），配合透明度递减形成极光景深。

五、极光配色的实操建议与约束

Aurora Softedge 没有预设主色（INDEX.md 中 hex 列为-），配色需按 morph-ppt 的舞台风格规范自行确定。建议遵循 pptx-design.md 的对比度公式：

Brightness = (R × 299 + G × 587 + B × 114) / 1000

深色底（亮度 < 128）时，正文亮度必须 ≥ 80%（#FFFFFF、#EEEEEE、#CADCFC）；图表序列填充与图标描边同样达标。极光色系常见取向可参考 Dark 组相邻风格：深蓝紫背景（如#0A0E27、#0F0F2D）搭配紫（#6C63FF）、青绿（#48E5C2）等柔和高饱和点缀，正文用#FFFFFF/#CADCFC这类高亮色。所有色值在最终交付前应通过officecli view "$FILE" html做 Gate 5b 的暗底暗字（dark-on-dark）目检。

六、多页连续极光：helpers 与 ghost 纪律

超过 2 页的连续极光流动建议使用 skills/morph-ppt/reference/morph-helpers.py（或同目录.sh版本，按平台二选一，不要混用）。helper 提供clone、ghost、verify、final-check四个动作，把"克隆上一页 + 施加transition=morph+ ghost 掉上一页#s(N-1)-*内容"的手工循环压缩为每次 1～2 行调用。

同时务必遵守Ghost Discipline（skills/morph-ppt/SKILL.md 明确列为强制规则）：每一页都是独立画布，第 N 页移出的!!actor-*不会自动在 N+1 页保持离屏——每新建一页内容后，都要把所有不应出现的旧!!actor-*再次set --prop x=36cm。final-check会在 ghost 数量超过 50 时拒绝交付（REJECT: Found … accumulated ghosts），这是 M-2 幽灵累积的自动防线。

七、交付验收与渲染器边界

交付前必须跑通 morph-ppt 的完整 Delivery Gate（继承自 pptx v2 的 Gate 1–5a 加上 5b-morph-1..4）：

• 5b-morph-1：!!actor-*退出后不得停留在可视区（x < 33.87cm即判定泄漏）；
• 5b-morph-2：相邻页间 ≥ 3 个不同!!形状在{x, y, width, height, rotation, font-size}中至少各变 1 项，防止"假装是 Morph 的静态页"；
• 5b-morph-3：相邻页至少共享 2 个完全相同的!!名字（极光椭圆层即配对证据）；
• 5b-morph-4：#s(N-1)-*不得滞留在第 N 页可视区。

注意 morph 过渡是运行时特性：PowerPoint 365（Windows/Mac）、Keynote、WPS、PowerPoint Online 支持；LibreOffice Impress、Google Slides 网页版、HTML/SVG 预览大多退化为静态或普通淡出（skills/morph-ppt/SKILL.md 将之归为[RENDERER-BUG]而非技能缺陷）。静态截图无法验证 Morph 运动，必须用上述查询证明配对正确性，并在真实支持 Morph 的软件中人工目检运动质量。

八、延伸阅读

• dark--aurora-softedge/style.md — 本文主题的风格档案
• reference/styles/INDEX.md — 52 套风格的索引与速查表（Dark 组定位、适用场景）
• reference/pptx-design.md — morph 舞台风格的对比度公式、字号阶梯、透明度三段位、场景演员细节
• skills/morph-ppt/SKILL.md — morph-ppt 技能主文档：三前缀命名、ghost 纪律、配对规划表、Delivery Gate 5b
• src/officecli/Core/DrawingEffectsHelper.cs —BuildSoftEdge的取值校验与 EMU 换算实现
• src/officecli/Handlers/Pptx/PowerPointHandler.ShapeProperties.cs — 形状 / 文本级softedge属性解析入口

• CLI
• AI 应用
• MCP 服务