minecraft-dev

dsh plugin --profile web add minecraft-dev

minecraft-dev

 

Minecraft 开发插件 for DeepSeek Harness（dsh）：让 agent 更擅长写 Minecraft 服务端插件与模组，覆盖 MC 1.7.10 ~ 26.3 全时代。v0.12 起提供三样别处没有的东西：18 份离线 API 签名索引（references/api-index/，钉选线从 1.7.10 到 26.3）、确定性分片流水线 mc_arbitrate（契约冻结 → brief → 审计 → 合并 → 编译 → 定点路由，全程不调模型）、21 条高置信静态审计规则（含 5 条跨分片检查）。许可以 Apache-2.0 + NOTICE 发布。

English: a Minecraft development plugin for DeepSeek Harness: Paper/Spigot plugins and Fabric/Forge/NeoForge mods across MC 1.7.10-26.3, 18 offline API signature indexes generated from the pinned artefacts, and a deterministic sharded pipeline (mc_arbitrate) - contract freeze, per-shard briefs, 21 audit rules, merge, compile-error routing - with no model call inside the engine. Apache-2.0 with NOTICE.

适配 dsh ≥ 0.1.5-rc.1（profile/bundle 插件体系；低于此版本请用 0.7.0 及更早版本），覆盖三条线：0.1.5-rc.x（目录形态 preset）、0.1.7-rc.x（agentPresets 声明形态；0.1.5~0.1.6 仍是 $DSH_HOME/.agent-presets 目录）、0.2.0-rc.x / 0.2.1-rc.x。实测过：0.1.5-rc.2、0.1.7-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.5（2026-10-29，独立 profile 实跑）。0.2.2-alpha 未实测 —— peer 会放行但 API 未逐条核对。⚠️ dsh 0.2.0 起有插件兼容性门禁（evaluatePluginCompatibility）：@deepseek-ai/dsh* peer 与运行版本不匹配会拒绝整包，不是警告。

已被 awesome-dsh-plugin 收录（Skills 分类）。

⚠️ dsh 0.2.1 把子代理的 persona / toolFilter 删了（@deepseek-ai/dsh-tool-subagent）：这两个键现在会直接抛错 —— "no longer supported; configure persona and tool plugins in an Agent Preset and select it with agentPreset (spawn only)"；backgroundMode / enableRunInBackground 也一并消失（写了不报错，但完全不生效）。因此自 v0.10.0 起，A–D 四个角色的"人设 + 工具范围"改为 4 个 Agent Preset（mc-plan / mc-skeleton / mc-content / mc-verify，见 preset/roles.js），宿主层的 4 行只剩 provider / toolName / agentPreset / maxDepth。同时 0.2.1 的委派一律异步：调用立即返回 id、完成时通知，角色人设里已写明结果要放在最后一条消息里。

兼容性：agentPreset 在 ≤ 0.2.0 上会被静默忽略（schemastery 保留未知键、旧版工具也不读它），所以同一份配置在旧版本上仍然挂载成功，只是那 4 个子代理不带角色人设 —— 旧版本用户可直接选择对应的 preset 来获得角色。详见 test/subagent-rows.test.js。

⚠️ 人设模板只能用 {{model}}（和 {{provider}}）：dsh-system-prompt 会对每个 {{name}} 做注册表校验，未注册的直接抛错，在模型请求发出之前就让该轮失败：

unknown prompt variable "{{cwd}}" in section "deployment:persona-prefix"; registered variables: provider, model。

dsh 0.2.1 的 dsh-agent 只注册 provider 与 model，没有 cwd/workspace 之类的变量。v0.10.0 的人设里写了 {{cwd}}，选择 Minecraft 系预设后首轮即失败（issue #3），v0.10.1 已修复（去掉该变量与只为插它而存在的 persona.suffix 行）。test/persona-variables.test.js 现在把可用变量钉死为 provider/model。

⚠️ dsh 0.2.0 起有插件兼容性门禁（dsh-app-boot 的 evaluatePluginCompatibility）：导入插件前拿它的 @deepseek-ai/dsh / @deepseek-ai/dsh-* peer 声明与运行版本比对，任一条不匹配就拒绝导入整包 —— 不是警告，是拒绝安装/整包被跳过（工具、技能、preset 全部消失，且 App 里可能只表现为"插件装了但没反应"）。而 node-semver 无法用单条范围表达"这些线的任意预发布版"（^0.1.5-rc.1 即使带 includePrerelease 也不匹配 0.2.0-rc.2），所以 peer 必须逐条枚举；新增 dsh 线时同步加一条，否则插件会静默失效。详见 test/peers.test.js。

