Nexus/docs/release/20260708/Nexus-release-text-integrity-gate-20260708.md

Nexus 发布文本完整性 Gate 增量记录（2026-07-08）

背景

本轮在发布文档中发现隐藏控制字符 0x08，会把 Markdown 代码块显示成异常的 bash fence。该问题容易由 Windows PowerShell/终端编码或临时脚本拼接引入，肉眼不容易发现。

已修复

1. 新增源码检查脚本：
   • scripts/check_text_integrity.py
2. 接入本地发布 Gate：
   • scripts/run_local_release_gate.py
3. 清理文档隐藏字符：
   • outputs/*.md 中的 0x08 已清除。
   • docs/research/jumpserver-easynode-architecture-analysis.md 中真实 ANSI ESC 已替换为可读的 \u001b。
4. 重新生成发布包：
   • nexus-release-20260708.tar.gz
   • SHA256: 46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b
   • entries: 2407

Gate 覆盖

check_text_integrity.py 会检查：

• UTF-8 解码异常；
• 隐藏控制字符，允许 \n、\r、\t；
• 典型坏 fence：真实 backspace 混入 bash 代码块；
• 自动跳过旧后台构建产物和 vendor 目录，避免误报 xterm/Monaco 的合法控制码表。

验证结果

• 文本完整性检查：OK: scanned 1751 text file(s)
• /app-v2 build:safe：通过
• app-v2 sensitive scan：通过
• 宝塔专项 pytest：60 passed
• 发布包扫描：通过
• 发布包 validate-only：通过
• metadata / .sha256 / 实际 tar SHA：一致

当前最新发布包

C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\outputs\nexus-release-20260708.tar.gz

46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b  nexus-release-20260708.tar.gz

线上状态

截至本记录生成时，线上 https://api.synaglobal.vip 尚未由 Codex 完成发布验证；原因仍是本机 Codex 审批代理 codex-auto-review 不可用导致联网/SSH 操作被拒绝。