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

66 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 对话”而失败;保留新
布局并恢复该兼容短语,再运行完整回归。