万一 dsh 又先发了新线而本插件还没跟上，可以用门禁自带的精确版本豁免兜底（自担风险，仅对那一个版本生效）：dsh plugin --profile <name> allow-version minecraft-dev@<版本> --dsh-version <运行版本> --accept-risk。

dsh 0.1.7 起 preset 的声明方式变了，本插件两种都支持并在运行时自动选择：0.1.5–0.1.6 的 preset 是 $DSH_HOME/.agent-presets/<id>/ 目录（插件启动时拷贝，已存在则不覆盖本地修改）；0.1.7 起 preset 改为 Cordis 声明行（@deepseek-ai/dsh-agent-preset）交给 agentPresets 服务，插件随之改用 agentPresets.register() 提交同一批行（preset/*/rows.js）。两种形态由同一个源生成，并由测试锁死一致。

许可：v0.12.0 起 [Apache-2.0](LICENSE) + [NOTICE](NOTICE)；此前版本仍为 MIT。源码：GitHub｜npm：minecraft-dev（线上 latest 为 0.10.1，0.12.x 尚未发布）。

功能一览

9 个技能（模型按需加载，不占常驻上下文）

技能 · 内容

minecraft-java-build · 全时代 Java/Gradle 构建知识：JDK 配对表、wrapper、foojay toolchain、依赖仓库、常见坑

minecraft-paper-plugin · Paper/Spigot 现代线插件（1.20.x / 1.21.x / 26.x）+ 5 份 API 参考

minecraft-fabric-mod · Fabric 模组（loom/loader/fabric-api/yarn 配合）+ 4 份 API 参考

minecraft-forge-mod · 传统 Forge 四时代（1.7.10 FG2 / 1.12.2 FG3 / 1.16.5 FG5 / 1.20.1 FG6）+ 3 份时代 API 参考

minecraft-neoforge-mod · NeoForge（1.20.1 legacyforge / 1.21.1 / 1.21.x / 26.2 stable + 26.3 beta-only）+ 3 份 API 参考

minecraft-spigot-legacy · 1.7.10 / 1.12.2 老线 Bukkit 插件 + Cauldron/Thermos/Mohist 混合服说明 + 2 份老线 API 参考

minecraft-major-mods · 大型模组附属开发：28 个模组条目（1.7.10×10 / 1.12.2×8 / 现代×10，含拔刀剑、神秘时代、匠魂、植物魔法、Create、Botania、AE2、Mekanism、Curios、JEI/REI 等），每条含核实过的 curse.maven 坐标与扩展点

minecraft-intake · 任务信息核对（v0.7）：用户请求写插件/mod/附属但信息不足时，按场景批量提问（版本/平台/加载器/核心/混合端/兼容性/部署），一次问全、不重复问、授权默认

minecraft-swarm · 分片仲裁（v0.12）：mc_arbitrate 的 7 个 action——契约冻结（含线程模型/API 白名单）、三段式 brief、21 条审计规则、合并、编译错误定点路由、升级材料、状态汇总

3 个工具

工具 · 用途

mc_scaffold · 一句话创建完整可构建项目：paper / fabric / forge / neoforge / spigot 五平台，自动配好构建脚本、主类、元数据、时代对应的 Gradle wrapper

mc_gradle · 在项目里跑 gradlew <task>：终端卡片显示、超时自动杀进程树、输出头尾截断、非零退出码不报错而是可读呈现

mc_codex · 只在「Minecraft 架构师」预设里可用：把架构 brief 写到 <项目>/.dsh/codex-architect.md，再用你自己的 Codex CLI 跑一次完全可见的架构会话——默认走官方 codex app-server --stdio 协议（会话会出现在 Codex 桌面版列表里、可续聊），也可 mode: "exec" 退回 codex exec；命令、完整输出、退出码、用时、改动文件、会话 id/线程 id、rollout 路径、token 用量全部回到会话里

4 个内置子代理（v0.5.0，四子代理团队）

子代理（toolName） · 环节与产出

subagent_mc_plan · A 方案：勘察项目 + web_search 联网查证 → 写 <项目>/PLAN.md + 5 行摘要

subagent_mc_skeleton · B 框架：按 PLAN.md 用 mc_scaffold 搭骨架 + 资源模板 + 测试桩 → 变更清单

subagent_mc_content · C 内容：按 PLAN.md 与骨架填充功能代码 → 变更清单 + 不确定点

subagent_mc_verify · D 编译审查：mc_gradle 编译/测试、修小错 → 验证报告

（注：4 个子代理为宿主层工具，任何 preset 会话可见；使用说明见 Minecraft 专家 preset persona。）

2 个 Agent 预设

预设 · 内容

minecraft

…(truncated)