43 lines
4.3 KiB
Markdown
43 lines
4.3 KiB
Markdown
# Phase 5g：页面后台化（blocks 模型）与字体子集化 - 任务拆解
|
||
|
||
## 使用规则
|
||
- boundary/verify 齐备；verify 只读断言；车道工作树开发禁 git，收编由 orchestrator 统一提交
|
||
- 构建一律 `export PATH="$HOME/.local/node/bin:$PATH"`（Node 26）
|
||
|
||
## 阶段一：实现
|
||
|
||
- [x] T1 blocks 骨架（关于页块式页面构建器）
|
||
- claim: op-gitea
|
||
- boundary: src/content.config.ts（siteAbout 加 blocks: z.array(discriminatedUnion)）、新增 src/lib/page-blocks.ts（getAboutBlocks：过滤 enabled、未知 type 跳过+WARN、文本 pickBi 回落、块数≤24/单块≤4000 字）、新增 src/components/blocks/{BlockRenderer,Prose,Tracks,Divider}.astro、AboutPage.astro 改由 blocks 驱动（blocks 空→intro markdown→默认文案三级回落）、public/admin/config.yml 加 list+types（typeKey: type）
|
||
- verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && grep -q "discriminatedUnion" src/content.config.ts && grep -q "BlockRenderer" src/components/pages/AboutPage.astro && grep -q "typeKey" public/admin/config.yml`
|
||
|
||
- [x] T2 块型扩充与图片管线
|
||
- claim: op-gitea
|
||
- boundary: 新增 src/components/blocks/{Cards,Timeline,Quote,Figure,LinkList,Cta}.astro + 图标键白名单（复用 SocialLinks 注册表或新建 icons 注册表）、schema 块型补全（图片字段用 image()，禁止外链字符串）、content/site/assets/ 目录、near docs 图表说明
|
||
- verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && ls src/components/blocks/ | grep -qC1 "Cards\|Timeline" && grep -q "image()" src/content.config.ts`
|
||
|
||
- [x] T3 样式即数据（theme.yaml + 对比度闸门）
|
||
- claim: op-artalk
|
||
- boundary: 新增 content/site/theme.yaml（12 个白名单旋钮：prose-size/measure/radius/accent/leading 等）、新增 src/lib/theme.ts（getTheme + themeVarsCss 生成 :root:root{…}）、BaseLayout.astro head 内联 theme 变量（构建期静态）、新增 scripts/build-perf/contrast-check.mjs（断言 theme 结果下正文对比度 ≥4.5）、public/admin/config.yml 加 theme 单例、build.sh 守卫挂载
|
||
- verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && test -f content/site/theme.yaml && node scripts/build-perf/contrast-check.mjs dist`
|
||
|
||
- [x] T4 首页细化与去重
|
||
- claim: op-artalk
|
||
- boundary: 新增 src/components/pages/HomePage.astro（承接现 index.astro 区块逻辑，locale prop）、src/pages/{index,en/index}.astro 改为薄壳、home.yaml 增 projectsLimit / announcement（markdown）/ postsTracks（轨开关细分），site-content 访问器同步
|
||
- verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && test -f src/components/pages/HomePage.astro && grep -q "HomePage" src/pages/en/index.astro`
|
||
|
||
- [x] T5 开源页收尾（缓存/回落/告警）
|
||
- claim: worker-one
|
||
- boundary: src/lib/site-content.ts（README 缓存策略与超时、回落矩阵）、content/.github-readme.md 与 README HTML 剥离策略（复用 rehype-content-sanitize 已挡危险标签；补: 外链徽章不阻断）、src/data/projects-fallback.json 回填 5-8 条真实仓、projects.ts include 未命中 console.warn
|
||
- verify: `E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS" && python3 -c "import json;d=json.load(open('src/data/projects-fallback.json'));assert len(d)>=5"`
|
||
|
||
- [x] T6 文档与后台 hint 补齐
|
||
- claim: worker-one
|
||
- boundary: docs/管理台.md（块编辑怎么用、增删排序、预览限制）、docs/写作指南.md（块字段表/受限类/主题项）、public/admin/config.yml 全字段中文 hint（含 T1-T4 新增字段）
|
||
- verify: `test -f docs/管理台.md && grep -q "blocks\|区块" docs/管理台.md && grep -c "hint" public/admin/config.yml | awk '$1>=20'`
|
||
|
||
- [x] T7 字体子集化工具
|
||
- claim: orchestrator
|
||
- boundary: 新增 scripts/build-perf/subset-fonts.py（pyftsubset 按指定字体 + 页面实际用字生成子集 woff2 + 重写 fonts.css 指向子集文件）、infra/deploy/build.sh 守卫挂载、docs/写作指南加字流程补"子集化"一节
|
||
- verify: `test -f scripts/build-perf/subset-fonts.py && python3 -c "import fontTools; print('fonttools ok')" && E2E_BASE=http://127.0.0.1:18924 node tests/e2e.mjs 2>&1 | grep -q "37/37 PASS"`
|