DEVTOOLBOX / CHANGELOG
变更记录
只记录可核对的变更：新增了什么、修正了哪条说明、依据是什么。
-
三张可打印速查卡，PDF 由构建期生成
ASCII、HTTP 状态码、Unix 权限位是三类最常被手工抄错且最容易查错的表。现在每张卡都有页面给出完整表格，并有一个由构建期直接从同一份数据排版生成的 PDF，所以打印件与网页版不会脱节。ASCII 卡收录全部 128 个码点（十进制、十六进制、类别、UTF-8 字节数）；状态码卡列出 62 个已登记状态码并附上决定修法的那个细节；权限卡把每个八进制位与它打印出的 rwx 三元组一一对应。
-
新增三篇指南补齐最后缺口：88/88 工具页都有指南可读
网络排查（地址、名字、端口、注册）、生成器（熵源、UUID 版本、口令规则、二维码纠错等级）、发布产物（SemVer 区间、权限位、校验和、压缩、可复现打包）三篇把指南总数推到九篇。JWT 解码器并入哈希指南后，88 个工具页全部带上了延伸阅读链接（此前是 70 个）。新篇与既有篇同一标准：七节、至少三张表、每节给判据、显式列出不可逆点。
-
修正指南里的六处事实错误，并加了重算常量的脚本
复核六篇指南的全部参考表格，发现并修正六处：累计时长那一行把 30 天后的本地时间写成 00:00，实际从 2026-03-08T00:00（纽约）加 30 天落在 01:00；日历运算示例用的是 3 月 10 日和 11 日，这两天并不跨春季跳变，所以「23 小时」是错的；英文大小写表称词尾 Σ 默认转小写得到 ς，实际默认映射得到 σ，ς 需要词尾规则；72 dpi 的 A4 像素写成 596，实际是 595；94^9 的熵写成 58.8 位，公式算得 59.0 位；另有两处熵值用了截断而非四舍五入。现在每条可计算断言都由 scripts/verify-guide-facts.mjs 重算，写错常量会直接让校验失败，而不是发出去。
-
新增四篇决策指南：哈希与加密、PDF 流程、时间、文本处理
哈希指南先区分哈希、HMAC、KDF 与加密四种原语，再谈算法名，并说明为什么快速哈希是口令存储的错误原语。PDF 指南从「文本型还是扫描型」这个分岔开始，因为后面每一步都取决于它。时间指南把「瞬间、偏移、时区、墙上时间」拆开，包括 23 或 25 小时的那一天。文本指南覆盖依赖语言的大小写映射、Unicode 归一化，以及「忽略大小写」究竟掩盖了什么。现有六篇指南，每篇 7 节、至少 3 张表、5 条 FAQ。
-
发布首批两篇决策指南
JSON 指南覆盖校验、格式化、结构查询、大文件与有损转换；编码指南覆盖字符集/编码/传输编码三层区分、UTF-8 字节边界、Base64 家族选型与乱码定位。每节都落到具体工具。
-
全部工具页补齐「只有该工具才成立」的深度内容
88 个工具全部补齐双语机制说明、可复现的实操示例（输出为真实计算结果）与取自实现的上限清单。英文页正文中位数从 230 词提升到 900 词以上，并在构建期加了「低于 600 词即失败」的闸门。
-
页面结构差异化：选型对比表、故障排查树、速查表
此前 88 个页面共用一套骨架。现在每个工具按性质追加 1–2 个带判断力的区块——选型对比、症状/原因/处理、可计算场景或速查表，全站共有 20 种页面骨架。
-
新增编辑方针页，关于页写明谁在负责
编辑方针写明内容范围、事实来源优先级（实现 → 规范 → 观察到的平台行为）、必须更新的触发条件，以及自动化与语言模型的使用边界。关于页说明谁在维护、内容如何复核、收入与编辑决策的关系。
-
四处说明与实现不符，已逐条修正
Base32 的示例值已过期，解码得到乱码；时间戳 FAQ 称「自动识别单位」，实际是显式开关；日期计算器被描述为有「包含模式」和节假日排除列表，实现中都没有；JSON 转 XML 被描述为「非法键替换为占位名」，实际按原样写出。四处均已改为真实行为。
-
移除伪造的评分结构化数据，广告按正文篇幅门控
此前每个工具页都输出一条「5 分、1 条评价」的 aggregateRating，却没有任何真实评价来源。该标记已全部移除，改为输出 author、dateModified 与可访问性信息；广告位仅在正文达到篇幅阈值时渲染。
-
内容质量改由测试守护，而不是靠自觉
单测现在断言：每个工具都有双语深度内容、没有任何句子被三个以上工具复用、页面骨架必须存在多种。构建校验在正文低于篇幅下限、缺少深度区块或重新出现伪造评分标记时失败。
-
llms.txt 改为构建期从注册表生成
面向 AI 的索引此前是手工维护的文件，会与工具注册表脱节。现在改为从单一真源推导每个工具 URL、分类行与数量的端点，并在校验中确认没有工具缺失。
-
为五个高频工具加上真实浏览器测试
Playwright 用例跑在构建产物而非 dev server 上：JSON 格式化、含中文的 Base64 往返、用公开向量校验 MD5/SHA-256、合并 PDF 并重新读取下载文件、把生成的 PNG 压成 WebP。交互前显式等待水合完成，避免抖动。