展开攻略目录
发布状态与复现
作者:AI 酋长 Andy|微信 AIPMAndy|公众号 AI酋长Andy|个人官网|公司官网
核对日期:2026-11-13。发布范围与完成标准以 DEPLOYMENT.md 为准。只有远程提交、工作流和实际访问均已核实,才标记为正式发布成功。
唯一正式目标:GitHub 与 GitHub Pages
- 唯一仓库:
AIPMAndy/chinese-international-student-business-jobs。 - 默认分支:
main;网站成品:本项目的dist/。 - 唯一正式网站目标:GitHub Pages。
- 正式网站:https://aipmandy.github.io/chinese-international-student-business-jobs/,已由成功部署日志及实际 HTTP 检查确认。
历史 ChatGPT Pages / Sites 的部署和访问记录不作为本项目的正式交付地址或 GitHub Pages 验收结果。
已完成的远程发布
源码、PDF、工作簿、模板与案例包、静态网站均已推送至公开仓库。GitHub Pages 部署成功;本次发布后对首页、正文、CSS、JS、PDF、XLSX、模板 ZIP 和源码 ZIP 共 8 个实际 URL 检查,均返回 HTTP 200,且 SHA-256 与部署提交的 dist 文件一致。 查看成功运行,对应提交 dfb6ef5b37c2e50d506283d64886a7d85194c639。该记录绑定此提交,后续更新以新的工作流结果为准。
最初的 404、缺少建仓接口与未登录记录属于发布前历史阶段,不再代表当前状态。目标仓库已存在;后续应审阅并更新本仓库 main,不要重复建仓。用户原有推送授权持续有效。
源码包与离线复现
完整源码在 downloads/repository-source.zip。解压出的独立项目包含中文正文、案例、模板、构建脚本、已审阅 PDF、XLSX 和静态网站。
源码 ZIP 不包含自身及自身的摘要文件,以避免递归包含和循环摘要;因此解压后,dist/downloads/repository-source.zip 与下载摘要需要在本项目内重新生成。这是打包规则,不代表正文、PDF 或案例缺失。
在新解压项目的根目录中,可以使用 Python 3.10 或更新版本完成以下离线恢复。所用 Python 脚本仅依赖标准库,不要求 GitHub 登录,也不会重新生成 PDF 或 XLSX:
python3 scripts/package.py
cp downloads/repository-source.zip downloads/SHA256SUMS.txt dist/downloads/
python3 scripts/check_pages_links.py
package.py 先打包模板与案例,把已完成的 PDF、XLSX 和模板包放入静态下载目录,再生成排除自包的源码 ZIP 及 downloads/SHA256SUMS.txt。复制步骤补齐网站的源码下载和摘要。新的下载摘要以本次生成结果为准。
链接检查模拟 GitHub Pages 的仓库子路径,验证首页、章节资源、锚点及四个必需下载文件。该步骤不访问互联网,只证明本地静态结构符合部署要求。
若正文或页面发生变化,应按项目构建说明重建对应成品后再打包;仅恢复解压包的下载结构,不需要重跑 PDF 渲染。
首次建仓脚本(历史说明)
本仓库已存在,不应重跑首次创建命令。下面保留脚本设计与恢复边界;后续更新直接使用已经确认的本项目仓库。
当 GitHub CLI 已在 github.com 认证为 AIPMAndy,且此新仓库仍未创建时,在本项目根目录执行:
bash scripts/publish-github.sh
脚本按以下顺序执行:
- 只读检查所需源文件、已审阅的 PDF/XLSX、静态首页和工作流;确认工作目录不是其他仓库的子目录,输出路径没有指向外部的符号链接。
- 确认认证账号为 AIPMAndy,且 GitHub 明确返回目标仓库不存在。账号不符、目标已存在、查询状态不明、已配置
githubremote 或本地 Git 范围无法确认时停止。 - 在本项目内运行标准库打包脚本,补齐
dist/downloads/repository-source.zip和SHA256SUMS.txt,运行 Pages 链接检查。检查失败时不提交、不建远程仓库、不推送。 - 只在本项目初始化或使用独立 Git 仓库,提交成品,创建固定的新公开仓库,并设置上述 GitHub Pages 目标为仓库主页。
- 只推送到固定
githubremote 的main,读回该远程分支的提交 SHA,与本地提交比对。脚本结束时仍明确提示 Pages 部署及访问尚待验收。
脚本不会复用或覆盖已存在的远程仓库。若建仓成功后因网络问题导致推送失败,应先核实目标仓库与 github remote 确实对应唯一目标,再重试推送;不要删除仓库,也不要改用其他项目。身份或接口问题应准确报告,不能解释为用户撤回授权。
GitHub Pages 部署与完成验收
已提供 .github/workflows/pages.yml,只允许本仓库 main 分支发布已提交的 dist/。在新仓库 Settings → Pages → Build and deployment → Source 选择 GitHub Actions,然后触发工作流;远端不会重新生成 PDF。
工作流依据 GitHub 官方自定义 Pages 工作流文档 配置,来源核对日期为 2026-11-13。当前已取得上方成功运行与线上访问证据。后续每次发布仍须等待其工作流完成,不能用旧版本的成功替代新版本验收。
完成正式交付需要保留:
- GitHub
main提交 SHA 与本次发布提交一致的读回结果。 - 对应提交的 Pages 工作流成功记录及实际
page_url。 - 实际首页、章节、CSS/JS,以及 PDF、XLSX、模板案例 ZIP、源码 ZIP 下载均正常的访问记录。
- 手机宽度下的导航、正文、表格及下载入口检查。
验证结果写入 VERIFY.md,区分历史记录、本地检查和本次 GitHub Pages 线上验收。
操作验收
输入: 本项目最终源文件、已审阅 PDF、XLSX、静态网站与验证记录。操作: 核对唯一目标与身份,恢复下载包并检查,提交、推送、部署,再实际访问。输出: 提交 SHA、工作流结果、实际 Pages 地址、下载摘要与访问记录。验收: 远程证据完整,下载与本次成品一致。错误处理: 记录具体缺失的执行能力、认证会话或构建错误;保留完成的成品,修复本项目后继续,不修改其他仓库。