Files
ssw-jnpf-lite-rust/src
adminandClaude Code 4611d75c39 fix(final): 复核后 4 处收尾 + 已知限制正本化到 docs/
影响
- 停机路径的输出从「一律说已优雅关闭」改为「按实际是否校验过来说」:临时库模式
  (PGLITE_DIR=memory://)下数据目录不可知 ⇒ 如实报「未校验」,不再给没校验过的断言。
- IPv6 绑定时启动横幅是合法 URL(http://[::1]:30010),此前是非法的 http://::1:30010。
- run.sh stop 给后端 3 秒宽限(与后端自己给嵌入式 PostgreSQL 的 3 秒预算对齐),
  此前 1 秒就 SIGKILL,正好把「PG 被 SIGKILL 打断 ⇒ 下次 crash recovery」又打回来;
  进程提前退出就立刻收工(0.2s 一跳轮询),stop 总耗时从 4.4s 回到 0.8s。
- 模块文档与实际改写层对齐(该层现在同管 405 与 413)。
- 已知限制清单从 git-ignored 的 SDD 过程草稿提升为受版本控制的 docs/known-limitations.md,
  HANDOFF 的指向同步改到它 ⇒ 草稿清理后引用不悬空。

改动
- run.sh:stop_pid 增加宽限参数(后端 3s / 前端 1s),宽限改为轮询存活、提前退出即收工。
- src/backend/src/main.rs:横幅按 IPv4/IPv6 分别拼 URL;停机结论区分「已校验且已关库」
  /「已校验但没关掉」/「临时库模式未校验」三种;模块文档补 413。
- docs/known-limitations.md(新增):分支级已知限制清单正本,含本轮新记的 (aa)(ab)。
- HANDOFF.md:已知限制摘要的编号与全局清单对齐,指向 docs/known-limitations.md。

设计
- 「第二次停机信号不再强杀」与「用 process::exit(0) 收尾」两条不修:前者收尾有界(≤3 秒),
  动刚写好的信号路径收益仅是省几秒;后者是刻意设计(pglite 收尾线程可能卡死,
  不能让它吊住进程),且与改动前行为一致。两条已记入 known-limitations (aa)(ab)。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 05:47:44 +08:00
..