Skip to content

fix: 统一中文协作并加固基准证据工具 - #525

Merged
Luo-root merged 1 commit into
mainfrom
chore/chinese-tooling-20261029
Oct 30, 2026
Merged

Luo-root merged 1 commit into
mainfrom
chore/chinese-tooling-20261029

Conversation

@Luo-root

Copy link
Copy Markdown
Owner

关联 Issue

见 #521。此 PR 交付工具/模板的中文统一及全仓体检发现的工具修复;全仓审查还依赖 Core 子视图和 DAG 依赖修复,不自动关闭议题。

改了什么

  • 将脚本注释、Python 说明字符串、SQLite 适配器注释、CSS/同步脚本注释和忽略规则说明统一为中文;Issue 表单、PR 模板及贡献约定要求中文标题与正文,gh --body-file 提交也沿用模板。
  • 生产采样恢复在任何写入前核验已确认 raw 前缀摘要、记录数、状态与错误统计。追加时仅散列新增字节;允许 raw 已 flush 一条而 manifest 尚未更新的中断窗口,损坏历史一律零写入拒绝。
  • 校验并保留 CLI 实际 config.parallelism,汇总交叉核验记录、CLI 与 manifest。兼容未记录 config 的历史报告,不补造 Go Config 不存在的 gomaxprocs。
  • 生产采样和恢复命令在建目录、读取二进制或启动进程前拒绝无效 repeats、空矩阵和非法数值。
  • recovery stdout 直接写原命名证据文件,超时也保留输出;异常回收进程树,清理错误不覆盖原异常。
  • 新 manifest 保存规范矩阵,恢复/历史汇总兼容等价表示并拒绝规范化后重复值;带空格参数完成采样后可正常汇总。
  • CI 的采样测试与汇总测试使用两个独立 steps,Ubuntu/Windows 分别传播各套测试的失败。

新增

新增完整性、实际并发、早拒绝、超时证据和进程清理回归,以及真实短进程的“采样→汇总→等价恢复”回归。CI 增加 test_production_summary.py。没有新增 Core API、公开包或 Go 根模块依赖。

影响范围

Python description=__doc__ 对应的 CLI 帮助文字改为中文。机器指令、版权/许可证原文、协议常量、错误字符串、运行输出与 Go 示例期望输出保持原样;英文 README 和站点正文继续保留双语分工。

非空旧中断报告若没有可核验摘要,恢复会保守拒绝;旧完整报告仍可用最终 hash 核验,原有 sampler_sha256 同版本限制保持。历史报告不回写、不补造身份,不修改历史性能数字。此次 CI 新增测试是有意行为变更,不能将整个 PR 称为纯注释改动。

测试

Python 3.13.2/Go 1.26.10/Windows amd64。所有临时探针和证据保留在仓库外。

  • python -B benchmarks/tools/test_production_tools.py、test_production_summary.py、test_tools.py 三套完整测试在最终集成副本共 49 项通过,0 失败、0 错误、0 跳过,10.979s。
  • 首轮 8 项新增回归在旧执行代码上产生 65 个失败断言、0 执行错误;原四项缺陷修复后通过独立边界探针。
  • 本轮矩阵负控复现“采样 0 退出但汇总/等价恢复拒绝”;修复后真实短进程往返、历史格式和重复值检查通过。
  • PowerShell 负控:同一步 37 → 0 最终返回 0;拆步后采样步骤返回 37、汇总步骤独立返回 29。两平台共用两个独立 steps。
  • 完整/中断 raw 损坏、UTF-8 字节边界、多一条已 flush 记录、历史错误保留、实际并发类型和数值检查、真实超时 stdout 与父子进程回收通过。
  • 第二轮独立复审 PASS,P0–P3 与待拍板均为 0:49 项完整测试、9 项旧探针、6 项规范化/CI 补测全部通过。34 组历史表示可恢复,96 组非法矩阵、33 组非法记录身份及 14 组身份/完整性破坏均被零写入拒绝。
  • 512 条 raw 记录取证:新增散列总量等于 raw 字节总数,未逐条重读整个 raw。
  • 5 个纯翻译 Python 文件的执行 AST 与旧版一致;另 5 文件对修复前中文快照核对,保留中文注释/说明字符串并单列行为修复。
  • .gitignore、CSS、同步脚本的非注释内容一致;Go 注释机器指令与示例输出保留;LF 和 git diff --check 通过。
  • 最终候选根模块及两个独立基准模块 build、vet、完整 race 通过;根包标准库依赖闭包保持;155 个 Go 文件 gofmt 输出为空;文档签名门禁及负控通过。
  • 最终候选 site/ 的 npm.cmd run build 通过,只有大于 500kB chunk 的普通提示;构建未改已跟踪源文件。

审查关注点

恢复必须先核验后写入,不能重写损坏历史或洗掉旧错误;规范化不放宽其他运行身份;错误与缺测值不能变成成功或零;Windows 与 Ubuntu 两套 CI 测试各自阻断。

自审

  • 已阅读完整 diff、调用方和所有行为变化。
  • 22 文件、726+/209−,共 935 changed lines;无凭据、raw 证据、数据库或二进制入库。
  • 已明确 CLI 帮助语言和恢复兼容边界,未宣称执行代码全部不变。
  • 新增说明性注释使用中文;机器指令、协议和示例输出断言保持原样。

@Luo-root
Luo-root merged commit 8d36722 into main Oct 30, 2026
6 checks passed
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