minecraft-dev

Minecraft 开发插件 for DeepSeek Harness (dsh)：让 agent 更擅长写 Minecraft 服务端插件与模组，覆盖 MC 1.7.10 ~ 26.3 全时代。适配 dsh ≥ 0.1.5-rc.1（profile/bundle 插件体系；低于此版本请用 0.7.0 及更早版本），覆盖三条线：0.1.5-rc.x（目录形态 preset）、0.1.7-rc.x（agentPresets 声明形态）、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。

已被 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）。两种形态由同一个源生成，并由测试锁死一致。

已发布 npm：minecraft-dev（MIT）｜ 源码：GitHub

功能一览

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

…