v0.5.1 — docs & packaging polish

v0.5.1 — public beta

文档与打包整备版（功能与 v0.5.0 一致）。

变更

• 重写 README 封面（banner / badges / 能力 / 快速开始 / 架构 / 截图）。
• 新增完整说明书 docs/MANUAL.md（架构、工具、卡片 DSL、团队、测试、排障、二次开发）。
• 删除草稿和中间报告（方案草稿、M1/M2/M3/M4-* 过程文档、临时文件）。
• 截图统一到 docs/assets/。
• 安装/状态/团队/发布文档同步到 0.5.x 实现。
• 插件 preset 工具列表同步为 14 个工具。

附件

• minecraft-mod-dev-0.5.1.zip
• mcdev_probe-0.1.0-dev.jar

校验：

minecraft-mod-dev-0.5.1.zip SHA256 0F4D3127A9D7724561A2066EF8E3865E0C94F88FFFC4E655C3F35CD70AB8452B
mcdev_probe-0.1.0-dev.jar SHA256 56BF82B7B158BB9AAFE5FD184BFD20B4BC6738E5EBDCD85A2302B9CBAA08DF52

文档

• README
• 完整说明书
• 安装
• 演示

v0.5.0 — public beta

v0.5.0 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针。

Highlights

• craft action：服务端 /craft 检查/消耗在线玩家背包材料并产出 result；F-004 crafted=true。
• quickPlay 根因修复：runClient 移除 quickPlay；客户端到 TitleScreen 后 probe /connect 显式连接；连续 3 次 kind=both attempt1 joined。
• 客户端挖掘：/player/mine 直接发 START_DESTROY_BLOCK 包，服务端权威；F-007 block air + charger×1。
• F-001..F-007 live；GameTest 12/12。
• 视觉证据：F-003 tooltip、F-005 raycast/toast、F-006 热栏能量条。
• 演示文档 docs/DEMO.md。

附件

• minecraft-mod-dev-0.5.0.zip
• mcdev_probe-0.1.0-dev.jar

校验：

minecraft-mod-dev-0.5.0.zip SHA256 AE70FA7A218490929479BD68AF172E17B82D83B43BE6F455A78F0068D0F727C2
mcdev_probe-0.1.0-dev.jar SHA256 56BF82B7B158BB9AAFE5FD184BFD20B4BC6738E5EBDCD85A2302B9CBAA08DF52

快速开始

见 docs/INSTALL.md 与 docs/DEMO.md。

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 实验性
• 客户端本地 block 状态可能短暂滞后，以服务端 /world/block 为准

v0.4.1 — public beta

v0.4.1 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针。

Highlights

• 生存挖掘完成：修复 charger 缺 mineable/pickaxe 标签；F-007 用服务端在线玩家 survival mine 验证 removed=true + charger×1。
• 新增 ui_close / close_ui、mine action；F-007 先关 GUI 再挖。
• F-001 补 data merge block Energy:5000（comparator floor 问题）；F-004 补 kill @e[type=item]（残留掉落）。
• F-001..F-007 全量顺序执行 ok=true, warnings=[]。
• F-003 tooltip、F-005 raycast/toast、F-006 热栏能量条截图证据齐全。
• mcdev_prepare 最多 3 次客户端等待/重试。
• Charger：GameTest 12/12；5/5 注入 bug 修复。

附件

• minecraft-mod-dev-0.4.1.zip：插件目录
• mcdev_probe-0.1.0-dev.jar：dev-mapped 探针（仅 dev run）

校验：

minecraft-mod-dev-0.4.1.zip SHA256 166E63242A62A7653043257FE3A2585EC24263D5A806E01AD05E74B2B25C331D
mcdev_probe-0.1.0-dev.jar SHA256 F7ECA4FF3AC0F8E78E3FEDB0F332A8255522B7801D2F7B9FBEB735D87A37107A

快速开始

见 docs/INSTALL.md：

