agentmc

jianf/agentmc

Fork 0

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	16f2e04fff	架构重构：差异全部下移到 Java，Python 只做路由用户口径：差异放在 Java 层，Python 相当于路由。下移到 Java（新增 cmd=setblocks）： Python 只发 RLE（[[stateId,count],...]），Java 用官方 API 完成调色板组装 / 位打包 / 官方序列化 / 入 cache / 渲染。 ★ 意外收益：走 ClientboundLevelChunkPacketData(chunk).getReadBuffer() + replaceWithPacketData(...) 这条官方路径，两代签名完全一致 ⇒ 原先的 Storage.chunks 反射注入整段删掉。新增 cmd=capacity：世界尺寸（sectionsCount/minSection/defaultBiome）由运行时回答，Python 不再硬编码 24/-4（1.16 时代是 16/0）。 Python 侧删除（防回归，见 test_import_surface）： render_bridge.py（旧桥，无世代概念） render._pack/_long_array/_encode_paletted/_encode_chunk/_varint anvil.encode_block_section/encode_chunk_payload/save_chunk_to_payload 合计 454→374 行（render.py）、300→177 行（anvil.py）保留在 Python（都是「不随版本变」的知识）： RLE 压缩（rle_encode/rle_decode，具名可测）存档读取（region/NBT）方块名→id 的路由（查询在 Java） NDJSON 协议测试：62 项单元 + 6 项渲染联测全绿新测试反映新架构：RLE 边界、运行时容量、世代分派、新路径渲染 test_anvil 里原有 8 项协议位打包测试已删（那已下移到 Java，由两代后端各自的编译验证覆盖）新增 scaffold/ARCHITECTURE.md（分层原则 + 加新世代步骤 + 防回归清单）	2026-09-25 19:21:45 +08:00
JianFeeeee	391d452c85	P9：Python 包装层 —— 真实存档 → 官方渲染器 → 出图新增两模块： mcfold/anvil.py 存档读取（region/NBT）+ 区块编解码工具 mcfold/render_bridge.py 桥：常驻 Java 渲染器进程，NDJSON 协议 mcfold/render.py 对外入口：WorldRenderer（存档→画面） scaffold/McfoldRenderServer.java Java 侧服务端（常驻，NDJSON）实测（真实存档 mc-test，DataVersion 3465=1.20.1）： injected=81 unknownBlocks=0 uniqueSpecs=111 loadedChunks=81 chunksRendered=60 distinctColors=11585 画面：草地/沙滩/树/水/天空/太阳/HUD（sample-real-save-render.png） ★ 分工落在实处（附录 D 的结论变成代码）：存档 palette 是方块名（minecraft:oak_log[axis=y]），网络载荷要 state id，名字→id 的权威映射只有客户端注册表有 ⇒ 新增 resolve 命令， Java 侧用 BlockStateParser.parseForBlock 解析（实测 111 种全中，0 unknown）踩坑（本轮新发现）： 1. level.dat 有两种布局（8字节头+zlib / 直接 gzip）—— 实测本机是后者 2. section 索引 ≠ 绝对 Y：存档用 -4..19，载荷用 0..23（少这步 → readerIndex 越界） 3. 注入前必须 set_viewport，否则 ClientChunkCache.inRange 丢弃区块 4. setPos 不会更新实体区块归属，要 setPosRaw + updateViewCenter 5. 生物群系只影响着色，用统一 plains 不影响「能渲染出世界」 6. camera 回包要用 JsonArray，字符串会被 Python tuple() 按字符拆开性能：启动 66s（GL+资源重载），之后每帧渲染 ~1s（含 100 帧 tick）	2026-09-25 17:33:41 +08:00

Author

SHA1

Message

Date

JianFeeeee

16f2e04fff

架构重构：差异全部下移到 Java，Python 只做路由

用户口径：差异放在 Java 层，Python 相当于路由。

下移到 Java（新增 cmd=setblocks）：
  Python 只发 RLE（[[stateId,count],...]），Java 用官方 API 完成
  调色板组装 / 位打包 / 官方序列化 / 入 cache / 渲染。

★ 意外收益：走 ClientboundLevelChunkPacketData(chunk).getReadBuffer()
  + replaceWithPacketData(...) 这条官方路径，两代签名完全一致
  ⇒ 原先的 Storage.chunks 反射注入**整段删掉**。

新增 cmd=capacity：世界尺寸（sectionsCount/minSection/defaultBiome）
  由运行时回答，Python 不再硬编码 24/-4（1.16 时代是 16/0）。

Python 侧删除（防回归，见 test_import_surface）：
  render_bridge.py（旧桥，无世代概念）
  render._pack/_long_array/_encode_paletted/_encode_chunk/_varint
  anvil.encode_block_section/encode_chunk_payload/save_chunk_to_payload
  合计 454→374 行（render.py）、300→177 行（anvil.py）

保留在 Python（都是「不随版本变」的知识）：
  RLE 压缩（rle_encode/rle_decode，具名可测）
  存档读取（region/NBT）
  方块名→id 的路由（查询在 Java）
  NDJSON 协议

测试：62 项单元 + 6 项渲染联测全绿
  新测试反映新架构：RLE 边界、运行时容量、世代分派、新路径渲染
  test_anvil 里原有 8 项协议位打包测试已删（那已下移到 Java，
  由两代后端各自的编译验证覆盖）

新增 scaffold/ARCHITECTURE.md（分层原则 + 加新世代步骤 + 防回归清单）

2026-09-25 19:21:45 +08:00

JianFeeeee

391d452c85

P9：Python 包装层 —— 真实存档 → 官方渲染器 → 出图

新增两模块：
  mcfold/anvil.py        存档读取（region/NBT）+ 区块编解码工具
  mcfold/render_bridge.py 桥：常驻 Java 渲染器进程，NDJSON 协议
  mcfold/render.py       对外入口：WorldRenderer（存档→画面）
  scaffold/McfoldRenderServer.java  Java 侧服务端（常驻，NDJSON）

实测（真实存档 mc-test，DataVersion 3465=1.20.1）：
  injected=81  unknownBlocks=0  uniqueSpecs=111
  loadedChunks=81  chunksRendered=60  distinctColors=11585
  画面：草地/沙滩/树/水/天空/太阳/HUD（sample-real-save-render.png）

★ 分工落在实处（附录 D 的结论变成代码）：
  存档 palette 是**方块名**（minecraft:oak_log[axis=y]），网络载荷要 **state id**，
  名字→id 的权威映射只有客户端注册表有 ⇒ 新增 resolve 命令，
  Java 侧用 BlockStateParser.parseForBlock 解析（实测 111 种全中，0 unknown）

踩坑（本轮新发现）：
  1. level.dat 有两种布局（8字节头+zlib / 直接 gzip）—— 实测本机是后者
  2. section 索引 ≠ 绝对 Y：存档用 -4..19，载荷用 0..23（少这步 → readerIndex 越界）
  3. 注入前必须 set_viewport，否则 ClientChunkCache.inRange 丢弃区块
  4. setPos 不会更新实体区块归属，要 setPosRaw + updateViewCenter
  5. 生物群系只影响着色，用统一 plains 不影响「能渲染出世界」
  6. camera 回包要用 JsonArray，字符串会被 Python tuple() 按字符拆开

性能：启动 66s（GL+资源重载），之后每帧渲染 ~1s（含 100 帧 tick）

2026-09-25 17:33:41 +08:00

2 Commits