Skip to content

docs: 对齐 v0.5.2 文档并补齐子视图修复 - #529

Merged
Luo-root merged 5 commits into
release/v0.5.2-shared-comments-20261030from
release/v0.5.2-docs-topology-20261030
Oct 30, 2026
Merged

Luo-root merged 5 commits into
release/v0.5.2-shared-comments-20261030from
release/v0.5.2-docs-topology-20261030

Conversation

@Luo-root

@Luo-root Luo-root commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

关联 Issue

见 #521。补齐原 #524 的 Topology 修复并完成 v0.5.2 文档对齐;依赖 #528、#527。

改了什么

原 #524 合入 chore/chinese-comments-20261029 后未传播到 main。本 PR 在 #528 上合入该固定修复,保留祖先漏绑下仍可见子视图的环/流诊断,以及真实根的 skip、切面、绑定和额度池上下文。运行实现与上一轮全仓体检通过的候选完全相同。

文档另作以下对齐:

  • 首页、双语页脚、指南、包总览、observe/yaml 的生成源 README、设计资料及安装命令统一使用 v0.5.2。
  • 双语迁移页说明:v0.5.2 是兼容 patch,从 v0.5.1 升级无需修改签名;更早对象模型/语法糖章节继续保留,不能误认为本次 patch 新增。
  • 生命周期页补充冻结验证共享声明和逐轮检查边界,以及漏绑祖先下子视图诊断的修复行为。
  • 生产对比页保持单页入口,标明历史测量不等于 v0.5.2 重测;原版本、数字、COMPLETED_WITH_ERRORS 和超时不动。
  • 说明工具 resume 的完整性检查、旧中断报告兼容边界、实际并发校验和超时 stdout 保留。

新增

仅在既有双语页面补充本次升级说明,没有新增页面、公开 API、依赖或性能/持久化能力声明。

影响范围

相对 #528:53 文件、407+/89−,共 496 changed lines;其中原 Topology 补丁 4 文件293+/7−,版本文档49文件114+/82−。两个独立基准模块仍保留其固定测量依赖,不重标历史。

测试

Go 1.26.10、Windows amd64,GOWORK=off GOTOOLCHAIN=local;Node v22.16.0、npm 11.4.1。

精确隔离候选 6cc0d2a960a3cc3db2406e64e7b05c58e8ebf890,tree b7419dec4f7769a0e4c0d09437c8494904422cdd:

  • go build -mod=readonly ./... 通过。
  • go vet -mod=readonly ./... 通过。
  • go test -mod=readonly -race -count=1 -timeout=240s ./... 四包通过:root 68.494s、observe 4.192s、tests 3.379s、yaml 2.279s。
  • 文档签名门禁及负控通过,3.164s。
  • site/ 下 npm.cmd run build 通过,25.86s;生成4页,只有普通chunk大小提示。复用相同锁文件的本地依赖,未改 package-lock.json。
  • 283 个已跟踪输入在完整检查前后哈希不变,git diff --check 通过。
  • 新文档之前的合并 tree 精确等于上一轮全仓体检通过的 07d627833f9b6f28d4cb045ce5ce341bcf252d8b;没有新运行实现。
  • 当前文档独立复审 PASS,P0–P3 与待拍板均为0;273处签名门禁、4个完整生成包页逐字节对照、49个HTML版本和2191个本地资源/页面目标核验通过。
  • 本次远端 CI 全绿:test、benchmark-correctness、Ubuntu/Windows production-correctness,run 40997225265;site build通过,run 40997225200;PR deploy按设计跳过。

审查关注点

保证这条堆叠链最终整体进入 main。安全合入顺序为先本 PR 进入 #528 分支,再 #528 进入 #527 分支,最后 #527 进入 main;不能先结束 main 的父 PR 后就认为后代内容也已发布。最终 main 要与精确候选比较文件树。

当前文档统一版本,但保留历史测量身份、旧版本升级起点和未测边界;不能将已有 API 改写为 patch 破坏性新增。

自审

  • 已读完整差异并核对双语对应。
  • 无凭据、数据库、探针或二进制入库。
  • 使用既有页面收口,历史测量与依赖不改。
  • 说明性注释维持中文,协议与示例输出原样。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant