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 起有插件兼容性门

许可：v0.12.0 起 Apache-2.0 + NOTICE；此前版本仍为 MIT。源码：GitHub｜npm：minecraft-dev（线上 latest 为 0.10.1，0.12.x 尚未发布）。 功能一览 9 个技能（模型按需加载，不占常驻上下文） 3 个工具 4 个内置子代理（v0.5.0，四子代理团队） （注：4 个子代理为宿主层工具，任何 preset 会话可见；使用说明见 Minecraft 专家 preset persona。） 2 个 Agent 预设 Minecraft 架构师：Codex 做架构，DSH 填内容（v0.8.0）

分工照搬 Cherry Studio 里的 Architect / Coder 两个智能体（// [TODO: Agent B] 描述 标记就是交接协议）：

1. DSH 先按 minecraft-intake 把版本/平台/加载器核对清楚，整理成一段 goal； 2. 点名后调用 mc_codex：它把架构 brief 写到 /.dsh/codex-architect.md（可读可改），然后用你自己的 Codex在项目目录里跑一次架构会话。默认 mode: "app-server"，实际执行的是 "…codex.exe" app-server --stdio 协议（thread/start + turn/start，prompt 就是那个文件的内容）——这条命令原样回显在会话里；mode: "exec" 时则是 "…codex.exe" exec - -C " " -s workspace-write --skip-git-repo-check -o " /.dsh/codex-last-message.md" /.dsh/codex-architect.md" 3. Codex 只写骨架：接口/签名/build 脚本/资源模板/主类注册，所有业务逻辑方法体留 // [TODO: Agent B] 描述，并额外产出 FILL-SPEC.md（标记位置 × 方法契约 × 构建命令 × UNVERIFIED 清