Document current machine behavior and resource namespaces

[Tu-shen2025]

Align the audited machine pages with current Netherite Block parameters and Supercomputer resource identifiers.

Constraint: Scope is limited to PR3 audit items and preserves existing file formatting.

Rejected: Unrelated audit findings and cleanup | They belong to separate PRs or are outside this release.

Confidence: high

Scope-risk: narrow

Directive: Keep machine documentation synchronized with generated resources and current code paths.

Tested: doc_audit, targeted machine/resource searches, and git diff --check.

Not-tested: No game runtime test; this is a docs-only change.

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && python3 -c "
import gzip, struct
for name in ['nb','sc']:
    raw = open(f'/tmp/{name}.nbt','rb').read()
    try:
        data = gzip.decompress(raw)
        print(name, 'gzip ok', len(data...

Reason: script execution via -e/-c flag

Reply /approve to execute, /approve session to approve this pattern for the session, /approve always to approve permanently, or /deny to cancel.

[Gugle2308]

验证完成。所有关键事实已核对：icon 修复正确（目标分支注册于 anvilcraft 命名空间）、结构文件存在于目标分支、PulseGenerator 枚举 RISING_EDGE/FALLING_EDGE/LOOP 与文档措辞一致、103 页英文翻译正确且无中文残留。以下是审查意见：

代码审查摘要 — PR #4564

操作: opened
范围: 5 个文件（0 Java，0 新增，0 删除）/ 79 行 diff
性质: 纯文档变更（ageratum 指南 .md），无代码逻辑

✅ 变更内容核对

文件	变更	验证结果
en_us/003_power/103_power_convert.md	表格头中文→英文翻译	✅ 与 zh_cn 页面表格内容一致；无中文残留
en_us/009_machine/201_netherite_block.md	脉宽参数 2gt→1gt、5"90→8"90	✅ 与 zh_cn 页面同步修改，双语一致
zh_cn/009_machine/201_netherite_block.md	同上	✅ 与 en_us 同步
en_us/009_machine/320_supercomputer.md	icon 命名空间 minecraft:→anvilcraft: + 中文模式名→英文	✅ icon 修复正确
zh_cn/009_machine/320_supercomputer.md	icon 命名空间修复	✅ 同上

✅ 关键正确性验证

1. icon 命名空间修复正确：anvilcraft:spacetime_supercomputer 在目标分支 dev/1.21/1.6 的 ModBlocks.java:1916 已注册（.block("spacetime_supercomputer", ...)），原 minecraft:spacetime_supercomputer 是无效 ID。参考页面 004_block/330_spacetime_supercomputer.md 同样使用 anvilcraft:spacetime_supercomputer，一致性 ✅
2. 结构文件存在性：201_netherite_block.md 引用的 structures/machine/netherite_block.nbt 在目标分支 git ls-tree 确认存在；supercomputer.nbt 同样存在 ✅
3. PulseGenerator 模式措辞：Rising Edge/Loop Mode 与游戏内实际枚举 Mode.RISING_EDGE/FALLING_EDGE/LOOP（PulseGeneratorBlockEntity.java:310）和 ScreenLang.java:48-50 的英文 UI 文案一致 ✅
4. 双语同步：en_us 与 zh_cn 的 201 页修改完全对称（1gt、8"90），无遗漏 ✅

🔴 关键问题

无

⚠️ 警告

• en_us/009_machine/201_netherite_block.md:29（与 zh_cn 对应行） — 该行 (Rising Edge Mode | 5"90 | 0gt) 中 5"90 与整页格式 Ngt 不一致，疑似 5gt 90 或 5t 90 的笔误。PR 将其改为 8"90，但格式异常本身仍保留（目标分支同样如此，非本 PR 引入，但既然在审计该页不妨顺手确认或修正）。同类模式 22gt | 30gt 正常，仅此一行带引号。
• en_us/009_machine/320_supercomputer.md:13-15 — 原 (循环模式| ...)、(上升沿触发| ...) 中文模式名已译为 Loop Mode/Rising Mode，与 en_us/201 页的 Rising Edge Mode 措辞不完全一致（Rising Mode vs Rising Edge Mode）。非阻塞，但建议统一为同一术语（如都采用 Rising Edge Mode 或游戏内 UI 的 Mode: Rising Mode）。

💡 建议

• 参数修改（1gt、8"90）与文档渲染无关，属于机器行为配置，建议在 PR 描述或 commit message 中注明参数来源（哪个 PR/commit 调整了实际机器逻辑），便于日后审计——当前 PR 描述仅声称"Align with current parameters"但未给出依据链接。

🟢 看起来不错

• icon 命名空间修复是真正的 bug 修复（原 minecraft:spacetime_supercomputer 无效，会导致导航栏 icon 渲染失败）
• 翻译严格遵循游戏内实际 UI 文案，术语准确
• 范围克制：仅 PR3 审计项，未夹带无关清理，符合"Scope is limited"声明

📋 声称验证表

声称	状态	对应文件
对齐 Netherite Block 当前参数（1gt、8"90）	✅	201_netherite_block.md (en/zh)
修复 Supercomputer 资源命名空间	✅	320_supercomputer.md (en/zh)
保持现有文件格式	✅	仅改表格头/参数/icon，无格式变动
无无关审计项夹带	✅	5 文件全部在 PR3 范围内

结论: APPROVE — 纯文档 PR，双语同步、命名空间修复正确、范围克制。仅两个非阻塞小问题（5"90 格式笔误残留、Rising Mode/Rising Edge Mode 术语统一）。

🧪 测试建议

纯文档 PR，无需运行时测试。建议人工打开 ageratum 渲染的 320 页确认导航 icon 正常显示（anvilcraft:spacetime_supercomputer 指向实际方块图标），以及 103 页表格渲染未因列头换行而错位。

---

由 Hermes Agent 审查

[Gugle2308]

💾 Self-improvement review: Patched references/audit-link-refresh-review.md in skill 'documentation-pr-review' (1 replacement). · Patched SKILL.md in skill 'documentation-pr-review' (1 replacement).