展开攻略目录

GitHub Pages 发布

项目:中国留学生商科岗位求职保姆级攻略。本要求更新于 2026-11-13,对应用户明确的部署纠正。

唯一正式部署目标

已完成的发布验收

源码、PDF、工作簿、模板与案例包、静态网站均已推送至公开仓库。GitHub Pages 部署成功;本次发布后对首页、正文、CSS、JS、PDF、XLSX、模板 ZIP 和源码 ZIP 共 8 个实际 URL 检查,均返回 HTTP 200,且 SHA-256 与部署提交的 dist 文件一致。 查看成功运行,对应提交 dfb6ef5b37c2e50d506283d64886a7d85194c639。该记录绑定此提交,后续更新以新的工作流结果为准。

ChatGPT Pages / Sites 不再作为此项目的正式部署目标。保留的历史配置不能作为继续发布到旧服务的依据。

发布前

  1. 在本项目完成内容、移动端排版、PDF、模板和下载包验收。已有正文和设计继续复用。
  2. 重建 dist/;网站导航和资源使用适配仓库子路径的相对链接。若构建脚本支持网站基址,用上面的预计 Pages 地址生成 canonical 和 sitemap;它仅表示部署目标。
  3. 对成品执行 python3 scripts/check_pages_links.py。该检查模拟 /chinese-international-student-business-jobs/ 子路径,核对 HTML/CSS 本地资源、HTML 锚点和必须下载的文件;不访问互联网,不验证政策或外部来源。
  4. 将本项目的源码、成品 PDF、模板、dist/、本发布文档与工作流一起提交。不要把 .git、凭据、会话临时目录或个人申请资料作为网站成品发布。

必须存在且非空的下载文件:

  • dist/downloads/business-careers-guide.pdf
  • dist/downloads/business-job-workbook.xlsx
  • dist/downloads/templates-and-cases.zip
  • dist/downloads/repository-source.zip

GitHub 设置和推送

确认精确仓库 AIPMAndy/chinese-international-student-business-jobs 已存在且属于 AIPMAndy;若尚未创建,在具备建仓操作的已授权会话中创建此独立公开仓库。新建接口缺失不应被描述为“用户未授权”。

在本仓库 Settings → Pages → Build and deployment → Source 选择 GitHub Actions。工作流在 main 的静态产物、Pages 工作流或检查脚本更新后自动执行,也可在 Actions 页面手动运行;只允许本仓库的 main 发布。

自 2026-11-14 起,工作流先用已锁定的 Node 依赖从 scripts/build-site.mjs 重建全 53 页网站,再重新打包模板、案例和源码归档;验证逐页 canonical/OG/JSON-LD、robots/sitemap、章节链接及 PDF/ZIP 存在性后发布,并对本轮在线产物逐项进行 HTTP 200 和 SHA-256 核对。已审阅的 180 页 PDF 不在远端重排。仓库内 dist/ 是旧快照,最终上线文件以当轮 Actions 构建结果为准。部署作业仅取得 contents: read、pages: write、id-token: write 权限。

完成标准

  1. GitHub 返回的 main 提交 SHA 与本次发布提交一致。
  2. 此提交的 Pages 工作流状态为成功,并取得部署实际返回的 page_url。
  3. 实际网站首页、至少一个章节页、CSS/JS、PDF、XLSX 和 ZIP 下载返回正常结果;不能只根据预计 URL 或工作流文件存在断言上线。
  4. 在手机宽度检查导航、正文、横向表格与下载入口。页内公众号、微信和官网使用已核实的公开品牌信息。

本地校验完成与线上发布是两个独立状态。没有上述远程证据时,发布状态保持“待推送 / 待部署 / 待线上验收”,如实列明当前阻碍。

官方依据

2026-11-13 核对:

下载 PDF 与模板下载可编辑正文