Files
cc-web/.planning/warframe-theme-rework/task_plan.md
2026-07-18 10:14:38 +08:00

4.1 KiB
Raw Blame History

Warframe 主题返工计划

目标

根据用户反馈重做 Warframe Wasteland 主题:优先解决文字费眼与图片构图随意的问题, 同时把用户提供的 Displate CDN 与 Pinterest Warframe 画作整理成多图视觉参考板; 保留用户最初上传的主题原图,不绕过站点验证,不把参考图复制进项目。

视觉策略

  • 视觉论点: 墨黑舰舱般的高对比工作台Warframe 原画只在空会话状态成为完整 立幅,进入阅读状态后退场,不再铺在正文背后。
  • 内容规划: 导航负责定位;欢迎态左侧负责操作提示、右侧负责完整画作;聊天区 只负责阅读;输入区使用稳定不透明表面。
  • 交互论点: 欢迎画作短距离淡入;会话选中态只用暗金边缘;输入聚焦使用清晰 暖色描边;遵守减少动态偏好。

执行步骤

  1. [complete] 评估用户提供的 Warframe 候选并确定构图
  2. [complete] 建立真实表面的文字对比度指标
  3. [complete] 重构欢迎态图片艺术面板
  4. [complete] 提升阅读导航与输入区域对比度
  5. [complete] 优化桌面与移动端响应式构图
  6. [complete] 更新主题资源与样式回归契约
  7. [complete] 运行回归测试并完成独立视觉审查

完成标准

  • 对用户提供的 CDN/Pinterest 参考记录来源 URL、可访问性、可借鉴的构图方法与 禁用方式;至少综合 3 张参考图的方法,保留最初主题原图,参考图不复制进项目。
  • 普通聊天状态的正文、导航和输入区后方不出现图片;所有阅读表面保持不透明。
  • 主文字、次文字、弱文字分别相对其真实不透明表面达到至少 7:1、5.5:1、4.5:1 分别检查默认、hover、active、focus、disabled、会话选中、输入占位符、消息气泡、 代码块、命令菜单和弹层,不再只计算主题变量。
  • 欢迎态在 1440×900 和 1024×768 使用明确的文字/立幅双区域390×844 单列展示, 图片完整、不挤压输入框、不产生横向滚动。
  • public/style.css 需移除阅读态图片并实现欢迎态布局、实色 token 和状态覆盖; public/app.js 只在确有必要时增加稳定欢迎态标记;scripts/regression.js 需断言 阅读态无背景图、欢迎态独立图片、关键状态色与响应式规则。
  • 专项与完整回归通过,独立审查无阻塞或中高风险问题;若仍无浏览器运行时,必须将 真实布局视觉验证标为待用户复核,不能用静态检查冒充浏览器验收。

风险与约束

  • 保留用户已有未提交改动,不重写无关子代理卡片逻辑。
  • 保持内部主题值 gilded,避免破坏已保存偏好。
  • 不重启 cc-web静态资源由现有服务实时提供。
  • 当前环境没有 Playwright/Chromium先检查是否存在可执行截图/DOM 尺寸替代路径。 若完全不可用,完成静态结构、对比度和构图规则审查后,保留“用户侧真实视觉复核” 未完成项,不虚报浏览器验收通过。

错误记录

  • Displate 搜索页和 robots.txt 均被 Cloudflare 安全检查替代,未获得作品列表。
  • DuckDuckGo HTML 与 Pinterest ideas 页面均在 30 秒后连接超时;不重复相同请求, 后续以用户已提供的 3 个 CDN 候选为决策集合。
  • 首次欢迎态组合补丁因 CSS 变量块上下文与当前文件不完全一致而未应用;改为分别 读取精确行并拆分 app/index、变量、欢迎布局三个小补丁不重复原补丁。
  • 欢迎态结构验证命令中的 rg 模式以 --page-background 开头,被误判为参数; Node/CSS 结构检查已通过,后续使用 rg -n -- '<pattern>' 校验,不重复原命令。
  • 最终并行核验中的全量回归超过单次 30 秒返回窗口,改为续接原进程读取终态;域名 检索命令因混合引号转义失败,改为多个 rg -e 参数完成同范围复核。
  • 首次完整回归因现有契约要求静态欢迎文案包含“开始与 Claude 对话”而失败;保留新 布局并恢复该兼容短语,再运行完整回归。