均在仓库根目录执行，需 Python 3（无第三方依赖，除非另有说明）。
| 脚本 | 作用 |
|---|---|
check_site_md_parity.py |
校验每个 site/*.html 是否有对应 site/md/<stem>.md 与正确 GitHub blob 链接（CI 引用）。 |
gen_cc_overview.py |
根据 site/data/cc-overview.json 写回 topic-cc-unpacked-zh.html 内三表；--check、--verify-in-sync、--dry-run。GitHub Actions site-md-parity 会在 CI 内再跑一次生成并用 cmp 比对前后文件，防止漏提交 HTML。 |
gen_cc_arch_treemap.py |
扫描 ccsource/claude-code-main/src 下各子目录 TS/TSX 数量，写 site/data/cc-arch-treemap.json（双层 Treemap：教学分区 → 子目录）；--verify-in-sync；无镜像时 verify 仅校验 JSON。 |
cc-tool-tiles.js / cc-feature-cards.js |
（静态脚本）读 site/data/cc-overview.json 的 tool_tiles、feature_cards，挂在 topic-cc-unpacked-zh.html。 |
check_cc_loop_steps.py |
校验 site/data/cc-loop-steps.json 结构（唯一 id、必填字段等）。 |
cc_loop_demo_events.py |
模块：演示用 (stage, title, detail) 列表，供下面两个脚本复用。 |
cc_loop_relay_demo.py |
向 stdout 打印 NDJSON 形式 demo 事件。 |
cc_loop_sse_relay.py |
本机 SSE 服务（默认 127.0.0.1:8769/events），供 topic-cc-loop-lab.html 联调。 |
fetch_ai_bot_tab.py |
抓取 ai-bot.cn 首页整类 section（如 term-86 的“AI智能体”）、favorites/* 分类专页（如 favorites/ai-agent/）或 AJAX 子 tab（如 id=94 的“降AI/AIGC率”），导出 JSON/Markdown。 |
install_skill_from_github.py |
从 GitHub 仓库浅克隆指定 skill 目录，并安装到 ~/.claude/skills/、.claude/skills/ 或 ~/.codex/skills/。 |
skillsmp_find_and_install.py |
通过 r.jina.ai 代理读取 SkillsMP 搜索结果，自动挑选候选 skill、回 GitHub 校验，并继续调用安装脚本。 |