49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
# 主题选择
|
||
|
||
主题负责**审美气质、排版语言、图片风格、Raw 风格、代码 / 公式风格**。它不是 CSS 皮肤，
|
||
也不是信息密度规则。
|
||
|
||
> CSS 给浏览器读，theme profile 给 AI 读。
|
||
|
||
- **组件库拥有运行时主题**：CSS token、`ThemeProvider` 注册、实际渲染。
|
||
注册的 runtime theme id 见 `src/theme/ThemeProvider.tsx`（当前：`tufte`、`press`）。
|
||
- **Skill 拥有主题 authoring profile**：`theme-profiles/index.json` + `<id>.md`，
|
||
指导 AI 如何选择和使用主题。
|
||
|
||
## 选择流程
|
||
|
||
1. 读 `theme-profiles/index.json`，拿每个主题的 `bestFor` / `mood`。
|
||
2. 按 `source.md` 的内容类型 / 语气，从 `bestFor` 命中里挑 1-2 个推荐：
|
||
- 技术 / 证据 / 数据型 → `tufte`。
|
||
- 叙事 / 评论 / 出版 / 产品手记 → `press`。
|
||
3. 读选定主题的 `theme-profiles/<id>.md`（写作 / 配图 / Raw / 代码前的权威）。
|
||
4. 把选择 + 理由写进 `plan/plan.md` 的 **Theme** 段（见 `plan-template.md`）。
|
||
|
||
## Density 与 Theme 解耦
|
||
|
||
theme profile 里可以写"不同信息密度下的表现建议"，但**不能写成限制**。例：
|
||
|
||
- `tufte + 100% longform`：克制长文、数据证据、Raw 点亮关键概念。
|
||
- `tufte + 40% visual-essay`：仍成立，Raw 偏图解 / 证据、低装饰。
|
||
- `press + 100% longform`：可做深度出版文章。
|
||
- `press + 40% briefing`：更强编辑节奏与图文留白。
|
||
|
||
## 主题选择自检
|
||
|
||
- 主题是否匹配文章类型？
|
||
- 当前信息密度下，正文 / Raw / 图片比例该如何调整？
|
||
- Raw 是否能在该主题下自然发生？配图策略是否符合主题？
|
||
- 是否存在主题与源材料冲突？（冲突要在 `plan/plan.md` 的 Theme 段解释）
|
||
- runtime theme id 是否真实存在于组件库？Skill profile 是否存在？
|
||
|
||
## 新增主题的约束
|
||
|
||
新增主题必须**同时**满足：
|
||
|
||
1. 组件库有 runtime theme CSS 与 `ThemeProvider` 注册（`src/theme/themes/<id>/`）。
|
||
2. Skill 有对应 `theme-profiles/<id>.md`。
|
||
3. `theme-profiles/index.json` 绑定到正确 runtime theme id。
|
||
|
||
- 只有 Skill profile、没有组件库 runtime theme → 只能作候选，不能用于正式生成。
|
||
- 只有组件库 runtime theme、没有 Skill profile → Agent 不能主动推荐。
|