1. 解压插件 zip，plugin_manager install_bundle target=/minecraft-mod-dev
2. 把 mcdev_probe-0.1.0-dev.jar 放进 /mods（或 mcdev_install_probe）
3. mcdev_prepare projectDir=/lab/forge-1.20.1-test kind=both
4. mcdev_gametest projectDir=... → 12/12
5. mcdev_stop side=all

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 实验性
• quickPlay 偶发 handshake 卡死：clean devJar + 3 次重试 + attempts 诊断，根因未完全定位
• 客户端 keyAttack 端点仍实验性；F-007 使用确定性的服务端玩家挖掘
• craft action 未实现；F-004 用 recipe_output 断言

v0.4.0 — public beta

v0.4.0 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针。

Highlights

• 14 个 mcdev_* 工具
• 修复生存挖掘：charger 缺 mineable/pickaxe 标签，之前玩家挖掘无掉落；已补标签。
• F-007 卡片 live：客户端 keyAttack 生存挖掘 → 方块 air → ItemEntity charger×1，warnings=[]
• 新增 mine / client_mine / items 步骤与 loot_mine / block_state / loot_items 断言
• F-003 tooltip、F-005 raycast/toast、F-006 热栏能量条均有截图证据
• mcdev_prepare 最多 3 次客户端等待/重试
• Charger：GameTest 12/12；5 个注入 bug 5/5 修复

附件

• minecraft-mod-dev-0.4.0.zip：插件目录（plugin/minecraft-mod-dev）
• mcdev_probe-0.1.0-dev.jar：dev-mapped 探针（仅 dev run；需 clean devJar 后安装）

校验：

minecraft-mod-dev-0.4.0.zip  SHA256 FD50EB2B6BFF09A3789F4635E7D70FA889AEBCFB2BA3B715D6004B96161120CE
mcdev_probe-0.1.0-dev.jar    SHA256 F7ECA4FF3AC0F8E78E3FEDB0F332A8255522B7801D2F7B9FBEB735D87A37107A

快速开始

见 docs/INSTALL.md：

1. 解压插件 zip，plugin_manager install_bundle target=<dir>/minecraft-mod-dev
2. 把 mcdev_probe-0.1.0-dev.jar 放进 <runDir>/mods（或用 mcdev_install_probe）
3. mcdev_prepare projectDir=<repo>/lab/forge-1.20.1-test kind=both
4. mcdev_gametest projectDir=... → 12/12
5. mcdev_stop side=all

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 实验性
• quickPlay 偶发 handshake 卡死：clean devJar + 3 次重试 + attempts 诊断，根因未完全定位
• craft action 未实现；F-004 用 recipe_output 断言

v0.3.9 — public beta

v0.3.9 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针。

Highlights

• 14 个 mcdev_* 工具
• mcdev_scenario 卡片断言：
  • recipe_output（/recipe）
  • loot_drop（/loot）
  • loot_break（/world/break，实际破坏方块 + ItemEntity 收集）
  • item_bar（/item）
• F-004 live：recipe×1、loot total=1、loot_break removed=true + drops charger×1，warnings=[]
• F-006 live：item_bar visible/width=6/color=65280；客户端热栏截图验证绿色 6/13 条
• F-001/F-002 live 通过
• 团队卡片执行：Tester 跑卡 + Reviewer 只读复核 + Lead 修正 setup give 静默失败
• mcdev_prepare 最多 3 次客户端等待/重试；恢复演练 attempt3 joined
• Charger：GameTest 12/12；5 个注入 bug 5/5 修复

快速开始

见 docs/INSTALL.md：

1. plugin_manager install_bundle target=<repo>/plugin/minecraft-mod-dev
2. cd lab/mcdev-probe && .\gradlew.bat clean devJar
3. mcdev_install_probe ...
4. mcdev_prepare projectDir=<repo>/lab/forge-1.20.1-test kind=both
5. mcdev_gametest projectDir=... → 12/12
6. mcdev_stop side=all

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 实验性
• quickPlay 偶发 handshake 卡死：clean devJar + 3 次重试 + attempts 诊断，根因未完全定位
• F-004 loot_break 是服务端 destroyBlock + 掉落收集，不是客户端玩家采矿
• craft action 未实现；F-004 用 recipe_output 断言
• 当前是本地 link 安装

v0.3.8 — public beta

v0.3.8 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针。

Highlights

