YG-Soft/X-Financial
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
6bdaeed6d48a5a6737842ea0dfa89fe188dabf0c
X-Financial/document/development/2026-06-25/feature/theme-settings-enterprise-ai-style/TODO.md
caoxiaozhu 6bdaeed6d4 chore: 忽略 .zcode 本地目录并更新规则表与开发日志 
- .gitignore 新增 .zcode/（ZCode 工具本地配置，不入库）
- 更新交通/通信/差旅等财务规则表
- 补充 2026-06-25/26 开发日志（chat UI SaaS 化、主题企业 AI 风格、bug 日志）
2026-06-26 22:42:46 +08:00

4.3 KiB
Raw Blame History

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

更新时间：2026-06-25

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

使用规则

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

1. 调研与边界

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

2. 契约与设计

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

3. 后端实现

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

4. 算法/规则实现

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

5. 前端实现

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

6. 测试与验证

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

7. 文档收尾

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