场景路线

视觉复刻路线

从参考页面到本地截图的前端复刻和验收流程。

场景

你需要复刻一个文档站、产品页或工具界面,并且后续还要继续修改。目标不是复制私有源码,而是用公开技术栈重建结构、视觉层级和编辑体验。

推荐路线

  1. 先确认技术栈和可复用模板,优先使用官方模板或开源组件。
  2. 前端视觉评测 设定桌面、移动、暗色模式三个验收视口。
  3. Browser Visual QA 反复截图。
  4. 修改组件和 Markdown 后运行 pnpm lintpnpm typecheckpnpm build

模型路由

第一轮搭结构建议 Deep 路由。跨多个组件、需要多次截图修正时切到 Max 路由。只改一段 Markdown 或一个按钮文案时用 Fast 路由。

验收

  • 关键路由返回 200。
  • 桌面、移动和暗色截图没有溢出、重叠或亮色漏底。
  • 原始复刻页保留可编辑源文件。
  • 新增内容遵守编号目录和站点导航顺序。

当前项目映射

本项目已经把 /codex/model 保存在 content/3.codex/5.model.md,并把视觉检查截图放在 output/playwright/。后续改版时不要删除基线页,先在新增页面和组件上扩展。