半桶水式 Codex 学习项目 QA 记录

本文记录课程化改造过程中的阶段性质量检查。它不是最终验收报告，而是用于后续继续迭代时快速判断哪些内容已经检查过、哪些风险仍需复看。

关联审计：半桶水式 Codex 学习项目完成度审计。
维护机制：Codex 官方资料定期复核协议。

2026-06-11 阶段检查

范围

本轮检查覆盖：

• 首页 /
• 课程入口 /course/
• 能力矩阵 /course/capability-matrix.html
• 学习路线 /guide/00-overview.html
• 订阅指南 /guide/02-subscribe-plus.html
• 桌面宠物 /guide/11-desktop-pet.html
• 任务设计 /practice/task-design.html
• 案例总览 /recipes/
• 入口地图 /platform/
• 配置总览 /configuration/
• 代表性高风险案例：GitHub Actions 自动修复、临床文献综述

构建检查

命令：

corepack pnpm build

结果：通过。VuePress 成功渲染 65 个页面，并生成 SEO、feed、sitemap 和 redirect 文件。

关键词检查

命令：

rg -n "[禁用表达清单]" docs/guide docs/course docs/practice docs/recipes docs/index.md

结果：无命中。

补充检查：

rg -n "[占位表达清单]" docs/index.md docs/course docs/guide docs/practice docs/recipes docs/platform docs/configuration

结果：无命中。

关键链接检查

本地服务：

python3 -m http.server 8801 --directory docs/.vuepress/dist

关键页面返回：

页面	状态
/	200
/course/	200
/course/capability-matrix.html	200
/guide/00-overview.html	200
/guide/02-subscribe-plus.html	200
/guide/11-desktop-pet.html	200
/practice/task-design.html	200
/recipes/	200
/platform/	200
/configuration/	200
/recipes/github-actions-ci-fix.html	200
/recipes/clinical-literature-review.html	200

全站内部链接脚本检查：

OK 78 html files checked

检查范围：docs/.vuepress/dist 下全部 HTML 文件里的本地 href 和 src。外部链接、mailto:、tel:、data:、javascript: 和构建产物 /assets/ 不纳入断链判断。

截图与布局检查

检查视口：

• 桌面：1440x1000
• 移动：390x844

检查页面：

页面	桌面横向溢出	移动横向溢出
/	0px	0px
/course/	0px	0px
/guide/02-subscribe-plus.html	0px	0px
/guide/11-desktop-pet.html	0px	0px
/practice/task-design.html	0px	0px
/recipes/	0px	0px

截图输出：

• /tmp/codex-btw-screens/phase5-home-desktop.png
• /tmp/codex-btw-screens/phase5-course-mobile.png
• /tmp/codex-btw-screens/phase5-task-design-desktop.png
• /tmp/codex-btw-screens/phase5-recipes-mobile.png
• /tmp/codex-btw-screens/phase2-gap-subscribe-mobile.png
• /tmp/codex-btw-screens/phase2-gap-pet-mobile.png
• /tmp/codex-btw-screens/phase2-gap-pet-desktop.png
• /tmp/codex-btw-screens/interaction-course-desktop.png
• /tmp/codex-btw-screens/interaction-course-mobile.png
• /tmp/codex-btw-screens/responsive-table-recipes-mobile.png
• /tmp/codex-btw-screens/responsive-table-configuration-mobile.png
• /tmp/codex-btw-screens/responsive-table-config-file-mobile.png

交互与键盘检查

浏览器脚本检查结果：

OK interaction checks passed

覆盖内容：

• TaskBriefBuilder：文本框可聚焦，输入后任务骨架实时更新。
• WorkflowPassport：tab 语义完整，支持 ArrowLeft、ArrowRight、Home、End 切换；移动端点击状态正常。
• CapabilityMatrix：能力域按钮支持 Enter 和 Space 激活。
• 移动端课程页点击交互后横向溢出为 0px。

移动端表格检查

浏览器脚本检查结果：

OK responsive table checks passed

覆盖页面：

• /recipes/：5 张表格，138 个单元格获得移动端字段标签，横向溢出 0px。
• /configuration/：3 张表格，30 个单元格获得移动端字段标签，横向溢出 0px。
• /configuration/config-file.html：3 张表格，40 个单元格获得移动端字段标签，横向溢出 0px。

人工复看结论：

• 首页视觉层级清楚，课程入口、学习路线和案例入口都在首屏或首屏后可见。
• 课程移动页可读，学习路径、任务卡和工作流护照组件没有明显挤压。
• 任务设计页已具备“这节解决什么、适合谁、工作流卡、验收标准、复用模板、风险边界”。
• 订阅指南已补充官方核对路径、订阅后验证、验收标准和支付风险边界。
• 桌面宠物页已从功能说明改成“状态可视化”小课，补充判断点和复用方式。
• 入口地图已补充入口选择逻辑、工作流卡、检查点和验收标准。
• 配置总览已补充配置四层模型、工作流卡、检查点和验收标准。
• 案例总览移动页信息密度较高，但未出现横向溢出；后续可继续优化表格在小屏上的扫读体验。

内容 QA 结论

当前内容基本满足 5 个课程 QA 问题：

• 新手知道先从课程入口、学习路线或第一个低风险任务开始。
• 首页、课程页、任务设计和案例页都说明了为什么学。
• 订阅页和桌面宠物页已补齐学习目的、适合人群、验收标准和风险边界。
• 入口地图和配置总览不再停留在工具清单，已补充“为什么选这个入口 / 为什么这样配置”的判断框架。
• 案例页已从工具介绍转向真实工作流场景。
• 核心入门页和案例页保留“验收标准”概念。
• 核心交互组件已完成键盘和移动端点击检查。
• 移动端长表格已增加字段标签式扫读增强。
• 文案保持半桶水的专业、通俗和人性化表达，没有使用低幼或过度承诺式表达。

后续维护提醒

• 订阅页涉及套餐、价格、额度和地区策略，后续按 官方资料定期复核协议 维护。
• 后续如果继续改动交互组件，需要同步补新的键盘和点击状态检查。