Web Deploy GitHub Pages

核心用法

Web Deploy GitHub Pages 提供端到端的静态网站托管解决方案，覆盖从项目初始化到自动化部署的完整工作流。用户通过 init_project.sh 创建标准化项目结构，选择 base-html、portfolio 或 landing 模板进行开发，最终借助 deploy_github_pages.sh 完成 GitHub 仓库创建与 GitHub Actions 配置，实现推送到 main 分支即自动部署。

显著优点

零配置部署：内置 GitHub Actions 工作流自动处理构建与发布，无需手动配置 Pages 设置。模板化开发：提供三种生产就绪模板，支持单页优先的现代响应式设计。纯前端栈：默认使用原生 HTML/CSS/JS，无构建依赖，加载性能优异。版本控制原生集成：基于 Git 的工作流天然支持代码回滚与协作。免费托管：GitHub Pages 提供全球 CDN 与 HTTPS 证书，零成本上线。

潜在局限

静态内容限制：仅支持纯静态网站，无法运行动态后端或数据库。仓库公开要求：免费版 GitHub Pages 需公开仓库，私有部署需 Pro 账户。定制化边界：预设模板可能限制高度自定义设计需求。CLI 依赖：依赖 GitHub CLI (gh) 认证状态，新手可能遇到权限配置障碍。传播延迟：DNS 更新与 CDN 缓存可能导致 5-10 分钟部署延迟。

适合人群

前端开发者、设计师、自由职业者、求职者（简历站点）、初创产品团队（MVP 落地页）、技术博主及任何需要快速托管静态内容的用户。尤其适合熟悉 Git 工作流、追求极简部署体验的开发者。

常规风险

• 权限泄露风险：脚本需 GitHub 个人访问令牌，存储不当可能导致账户泄露
• 内容安全风险：静态站点仍可能包含 XSS 漏洞（如用户输入未转义）
• 供应链风险：CDN 引入的第三方库若被篡改将影响站点安全
• 配置漂移：手动修改仓库 Pages 设置可能破坏自动化工作流
• 账户锁定：GitHub 政策变更或账户限制可能导致站点下线

核心用法

web-deploy-github Skill 提供完整的静态网站创建与部署工作流，涵盖从项目初始化到 GitHub Pages 上线的全流程自动化。用户只需提供项目名称和 GitHub 用户名，即可通过两条命令完成部署：

1. `bash scripts/init_project.sh <project-name>` — 生成标准项目结构（index.html、styles.css、script.js、GitHub Actions 工作流配置）
2. `bash scripts/deploy_github_pages.sh <project-name> <github-username>` — 初始化 Git 仓库、创建远程仓库、配置 Pages 设置并触发首次部署

Skill 内置三套模板：base-html（极简 HTML5 骨架）、portfolio（作品集/简历模板，含 Hero、About、Skills、Projects、Contact 区块）、landing（落地页模板，含 Hero、Features、Pricing、CTA）。生成代码遵循现代前端最佳实践：语义化 HTML5、移动优先响应式设计、CSS 变量主题系统、Vanilla JS 渐进增强、自动 dark mode 支持。

---

显著优点

极致简化部署流程：将 GitHub Pages 配置、GitHub Actions 工作流编写、仓库初始化等繁琐步骤封装为单条命令，大幅降低技术门槛。

开箱即用的模板系统：三套预置模板覆盖最常见的静态站点场景，生成代码即为生产就绪状态，无 placeholder、无依赖安装、无构建步骤。

纯原生技术栈：默认采用原生 HTML/CSS/JS，零依赖、零构建工具，加载速度极快，维护成本极低；如需框架可通过 CDN 引入。

全自动 CI/CD：基于 GitHub Actions 的持续部署，推送至 main 分支即自动构建并发布至 gh-pages 分支，无需手动操作。

---

潜在缺点与局限性

单页应用优先：架构设计针对单页/轻量多页站点优化，复杂多页路由、服务端渲染、动态 API 路由等场景不在支持范围内。

依赖外部工具链：必须预装 Git 和 GitHub CLI (gh)，且需完成 gh auth login 认证，Windows 用户需额外配置环境。

定制化深度有限：模板生成后如需深度定制（如添加后端逻辑、数据库、自定义域名 SSL 配置），仍需手动介入 GitHub 设置。

域名与访问延迟：默认使用 github.io 子域名，国内访问可能存在延迟；自定义域名需手动在仓库 Settings 中配置。

---

适合人群

• 开发者/设计师：快速搭建个人作品集、简历站点、技术博客
• 初创团队/独立开发者：产品落地页、MVP 展示页面、活动页
• 学生/求职者：零成本上线项目展示站点，替代传统 PDF 简历
• 开源项目维护者：项目文档站点、演示页面、下载页

---

常规风险

GitHub 账号权限风险：脚本需 GitHub CLI 的 write 权限以创建仓库和配置 Pages，建议在专用 token 或 SSH key 环境下操作，避免使用高权限 personal token。

公开仓库默认：创建的仓库默认为 public，若需部署敏感内容（如内部文档）需手动改为 private（GitHub Pro 功能）。

Actions 配额：GitHub Free 账户有 Actions 使用时长限制，高频更新可能触发限额。

DNS 传播延迟：首次部署后 github.io 域名解析可能需要 5-10 分钟生效，非 Skill 故障。