# llm-master 同步维护入口
后续继续同步时，让 AI 先读且只需指定读取本文档：
docs/src/_llm-master-sync/README.md。本文档是维护入口，具体历史和长期设计再通过文内链接查阅。
本目录只用于维护 llm-master 开源仓库，不属于公开内容。
# 当前进度
- 首轮建设已完成：正文镜像、根首页、六阶段学习路线、四条专项路线、六个专题和全量索引均已建立。
- 已公开同步 153 篇 Markdown，上次内容基线对应源提交
55bb0b632b45bf19fea710ebb7864870ab8d20a2，目标提交为d132dc3f5622318f3db942b2909fb61223c3c59d。 - 2026-09-13 已检查至源仓库提交
5733cfbfe5ca66e859ab70a1bc469d0227cdca71：新增 0、更新 0、目标端待删除 0，当前无正文需同步。 - 已知问题与完整首轮校验结果见同步记录。
# 同步范围
- 内容源：
docs/src/llm和docs/src/interview/llm。 - 目标仓库：
/Users/kama/Documents/workplace/projects/llm-master。 - 正文在卡码笔记中维护，再原样同步到
llm-master；不直接修改目标仓库中的镜像正文。 - 默认排除
CLAUDE.md、_*.md、drawio/、备份、临时文件和.DS_Store。 - 源文件删除默认只报告，不自动传播到目标仓库。
长期目标、目录设计、路线原则和验收标准见建设与同步规划。
# AI 执行顺序
- 读取本文档，再读同步记录的最新一条；需要改动路线、范围或目录设计时，再读建设与同步规划。
- 运行
./scripts/sync-content.sh check，确定当前新增、更新和待删除文件。 - 运行
./scripts/sync-content.sh dry-run，展示即将发生的变更；检查新文章是否为公开完成稿，以及导航、路线、专题索引是否需同步调整。 - 确认清单后运行
./scripts/sync-content.sh apply。只有用户明确确认删除时，才使用apply --delete。 - 生成全量索引，执行字节哈希、内部链接和敏感文件校验。
- 将本次来源提交、目标提交、变更数量、导航变更、校验结果和异常追加到同步记录，并更新本文档的“当前进度”。
# 维护文档与工具
- 建设与同步规划：项目定位、长期路线、同步原则和验收标准。
- 同步记录：每次同步的来源提交、范围、变更数量、验证结果和已知问题。
content-hashes.sha256：最近一次公开正文的 SHA-256 基线。scripts/sync-content.sh：正文差异检查、预览和同步。scripts/verify-content.sh：正文哈希、链接和排除项验证。scripts/generate-index.py：全量文章索引生成。scripts/check-links.py：仓库内 Markdown 链接检查。
# 命令
./scripts/sync-content.sh check
./scripts/sync-content.sh dry-run
./scripts/sync-content.sh apply
./scripts/verify-content.sh
python3 scripts/generate-index.py
python3 scripts/check-links.py
1
2
3
4
5
6
2
3
4
5
6
以上命令均在 docs/src/_llm-master-sync 目录执行。默认内容源为 /Users/kama/Documents/workplace/vuepress-bagu-plus，目标仓库为 /Users/kama/Documents/workplace/projects/llm-master。可分别通过 LLM_MASTER_SOURCE_ROOT 和 LLM_MASTER_TARGET_ROOT 覆盖。
正文删除默认只报告，不传播。确认删除清单后，才可显式运行 ./scripts/sync-content.sh apply --delete。
评论
验证登录状态...