Codex 教程 02：快速读懂陌生仓库（结构/入口/风险点）
用最短路径理解项目：从目录树到关键链路，再到可落地的修改策略与风险控制。
你将学到什么
陌生仓库上手的关键不是“把所有文件看完”，而是用结构化方法找到入口、数据流与风险点。本篇给你一套 30 分钟内建立全局认知的流程。
你将获得
- 可复用的模板
- 可执行的步骤
- 可验证的清单
- 可回滚的策略
适合人群
- 希望把 AI 变成稳定生产力的开发者
- 需要为团队沉淀规范的人
- 正在做多页面内容站/工程项目的人
三层扫描法
- 1) 目录层：找到入口文件、路由/页面目录、构建脚本
- 2) 组件层：找公共布局（header/footer）、可复用组件与样式来源
- 3) 行为层：找事件处理、数据依赖与外部链接
快速提问模板
请概述该站点的页面生成流程：入口脚本、模板来源、输出目录结构。
请列出顶部导航的链接来源与生成位置。
请指出二级页面复用的布局模块，并说明如何修改“页面最大宽度”。风险点清单
- “全局遮罩层/移动菜单”覆盖页面导致点击无响应
- 通用模板导致内容同质化、SEO 质量下降
- 链接指向锚点但页面已拆分，出现空页或跳转失败
- 图片路径相对引用错误，二级页丢图
输出：一页架构说明
你应该能用一页纸写出：页面怎么生成、哪些模板可复用、哪些地方要做差异化、如何验证输出是否正确。这是后续大改的“地图”。
检查清单
通用验收清单
- 导航链接：点击可达、无同内容页面、无死链
- SEO：每页独立 title/description/keywords/canonical/og/robots
- 结构：H1 仅一个，H2/H3 语义清晰，段落足够长
- 性能：图片本地 webp + lazy-load + decoding=async
- 可维护：内容/模板集中管理，支持批量重建
前置条件与准备
- 明确当前页面/功能的‘唯一主题’（避免同质化）
- 准备一份验收清单（SEO/链接/内容/性能）
- 所有外链优先指向官方或可验证来源
- 每次改动都能重新生成并抽样检查关键页面
练习与作业
练习 A（10 分钟）
为站点新增一个‘专题页’，要求包含：表格 + FAQ + 相关链接。
练习 B（30 分钟）
为该专题页补齐 SEO meta，并将其加入站点地图与教程中心的相关链接。
相关链接
高频问答
如何判断页面内容是否足够‘丰富’？
至少包含：清晰的 H2/H3、多个段落、可执行步骤、示例/命令/表格/FAQ，并且与主题强相关。
为什么布局要做差异化？
布局差异化能降低模板感，提升阅读体验；同时让搜索引擎更容易区分页面意图与主题。
如何保持资料‘最新’？
关键链接与规格尽量指向官方来源；页面标注更新时间，并定期检查外链与版本信息。
如何避免‘越写越宽、越看越累’？
用更窄的内容容器（max-w-6xl/5xl）、更好的行高、更多分段与模块化卡片，让长文更精致。
进阶扩展
下一步建议：把本教程里的‘模板/清单/示例’固化为仓库内的文档与脚本。这样任何人接手都能按同一标准生成页面、校验 SEO、检查链接与内容密度，并持续扩展长尾专题。
