# 主题设置与企业沉稳 AI 模式 开发 TODO

更新时间：2026-06-25

文档路径：document/development/2026-06-25/feature/theme-settings-enterprise-ai-style/TODO.md

## 使用规则

- 每个任务都需要关联 `CONCEPT.md` 中的章节，格式为 `[CONCEPT: 章节名]`。
- 完成实现后再勾选对应任务，不用文档勾选代替代码验证。
- 涉及真实页面效果的任务，需要在 5173 页面完成验收后再标记完成。

## 1. 调研与边界

- [x] [CONCEPT: 背景与问题] 确认当前设置外观入口仍使用“界面皮肤”语义，后续需要改为“主题设置”。
- [x] [CONCEPT: 方案设计] 确认当前主题能力主要依赖 `appearanceForm.themeSkin`、主题选项和根节点 dataset。
- [x] [CONCEPT: 方案设计] 确认企业沉稳 AI 模式主要需要覆写 `personal-workbench-ai-mode.css` 中的背景、对话、图标和提示块样式。
- [x] [CONCEPT: 风险与开放问题] 梳理旧色板值到三类主题值的完整映射清单。
- [x] [CONCEPT: 用户与场景] 确认三类主题在设置页中的展示顺序和说明文案。

## 2. 契约与设计

- [x] [CONCEPT: 功能能力] 将主题枚举收敛为 `vivid`、`enterprise`、`intelligent`。
- [x] [CONCEPT: 功能能力] 明确三类主题的中文名称、适用场景和视觉关键词。
- [x] [CONCEPT: 方案设计] 设计 `normalizeThemeMode` 兼容函数，保证旧值和未知值都有稳定回退。
- [x] [CONCEPT: 方案设计] 决定是否新增 `themeMode` 前端概念，并保持与 `themeSkin` 字段兼容。
- [x] [CONCEPT: 指标与验收] 定义企业沉稳 AI 模式的视觉验收标准。

## 3. 后端实现

- [x] [CONCEPT: 方案设计] 评估后端 settings schema 是否需要补充主题枚举校验。
- [x] [CONCEPT: 方案设计] 若继续复用 `themeSkin`，确保后端允许新主题值保存。
- [ ] [CONCEPT: 测试方案] 补充或更新设置持久化测试，覆盖三类主题值。
- [x] [CONCEPT: 风险与开放问题] 确认不需要数据库结构迁移，并在实现说明中记录。

## 4. 算法/规则实现

- [x] [CONCEPT: 算法与公式] 实现旧主题值到新主题值的 normalize 逻辑。
- [x] [CONCEPT: 算法与公式] 为未知值设置默认回退策略，优先回退到“企业沉稳”。
- [x] [CONCEPT: 算法与公式] 确保本地缓存、后端返回值和根节点 dataset 使用同一套归一化结果。

## 5. 前端实现

- [x] [CONCEPT: 功能能力] 将设置左侧菜单“界面皮肤”改为“主题设置”。
- [x] [CONCEPT: 功能能力] 将页面标题改为“主题风格与界面体验”。
- [x] [CONCEPT: 功能能力] 将保存反馈和说明文案从“皮肤”语义调整为“主题”语义。
- [x] [CONCEPT: 功能能力] 将原色板式选项调整为三类主题卡片。
- [x] [CONCEPT: 功能能力] 为“动感活泼”保留当前视觉风格。
- [x] [CONCEPT: 方案设计] 为“企业沉稳”新增 AI 模式样式覆写。
- [x] [CONCEPT: 方案设计] 为“专业智能”新增介于活泼和沉稳之间的样式边界。
- [x] [CONCEPT: 指标与验收] 检查主题卡片、按钮和说明文字在移动端不溢出、不重叠。
- [x] [CONCEPT: 方案设计] 保证刷新页面后主题选择和 AI 模式样式仍然一致。

## 6. 测试与验证

- [x] [CONCEPT: 测试方案] 更新设置页相关前端测试，断言“主题设置”和三类主题选项。
- [x] [CONCEPT: 测试方案] 补充 normalize 逻辑测试，覆盖旧值、未知值和三类新值。
- [x] [CONCEPT: 测试方案] 补充 AI 模式企业沉稳 CSS 钩子测试或静态断言。
- [x] [CONCEPT: 测试方案] 运行前端设置相关定向测试。
- [x] [CONCEPT: 测试方案] 运行 `npm --prefix web run build`。
- [x] [CONCEPT: 测试方案] 运行 `git diff --check`。
- [x] [CONCEPT: 测试方案] 在真实 5173 页面验收 `/app/settings?section=appearance`。
- [ ] [CONCEPT: 测试方案] 在真实 5173 页面验收 AI 工作台三类主题切换效果。

## 7. 文档收尾

- [x] [CONCEPT: 本轮文档记录] 实现完成后更新本文勾选状态。
- [x] [CONCEPT: 指标与验收] 在最终交付说明中记录测试、构建和真实页面验收结果。
- [ ] [CONCEPT: 风险与开放问题] 若第三类主题命名发生变化，同步更新概念文档和测试描述。
