Skip to content

Update the guide book: new logistics and armor pages 更新手册:新增物流元件与盔甲页面,修订流程/机器页 - #4945

Merged
PigeonNian merged 8 commits into
dev/1.21/1.6from
pig/1.21/1.6
Sep 19, 2026
Merged

PigeonNian merged 8 commits into
dev/1.21/1.6from
pig/1.21/1.6

Conversation

@TBPig

@TBPig TBPig commented Sep 19, 2026

Copy link
Copy Markdown
Contributor

No description provided.

- 同步中英文手册中的物品、配方、结构和机制说明
- 补充物流元件、红石元件、仓储端口及工具操作内容
- 将溜槽文档重命名为物流元件并更新相关链接
- 新增物品分配器结构预览资源
# Conflicts:
#	src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/201_tesla_tower.md
- 重构功能性盔甲页面并合并飘升机背包说明
- 新增耐候盔甲页面与多相物质相关链接
- 补充结构扫描仪导入导出流程及界面图示
- 调整建筑杖页面分类与使用说明
- 补充翻转布局、经验收集器和配方等双语内容
- 同步主线流程的物品展示、章节层级与说明文字
- 更新珠宝匠交易表、机器参数和结构引用
- 补充板条箱、结构扫描仪、建筑杖等英文文档
- 完善英文首页介绍及手册使用指引
Copilot AI lite review requested due to automatic review settings September 19, 2026 10:34

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Unresolved documentation accuracy, completeness, and navigation issues remain.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 7 Low severity

Open (7)
What changed in this PR

Refreshes the bilingual Ageratum manual with reorganized progression guidance, new documentation, and updated recipes and mechanics.

Changes:

  • Updates progression chapters and guide navigation.
  • Adds documentation for tools, armor, machines, storage, logistics, and redstone.
  • Revises recipes, timings, behavior instructions, and superseded references.
File Reviewed change / note
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​index.md Updates introduction and guide usage.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​009_machine/​201_netherite_block.md Adjusts pulse timing.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​009_machine/​201_gem.md Adds pulse-generator settings.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​009_machine/​001_iron.md Numbers setup instructions.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​007_struct/​000_anvil_processing.md Updates solid-liquid processing details.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​006_prop/​101_ionocraft_backpack.md Removes the superseded page.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​006_prop/​101_building_rod.md Adds Building Rod documentation. nit (1 vote): wording overstates passive inventory and entity-reach effects.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​005_tool/​301_weatherproof_armor.md Adds Weatherproof Armor documentation. nit (3 votes): uses the wrong navigation icon; nit (1 vote): missing tools category.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​005_tool/​301_resonator.md Documents radial-menu cycling.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​005_tool/​301_multitool.md Documents radial-menu cycling.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​005_tool/​301_heavy_halberd.md Documents radial-menu cycling.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​005_tool/​101_functional_armor.md Adds Functional Armor documentation. nit (1 vote each): missing tools category, omitted Ionocraft deployment instruction, and incorrect 4× jump value instead of 3.5×.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​215_large_crate.md Adds fluid storage and consolidation. nit (3 votes): duplicated ; nit (1 vote): missing storage_port_consolidator recipe tag.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​201_tesla_tower.md Updates Tesla Tower behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​201_exp_collector.md Adds an alternate recipe.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​101_structure_scanner_alternative.md Expands scanner instructions. nit (1 vote): correct the client-folder location and permission wording.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​100_heater.md Revises fueling behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​003_crate.md Adds storage-station features.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​001_redstone.md Adds redstone component details.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​001_logistics.md Adds consolidated logistics documentation. nit (2 votes): add the two new item IDs to frontmatter.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​001_chute.md Removes the superseded page.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​003_power/​201_heat_collection.md Adds day/night generation information.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​003_power/​102_power_charge.md Adds the magnet-block charging recipe.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​002_material/​312_transcendium.md Clarifies Heavy Halberd behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​002_material/​140_void_matter.md Clarifies disposal behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​002_material/​101_capacitor.md Adds a salvage recipe.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​002_material/​000_gems.md Documents dispenser activation.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​001_feature/​101_heated_block.md Adds super-heating information.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​001_feature/​001_jeweler.md Updates workstation references and formatting.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​015.md Reorganizes endgame progression. nit (1 vote): two late-game sections remain empty and lack process guidance.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​014.md Adds transcendium progression details and item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​013.md Adds material item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​012.md Adds synthesis item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​011.md Reorganizes industrial progression.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​010.md Adds material and quest displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​009.md Reorganizes resource progression.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​008.md Adds large-block displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​007.md Adds beacon-related displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​006.md Adds Royal Steel displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​005.md Expands electrical progression.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​004.md Adds early-game item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​003.md Updates workstation instructions.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​002.md Adds Topaz and iron-farm guidance.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​000_process/​001.md Adds starting item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​structures/​anvil_workstation.snbt Removes the superseded structure.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​index.md Updates introduction and guide usage.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​009_machine/​201_netherite_block.md Adjusts pulse timing.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​009_machine/​201_gem.md Adds pulse-generator settings.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​009_machine/​001_iron.md Numbers setup instructions.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​007_struct/​000_anvil_processing.md Updates solid-liquid processing details.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​006_prop/​101_ionocraft_backpack.md Removes the superseded page.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​006_prop/​101_building_rod.md Adds Building Rod documentation. nit (1 vote): wording overstates passive inventory and entity-reach effects.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​005_tool/​301_weatherproof_armor.md Adds Weatherproof Armor documentation. nit (3 votes): uses the wrong navigation icon; nit (1 vote): missing tools category.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​005_tool/​301_resonator.md Documents radial-menu cycling.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​005_tool/​301_multitool.md Documents radial-menu cycling.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​005_tool/​301_heavy_halberd.md Documents radial-menu cycling.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​005_tool/​101_functional_armor.md Adds Functional Armor documentation. nit (1 vote each): missing tools category, omitted Ionocraft deployment instruction, and incorrect 4× jump value instead of 3.5×.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​215_large_crate.md Adds fluid storage and consolidation. nit (1 vote): add the missing storage_port_consolidator recipe tag.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​201_tesla_tower.md Updates Tesla Tower behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​201_exp_collector.md Adds an alternate recipe.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​101_structure_scanner_alternative.md Expands scanner instructions. nit (1 vote): correct the client-folder location and permission wording.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​100_heater.md Revises fueling behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​003_crate.md Adds storage-station features.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​001_redstone.md Adds redstone component details.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​001_logistics.md Adds consolidated logistics documentation. nit (2 votes): add the two new item IDs to frontmatter.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​001_chute.md Removes the superseded page.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​003_power/​201_heat_collection.md Adds day/night generation information.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​003_power/​102_power_charge.md Adds the magnet-block charging recipe.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​002_material/​312_transcendium.md Clarifies Heavy Halberd behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​002_material/​140_void_matter.md Clarifies disposal behavior.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​002_material/​101_capacitor.md Adds a salvage recipe.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​002_material/​000_gems.md Documents dispenser activation.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​001_feature/​101_heated_block.md Adds super-heating information.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​001_feature/​001_jeweler.md Updates workstation references and formatting.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​015.md Reorganizes endgame progression. nit (3 votes): restores the omitted mass-energy inverter usage guidance.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​014.md Adds transcendium progression details and item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​013.md Adds material item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​012.md Adds synthesis item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​011.md Reorganizes industrial progression.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​010.md Adds material and quest displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​009.md Reorganizes resource progression.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​008.md Adds large-block displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​007.md Adds beacon-related displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​006.md Adds Royal Steel displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​005.md Expands electrical progression.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​004.md Adds early-game item displays.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​003.md Updates workstation and structure guidance. nit (3 votes): replaces em dashes with literal ? characters in two warning lines.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​002.md Adds Topaz and iron-farm guidance.
src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​001.md Adds starting item displays.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/main/resources/assets/anvilcraft/ageratum/en_us/000_process/003.md Outdated
Comment thread src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/215_large_crate.md Outdated
@Gugle2308

Copy link
Copy Markdown
Collaborator

已完成全部核查(导入手册目录、逐文件 en/zh 对账、把 base/head 两份真实源码树取下来交叉验证、以及解析结构 NBT + 逐条 recipe/item 引用校验)。以下是审查意见。


代码审查摘要 — PR #4945

操作: opened
范围: 98 个文件(0 Java;44 en_us + 44 zh_cn 手册页、3 新增 / 5 删除 .nbt 结构、2 新增 PNG)/ 3,629 行 diff
基线核对: head d6284032 (pig/1.21/1.6) vs base 68d5f625 (dev/1.21/1.6)

✅ 交叉验证结果(对 base 分支真实源码逐条核对,全部通过)

