SuperAPI AI 工具集

github-pages-publisher

部署与运维

查看项目

更新于 10-15 19:58

技能介绍

用途:这是页面产物的部署/输出层,把其他技能生成的、已经构建好的静态文件发布到 GitHub Pages 仓库,本身不做前端设计工作。

主要能力:按固定目录结构 <year>/<year>-<month>/<page-slug>/ 存放产物(如 2026/2026-03/my-landing-page/),禁止平铺在仓库根目录;保留相对资源路径,以 index.html 为入口,保持页面目录自包含,避免破坏已发布页面;对过大的 .jpg、.jpeg、.png、.webp 图片做优化(默认目标 500KB,可调);发布前校验入口文件、本地绝对路径、密钥、资源可达性与页面渲染;返回最终公开 URL,形如 <pages-base-url>/<year>/<year>-<month>/<page-slug>/。

使用方式:运行 python3 scripts/publish_static.py --source <dir-or-html> --slug <name> [--date YYYY-MM-DD] [--image-max-kb 500],脚本会复制产物、优化图片、提交推送并打印公开 URL。单独优化图片可运行 uv run --with pillow python3 scripts/optimize_images.py <artifact-dir> --max-kb 500。需要原图时用 --keep-large-images 或 --image-max-kb 0。slug 使用小写字母、数字和连字符。配置见 config/README.md,操作清单见 references/publish-checklist.md。

限制:图片优化是建议而非硬性要求,Pillow/uv 不可用或优化失败时继续发布原图并给出警告;不删除 Pages 仓库中无关目录,只替换目标页面目录内容;不得在输出、日志或提交文件中暴露令牌;本地视口校验失败不得推送。