• 14 个 mcdev_* 工具
• mcdev_scenario 卡片断言扩展：
  • recipe_output（/recipe）
  • loot_drop（/loot）
  • item_bar（/item，visible/width/color）
• F-004 live：recipe=examplemod:charger×1、loot total=1，warnings=[]
• F-006 live：item_bar visible=true/width=6/color=65280，warnings=[]
• F-001/F-002 live 通过
• mcdev_prepare 最多 3 次客户端等待/重试；恢复演练 attempt3 joined
• Charger：GameTest 12/12；5 个注入 bug 5/5 修复

快速开始

见 docs/INSTALL.md：

1. plugin_manager install_bundle target=<repo>/plugin/minecraft-mod-dev
2. cd lab/mcdev-probe && .\gradlew.bat clean devJar
3. mcdev_install_probe ...
4. mcdev_prepare projectDir=<repo>/lab/forge-1.20.1-test kind=both
5. mcdev_gametest projectDir=... → 12/12
6. mcdev_stop side=all

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 实验性
• quickPlay 偶发 handshake 卡死：clean devJar + 3 次重试 + attempts 诊断，根因未完全定位
• craft action 未实现；F-004 用 recipe_output 断言验证配方
• 当前是本地 link 安装

v0.3.7 — public beta

v0.3.7 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针。

Highlights

• 14 个 mcdev_* 工具
• mcdev_scenario：YAML 卡片、dryRun、give.select/select_item、block/comparator analog、wait
• mcdev_prepare：客户端最多 3 次等待/重试，Disconnected 提前失败，返回 attempts 诊断
  • 恢复演练：attempt1/2 Disconnected → attempt3 joined
• F-001/F-002 卡片 live 全过
• Charger：GameTest 12/12；5 个注入 bug 5/5 检出并修复
• 团队：Builder/Tester 实现 F-006；Builder/Reviewer 修 bug

快速开始

见 docs/INSTALL.md：

1. plugin_manager install_bundle target=<repo>/plugin/minecraft-mod-dev
2. cd lab/mcdev-probe && .\gradlew.bat clean devJar
3. mcdev_install_probe ...
4. mcdev_prepare projectDir=<repo>/lab/forge-1.20.1-test kind=both
5. mcdev_gametest projectDir=... → 12/12
6. mcdev_stop side=all

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 实验性
• quickPlay 偶发 handshake 卡死：已加 clean devJar + 3 次重试 + attempts 诊断，根因未完全定位
• 当前是本地 link 安装

v0.3.0 — public beta

v0.3.0 — public beta

DeepSeek Harness 插件 + Minecraft 1.20.1 Forge 探针，用于 AI 团队写模组、跑 GameTest、开真实客户端、点 UI、截图、修 bug。

Highlights

• 14 个 mcdev_* 工具：status / command / ui / click / use / screenshot / run_dump / install_probe / scenario / build / gametest / prepare / stop / launch_status
• mcdev_prepare 自动启动 server/client 并等待 probe ready
• mcdev_scenario 步骤执行器（status/command/use/ui/click/screenshot/run_dump/wait/assert）
• mcdev_install_probe 校验 *-dev.jar + MixinConfigs
• Charger reference mod：GameTest 12/12；5 个注入 bug 5/5 检出并修复
• 团队流程：Builder/Tester 实现 F-006；Builder/Reviewer 修 bug 演练
• 文档：安装、工具、团队、排错、状态、演示

快速开始

见 docs/INSTALL.md：

1. plugin_manager install_bundle target=<repo>/plugin/minecraft-mod-dev
2. cd lab/mcdev-probe && .\gradlew.bat devJar
3. mcdev_install_probe ...
4. mcdev_prepare projectDir=<repo>/lab/forge-1.20.1-test kind=both
5. mcdev_gametest projectDir=<repo>/lab/forge-1.20.1-test → 12/12

已知限制

• 仅 Windows + Minecraft 1.20.1 + Forge 47.4.x + Java 17 + DSH 0.2.1-rc.2
• 探针 Mixin dev-only；生产 SRG 未支持
• Agent Teams 是实验性的
• 当前是本地 link 安装，不是正式 npm 包