手册声称 源码依据 结论
飘升机耗 2 kW / 背包耗 8 kW IonocraftEntity.CONSUMPTION = 2IonocraftBackpackItem.FLIGHT_POWER = 8 ✅(旧文档 16/64 kW 是错的,本次修正正确)
建筑杖 8 MFE、每方块 100 FE、上限 4,000 MAX_ENERGY = CapacitorItem.ENERGY = 8_000_000consume(blocks*100)BuildingRodService.MAX_BLOCKS = 4000
随身携带即 +3 方块/实体交互距离 CrabClawItem.holdingCrabClawIncreasesRangeBuildingRodItem.isCarried 计入,EntityReachAttribute 同时给两个 range 属性加 +3
特斯拉塔 128 kW、4s、连锁 4 个、40/30/20/10 SWITCH ? 128 : 0STRIKE_COOLDOWN_TICKS = 4*20for (jump<4)40.0F - jump*10.0F
加热器 <500s 补燃料、240s 可工作、双击放一组 REFUEL_THRESHOLD = 500*20LIT_THRESHOLD = 240*20DOUBLE_CLICK_INTERVAL
分配器 16 组 / 16 格、流体端口 128 B、滞回 50~75% SLOT_COUNT=16/MAX_DISTANCE=16CAPACITY_MB = 128*1000ADJUST_FILL_START=0.5 / ADJUST_DRAIN_START=0.75
口袋 6 格、耐候护腿 12 格、耐候胸甲 160 MFE PocketInventory.getSize 返回 12/6、WeatherproofChestplateItem.MAX_ENERGY = 160_000_000
红石骰子=三骰之和−3、均匀/真实模式 getFace(0)+getFace(1)+getFace(2)-3UNIFORM_OUTCOMES[16] / 三个 nextInt(6)+1
物品探测器 All/Any 过滤、虚空物质块可直接吞入物品、宝石效果可被发射器触发 Mode.ALL/ANYCapabilitiesEventListenerVOID_MATTER_BLOCK 注册 VoidItemHandlerregisterBehavior(TOPAZ/RUBY/SAPPHIRE…)

引用完整性(脚本全量校验):23 个新增 <recipe id> 全部存在于 src/generated/resourcessuper_heating_warp_raw_copper_2_copper_ingotVanillaRecipesWrap 运行期生成,且非本 PR 新增);131 个 <ref/item/block id> 全部为已注册物品/方块;全手册相对链接与锚点与 base 对比无新增断链,被删的 001_chute.md / 101_ionocraft_backpack.md 已无残留引用。

结构 NBT 解析核对anvil_workstation.nbt 内含 big_red_button ✅ 与新文案「按住大按钮让铁砧下落」一致;p2_topaz.nbt = 冲压台 + 晶洞 ✅;item_splitter.nbt ✅;gem 机 pulse_generator StartMode=2(LOOP) / WaitingTime=16 / SignalDuration=6 ✅ 文案「16gt / 6gt」;ancient_debris.nbt 由 15 改 16 ✅ 文案同步。

⚠️ 警告

  1. en_us/000_process/003.md:22,27 — 破折号被损坏成半角 ?(文本乱码)

    • These are important concepts ? be sure to master all of them(原为
    • Use a fish_tank instead of a cauldron ? the former can serve as a container(原为
    • 字节级证据:删除行是 E2 80 94(—),新增行变成 3F 20? );同文件其他 (如 en 004.md 的 Minerals — Something from Nothing)未受影响,zh 侧同句也未受影响。疑似该文件经非 UTF-8 编辑器保存导致丢字。请恢复为
  2. is 结构文件 与文案冲突:anvil_workstation_2.nbt 的物品探测器并非「反向输出」

    • 文案(en_us/000_process/003.md:51zh_cn/000_process/003.md:51):设置探测距离为 2 格,输出模式为反向输出
    • 本 PR 同步更新的 structures/anvil_workstation_2.nbt:4 个 anvilcraft:item_detector 均为 Range: 2 ✅ 但 OutputInvert: 0(未反向)。ItemDetectorBlockEntity.saveAdditional 是无条件写该键的,且 outputInvert 为真时 output = 15 - output(与 001_redstone.md 的「反向输出」描述一致)。
    • 即:2 格对得上、反向输出对不上。请确认是补文案还是重新导出结构体,二者应取其一。

💡 建议

  1. weaponproof 页面 nav 图标疑似复制粘贴:新增的 en_us|zh_cn/005_tool/301_weatherproof_armor.md 均为 icon: "anvilcraft:ionocraft_backpack",与 101_functional_armor.md 完全相同,而该物品已归属功能性盔甲页的 items:。建议改为 anvilcraft:weatherproof_spacesuit_chestplate(或 weatherproof_core),否则侧栏两个页面同图标。

  2. 004_block/001_logistics.md(en+zh)的 items: 未收录本页新增的两个方块:页面文档化了 overflow_chuteitem_splitter,但 front-matter items: 只列了 chute/magnetic_chute;这两个方块在全手册其它任何页面的 items: 中均未出现。若 items: 用于建立「物品→页面」索引,它们将无法从物品索引进入。请确认是否有意为之。

  3. 4 个新增文件缺少文件尾换行en_us/005_tool/101_functional_armor.mden_us/005_tool/301_weatherproof_armor.mden_us/006_prop/101_building_rod.mdzh_cn/006_prop/101_building_rod.md(同页 zh 版 functional_armor / weatherproof_armor 却有换行,中英不对称)。其余 No newline 命中(201_tesla_tower 双语、zh_cn/003_crateen_us/201_exp_collector 等)经 base/head 对比为既有问题,未计入。

  4. zh_cn/004_block/100_heater.md:47 断链[物品加工:烹饪](../007_struct/anvil_processing.md#快速烹饪) 少了 000_ 前缀(en 侧为正确的 000_anvil_processing.md#fast-cooking)。base 已存在,但本 PR 正好改了这一文件,顺手修掉更好。

  5. zh 术语统一zh_cn/001_feature/101_heated_block.md 新增行用「超温加热配方」对应 en 的 Super-Heating Recipe,而全书中 Super-Heating 一贯译作「高温熔炼」(见 100_heater.md007_struct)。建议统一为「高温熔炼配方」。

🟢 看起来不错

  • 页面重组干净:001_chute.md → 001_logistics.md(扩充溢流溜槽、物品分配器)、101_ionocraft_backpack.md → 005_tool/101_functional_armor.md(新增呼吸头盔/口袋护腿/缓冲靴),旧页 nav items 全部在新页重新登记,无导航条目丢失;en/zh 文件集合 44/44 完全一致(本仓库无 en_ud,无需镜像)。
  • 数据修正有实据:飘升机/背包耗电 16/64 kW→2/8 kW、010.md 铁锭 3 组→2 组、ancient_debris 脉冲 15gt→16gt、超级加热/拆解/exp_collector_alt 等新配方条目全部真实存在。
  • 顺带修复了 en_us/004_block/101_structure_scanner_alternative.md 原有的缺失尾换行,表格重排后内容与 en 一致。

结论: COMMENT — 内容准确度很高、引用与结构体交叉验证基本全绿,合并前请修掉第 1、2 项(? 乱码 + 结构与文案的「反向输出」冲突),第 3~7 项建议顺手处理。

标题建议

现标题 Update the manual 更新手册 对 98 文件的手册改版偏笼统。建议:
Update the guide book: new logistics and armor pages 更新手册:新增物流元件与盔甲页面,修订流程/机器页
(本次 gh auth status 显示 token 已失效,未自动修改标题。)

@Gugle2308

Copy link
Copy Markdown
Collaborator

⚠️ Iteration budget exhausted (90/90) — asking model to summarise

@Gugle2308

Copy link
Copy Markdown
Collaborator

💾 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).

@Gugle2308

Copy link
Copy Markdown
Collaborator

代码审查摘要 — PR #4945

操作: review_requested(opened/synchronize 类,正常审查)
范围: 98 个文件(0 Java、88 markdown:en_us 44 + zh_cn 44、2 PNG、8 个 NBT 结构) / 3,629 行 diff
性质: 纯文档 PR(Ageratum 手册重写/新增/重组),无代码变更 —— 审查重点为内容准确性、跨语言对称性、引用完整性

🔴 关键

  • en_us/000_process/003.md(本 PR 新增行)出现 2 处 ? 乱码,疑似破折号/冒号在编辑中被吞
    • 第 20 行:These are important concepts ? be sure to master all of them
    • 第 22 行:Use a <ref item="anvilcraft:fish_tank"/> instead of a <ref item="minecraft:cauldron"/> ? the former can serve as a container
    • cat -A 核对 PR head 真实文件,确认落盘内容就是 ?(不是 diff 渲染问题),base 无这两行 → 本 PR 新引入。zh_cn 对应句为「,」「——」,语义正常。请改回 (或 :)。(同页 004.mdMinerals — Something from Nothing em dash 完好,说明不是全局编码问题,仅这两处。)

⚠️ 警告

  • zh_cn/004_block/100_heater.md 段内链接断链[物品加工:烹饪](../007_struct/anvil_processing.md#快速烹饪) → 实际文件名是 000_anvil_processing.md。en_us 侧写法正确(../007_struct/000_anvil_processing.md#fast-cooking),且全 ageratum 树中仅此一处用旧名。base 已存在此错误(非本 PR 引入),但本 PR 恰好改了该文件末行(EOF 换行),建议顺手修正。
  • 006_prop/101_ionocraft_backpack.md 删除 → 005_tool/101_functional_armor.md 迁移疑似丢 3 条说明:旧页 38 行中的
    1. Reentering the grid during this descent immediately resumes creative flight
    2. After landing, entering a grid grants flight ability without automatically taking off
    3. The backpack does not store energy and cannot be charged with capacitors
      在新页(49 行,覆盖 4 件装备)中未见对应中英文句子。请确认是有意删除还是迁移遗漏(第 3 条若仍成立,对玩家很关键)。
  • en_us/005_tool/301_weatherproof_armor.md 措辞准确性Combines ... with protection exceeding that of **netherite armor**。代码 EquipmentArmorItemArmorMaterials.NETHERITE(护甲值与下界合金相同)+ 自定义耐久 type.getDurability(74)(约下界合金 37 的 2 倍)。「防护超过下界合金」宜改为「耐久远超下界合金」以免误导。

💡 建议

  • EOF 换行符缺失(新增页面)en_us/005_tool/101_functional_armor.mden_us/005_tool/301_weatherproof_armor.mden_us/006_prop/101_building_rod.mden_us/004_block/201_tesla_tower.mdzh_cn/006_prop/101_building_rod.mdzh_cn/004_block/003_crate.md 均以 \ No newline at end of file 收尾(新增侧),建议统一补上。
  • index.md(en/zh 同步)列表层级被破坏:第 5 条「书中的结构可以…投影」下的三行原为 - 二级缩进,本次改为顶层 - ,并在第 5 条后插入了空行 → 渲染明细表会被拆出列表。中英两侧同错,可一并调整。
  • 003_power/201_heat_collection.md 中文表格只做了列宽对齐重排(+13/-10),信息无变化 —— 若为编辑器自动格式化,建议后续避免此类纯格式 diff,便于审阅。
  • 004_block/201_tesla_tower.md 末尾缺换行 + 结构重排:字段顺序(能耗/红石 → 功能)与 en/zh 一致,内容正确,仅格式项。

🟢 看起来不错(已逐条对源码验证)

  • 跨语言对称 100%:44 en_us / 44 zh_cn,各子目录(000_process…009_machine)文件数完全一致,无 en_ud 目录需要同步(本仓库 ageratum 无 en_ud)。
  • 数值全部与 dev/1.21/1.6 源码一致
    • 特斯拉塔「每 4 秒 / 半径 8 格 / 连锁 4 个 / 40·30·20·10」= STRIKE_COOLDOWN_TICKS=4*20expandTowards(8,8,8)jump<440.0F - jump*10.0F
    • 加热器「低于 500s 补一份燃料 / 240s 才够温度」= REFUEL_THRESHOLD=500*20LIT_THRESHOLD=240*20
    • 建筑杖「8 MFE / 4000 方块 / 每块 100 FE / 携带即 +3 触及(不看电量)」= CapacitorItem.ENERGY=8_000_000MAX_BLOCKS=4000blocks*100isCarried()+CrabClawItem.RANGE_ATTRIBUTE_MODIFIER=3
    • 耐候胸甲「160 MFE / 12 格口袋 / 站流体源(潜行下沉)/ 免疫环境伤害但不免疫虚空」= MAX_ENERGY=160_000_000PocketInventory 12canStandOnFluidisImmune+collideWithVoidFloor
    • 骰子「均匀 0–15 / 三点和减 3」= UNIFORM_OUTCOMES[nextInt(16)]getFace(0)+getFace(1)+getFace(2)-3 ✅;储物流体端口 128 B 与 50–75% 液位 ✅
    • 仓储合成窗口「放入工作台+切石机并选择消耗以解锁」= BaseStorage.unlockCrafting() 检查 PLAYER_WORKSTATIONS_CRAFTING_TABLES/STONECUTTERS 后各抽取 1 ✅
  • 引用完整性(脚本全量校验 PR head 树):111 个 anvilcraft: item/block id、23 个 <recipe>、全部 <structure>/图片/.md 链接 → 0 处解析失败structures/ 全部 id= 目标存在;新增 2 张 PNG(ionocraft_backpack.pngstructure_scanner.png)均被 en/zh 双页引用,非孤悬资源。
  • 页面重组无残留:删除的 001_chute.md101_ionocraft_backpack.mdanvil_workstation.snbt 在 head 树中零引用;新 nav items: 覆盖旧条目并扩展(chute→logistics 增 overflow_chute/item_splitter;ionocraft_backpack→functional_armor + weatherproof_armor)。
  • 唯一待确认的 recipe id anvilcraft:super_heating_warp_raw_copper_2_copper_ingotVanillaRecipesWrap 运行时 datagen 生成(不在 src/generated,与 base 同写法),非本 PR 问题

📋 声称验证表

声称(PR 标题/描述:更新手册) 状态 对应文件
手册页面重写/重组(进程页去掉 N- 前缀、改 H1 标题) 000_process/001–015.md(en+zh)
溜槽/磁性溜槽/简化溜槽 → 物流组件整页重写 004_block/001_logistics.md(删 001_chute.md)
新增「存储站」汇总章节(分类显示/合成窗口/翻转布局/Ctrl+Z) 004_block/003_crate.md、215_large_crate.md
飘升机背包 → 功能性盔甲(呼吸头盔/口袋护腿/缓冲靴/飘升机) 005_tool/101_functional_armor.md ⚠️ 见丢 3 条说明
新增耐候盔甲页 005_tool/301_weatherproof_armor.md ⚠️ 措辞需校正
新增建筑杖页 006_prop/101_building_rod.md
结构扫描仪 导入/导出 章节 + 新截图 004_block/101_structure_scanner_alternative.md
红石新元件(大按钮/红石骰子)、蟹钳、紫水晶探查等流程页配图 004_block/001_redstone.md、005.md 等
结构文件 snbt → nbt 迁移 ✅(solid_liquid.snbt 未迁移属 base 现状) structures/anvil_workstation.nbt 等

备注(分支状态):md 侧 pre-image 校验通过(无合并冲突);但 head 落后于 dev/1.21/1.6 —— dev 侧已有 ItemTooltipManager/ItemTooltipLang 的提示文案更新(含 building_rod、ionocraft_backpack 的 SHIFT 提示)与 en_ud 语言文件变更均不在本 PR。合并前建议 rebase,并让手册相关描述与最新提示文案对齐。

结论: COMMENT(建议修复后合并) — 文档体量很大但质量高:跨语言对称、全部 id/配方/结构/图片引用经脚本与源码双向核对无误,功能数值与代码逐条吻合。阻塞项只有 en_us/000_process/003.md 两处 ? 乱码;另建议一并处理 zh_cn 加热器页断链、飘升机背包迁移丢条与耐候盔甲「防护超过下界合金」措辞。

标题建议gh auth status 显示 token 已失效,本次未自动修改):Update the manual: restructure guide pages, add logistics/armor/building-rod pages 更新手册:重构流程页并新增物流组件、功能性/耐候盔甲与建筑杖页面


由 Hermes Agent 审查(依据 dev/1.21/1.6 @ 68d5f6258d 与 PR head d6284032e9 交叉验证)

@Gugle2308

Copy link
Copy Markdown
Collaborator

💾 Self-improvement review: Patched SKILL.md in skill 'documentation-pr-review' (1 replacement).

@TBPig TBPig changed the title Update the manual 更新手册 Update the guide book: new logistics and armor pages 更新手册:新增物流元件与盔甲页面,修订流程/机器页 Sep 19, 2026
Copilot AI review requested due to automatic review settings September 19, 2026 10:52
@Gugle2308

Copy link
Copy Markdown
Collaborator

⚠️ Dangerous command requires approval:

cd /tmp; echo "=== 每文件 en/zh 新增标题数对比 ==="; for f in 000_process/001.md 000_process/002.md 000_process/003.md 000_process/004.md 000_process/005.md 000_process/006.md 000_process/007.md 000_process/008...

Reason: Security scan — [MEDIUM] Variation selector characters detected: Content contains Unicode variation selectors (VS1-256). These are commonly used in emoji sequences but may indicate steganographic encoding or obfuscation

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

@Gugle2308

Copy link
Copy Markdown
Collaborator

代码审查摘要 — PR #4945

操作: review_requested(opened)
范围: 98 个文件(88 md、7 nbt 结构、2 png、1 snbt;13 新增 / 5 删除)/ 3633 行 diff — 纯文档 PR,无 Java 变更
基准: 已对照 dev/1.21/1.668d5f6258d)源码逐条交叉验证


