官网改版后提问指南在 https://cpp.tongji.sh/Website/qa/ask/, 平台内不再单独留一份: - 删除 customization/custom/public/assets/tjhlp/ask-guide.html - home.tmpl(「按模板提问」卡片 + 底部相关站点)、base/head_navbar.tmpl(未登录导航 与用户菜单两处)、学期答疑入口卡片: 全部改指官网 /Website/qa/ask/ - issue-templates 两个 config.yaml 同样改指官网; general 里原来那条「答疑平台提问指南」 (指向平台内副本)直接去掉, 只剩「提问指南」+「课程官网」两条官网入口 - 顺手修掉两个已失效的官网地址: /Website/faq/ -> /Website/qa/faq/(旧的是跳转页), /Website/contact -> /Website/contact.html(旧地址现在 404) - custom/public 因此变成空目录, 加 .gitkeep 占位: bind mount 的源目录不存在时 docker compose 会以 root 创建它, 之后普通用户/CI 写不进去(同 options/.gitkeep 的坑) 断言同步: check.sh 与 preview.sh check 改为断言指向 /Website/qa/ask/、页面里没有 ask-question//Website/faq//Website/contact" 这些旧地址、平台内副本已 404。 实测(预览): 首页与导航栏 3 处 qa/ask/、1 处 qa/faq/、1 处 contact.html, 登录后卡片 再 2 处 qa/ask/; 两套检查脚本全过; scripts 80 个测试全过。
`ROOT` 是仓库根, 但断言用的是 `${ROOT}/custom/...`, 那个路径根本不存在, 于是 `if [[ -f ... ]]` 永远为假 —— 「生成的 zh-CN 语言文件已无工单」这条从未真正跑过 (在预览/生产上跑都是直接跳过, 看不出来)。改成 `customization/custom/...`。 顺带加上首页(登录后)学期答疑入口卡片的模板层断言: 卡片模板在位 + dashboard.tmpl 里确实 include 了它。渲染结果需要登录才能看, 那部分在 preview.sh check 里 (它用 previewadmin 登录后抓首页)。 实测: customization/check.sh 对预览与生产都跑通(生产多一条 OIDC 入口 307)。
按 deploy/ci-cd.md 方案把除推送触发之外的东西都准备好: - customization/check.sh <base-url>: 把 preview.sh check 里的"定制生效"断言抽成 任意实例可跑的脚本(首页/页脚/meta/官网链接/登录页两张卡/无通行密钥方框/ 无「工单」/无 example.com), 另加生产才有的 OIDC 入口 307 断言(404 = 认证源没注册上)。 实测对生产 17/17 通过。 - deploy/scripts/auto-deploy.sh: build.py -> compose up -d -> verify.sh + check.sh, 失败自动回滚到 deploy/.state/last-deployed; flock 串行; 结束时把 clone 所有权还给 ymy(job 容器里是 root); 内网验证强制不走代理。 - deploy/runner/{compose.yaml,config.yaml,.env.example}: act_runner v0.6.1 跑在容器里 (不需要 root), network: host + 同路径挂载部署克隆 + 宿主 docker CLI/compose 插件, capacity 1 保证部署串行。 - .gitea/workflows/deploy.yml: push main + workflow_dispatch, [skip deploy] 跳过, concurrency 串行, 只做"同步到 github.sha + 调 auto-deploy.sh"。 - .gitignore: deploy/.state/、deploy/runner/{.env,data/}。 依据见 deploy/ci-cd.md(含全部实测证据与待确认项)。