姚章浩 90db243a68 fix(web): 旧 index.html 的哈希资源回退到「上一版构建」，页面不再空白/裸奔 ...

现象（主人反馈：页面**偶尔**变成"只有文字没样式"）：旧入口 index.html 引用的是上一版的
`index-CddbQIqQ.js` / `index-DLg1Y9tN.css`，而新镜像里只剩当次构建的两个文件
⇒ JS 404 白屏、CSS 404 只有文字没样式。触发条件是"短时间内多次重建 web + CDN/浏览器还拿着旧入口"。

修复（三层，各管一段）：

1. **入口不缓存**（上一笔已做）：`index.html` → `no-cache, must-revalidate`，CDN/浏览器每次回源校验；
2. **旧哈希资源仍可取**（本笔）：`/assets/` 未命中时先回退到只读挂载的
   `deploy/legacy-assets/assets`（**上一版构建**的资源），再 404 ⇒ 还持有旧入口的客户端
   不会因为一个文件 404 而白屏/裸奔；该目录由 `scripts/deploy-api-web.sh` 在**每次重建前**
   从"正在运行的那个镜像"里落盘（`LEGACY_ASSETS=` 会打在部署日志里），并加进 .gitignore；
3. **未命中不再回退成 HTML**：避免浏览器把 index.html 当 JS 执行报一堆语法错误。

验证：旧入口的两个引用 `assets/index-CddbQIqQ.js`、`assets/index-DLg1Y9tN.css` 现在都是 200
（旧客户端可用）；当前入口的 `assets/index-Dbnd-DW-.js`、`assets/index-Bgkt4A1i.css` 也是 200；
不存在的文件名仍明确 404；`nginx -t` 通过；本机 8088 与公网入口 kg.zheromiku.top 一致；make verify 15/15。

2026-10-14 10:58:01 +08:00

..

accept_catalog_controls.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_catalog_route_canary.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_document_workbench_v2.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_document_workbench.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_live_catalog_refresh.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_monitor_simulation.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_refresh_failure_message.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_release_planner.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_source_catalog.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_source_links.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

accept_system_settings.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

artifact_fetch_blank_doc_test.py

fix(fetch): 钉钉空文档显式报 empty_document

2026-09-30 10:54:07 +08:00

artifact_fetch_test.py

fix(artifact): 类型误标回退 + 服务端阻断判可重试 + 空白单元格重读

2026-10-09 12:15:22 +08:00

artifact_fetch.py

fix(artifact): 类型误标回退 + 服务端阻断判可重试 + 空白单元格重读

2026-10-09 12:15:22 +08:00

axls_to_xlsx.py

fix(artifact): 类型误标回退 + 服务端阻断判可重试 + 空白单元格重读

2026-10-09 12:15:22 +08:00

backup_layout.sh

feat(backup): 备份目录契约 + 导入前留档覆盖 ES 层

2026-10-09 12:19:15 +08:00

check_changelog.py

feat(version): 变更记录改固定四类，破坏性变化带发布文档链接

2026-10-13 14:59:35 +08:00

check_deps_vuln.py

feat(ci): 唯一权威门禁 make verify（14 项必需检查，汇总不认"未运行"）

2026-10-12 00:10:51 +08:00

check_format.py

feat(ci): 唯一权威门禁 make verify（14 项必需检查，汇总不认"未运行"）

2026-10-12 00:10:51 +08:00

check_secrets.py

feat(ci): 唯一权威门禁 make verify（14 项必需检查，汇总不认"未运行"）

2026-10-12 00:10:51 +08:00

ci_chain_fixture.py

fix(ci): 第一步改最小 bootstrap（空工作区可启动），新分支范围以默认分支为基准

2026-10-12 16:45:10 +08:00

ci_checks.py

feat(version): 开发号随提交自动递增 + 首个正式版本 0.1.0

2026-10-13 16:45:56 +08:00

ci_negative_fixtures.sh

feat(release): 抬档门禁（破坏性 ⇒ 0.x 抬次 / ≥1.0.0 抬主）+ 1.0.0 前置（稳定契约承诺）

2026-10-13 17:13:44 +08:00

ci_preview_negative_test.py

test(ci): 反向夹具扩到 54 条，含预览发布与合并调用链负例

2026-10-12 11:15:18 +08:00

deploy-api-web.sh

fix(web): 旧 index.html 的哈希资源回退到「上一版构建」，页面不再空白/裸奔

2026-10-14 10:58:01 +08:00

dws_error_map.py

fix(artifact): 类型误标回退 + 服务端阻断判可重试 + 空白单元格重读

2026-10-09 12:15:22 +08:00

ensure_local_routing_kbs.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

es_kb_export.py

feat(backup): 备份目录契约 + 导入前留档覆盖 ES 层

2026-10-09 12:19:15 +08:00

import_display_metadata.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

install_backup_schedule.sh

feat(backup): 系统设置里的存储与备份——定时时间与储存天数可配、下发到目标主机 cron

2026-10-09 13:50:23 +08:00

live_catalog_refresh.py

fix(settings): add DingTalk spaces and render the real login QR

2026-09-30 10:54:07 +08:00

logical-backup.sh

feat(backup): 系统设置里的存储与备份——定时时间与储存天数可配、下发到目标主机 cron

2026-10-09 13:50:23 +08:00

oss_bucket_settings.py

feat(release): 发布前快照硬门禁 + 云内快照 + ES/OSS 保护

2026-10-09 10:59:55 +08:00

release_preflight.py

feat(release): 抬档门禁（破坏性 ⇒ 0.x 抬次 / ≥1.0.0 抬主）+ 1.0.0 前置（稳定契约承诺）

2026-10-13 17:13:44 +08:00

restore_drill.py

test(backup): 留档回填演练脚本 + 实测通过

2026-10-09 13:07:41 +08:00

source_catalog_import.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

stage_pp_routing_canary.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

target_kb_snapshot.sh

test(backup): 留档回填演练脚本 + 实测通过

2026-10-09 13:07:41 +08:00

test_dws_error_map.py

fix(artifact): 类型误标回退 + 服务端阻断判可重试 + 空白单元格重读

2026-10-09 12:15:22 +08:00

test_import_display_metadata.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

test_live_catalog_refresh_progress.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

test_source_catalog_import.py

feat: 知识治理平台(含已验证发布/回滚契约)

2026-09-30 10:54:06 +08:00

test-scope.json

feat(version-history): 「版本记录」页 —— 追踪远端 main 全部提交（只读 + 管理员手动同步）

2026-10-13 19:40:19 +08:00

version.py

feat(version): 开发号随提交自动递增 + 首个正式版本 0.1.0

2026-10-13 16:45:56 +08:00

wiki_cleanup_backup.sh

chore(deploy): 部署与备份脚本、示例配置与忽略规则

2026-09-30 10:54:07 +08:00

wiki_e2e_newkb.sh

feat(release): 文档发布会带上知识库 wiki 快照并支持撤权剥离

2026-09-30 10:54:07 +08:00

wiki_e2e_test5.sh

feat(release): 文档发布会带上知识库 wiki 快照并支持撤权剥离

2026-09-30 10:54:07 +08:00