🔴 关键

  • 无。

✅ 数据结构与引用完整性(全部通过)

检查项 结果
en/zh 目录页数对称(10 个目录) ✅ 逐目录完全一致
新页面中英标题树 ✅ 8/8、6/6、8/8、8/8 层级一一对应
旧导航 items 覆盖 chute/magnetic_chute/ionocraft/ionocraft_backpack 全部在新页面 items 中,无导航入口丢失
删除页面的反向链接 000_process/002.md../004_block/001_chute.md001_logistics.md(en+zh 均改),全库无残留
.snbt.nbt 迁移 anvil_workstation.snbt 删除、anvil_workstation.nbt 新增,en/zh <structure> 引用同步;无残留旧引用
新增资源被引用(无孤悬) item_splitter.nbtp2_topaz.nbtanvil_workstation.nbtionocraft_backpack.pngstructure_scanner.png 各被引用 2 次(en+zh)
新增 <item>/<block> id 存在性(95 个) ✅ 全部命中 ModItems/ModBlocks
新增 <recipe id> 存在性(23 个) ✅ 全部可解析(super_heating_warp_*VanillaRecipesWrap 动态生成,非缺陷)
跨页面链接/结构路径(脚本解析相对路径) ✅ 0 处断链
TODO / FIXME / 调试语句 / 尾随空格 ✅ 新增行 0 命中

✅ 数值与行为声明交叉验证(对照源码)

