web-deploy-github

用途：自动创建并部署单页静态网站到 GitHub Pages，适合作品集、CV 页面、落地页等。

主要能力：提供完整工作流，从项目结构初始化到通过 GitHub Actions 自动部署。内置模板包括 base-html（最小 HTML5 样板）、portfolio（含分区作品集/CV 模板）、landing（含 hero 与 CTA 的落地页）。设计上优先单页布局、纯 HTML/CSS/JS、响应式、现代 CSS（flexbox/grid）、CSS 变量、渐进增强与性能优化。

使用方式：

1. 初始化项目：bash scripts/init_project.sh <project-name>，生成 index.html、styles.css、script.js、README.md 及 .github/workflows/deploy.yml。
2. 开发网站，可从 assets/templates/ 选择模板。
3. 配置并部署：bash scripts/deploy_github_pages.sh <project-name> <github-username>，脚本会初始化 git、通过 GitHub CLI 创建仓库、配置 Pages、推送首次提交并触发部署。
4. 推送 main 分支后 GitHub Actions 自动部署到 gh-pages，站点地址为 https://<username>.github.io/<project-name>/。

适用场景：作品集、CV 页面、产品落地页等单页静态站点。

限制与排查：需已认证 gh CLI（gh auth status）；Pages 源需设为 gh-pages 分支；DNS 传播可能需 5-10 分钟；构建失败需查看 Actions 日志并检查 deploy.yml 语法与文件路径。具体收费、平台支持范围等资料暂未提供。