用途:在任意 GitHub 仓库(新建或已有)中搭建与 fandhe-frontend 官方站点相同设计与机制的 GitHub Pages 文档站点。Markdown 放在 site/,推送到默认分支后由 GitHub Actions 构建并发布。对已构建的仓库再次运行可更新到技能最新结构,同时保留用户编辑的 site/ 内容与 pages.yml 中的用户区段。
主要能力:生成器使用 fandhe-frontend 的 Rust SSG(crates/docs-site),按 tools/docs-site-gen/FF_REV 记录的 commit 通过匿名 cargo install --git(--locked)安装 docs-site 二进制,并以 --no-page-sections 生成;品牌设置(品牌名、GitHub 链接、页脚等)由 site/nav.toml 的 [site] 指定,生成后不做替换;部署调用 Fandhe-AI/actions 的公共 reusable workflow(pages-deploy.yml@latest)。
使用方式:以 /setup-github-pages 触发。新构建时确认目标仓库、站点 title、base_path、品牌显示、导航构成与公开范围;更新时仅确认目标仓库与公开范围。本地构建命令为 bash tools/docs-site-gen/build-local.sh --clean --write-third-party。scaffold.py 负责模式判定(--detect)、放置与更新、冲突差分(--show-diff),退出码 0 成功、2 输入或写入目标不合法、3 冲突、4 放置完成但 check_site 失败。
适用场景:希望用 GitHub Pages 发布文档站点、并保持与 fandhe-frontend 一致外观与构建流程的仓库。
限制:需要 git、cargo/rustup(stable)、已认证的 gh、curl、python3,测试需 Node.js;需要目标仓库管理员权限与网络访问。Pages 站点即使仓库为 private 也通常以公开 URL 可访问。不可用于 Fandhe-AI/fandhe-frontend 自身。不可信仓库不应执行本地构建,应在 CI 或隔离环境验证。THIRD-PARTY-LICENSES 需提交到仓库。其余细节暂未提供。