文档声明 源码依据 结论
飘升背包工作时 8 kW FLIGHT_POWER = 8 ✅(旧页面写 64 kW,本次修正
飘升机上升 2 kW IonocraftEntity.CONSUMPTION(2) ✅(旧页面写 16 kW,修正)
建筑杖 8 MFE / 100 FE 每方块 / 单次上限 4000 MAX_ENERGY=8,000,000blocks*100MAX_BLOCKS=4000
建筑杖携带即 +3 方块与实体触及距离(与是否储电无关) updateReach 无能量判断;EntityReachAttribute.getRangeModifierSupplier 同时挂两个属性;CrabClawItem:56BuildingRodItem.isCarried
无限流体一次最多消耗 2 桶 BuildingRodFluids:96canConvertToSource ? 2 : cells.size()
加热器:< 500s 补燃料、240s 才够温、无 1200s 上限 REFUEL_THRESHOLD=500*20LIT_THRESHOLD=240*20、无上限 clamp ✅(删除"上限 1200s"正确)
特斯拉塔 4 秒 / 半径 8 / 连锁 4 目标 40·30·20·10 / 128 kW STRIKE_COOLDOWN_TICKS=4*20expandTowards(8,8,8)jump<440-jump*10128
耐候胸甲额外 160 MFE WeatherproofChestplateItem.MAX_ENERGY = 160_000_000
护腿 6 格 / 耐候护腿 12 格口袋 PocketInventory.capacity() 返回 6 / 12
分配器 16 格、单物品、最远 16 格、按落高均分 SLOT_COUNT=16MAX_DISTANCE=16shares=ceil(fallDistance)
溢流溜槽无 GUI、铁砧锤单击开闭对应面溢流口 getMenuProvider→nulluse() 校验 ANVIL_HAMMER + 非进出方向翻转属性
简化溜槽不合并物品、占位即拒绝输入 SimpleChuteBlockEntity:32 注释与逻辑
红石骰子输出 = 三骰之和 −3、均匀/真实模式、锤子右键切换 getOutput = face0+1+2-3uniform/realisticRedstoneDiceModePacket 校验锤子
宝石效果可由发射器触发 ModDispenserBehavior 注册 TOPAZ/RUBY/SAPPHIRE/EXP_GEM

⚠️ 警告

  1. 4 个新页面缺少文件末尾换行,但同批新增的 zh 页面却有换行 —— 不一致:

    • en_us/005_tool/101_functional_armor.md(NEW,缺)
    • en_us/005_tool/301_weatherproof_armor.md(NEW,缺)
    • en_us/006_prop/101_building_rod.md(NEW,缺)
    • zh_cn/006_prop/101_building_rod.md(NEW,缺)
      zh_cn/004_block/001_logistics.mdzh_cn/005_tool/101_functional_armor.mdzh_cn/005_tool/301_weatherproof_armor.md 已正确带换行。)另有 9 个被修改文件仍缺 EOF 换行(en_us/004_block/201_tesla_tower.mdzh_cn/004_block/201_tesla_tower.mdzh_cn/004_block/003_crate.md 等),本 PR 已修好其中一部分(如 zh_cn/004_block/100_heater.md),建议一次对齐。
  2. 页面合并造成行为说明丢失006_prop/101_ionocraft_backpack.md(36 行整页删除)并入 005_tool/101_functional_armor.md,旧页面的以下内容在新页面中已无对应描述,而这些行为在源码里仍然存在,建议保留:

    • "Reentering the grid during this descent immediately resumes creative flight" —— IonocraftBackpackItem#refreshFlightresumeFlight 逻辑仍在;
    • "After landing, entering a grid grants flight ability without automatically taking off" —— 源码注释「触地优先结束本次缓降,避免同一刻重新入网时自动起飞」仍是现行行为;
    • "The backpack does not store energy and cannot be charged with capacitors"(背包确无 STORED_ENERGY/可充电实现);
    • 安装饰品/Curio 模组时可放入饰品槽的提示(CuriosCommon 集成仍存在)。
  3. 中英不对称(预存在,但本 PR 已改动该文件,顺手可修)zh_cn/004_block/100_heater.md[物品加工:烹饪](../007_struct/anvil_processing.md#快速烹饪) 指向不存在的 anvil_processing.md,实际文件为 000_anvil_processing.md;en 侧写法正确。全库仅此一处。


💡 建议

  1. en_us/000_process/003.md 排版回退:These are important concepts — be sure to master all of them 被改成 -(同文件其他地方仍在使用 );新增句 ... instead of <cauldron/> ? the former can serve as a container 用孤立 ? 作分隔符,zh 侧对应为「,前者可以充当容器」,建议英文改为冒号或破折号。
  2. 006_prop/101_building_rod.md 被动效果只写了 +3:物品 tooltip(item.anvilcraft.building_rod.desc)明确「双手任持建造时为 +15 格方块触及距离」(updateReach15-3=12,再叠加蟹钳 +3)。建议补充,否则读者会低估建造半径。
  3. zh_cn/006_prop/101_building_rod.md## 额外特性 前多一个空行(72 行 vs en 71 行),结构对齐一下。
  4. 001_logistics.md# Simple Chute / # 简化溜槽 未随本次 <ref> 化统一(该方块有 anvilcraft:simple_chute 可引用);小标题 ## Storage Characteristics / ## Control Characteristics 在 en 下与 ## Function 层级一致,可接受。
  5. en_us/index.md 新增列表最后一项 ... power weapons and tools. 结尾带句点,其余条目无标点,建议统一。

🟢 看起来不错

  • 章节重构(###)配合 > 引言 / <item> / <row> / <structure> 增强,阅读体验提升明显;> 引用块在其他页面已有先例,渲染安全。
  • 100_heater.md201_tesla_tower.md101_structure_scanner_alternative.md000_anvil_processing.md 属于实质性纠错(1200s 上限、特斯拉链式伤害、导入导出/管理员权限、固液反应不总消耗液体),且中英同步修改,质量很好。
  • 215_large_crate.md 新增"自动化存储访问"(storage_port / storage_fluid_port / consolidator)与 004_block/001_redstone.md 补充 big_red_button / redstone_dice,覆盖了此前手册空白的方块。
  • 009_machine/201_netherite_block.md15gt → 16gt 与本次 machine/netherite_block.nbt 二进制更新同步,属于配套修正。

📋 声称验证表

PR 声称 状态 对应文件
新增物流元件页面 004_block/001_logistics.md(en+zh,替换 001_chute.md
新增盔甲页面 005_tool/101_functional_armor.md005_tool/301_weatherproof_armor.md(en+zh)
修订流程页 000_process/001~015.md 全 15 页(en+zh)
修订机器页 009_machine/001_iron.md201_gem.md201_netherite_block.md(en+zh)
(未在标题中提及)新增建筑杖页面 ⚠️ 006_prop/101_building_rod.md(en+zh,NEW)
(未在标题中提及)结构文件 snbt→nbt 迁移 ⚠️ structures/anvil_workstation.snbt → .nbt

结论: APPROVE(COMMENT) — 纯手册 PR,无 Java 变更;导航/链接/结构文件引用/资源引用完整性全部通过,所有新增的数值与行为声明均已在 dev/1.21/1.6 源码中逐条复算通过(含修正了旧页面的 64 kW/16 kW/1200s 等过时数据)。仅建议处理 EOF 换行一致性、页面合并时的行为说明丢失,以及 zh 加热器页的断链。


建议标题(本次 gh 未认证,未自动修改)Update the guide book: add logistics, armor and building rod pages 更新手册:新增物流元件/盔甲/建筑杖页面,修订流程与机器页

由 Hermes Agent 审查

@Gugle2308

Copy link
Copy Markdown
Collaborator

已完成全面核对(diff 分析 + 拉取 PR head 源码交叉验证)。以下是审查意见:


代码审查摘要 — PR #4945

操作: synchronize
范围: 98 个文件(44 en_us + 44 zh_cn Markdown、8 个结构文件、2 个新纹理;0 Java)/ +1096 −310 行 / 新增 13、删除 5
性质: 纯手册(ageratum)更新 — 新增物流元件页、功能性盔甲页、耐候盔甲页、建造杖页;删除/重组 001_chute.md101_ionocraft_backpack.md

✅ 关键数值核对(对照 PR head 源码,全部通过)

手册声称 源码证据 结果
离子推进背包 8 kW IonocraftBackpackItem.FLIGHT_POWER = PowerConsumption(8) ✅(旧页写 64 kW 是错的,本 PR 修对了)
离子飞行器 2 kW IonocraftEntity.CONSUMPTION = PowerConsumption(2) ✅(旧页 16 kW 同样是错的)
建造杖储能 8 MFE MAX_ENERGY = CapacitorItem.ENERGY = 8_000_000
每方块 100 FE / 单次 4000 方块 consume(): blocks * 100BuildingRodService.MAX_BLOCKS = 4000
携带即 +3 交互距离 CrabClawItem.holdingCrabClawIncreasesRangeBuildingRodItem.isCarried() 视为持蟹钳,+3 modifier 同时作用于 BLOCK/ENTITY
分配器 16 组/单一物类、最远 16 格、按落高均分 SLOT_COUNT=16MAX_DISTANCE=16ItemSplitterBehavior.splitToSpace(ceil(fallDistance))
溢流溜槽 1 组、铁砧锤右键开关溢流口 SLOT_COUNT=1OverflowChuteBlock:280 校验 ANVIL_HAMMER + 逐面 OVERFLOW_* 属性
简化溜槽「不合并、占槽即拒收」 SimpleChuteBlockEntity.insertItem: if (!getStackInSlot(0).isEmpty()) return stack
口袋 6 格 / 耐候护腿 12 格 EquipmentArmorItem: weatherproof ? 12 : 6
耐候胸甲 160 MFE、低电耗电容补充 MAX_ENERGY = 160_000_000canAccept(... <= FLIGHT_CONSUMPTION)
功能性盔甲=铁级防护 / 耐候=超越下界合金 材质 IRON / NETHERITE,且 getDefense() 额外 +2/+3、getToughness() +1/+2
全套环境免疫、不免疫虚空伤害 EquipmentAbilities.isImmune:IS_ENVIRONMENT/火/霜冻/闪电;FELL_OUT_OF_WORLD 显式 return false
固液反应「部分配方不消耗液体」+ 杜鹃花条 data/.../recipe/solid_liquid/flowering_azalea(.leaves).json 存在
扫描仪导出入同目录、可自选自动旋转 getWorldPath(ROOT).resolve("anvilcraft/structures")autoRotate 读写

结构文件迁移正确anvil_workstation.snbt 删除 → anvil_workstation.nbt 新增,2 处引用(en/zh 000_process/003.md)已同步为 .nbt;新结构调色板含 big_red_button,与页内 tip「按住大红色按钮让铁砧下落」一致 ✅。新增的 item_splitter.nbtp2_topaz.nbt 及两张 PNG 均已被对应页面引用,无孤悬资源 ✅。

多语言与交叉引用:en/zh 各 44 页一一对应;删除的两个页面在整棵 ageratum 树中已无任何残留引用(001_chute.md / 101_ionocraft_backpack.md 全库 grep 为空),000_process/002.md 的链接已双语改指 001_logistics.md;离子飞行器内容完整迁移进功能性盔甲页(未丢失);新页 navigation.title 的 §分级(无§/§2/§5)与同目录兄弟页约定一致 ✅。zh 侧 003_crate.md 补上了 en 早已存在的「Shift 合成 1 组 / 空格 8 组」第 2 步,属于追平 ✅。


⚠️ 警告

  1. 005_tool/101_functional_armor.md(及 zh 同页)— 缓冲靴跳跃倍数与源码不符
    新增文本:「press Space to jump up to 4 times as high」/「最多可跳至 4 倍高度」。源码 EquipmentAbilities.MAX_JUMP_HEIGHT_MULTIPLIER = 3.5,且 consumeChargedJumpjumpHeight(normal) * multiplier(作用在高度上)→ 满蓄力实为 3.5 倍。模组自带 tooltip(ItemTooltipLang)写的是「up to 4 blocks height」,与本页「4 倍」也不是一回事。建议按 3.5×(或与 tooltip 统一为「约 4 格高」)改写,中英同步。

  2. 004_block/101_structure_scanner_alternative.md(及 zh 同页)— 「服务器需 OP 权限」未在代码中找到依据
    新增文本:「On servers, file operations require operator permissions」。但在 PR head 上通查 src/main/javahasPermissions / isOp( / canUseGameMasterBlocks / isSingleplayer / isDedicatedServer 仅在 PipeBlockItem.java:637 出现一次,与扫描仪无关;StructureScannerFilePacket.handleOnServer 只校验 containerMenumenu.stillValid(player)StructureScannerFiles.saveImportedStructure/exportStructure 直接写 <world>/anvilcraft/structures,没有权限门槛。若这是计划中的行为,请注明;否则建议删除该句(或补上对应的代码改动)。

  3. zh_cn/004_block/100_heater.md:47 — 断链(缺 000_ 前缀)
    [物品加工:烹饪](../007_struct/anvil_processing.md#快速烹饪),实际文件为 000_anvil_processing.md;en 侧写的是 ../007_struct/000_anvil_processing.md#fast-cooking。全库仅此一处仍指向不存在的 007_struct/anvil_processing.md。属历史遗留,但本 PR 已重写该文件末尾(EOF 那一行),顺手修掉成本极低。

💡 建议

  • 缺末尾换行(6 处,本 PR 引入/保留):新页 en_us/005_tool/101_functional_armor.mden_us/005_tool/301_weatherproof_armor.mden_us/006_prop/101_building_rod.mdzh_cn/006_prop/101_building_rod.md;以及尾巴被重写但仍无换行的 en_us/004_block/201_tesla_tower.mdzh_cn/004_block/003_crate.md。注意 zh 的 functional/weatherproof armor 两页是有换行的,en 侧漏了。
  • 离子背包并入盔甲页时丢了若干用户可见细节:饰品模组 curio 槽兼容、「背包不储能且不能用充能器充电」、右键放置离子飞行器实体、以及「脱离电网滑翔中重新入网即恢复飞行 / 落地后入网不自动起飞」。建议至少保留 curio 槽与「不储能」两条。
  • 建造杖页只写了 +3 被动射程BuildingRodItem.updateReach 在填充/蓝图模式开启时会把 BLOCK_INTERACTION_RANGE 额外 +12(叠加蟹钳 +3 后共 +15),并把 ENTITY_INTERACTION_RANGE 的该 modifier 显式归零。建议补一句模式内射程说明。
  • zh_cn/004_block/001_logistics.md:「打开gui可以:」小写 gui(沿用旧页),与同页「无 GUI」不统一,可选统一为 GUI

🟢 看起来不错

  • 修正了旧页 64 kW / 16 kW 两处实质性数值错误,并修正了背部储能/充电的表述。
  • 页面重组干净:Chute → Logistics Components 导航 items 由 2 项扩展为 4 项(chute / magnetic_chute / overflow_chute / item_splitter),旧页内容完整保留并新增简化溜槽「存储/控制特性」分组。
  • 新增/更新的结构文件与页面文字自洽(big_red_button ↔ tip),.snbt → .nbt 格式统一。
  • 数值型断言普遍可溯源,未发现编造数据;未发现硬编码凭据、TODO 或调试残留。

📋 声称验证表

声称 状态 证据
新增物流元件页面 004_block/001_logistics.md(en/zh)替换 001_chute.md,旧链接已改指
新增盔甲页面 005_tool/101_functional_armor.md301_weatherproof_armor.md(en/zh)
修订流程页 000_process/001–015.md 全部 15 页双语更新
修订机器页 009_machine/001_iron.md201_gem.md201_netherite_block.md + structures/machine/*.nbt
(标题未提及)新增建造杖页 006_prop/101_building_rod.md(en/zh,+49 行/页)— 建议并入标题

结论: COMMENT — 内容质量高、数值断言绝大多数与源码一致,未发现阻塞性问题。建议合并前处理 ⚠️ 第 1、2 项(数值/权限断言与实现不符,对一份以「准确性」为目标的手册是核心风险),第 3 项断链与 💡 项可一并顺手修掉。

标题建议(本次因 gh auth status 显示 token invalid、gh 未认证,未自动修改,禁止导出凭据):
Update guide book: add logistics, functional/weatherproof armor and building rod pages 更新手册:新增物流元件、功能性盔甲、耐候盔甲与建造杖页面,修订流程与机器页


由 Hermes Agent 审查

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Unresolved moderate and minor documentation issues remain in both locales.

Review effort: Lite
Findings: None

Resolved since last review (7)
Previously missed (7)

In code that hasn't changed since last review

Low severity Replace malformed question mark with sentence punctuation

src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​000_process/​003.md:27

The new ? between these two clauses is malformed punctuation and renders as a question mark rather than a sentence separator. Replace it with a semicolon or em dash.

Low severity Add the missing redstone dice recipe entry

src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​001_redstone.md:95

The redstone dice has a shaped recipe registered by RegistrumBlockRecipeLoader.redstoneDice, but unlike the adjacent big button section it has no <recipe> entry. Add the recipe so the new guide page exposes how to craft this listed component.

Low severity Correct blueprint folder and permission documentation

src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​101_structure_scanner_alternative.md:48

Import/export is performed by the client: BlueprintClientFiles.directory() resolves <client game directory>/anvilcraft/structures, while the server packet handlers only validate the open menu and do not check operator status. This line therefore documents the wrong folder and incorrectly says operator permissions are required; update it to describe the client folder and actual permission behavior.

Low severity Add the missing storage port consolidator recipe

src/​main/​resources/​assets/​anvilcraft/​ageratum/​en_us/​004_block/​215_large_crate.md:74

The storage port consolidator has a shaped recipe registered by ShapedRecipeLoader.storagePortConsolidator, but this section is the only new storage component without a recipe display. Add the recipe so readers can see how to craft it.

Low severity Add the missing redstone dice recipe entry

src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​001_redstone.md:93

The redstone dice has a shaped recipe registered by RegistrumBlockRecipeLoader.redstoneDice, but unlike the adjacent big button section it has no <recipe> entry. Add the recipe so the new guide page exposes how to craft this listed component.

Low severity 修正蓝图文件夹和权限说明

src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​101_structure_scanner_alternative.md:48

导入导出由客户端执行:BlueprintClientFiles.directory()使用的是客户端游戏目录下的 anvilcraft/structures,而服务器数据包处理只校验已打开且有效的菜单,并不检查管理员权限。因此这一行同时写错了文件夹位置和权限要求,请改为描述客户端目录及实际权限行为。

Low severity Add the missing storage port consolidator recipe

src/​main/​resources/​assets/​anvilcraft/​ageratum/​zh_cn/​004_block/​215_large_crate.md:73

The storage port consolidator has a shaped recipe registered by ShapedRecipeLoader.storagePortConsolidator, but this section is the only new storage component without a recipe display. Add the recipe so readers can see how to craft it.

@Gugle2308

Copy link
Copy Markdown
Collaborator

💾 Self-improvement review: Patched SKILL.md in skill 'documentation-pr-review' (1 replacement). · Patched references/manual-asset-and-link-verification.md in skill 'documentation-pr-review' (1 replacement).

@Gugle2308

Copy link
Copy Markdown
Collaborator

⚠️ Dangerous command requires approval:

cd /tmp; curl -sL "https://api.github.com/repos/Anvil-Dev/AnvilCraft/pulls/4945" -o pr4945.json; python3 -c "
import json
d=json.load(open('/tmp/pr4945.json'))
print('state', d.get('state'), 'merged',...

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.

Copilot AI review requested due to automatic review settings September 19, 2026 11:08

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@Gugle2308

Copy link
Copy Markdown
Collaborator

审查完成。以下是直接输出到 PR 评论区的审查意见。


代码审查摘要 — PR #4945

操作: edited(审查至 head 3ba9873a;期间 PR 被重新推送,文件数 98 → 100)
范围: 100 个文件(0 Java,90 个 md = 45 en + 45 zh,13 新增文件:8 个 md + 3 个 .nbt + 2 个 .png,5 删除)/ diff 3659 行,+1098 / −310
性质: 纯手册(Ageratum)变更,无代码/数据文件


✅ 结构与一致性检查(全部通过)

检查项 结果
新增资源是否被引用 anvil_workstation.nbt / item_splitter.nbt / p2_topaz.nbt<structure>)与 ionocraft_backpack.png / structure_scanner.png![]())均被手册引用,无孤悬资源
新增 NBT 文件有效性 ✅ 三个 .nbt 均为合法 gzip+NBT(size/entities/blocks/palette 结构完整);两张 PNG 魔数与 IEND 尾部均合法
.snbt.nbt 迁移 anvil_workstation.snbt 已删除,en/zh 两侧引用同步改为 .nbt,无残留 .snbt 引用
删除页引用清理 ✅ 被删的 004_block/001_chute.md 仅在 000_process/002.md 被引用,en/zh 两侧均改为 001_logistics.md;被删的 006_prop/101_ionocraft_backpack.md 无外部引用 → 无死链
导航 items 覆盖(4c) ✅ 旧 chute 页 items [chute, magnetic_chute] → 新 logistics [+overflow_chute, +item_splitter];旧 ionocraft 页 → 新 101_functional_armor items 扩为 5 项,无条目丢失
ID 存在性 ✅ 92 个 <ref item>、23 个 <recipe id>、2 个 <block id> 全部在目标分支解析成功
en/zh 结构对等 ✅ 45 对页面标题数、<row>/<tip>/<info>/<item>/<recipe> 标签数一致(仅 201_tesla_tower# Function 属 zh 原本已有、heat_collection 表格重排等良性差异)
多语语言质量 ✅ en 新增行无 CJK 残留;zh 无半角标点混用、无截断句、无社区黑话

🔴 关键(数值与源码不符)

  • 004_block/101_smart_block_placer.md(en + zh)— 蓝图模式耗电未同步修正。 本 PR 把范围放置从 8kW 修正为 16kW(✅ 与 SmartBlockPlacerBlockEntity.TargetMode.POSITION(16) 一致),但同一页下文的 Blueprint Mode 仍写 Power consumption increases to 64kW / 能耗提高至 64kW。目标分支源码 TargetMode.BLUEPRINT(128),应为 128kW。同一页出现 16 / 64 两个数,且 64 是旧值的一半,属于"改一半"的漏改。

⚠️ 警告

  • 005_tool/101_functional_armor.md(en + zh)— buffer boots 跳跃描述与原意不符。 en 写 jump up to 4 times as high,zh 写 最多可跳至 4 倍高度;而官方 tooltip 是 up to 4 blocks height(官方 zh:最多可跳跃 4 格方块高),即绝对高度 4 格,不是 4 倍。代码 EquipmentAbilities.MAX_JUMP_HEIGHT_MULTIPLIER = 3.5(3.5 倍普通跳跃高度)也印证不是"4 倍"。建议改为 up to 4 blocks high / 最多 4 格方块高
  • en_us/000_process/003.md — 标点错误。 新增行 - Use a <ref item="anvilcraft:fish_tank"/> instead of a <ref item="minecraft:cauldron"/> ? the former can serve as a container? 是残留的错字(zh 侧对应句用的是 ),语义应为破折号/分号:— the former can serve as a container
  • zh_cn/001_feature/101_heated_block.md — 术语不一致。 新增表格行的首列 en 为 Super-Heating Recipe,zh 译为 超温加热配方。但模组官方 zh 名为 gui.anvilcraft.category.super_heating = 高温熔炼,且 超温 是官方另一档温度 tooltip.anvilcraft.heat.tier.overheated 的名字——同一行"加热能力"列恰好写 高温(Heated),术语自相矛盾。建议 zh 改为 高温熔炼配方(与 100_heater.md 现有译法一致)。
  • 4 个新增文件缺文件末尾换行符: en_us/005_tool/101_functional_armor.mden_us/005_tool/301_weatherproof_armor.mden_us/006_prop/101_building_rod.mdzh_cn/006_prop/101_building_rod.md。同批新增的 zh_cn/005_tool/101_functional_armor.mdzh_cn/005_tool/301_weatherproof_armor.mdzh_cn/004_block/001_logistics.md 都有末尾换行 → 英文侧系统性缺失,建议统一补上(注意本仓库另有 10 处历史遗留 MOD 文件同样缺末尾换行,可另行处理)。

💡 建议

  • 删页内容丢失(006_prop/101_ionocraft_backpack.md005_tool/101_functional_armor.md:以下行为说明在新页中被丢弃,经核对在当前源码里仍然成立,建议补回(可放 <info>):
    • 安装饰品/Curio 类模组时可放入饰品栏;
    • 缓降途中重新进入电网会立即恢复飞行(refreshFlightresumeFlight = powered && hadDescent && !player.onGround());
    • 落地后进入电网只获得飞行能力、不会自动起飞(源码注释「触地优先结束本次缓降」);
    • 普通喷气背包本体不储电、不能用电容器充能(只有耐候胸甲储电,WeatherproofChestplateItem.MAX_ENERGY)。
  • 建筑杖页面缺"建造态 +15 格触及距离":官方 tooltip 为 Grants crab claw reach while carried, including in pockets; hold in either hand to build with +15 block reachBuildingRodItem.updateReach() 建造时把 BLOCK_INTERACTION_RANGE 设为 15 − 3,叠加蟹钳被动的 +3 才是 +15。当前页面只写了被动 +3,可能让读者以为建造时也只有 +3。
  • 耐候头盔视野描述偏窄:文档写 Provides clear vision in lava,官方 tooltip 是 clear vision in all fluidsEquipmentArmorItemtooltip.anvilcraft.equipment.clear_vision)。
  • 耐候胸甲漏写耗电速率:官方 tooltip 有 Uses 100 kFE per second,建议补上(与"160 MFE 可飞行时长"直接相关)。
  • 历史遗留的错误 recipe id004_block/100_heater.md(en + zh)引用 <recipe id="anvilcraft:super_heating_warp_raw_copper_2_copper_ingot"/>,但不存在该 id 的配方(实际文件为 super_heating/raw/copper_ingot.json)。本 PR 已经为修 EOF 换行动了这一行(zh 侧),顺手改成正确 id 更稳妥。

🟢 看起来不错

  • 新增的两张页面结构清晰:001_logistics.md 覆盖 chute / magnetic / simple / overflow / item splitter,并给出分配器"遮挡顺延 + 16 格上限"的示例,与 ItemSplitterBlockEntity.collectSpaceTargets()continue(跳过遮挡、继续前推直到凑够份数)逐句对得上。
  • 大量过时数值被正确修正:喷气背包 64kW → 8kWFLIGHT_POWER=8)、飘升机 16kW → 2kWIonocraftEntity.CONSUMPTION=2,旧文档的 16 是更早版本)、智能方块放置器 8kW → 16kW、特斯拉塔补上 128kW / 连锁 4 目标 40-30-20-1040.0F - jump * 10.0F)、加热器 500s 补燃 / 240s 工作REFUEL_THRESHOLD / LIT_THRESHOLD)并删除了错误的 1200s 上限(源码确实无上限钳制)。
  • anvil_workstation.nbt重新设计(magnet_block / anvil / stamping_platform / big_red_button,替换掉旧的 observer + note_block 时序),与改写后的 000_process/003.md「按住大红色按钮即可让铁砧下落」一致,属有意修订而非丢失。
  • 蓝图表 p2_topaz.nbt(stamping_platform + anvil + arrow + geode)、item_splitter.nbt(分配器 + 8 个板条箱 + 指示方块)与对应正文描述一致。

📋 声称验证表

PR 声称 状态 依据
新增物流元件页(chute/simple/overflow/splitter) 001_logistics.md × 2,9 格 / 1 组 / 16 组 / 16 格 / 按落高均分均与源码一致
新增盔甲页(功能性、耐候) 101_functional_armor.md301_weatherproof_armor.md × 2,6/12 口袋格、160 MFE、铁质/下界合金+防护均核对通过
修订流程页(000_process 全 15 页 + index) 链接改名、结构改 .nbt、数值更新齐全
修订机器页 ⚠️ 101_smart_block_placer.md 蓝图耗电漏改(64 → 应为 128kW),见 🔴
新增建筑杖页 ⚠️ 数值全部正确(8 MFE / 100 FE / 4000 块 / 免充能可用的 +3),但漏写建造态 +15 触及

结论: COMMENT(建议修复 🔴 + ⚠️ 后再合并) — 无代码风险,但既然本 PR 的核心价值就是"把过时数值改对",smart_block_placer 蓝图模式 64kW 与新写的 16kW 同页并存会立刻造成读者困惑;buffer boots 的"4 倍高度"属实质语义错误。其余为可选优化。

PR 标题已是 <英文> <中文> 且准确(Update the guide book: new logistics and armor pages 更新手册:新增物流元件与盔甲页面,修订流程/机器页),无需修改;本次 gh auth status 显示 token 失效(The token in /opt/data/home/.config/gh/hosts.yml is invalid),故未执行 gh pr edit,也不影响本审查。


由 Hermes Agent 审查

@PigeonNian
PigeonNian merged commit 4f77cc7 into dev/1.21/1.6 Sep 19, 2026
2 checks passed
@Gugle2308

Copy link
Copy Markdown
Collaborator

⚠️ Dangerous command requires approval:

cd /tmp; awk '/^diff --git/{if(f!=""){if(h==0 && b==0) print "⚠️ 无 hunk 且非二进制: "f} f=$NF; h=0; b=0; next} /^@@/{h++} /^Binary files/{b++} END{if(h==0&&b==0)print "⚠️ 无 hunk 且非二进制: "f}' pr4945.diff; ec...

Reason: Security scan — [MEDIUM] Variation selector characters detected: Content contains Unicode variation selectors (VS1-256). These are commonly used in emoji sequences but may indicate steganographic encoding or obfuscation

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

@Gugle2308

Copy link
Copy Markdown
Collaborator

操作类型为 closed,按约束 1 停止流程,不发布审查评论。

如需对重新开启(opened/synchronize)的同名 PR 做完整审查,请再次触发 webhook。

@Gugle2308

Copy link
Copy Markdown
Collaborator

💾 Self-improvement review: Patched references/pr-class-routing.md in skill 'github-webhook-pr-review' (1 replacement).

@Gugle2308

Copy link
Copy Markdown
Collaborator

⚠️ Iteration budget exhausted (90/90) — asking model to summarise

@Gugle2308

Copy link
Copy Markdown
Collaborator

代码审查摘要 — PR #4945

操作: review_requested
范围: 100 个文件(0 Java,全部为 assets/anvilcraft/ageratum/ 手册资源)/ 3,659 行 diff
结构: en_us 45 md | zh_cn 45 md | structures 8 | textures 2;新增 13(4 页 md + 3 nbt + 2 png + …)、删除 5(2 页 md + 1 snbt)


✅ 多语言/资源一致性(逐文件核对通过)

检查项 结果
en_us 45 vs zh_cn 45 文件清单 diff 为空,完全对称
新增页双语言成对 001_logistics.md101_functional_armor.md301_weatherproof_armor.md101_building_rod.md 均 en+zh 各一份 ✅
删除页有替代 001_chute.md001_logistics.md(items 由 2 项扩到 4 项);101_ionocraft_backpack.md005_tool/101_functional_armor.md(原 items 被完全覆盖)✅
.snbt.nbt 迁移 anvil_workstation.snbt 删除 + anvil_workstation.nbt 新增,引用同步 ✅
新增二进制资源被引用 新增 3 个 nbt(anvil_workstation/item_splitter/p2_topaz)与 2 个 png 全部在正文有引用,无孤悬资源 ✅
154 个 <ref>/<item> id 全部能在 lang/en_us.json 解析,无拼写错误 ✅
23 个 <recipe id> 22 个存在于生成资源;super_heating_warp_raw_copper_2_copper_ingotVanillaRecipesWrap 动态拼装(super_heating_warp_%s_2_%s),非缺失
跨页锚点 015.md → 011.md#experience-logistics301_weatherproof_armor → 101_functional_armor.md#pocket-storage 均与目标页标题匹配,且本次 ### 标题提级未破坏锚点 ✅

✅ 数值与源码交叉验证(逐条核对 dev/1.21/1.6 源码,全部一致)

手册表述 源码依据 结果
燃烧加热器:低于 500s 补燃料 / 达 240s 可工作 / 每批耗 240s REFUEL_THRESHOLD=500*20LIT_THRESHOLD=240*20
> 烫脚 BurningHeaterBlock 受伤逻辑 + IDamagingHeater
悬浮机 2 kW、喷气背包 8 kW IonocraftEntity.CONSUMPTION=2IonocraftBackpackItem.FLIGHT_POWER=8修正了旧页 16/64 kW ✅ 修正正确
防候胸甲 160 MFE、腿部 12 格口袋、基础版 6 格 MAX_ENERGY=160_000_000pockets 12/6
建造杖 8 MFE / 100 FE 每方块 / 上限 4000 MAX_ENERGY=CapacitorItem.ENERGY=8_000_000blocks*100BuildingRodService.MAX_BLOCKS=4000
「+3 交互距离(携带即生效)」 updateReachBLOCK_INTERACTION_RANGE += 15-3ENTITY += 15PlayerTickEventHandler
特斯拉塔链式 40/30/20/10,最多 4 跳 strikeChain40.0F - jump*10.0Fjump<4
简化溜槽「槽内有物时拒绝新输入,不合并物品」 SimpleChuteBlockEntity.insertItem 空槽守卫
溢流溜槽 1 组、铁砧锤右击侧面开关溢流口 SLOT_COUNT=1OverflowChuteBlock.use()(只对非出入口方向生效,长按轮盘转朝向不冲突) ✅ 描述准确
物品分配器 16 组/单一种类/最远 16 格/份数=下落高度 SLOT_COUNT=16insertItem 同物品校验、MAX_DISTANCE=16splitToSpace(ceil(fallDistance))
骰子:均匀模式 0–15 等概率;真实模式 3d6;输出=点数和−3;需铁砧锤选中模式 UNIFORM_OUTCOMES 16 项恰好对应 scenario 0–15 各一次;RedstoneDiceInputListener 校验 AnvilHammerItem ✅ 精确
大红按钮:手持铁砧锤仍可按住 press() 仅排除 BUILDING_ROD,输入监听仅排除 BuildingRodItem.isHeld
口袋轮盘 [Ctrl+F] ModKeyMappings.POCKETS = CONTROL + GLFW_KEY_F
防候靴「站流体源、潜行下沉」/头盔「熔岩清晰视野」/全套「免环境伤害、不防虚空但阻止坠入」 对应 tooltip.anvilcraft.equipment.* 三语一致
呼吸头盔=铁质防护、防候甲>下界合金、用多相物质修复 EquipmentArmorItem IRON/NETHERITE + getDefense/getToughness 加成、isValidRepairItem

⚠️ 警告

  • 004_block/101_smart_block_placer.md(数值只改了一半) — 本 PR 把「范围放置」从 8kW 改为 16kW(正确:TargetMode.POSITION(16)),但同文件「蓝图模式」仍写 64kW,源码为 TargetMode.BLUEPRINT(128),且 getInputPower() 直接返回 target.getPower()。建议同批一并改为 128kW
  • 005_tool/101_functional_armor.md(跳跃高度表述) — 「press Space to jump up to 4 times as high」/ zh 同义。源码 EquipmentAbilities.MAX_JUMP_HEIGHT_MULTIPLIER = 3.5(游戏内 tooltip 为「最多可跳跃 4 格方块高」)。建议改为 3.5 倍 或「约 4 格高」,避免与 tooltip 冲突。
  • 005_tool/101_functional_armor.md(内容精简需确认) — 被删除的 101_ionocraft_backpack.md 原有 <info>「安装饰品/curio 模组后可放入饰品槽」,新页完全未提;同时物品 tooltip 中的「清空口袋后才能卸下护腿」(tooltip.anvilcraft.equipment.pockets)在口袋段落也缺失。我在 IonocraftBackpackItem 中未 grep 到 curio 相关引用,删除可能是有意的——请作者确认:若已移除饰品槽支持则忽略,若仍支持建议补回该提示。
  • 3 个新页面缺文件末尾换行101_functional_armor.md301_weatherproof_armor.md101_building_rod.md 的 diff 均带 \ No newline at end of file(全 diff 共 16 处)。建议统一补上,避免后续 diff 噪音。

💡 建议

  • zh_cn/002_material/140_void_matter.md — 新增「虚空物质块可通过溜槽等方块接收物品,输入物品会被直接销毁」。我确认了 CrateBlock.hasAdjacentVoidMatter(放板条箱旁开启溢出销毁),但在 BaseChuteBlockEntity / ItemHandlerUtil 路径中未找到虚空物质块自身接收物品的实现。请补充该描述的依据(若指激发态衰变或其它机制,建议明确写出)。
  • 章节索引页未同步 — 流程页一级标题由 # 1-Getting Started 之类的「编号前缀」改为纯标题(# Amethyst Detection …),各目录 index.md000_process/index.md 等)不在本 PR 中。请确认它们没有引用旧标题文本或锚点。
  • 补一句 pocket 段落的卸载前置条件(见上);301_weatherproof_armor.md 胸甲段「Stores an additional 160 MFE」建议去掉 “additional”,改为「自带 160 MFE,可在电网外飞行(耗电 100 kFE/s)」更贴合 tooltip...recharge
  • 标题建议 — 当前标题只提「物流元件与盔甲」,但本 PR 实际还新增 101_building_rod.md 并对 100 个文件做了大范围结构重排(H2→H1、导航 items 扩容、多处过时数值修正)。建议改为:
    Update guide book: add logistics / armor / building rod pages and fix outdated values 更新手册:新增物流、盔甲与建造杖页面并修正过时数值
    (本次未执行 gh pr edit,如需我可代改。)

🟢 看起来不错

  • 纯文档 PR 却做了源码级数值对账:悬浮机 16→2 kW、背包 64→8 kW、智能方块放置器 8→16 kW、下界合金机器 (Loop|15gt|0gt)(16gt|0gt),均为真实修正而非臆改。
  • 001_logistics.md 把 overflow_chute / item_splitter 的「均分」语义(含「除不尽留在自身、不参与本次分配」「遇遮挡顺延至 16 格」)写得与 splitToSpace / tryOverflowOutput 实现完全吻合,是本次质量最高的新页。
  • 删页→并页时未丢导航条目(原 chute 页 2 个 item 全部保留并新增 2 个)。
  • 中英双侧改动行数大体镜像(+/- 逐文件偏差 ≤5 行,属语言差异正常范围)。

结论: COMMENT — 无阻塞性缺陷,en/zh 对称与资源引用完整度都很干净;建议修正「智能方块放置器蓝图 64kW → 128kW」「buffer boots 3.5 倍」两处数值,并确认饰品槽/口袋卸载提示与虚空物质描述的依据后合并。

🧪 测试建议:本次无 Java/数据变更,跳过。


由 Hermes Agent 审查

@Gugle2308

Copy link
Copy Markdown
Collaborator

💾 Self-improvement review: Patched references/manual-asset-and-link-verification.md in skill 'documentation-pr-review' (1 replacement). · Patched SKILL.md in skill 'documentation-pr-review' (1 replacement).

@Gugle2308

Copy link
Copy Markdown
Collaborator

代码审查摘要 — PR #4945

操作: synchronize(已重新审查全部变更)
范围: 100 个文件 — 手册页 90 个(en_us 45 / zh_cn 45,集合完全一一对应)+ 结构/纹理资源 10 个;13 新增 / 5 删除;+1467 −521,138 hunks
diff 完整性: 首次下载曾被 CDN 截断(仅 72 文件),已重新下载校验:md5=d472dfa7e2c9c0cb050d49644c10bc9d、100 文件,与 API changed_files=100 一致,本审查基于完整 diff(目标分支 dev/1.21/1.6 = fe912815bf,源码为准)

✅ 已交叉核对(数值/机制声明 vs 目标分支源码)

手册声明 代码依据 结论
飘升机背包耗电 8 kW(旧文档 64kW) IonocraftBackpackItem.FLIGHT_POWER = new PowerConsumption(8)
飘升机耗电 2 kW(旧 16kW) IonocraftEntity.CONSUMPTION = new PowerConsumption(2)
智能方块放置器耗电 16 kW(旧 8kW) SmartBlockPlacerBlockEntity.TargetMode.POSITION(16)
特斯拉塔 128 kW / 4 秒 / 连锁 4 个 / 40·30·20·10 getInputPower()→128STRIKE_COOLDOWN_TICKS=4*20jump<440.0F - jump*10.0Finflate(4.0) 连锁搜索
加热器:<500s 补燃料、240s 可工作、每批 240s REFUEL_THRESHOLD=500*20LIT_THRESHOLD=240*20
建筑杖:8 MFE / 100 FE 每方块 / 4000 方块 / 携带 +3 触及距离 MAX_ENERGY=CapacitorItem.ENERGY=8_000_000blocks*100BuildingRodService.MAX_BLOCKS=4000;"携带即生效"来自 tooltip Grants crab claw reach while carried + CrabClawItem.RANGE_ATTRIBUTE_MODIFIER=3(作用于方块与实体)
物品分配器 16 组 / 最远 16 格 SLOT_COUNT=16MAX_DISTANCE=16
仓储流体端口 128 B / 50%~75% CAPACITY_MB=128*1000ADJUST_DRAIN_START=0.75 + 滞回注释
红石骰子=三骰之和−3,均匀模式 0~15 等概率 getFace(0)+getFace(1)+getFace(2)-3UNIFORM_OUTCOMES[random.nextInt(16)]
耐候盔甲 160 MFE / 12 格与 6 格口袋 / 铁质与超越下界合金防护 MAX_ENERGY=160_000_000pockets 12 : 6ArmorMaterials.IRON / NETHERITE + getDefense()+2/+3getToughness()+2/+1
存储站合成窗口需"消耗"工作台与切石机解锁 storage.isCraftingUnlocked(),破坏时返还 CRAFTING_TABLE/STONECUTER
胸甲能量不足时消耗背包内电容器 WeatherproofChestplateItem.tickEnergy 查找 IFullCapacitor 并补充
口袋轮盘 [Ctrl+F] ModKeyMappings.POCKETS = CONTROL + GLFW_KEY_F

🔴 关键

  • 无阻断性问题。

⚠️ 建议合并前处理

  1. 005_tool/101_functional_armor.md(en/zh)缓冲靴跳跃写成 4 倍,代码是 3.5 倍EquipmentAbilities.MAX_JUMP_HEIGHT_MULTIPLIER = 3.5multiplier = 1 + (3.5-1)*progress);游戏内 tooltip 写的是 up to 4 blocks height(说的是高度≈4 格,不是倍数)。建议改为「最多约 3.5 倍跳跃高度(约 4 格)」。
  2. index.md(en/zh)手册使用导引第 5 项的嵌套列表被拍平 — 三个条目由 - 降级为顶层 - ,不再是第 5 项(“……投影:”)的子条目。手册其它页仍在使用嵌套列表且渲染正常,建议恢复缩进。
  3. 4 个新增文件缺末尾换行en_us/005_tool/101_functional_armor.mden_us/005_tool/301_weatherproof_armor.mden_us/006_prop/101_building_rod.mdzh_cn/006_prop/101_building_rod.md;其中前两个 zh 侧有换行、en 侧没有,两侧不一致。

💡 建议(非阻断)

  1. en_us/000_process/003.mdinstead of a cauldron ? the former can serve as a container 里的 ? 是笔误(zh 侧用 ,同 PR 的 004.md);同一 hunk 还把 <warning> 的 em dash 改成了半角 -important concepts - be sure),建议统一为
  2. en_us/000_process/015.md 重排时删掉了唯一一句 Use it to accelerate mass accumulation in the <ref item="anvilcraft:space_overcompressor"/>.(zh 侧本就没有),导致 ## Mass Producing spacetime_supercomputer## Mass Producing mass_energy_inverter 现在都是空标题 —— 建议补内容或合并两节。
  3. 004_block/001_redstone.md(en/zh):红石骰子小节缺少 <recipe id="anvilcraft:redstone_dice"/>(同页大按钮、同 PR 的溢流口/物品分配器都有配方展示),配方在目标分支确实存在,建议补上。
  4. 003_power/201_heat_collection.md:zh 侧重排了整张可集热方块表格(对齐),en 侧未同步;两侧数值一致(2/4/4/4/4/16/64/256),只是格式不同。
  5. 006_prop/101_ionocraft_backpack.md 合并进 101_functional_armor.md 时丢了两条仍然成立的行为说明:①缓降途中重新入网恢复飞行、落地后入网只获得能力不自动起飞(IonocraftBackpackItem.refreshFlightresumeFlight 与"触地优先结束本次缓降"注释);②背包不储电、不能用电容器充能(IonocraftBackpackItem 无能量组件)。旧页的 curio 饰品栏说明删除是对的 ✅(data/curios 现仅 charm/head 标签)。
  6. zh_cn/006_prop/101_building_rod.md## 额外特性 前多一个空行(en 侧没有)。
  7. 000_process/003.md 移除 [炼药锅增强](../001_feature/000_cauldron.md) 链接后,该页在流程页中的入口消失(页面本身仍在),建议在别处保留入口。

🟢 看起来不错

  • 多语对称性优秀:en/zh 页面集合完全一致(45 vs 45),新增/删除成对(001_chute.md001_logistics.md101_ionocraft_backpack.md101_functional_armor.md),无单侧遗漏;导航 items 由 2 项扩展为 4 项(新增 overflow_chute、item_splitter),旧入口无丢失。
  • 资源迁移完整anvil_workstation.snbt.nbt 全库无残留 .snbt 引用;被删两个页面在目标分支除本 PR 已更新的引用外无其他引用(无死链)。
  • 5 个新增资源全部被引用(p2_topaz.nbt / item_splitter.nbt / anvil_workstation.nbt / structure_scanner.png / ionocraft_backpack.png),无孤悬文件;二进制校验通过(PNG 魔数 89504e47,1016×69 与 1294×1006;NBT 1f8b0800 gzip)。
  • 抽查 16 个 <recipe id>super_heating/heated_netherite_blockitem_crush/capacitorexp_collector_altcharger_charging/magnet_blockbig_red_buttonoverflow_chuteitem_splitterstorage_fluid_portweatherproof_coretwo_to_one_smithing/*breathing_helmetpockets_leggingsbuffer_bootsbuilding_rodredstone_dicestructure_scanner)均存在于目标分支生成资源。
  • 修正了多处旧文档错误并补齐缺失信息(背包/飘升机/放置器耗电、特斯拉塔连锁伤害、脉冲发生器 15gt→16gt、加热器补料阈值、存储站翻转/撤回、扫描仪导入导出、新红石元件等)。

📋 声称验证表

声称 状态 对应文件
新增物流元件页面 004_block/001_logistics.md(en/zh,替换 001_chute.md)
新增盔甲页面 005_tool/101_functional_armor.md005_tool/301_weatherproof_armor.md
修订流程页 000_process/001–015index.md
修订机器页 009_machine/001_iron.md201_gem.md201_netherite_block.md
标题未覆盖:新增建筑杖页 / 结构扫描仪导入导出 / 新红石元件 ⚠️ 006_prop/101_building_rod.md004_block/101_structure_scanner_alternative.md004_block/001_redstone.md

结论: COMMENT(可合并,建议先处理 ⚠️ 三项) — 手册内容准确度很高,我抽查的所有数值与机制声明均与目标分支源码一致;未发现结构错误或内容丢失导致的问题。

标题: gh auth status 显示 token 已失效(/opt/data/home/.config/gh/hosts.yml invalid),本次未自动修改标题。建议标题:
Update the guide book: logistics, armor and building rod pages 更新手册:新增物流元件/盔甲/建筑杖页面,修订流程与机器页

实机验证建议(静态检查之外): 打开手册确认三处新增 <structure>(p2_topaz / anvil_workstation / item_splitter)与两张截图正常渲染、<item>/<recipe> 标签无报错——资源存在性与相对路径已核对通过,渲染仍需游戏内确认。


由 Hermes Agent 审查

@Gugle2308

Copy link
Copy Markdown
Collaborator

💾 Self-improvement review: Patched SKILL.md in skill 'documentation-pr-review' (1 replacement). · Patched references/manual-asset-and-link-verification.md in skill 'documentation-pr-review' (1 replacement).

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.

4 participants