用途:本技能是 GitHub Pages 的部署与管理指南,用于创建、配置、发布和排查静态站点,触发词涉及 setup github pages、add custom domain、setup jekyll、custom build、deploy to github pages、pages not working 等,并路由到 QuickStart、CustomDomain、JekyllSetup、ActionsWorkflow、Troubleshoot、Deploy 等工作流文件。
主要能力:区分用户/组织站点(仓库名须为 <username>.github.io,每账号仅一个)与项目站点(任意仓库,URL 含仓库名);支持从分支(根目录或 /docs)发布,或用自定义 GitHub Actions 构建(Hugo、Gatsby、Next.js 等)。Jekyll 方面列出自动启用的插件(如 jekyll-paginate、jekyll-gist、jekyll-relative-links 等)和无需额外配置的主题(Architect、Cayman、Minima、Minimal 等),也支持 remote_theme。自定义域名部分给出 apex 与子域名的 A/AAAA/CNAME 记录及验证命令,例如 dig example.com +noall +answer -t A。
用法:在仓库 Settings > Pages 选择发布来源;自定义域名需同时配置 DNS 记录并在仓库放置 CNAME 文件;HTTPS 应在证书签发后强制启用。技能内含 scripts/verify-dns.sh 与 scripts/check-site-status.sh 脚本。
限制:仓库与发布站点各约 1 GB,带宽 100 GB/月(软限),分支构建 10 次/小时(软限),部署超时 10 分钟;不支持服务端语言,不允许商业交易或电商;私有仓库仅 Pro/Team/Enterprise 可用 Pages。注意 CDN 缓存约 10 分钟,构建错误日志在 Actions 界面而非 Pages 设置,切换发布来源需重新部署。具体命令与代码以资料为准,本简介未提供部分暂缺。