学页｜白标品牌定制中心

概述

学页｜白标品牌定制中心是一款面向 K12 教培机构品牌、运营与校区管理团队的品牌资产定制技能。团队只需提供机构名称、Logo、标准色等基础品牌要素，即可一键生成学页生态的单一品牌事实源 brand.json，并让全部学页技能的交付物（学习报告、学情仪表盘、互动教室、课件、切片视频包装等）自动套用机构品牌，解决品牌落地中的四大痛点：

1. 配置重复——每个技能各自要一遍机构名、Logo、配色，改一次品牌要重配七处
2. 风格漂移——不同人不同时间生成的交付物色值不一、Logo 位置各异，机构显得不专业
3. 对比度事故——品牌色直接做文字/背景，投屏后看不清、打印出来一团糊
4. 无品牌规范沉淀——品牌要求散落在聊天记录和口头传达里，新人接手两眼一抹黑

本技能把品牌要素沉淀为一份机器可读、人可核对的 brand.json：上游一次采集，下游所有学页技能读取同一份配置渲染交付物——改一处，全系列焕新。同时产出品牌规范页（.html，可投屏可发微信）、应用矩阵（品牌要素在 7 个学页技能中的落点速查）与品牌预览（效果先行确认再量产）。

产出为单文件 HTML（无外部依赖、可离线打开）+ brand.json（供全部学页技能消费）+ 品牌资产包目录（可选存放 Logo 图片文件）。

触发场景

以下情况触发本技能：

• 直接关键词：白标、品牌定制、品牌换装、换品牌、机构品牌、白标定制、品牌中心、统一品牌、品牌配置、去学页化、贴牌、OEM定制
• 语境触发：用户描述机构品牌落地需求（如"把我们机构的品牌应用到所有交付物""报告要用我们自己机构的名字和Logo""换个配色，家长端看到的都是我们品牌"）
• 材料触发：用户上传品牌资产（Logo图片、VI手册、色值截图、品牌规范文档），要求生成品牌配置或应用到学页交付物
• 首启触发：机构首次使用任何学页技能前，先配置品牌（"第一次用学页，先把机构品牌设置好"）
• 更新触发：机构品牌升级/换季/并购更名后，更新 brand.json 使全系列交付物焕新

不触发的场景：单个交付物的具体内容生成（用对应学页技能）、Logo 图片本身的设计绘制（用图像生成工具）、非学页生态产物的品牌应用。

工作流程

品牌定制遵循五步标准化工作流。Step 1-3 为首次配置流程，Step 4-5 为日常使用与更新流程。

Step 1: 品牌要素采集

从用户输入与上传材料中提取品牌要素。如信息不完整，提问补充。

需采集的要素：

采集规则：
1. 最多提问 3 个问题，一轮问完，禁止多轮追问
2. 只问缺失的必填项（机构名称、主色）；用户已表达的信息不重复问
3. 若用户上传 VI 手册/Logo/色值截图，先提取信息，减少提问
4. 非必填项未提供时使用默认值，不提问；默认值须在交付时明示
5. 信息齐全时直接进入 Step 2，无需确认

素材处理： 用户上传的 Logo/品牌图片复制到品牌资产包目录（如 品牌资产包/logo.png），brand.json 中记录相对路径引用，不内嵌图片本体。

Step 2: 品牌配置生成

将采集的要素固化为 brand.json——学页生态的单一品牌事实源。

实现方式： 加载 references/brand-schema.md 按规范生成，或直接调用 scripts/brand_kit_builder.py 交互式生成。

brand.json 结构要点：

brand.json
├── meta           配置版本、更新时间、适用学页技能清单
├── identity       机构名称、标语、Logo路径、多校区标识
├── colors         主色/辅助色/强调色/文字色/背景色（明暗双主题各一套）
├── typography     字体栈（标题/正文）、字号基准
├── tone           话术语气、品牌话术替换表（如"学页"→机构名）
└── assets         Logo等素材文件的相对路径与用途标注

