jcs130/dsh-minecraft-agent ↗★ 4
@jcs130/dsh-minecraft-agent
DeepSeek Harness host adapter for the independent Minecraft SDK, with shared visualization and optional server capability packs.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jcs130/dsh-minecraft-agent说明文档
阅读完整 README ↗配置
- Node.js 24,在 DSH 中配置并选择默认模型。安装插件后,点击侧栏 Minecraft,填写服务器地址、角色名与登录方式,再点击 保存并连接游戏。首次任务可留空,先连接;之后在右侧原生会话里下达任务。无需另填模型密钥或手写 JSON。
- 协议默认
auto,交给 Mineflayer 识别服务器,也可显式指定 1.21.11 等受支持版本;正版首次连接需微软授权。已有登录服账号可在可选设置填/login密码,插件不自动注册账号。千灯纪邀请身份请沿用专用接入流程,不能绕过激活直接建号。 - 首次配置保存在当前 DSH profile 的私有目录;同一服务器与身份续用自己的数据和会话,不同身份隔离。停止并配置先正常停止本插件的身体,保留目标、会话与记忆,然后允许修改。停止意图会持久化,重启不会擅自恢复。
- 高级部署仍可将 mc-harness 的 configFile 指向私有 JSON,显式设置 enabled、name、dataDir、personaFile、DSH provider/model、contextTokens/maxTokens、minecraft.host/port/username。该路径不受首次配置覆盖。
reasoningEffort显式传给 DSH 的创建与恢复入口;off表示本轮关闭思考,其他等级以 provider 声明为准。未配置时沿用 DSH 的选择,不暗中降低模型质量。- 攻略续读与短反思:支持新核心时完整正文可分页续读;重复只读证据可触发现有请求的一次短思考,保留日常无思考与原输出预算。
- serverPack 默认 none;千灯纪选择 qiandengji。以当前服务端回执作为事实来源。
- 首次接入自动分配本机端口;高级配置使用 consolePort 和 minecraft.viewerPort。DSH 的 Minecraft 页面组合共享游戏面板和 DSH 原生会话组件,可切换游戏 + 决策、只看游戏、只看决策。实际推理默认折叠;模型未返回时不补写。侧栏输入直接进入该身体的原会话,不创建另一个 Agent;会话标签复用宿主已有输入框。/#experiments 可直达共享实验页,/metrics 仍可独立打开。
- 可用 startPaused 设置首次启动暂不连接;之后操作员的连接/断开选择保存在 dataDir/connection-state.json,重启沿用。暂停期间保留会话、目标和记忆,连接后才恢复目标及待投递的操作员指令。
- minecraft.hostDecisions.combat 显式设置 enabled、endpoint、model、mode、timeoutMs、minIntervalMs、maxAgeMs。快决策状态、候选与驱动来自共享核心,可选服务器包仅转出同一契约;默认关闭,不探测地址。模型不可用时保留核心的规则控制。
- 上下文预算:首次配置读取 DSH 所选模型的上下文元数据;不可用时回退 131072。高级配置可显式设 contextTokens。压缩在
contextTokens × compaction.triggerRatio(默认 0.55)时触发;旧的compaction.thresholdRatio若越过预算会在启动时报错。超预算请求先压缩再重试,仍超出则道别并下线。 - 省上下文:
*_script默认保留,用于按需发现共享工作/移动脚本和自己的方法库;可用tools.exclude显式关闭。默认tools.profile: "lean"隐藏少用工具(蓝图、铁路、摄影、战术等,可用tools.include单独加回或profile: "full"全开),工具说明压缩到tools.descriptionChars(默认 300 字),参数细节用*_tool_help按需查;每步事件快照只保留最近context.events(默认 10)条,回执给模型时截到context.receiptChars(默认 1500 字),完整内容仍在会话日志。node scripts/measure-context.mjs qiandengji 人设.md可测固定提示大小。 - 防打转:连续 6 次只走动/张望且停在约 24 格范围内时提示模型改进;纯蹲下/跳跃等控制请求不会自动重置无进展计数。持续模式到 12 次先休整,随后重新观察并调整,不把卡住当成功。单个回合默认 30 步后在安全边界让出控制并继续同一目标;明确选择有限模式时才应用累计
maxGoalCalls(默认80,设0关闭)。已完成目标的旧回执不再唤醒,退出道别结果写在 status.json 的goodbye。 - 补给提示:饥饿低于
survival.foodThreshold(默认15,设0关闭)时提醒结合现场危险安排进食,不禁止战斗或移动。合成顺序与库存确认继续由核心处理;mc_do入队不是合成完成,宿主不会依据同一份旧背包再设一层合成锁。完成与失败依据原任务身份和原生终态核对。 - 唤醒:默认把普通公屏、私聊、点名、危险和连接变化交给 Agent 判断是否回应;不要求每条聊天都回复。目标进行中另加本身任务回执。自发聊天、系统提示和状态倒计时不因此唤醒。配置面板或
wake.publicChat:false可关闭普通公屏;wake.on可覆盖类别。 - 目标:游戏内目标(
*_goal done)结案会同时结束 DSH 会话目标,只应在整个目标达成时使用。持续模式下连续noopRoundLimit(默认 3)轮无动作会短暂休整后自主恢复;40 轮是可延长的原生窗口,累计轮数不清零。关闭持续模式后使用有限预算。目标留空只连接,不启动推理。 - 聊天:默认公屏,可写
@玩家名;chat.maxPublicLines默认 0(不限制累计总句数),chat.minIntervalMs默认 5000。用户仍可显式设置上限。私聊优先原版/tell,结果未知不自动转公屏。配置chat.goodbye时保留下线道别及status.json回执。 - API key 由 DSH provider 环境变量提供,游戏密码按服务器及用户名独立配置;不要写入人格、聊天或仓库。
官方 DeepSeek 云端的显式无思考配置见 provider 示例 和 Agent 示例。示例安装时不启用,须先填自己的路径、账号与预算。完整说明见 迁移指南,旧版说明见 0.1.x 文档。