wait4xandGLM-5.3
c307285a25
- T2：localePath 先归一 zh 再拼前缀（Header/CommandPalette/
BaseLayout 三处 /en/en/ 同源病根一刀），返回值统一尾斜杠；
BaseLayout 自指 canonical 全量 35 页；E2E 新增 en canonical
自指断言（33→34）
- T3：content-lint.mjs 零依赖三检（断链 FAIL/缺图 FAIL/zh-en
配对 WARN；CONTENT_LINT 逃生门；photos-originals 叠加层与
/admin 单语两误报已修）；prod-smoke.sh 三断言（robots 未落明
确 FAIL 不静默）；build.sh 守卫行挂载（smoke 对 staging 首版
容忍，T1 robots 上线后转硬门，触发条件注释在案）
- tasks.md verify 字面量 33→34 联动同步（6 处）
车道：op-gitea（verify 六条实录）；收编验收：E2E 34/34+产物零
/en/en/+lint 0/0/0 实跑复现
验证: node tests/e2e.mjs 34/34 PASS；! grep -r /en/en/ dist/；
content-lint 三检 0 违例；bash -n+test -x 过
Spec: 2026-10-26_blog-5f
Co-authored-by: GLM-5.3
4.8 KiB
4.8 KiB
Phase 5f：SEO 解封与功能优化批 + 美化首批 - 任务拆解
使用规则
- boundary/verify 齐备；verify 只读断言；车道工作树开发禁 git，收编由 orchestrator 统一提交
阶段一：实现
-
T1 SEO 仓库侧三件（robots.txt + admin noindex 预案 + 用户操作单）
- claim: orchestrator
- boundary: 新建 public/robots.txt（Allow 全站；Disallow /admin/ /draft/；Sitemap 行）；docs/上线检查单.md 追加「SEO 解封操作单」节（nginx snippet 行号/内部 vhost 补回清单/ESA purge+TTL+绕缓存三动作）；nginx/ESA 实操归用户
- verify:
test -f public/robots.txt && grep -q "Sitemap: https://wait4x.online/sitemap-index.xml" public/robots.txt && grep -q "Disallow: /admin" public/robots.txt && grep -q "SEO 解封操作单" docs/上线检查单.md
-
T2 localePath 双 en 修复 + 自指 canonical + 尾斜杠归一
- claim: op-gitea（mesh 车道）
- boundary: src/lib/locale.ts（先归一 zh 再拼前缀）；BaseLayout.astro 加自指 canonical（Astro.site+withSlash）；Header.astro nav-lang href 尾斜杠补齐；E2E 可加断言
- verify:
! grep -r "/en/en/" dist/ && grep -q 'rel="canonical"' dist/en/archives/mian-sha/index.html && node tests/e2e.mjs 2>&1 | grep -q "34/34 PASS"
-
T3 构建期内容 lint + 生产冒烟 + build.sh 守卫挂载
- claim: op-gitea（mesh 车道）
- boundary: 新建 scripts/build-perf/content-lint.mjs（dist 断链：站内 a[href] 逐一对产物；图片存在性；zh/en 配对警告）+ scripts/build-perf/prod-smoke.sh（curl robots/sitemap/首页头三断言）；build.sh 守卫行（存在性守卫铁律）；首版 fail 但提供 SKIP 环境变量逃生门
- verify:
node scripts/build-perf/content-lint.mjs dist && bash -n infra/deploy/build.sh && test -x scripts/build-perf/prod-smoke.sh
-
T4 reader 纯文本模式（html.reader + 命令面板 + r 键 + 持久化）
- claim: orchestrator
- boundary: global.css 尾部集中 html.reader 段（按 08 文档 §4.4 清单：隐 bg-glow/进度条/收 Header 尾部钮/Footer 收单行 ICP 必留；正文字号微升行宽收窄）；CommandPalette data-cmd="reader" + ui.ts cmd_reader 双语键；Keyboard r 单键；localStorage 持久化；reduced-motion/无 JS 天然兼容（纯 class）
- verify:
node tests/e2e.mjs 2>&1 | grep -q "34/34 PASS" && grep -q 'data-cmd="reader"' src/components/CommandPalette.astro && grep -q "html.reader" src/styles/global.css
-
T5 代码块窗条（P 卡：≥4 行灰阶窗+mono 标题+灰阶三点）
- claim: op-artalk（mesh 车道）
- boundary: 技术轨代码块渲染层（自查源码定落点：prose-tech 容器/全局 pre 样式）；≥4 行块加窗条（灰阶三点非红黄绿+mono 语言/文件标签），单行块裸 pill；亮暗双态；scoped 样式优先不动 global.css（与 T7 划界）
- verify:
node tests/e2e.mjs 2>&1 | grep -q "34/34 PASS" && grep -rqE "code-win|codebar|窗条" src/styles/ src/components/
-
T6 书评纸面板（Q 卡：圆角米灰纸卡+暗色暖棕+hairline 边框）
- claim: op-artalk（mesh 车道）
- boundary: 书评正文容器（prose-reading 所在组件 scoped 样式）：圆角纸卡+米灰 #f4f4f2 系亮/暖棕暗态；边框 hairline 级防长文竖线感（08 裁定 §6-2）；标题区外置结构不动；--paper 变量需求提给 orchestrator 入 tokens（T7 协同），不直接改 tokens.css
- verify:
node tests/e2e.mjs 2>&1 | grep -q "34/34 PASS" && grep -rq "paper" src/components/ | grep -v node_modules
-
T7 版式基底（K/L/O 卡：流距 token+灰阶补档+暗色 hairline 降档+微交互曲线+focus ring）
- claim: orchestrator（tokens/global 专属车道）
- boundary: tokens.css（--flow-* 流距五变量+灰阶补档评估+--paper 纸色变量）；global.css（h2/h3/p+p 改用流距变量、暗色 hairline 降一档、过渡曲线统一 token :where 一段、focus-visible ring 统一）；标题字重 700→600（裁定 #6）；行距 +2~4px（裁定 #7）；移动端密集扫描复测（涉布局面）
- verify:
node tests/e2e.mjs 2>&1 | grep -q "34/34 PASS" && grep -q "flow-h2-pre" src/styles/tokens.css && grep -q "focus-visible" src/styles/global.css
-
T8 首屏 tagline + 图库质感（M/N 卡：身份语+圆角统一+暗色衬底）
- claim: orchestrator
- boundary: 首页身份区（IdCard 或等位组件）加 tagline ≤20 字（措辞备两案入完成总结供用户选，默认「写作者 · 读者 · 快门按压者」）；GalleryPage 圆角统一 --radius-img 暗色 4% 衬底（裁定 §6-4 双模式分判；衬底圆角≤照片圆角防框中框）；亮色直贴不动
- verify:
node tests/e2e.mjs 2>&1 | grep -q "34/34 PASS" && grep -rq "tagline" src/pages/index.astro src/components/ && grep -q "radius-img" src/styles/tokens.css