关键约束：
1. 色彩须通过 WCAG AA 对比度校验——主色做文字用 primary_text（文字场景变体，主色对底不足 4.5:1 时同色相自动加深/提亮），白字压主色底（按钮）≥3:1，正文组合 ≥4.5:1；不达标自动给出最小改动的修正建议
2. 明暗双主题各生成一套完整色板，缺省时由主色算法衍生（暗色主色自适应提亮至对暗底可读）
3. 字体必须给出离线降级栈（在线字体 + 系统黑体兜底），保证断网环境交付物不塌版
4. 话术替换表须包含品牌名替换规则，确保交付物中不残留"学页"原生品牌词

文件位置： brand.json 统一存放在机构工作空间根目录（或用户指定目录），全部学页技能从此处读取。

Step 3: 品牌资产包生成

生成人可核对的品牌规范与效果预览，先确认再量产。

交付物：

实现方式： 调用 scripts/brand_preview.py 由 brand.json 渲染预览；应用矩阵内容加载 references/application-matrix.md。

确认环节： 生成预览后请用户确认品牌效果（重点核对：色值准确、Logo 清晰、对比度可读、话术无"学页"残留）。用户提出修改时回到 Step 1 增量更新对应要素，重跑 Step 2-3。

Step 4: 品牌应用与量产（下游消费）

品牌确认后，在后续使用任何学页技能时自动应用品牌。

应用机制：

1. 学页技能生成交付物前，检测工作空间是否存在 brand.json
2. 存在 → 读取并以品牌要素渲染（配色、机构名、Logo、字体、话术替换全部套用）
3. 不存在 → 按学页原生默认风格渲染，并在交付时提示"可先配置品牌"

应用落点速查（详见 references/application-matrix.md）：

重要： 本技能管理"交付物长什么样"，不代行各技能的内容生成。品牌应用由各学页技能在渲染时读取 brand.json 完成；本技能负责生成、校验、维护这份配置并给出应用矩阵指导。

Step 5: 品牌更新与多机构管理

品牌更新： 机构品牌升级时，修改 brand.json 对应字段（或重走 Step 1-3），后续新生成的交付物即用新品牌；已生成的历史交付物不回溯修改，如需焕新须重新生成。

多校区/多品牌：
- 单机构多校区：在 brand.json 的 identity.campuses 中配置校区名+色点，交付物按校区标识区分
- 多机构（如代理商服务多家机构）：每家机构一套独立品牌资产包目录，生成交付物时指定使用哪套 brand.json

版本管理： brand.json 的 meta.version 随每次修改递增，meta.updated_at 记录更新时间，便于排查"这份报告用的是哪版品牌"。

参考文档索引

以下参考文档按需加载，不必一次性全部读取：

工具脚本

以下脚本可直接执行，提供确定性能力：

品牌校验用法：

python scripts/brand_validator.py brand.json
python scripts/brand_validator.py brand.json --json

资产包构建用法：

python scripts/brand_kit_builder.py --interactive
python scripts/brand_kit_builder.py --name "启航教育" --primary "#E63946" --slogan "让每一页学习都有回响"

品牌预览用法：

python scripts/brand_preview.py brand.json --output 品牌规范.html

依赖的 WorkBuddy 内置技能

下游品牌消费由各学页技能自行完成，本技能不依赖其运行。

重要约束

1. 单一事实源：brand.json 是学页生态唯一品牌配置来源；任何学页技能不得硬编码机构品牌信息，必须读取 brand.json。
2. 对比度红线：未通过 WCAG AA（4.5:1）的配色组合禁止产出；校验不通过时必须先修正再交付，自动修正建议须明示用户。
3. 去原生品牌：应用品牌后，交付物中不得残留"学页"原生品牌词（话术替换表强制覆盖）；品牌规范页与预览页本身须标注"由学页品牌中心生成"以区分生成工具与机构品牌。
4. 离线可用：所有品牌渲染逻辑随交付物单文件内联（字体降级栈、色值、Logo 内嵌 base64 或路径引用），断网环境不塌版。
5. 素材安全：用户上传的 Logo 等素材仅复制到用户工作空间的品牌资产包目录，不上传外部服务；brand.json 只记录相对路径。
6. 默认值透明：使用默认品牌要素（默认主色/默认字体等）时，必须在交付时明确告知用户哪些是默认值、如何修改。
7. 历史不回溯：品牌更新只影响后续新生成的交付物，不自动修改已生成文件；需焕新历史交付物时提示用户重新生成。