6bdaeed6d4
- .gitignore 新增 .zcode/（ZCode 工具本地配置，不入库） - 更新交通/通信/差旅等财务规则表 - 补充 2026-06-25/26 开发日志（chat UI SaaS 化、主题企业 AI 风格、bug 日志）
70 lines
4.3 KiB
Markdown
70 lines
4.3 KiB
Markdown
# 主题设置与企业沉稳 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: 风险与开放问题] 若第三类主题命名发生变化，同步更新概念文档和测试描述。
|