核心用法
web-deploy-github 是一套面向单页静态网站的端到端自动化部署方案。用户通过两条核心命令即可完成从项目初始化到线上发布的全流程：首先运行 init_project.sh <project-name>> 生成标准项目结构（HTML/CSS/JS + GitHub Actions 工作流），随后执行 deploy_github_pages.sh <project-name> <github-username>> 完成仓库创建、Pages 配置与首次部署。GitHub Actions 会在后续每次推送到 main 分支时自动触发部署，将站点发布至 https://<username>.github.io/<project-name>/。
该技能内置三套模板：极简 HTML5 样板、作品集/CV 模板、营销落地页模板，覆盖常见静态站点场景。开发规范强调单页优先、无依赖原生技术栈、移动优先响应式设计，并支持暗黑模式与性能优化（图片懒加载、资源压缩）。
显著优点
1. 零配置自动化：完整封装 GitHub CLI 与 Actions 的复杂配置，用户无需手动创建仓库、设置 Pages 源分支或编写 YAML 工作流。
2. 模板化快速启动：预置经过设计的现代模板，可直接生成生产级代码，避免从零搭建的重复劳动。
3. 免费托管与 CI/CD：依托 GitHub Pages 实现全球 CDN 加速与 HTTPS 支持，配合 Actions 实现真正的推送即部署。
4. 技术栈简洁：优先使用原生 HTML/CSS/JS，无构建工具依赖，降低维护成本与学习曲线。
潜在缺点与局限性
- 单页架构约束：设计哲学偏向单页应用，多页面站点需手动扩展结构。
- GitHub 生态绑定：深度依赖 GitHub CLI 认证与仓库权限，无法迁移至其他 Git 托管平台。
- 外部脚本黑盒：核心逻辑封装在
init_project.sh与deploy_github_pages.sh中，用户若不审查脚本则难以知晓完整执行细节。 - 无服务端能力：纯静态托管，无法支持表单处理、数据库等动态功能（需配合第三方服务）。
适合的目标群体
- 开发者/设计师：需要快速上线个人作品集、简历或项目展示页。
- 初创团队：为产品 MVP 搭建轻量级营销落地页，验证市场假设。
- 技术写作者：发布文档站点或博客（可配合静态站点生成器扩展）。
- 教育机构：学生前端作业的标准化提交与展示平台。
使用风险
- 命令注入风险：脚本接收用户输入作为 shell 参数，若项目名包含特殊字符可能导致意外行为。
- 权限过度授予：需向 GitHub CLI 开放仓库创建与写入权限，建议创建专用令牌并定期轮换。
- 网络依赖：首次部署依赖 GitHub API 可用性与本地网络环境，国内用户可能需配置代理。
- Actions 配额：私有仓库受 GitHub Actions 免费额度限制，公开仓库无此顾虑。