前言¶
DSH 中常见的 Workspace、Session、Conversation、Trajectory、Composer、权限、模型选择和上下文统计，通常需要分别打开不同视图。dsh-minecraft-ui 是一个由 TFboy1 维护的客户端插件包，许可证为 MIT。它把 DeepSeek Harness 变成一座可游玩的 Minecraft 风格 Agent 工作空间，让这些对象以体素世界中的设施呈现。
这是什么¶
dsh-minecraft-ui 以 Cordis Client Plugin 形式挂载到官方 shell.overlay，保留 DSH 原生的 Workspace、Session、Conversation、Trajectory、Composer、权限、模型选择和上下文统计。
它把 DSH 的运行状态转译为游戏对象：运行中的 Session 显示为工作小狗，状态牌展示 Agent 最新进展，并通过 Tool Call 引导到对应设施。
核心功能¶
体素世界¶
- 可游玩的 Minecraft 风格第一人称体素世界。
- 支持移动、跳跃、疾跑、潜行、挖掘、放置方块和切换快捷栏。
- 世界差异、玩家位置、背包、箱子与选择状态可持久化。
语义设施¶
插件提供以下语义设施：
- 模型箱
- 插件箱
- 附魔台
- 制图台
- 社区插件宝箱
- 资料书架
- Agent 终端
工作小狗¶
- 运行中的 Session 显示为工作小狗。
- 状态牌展示 Agent 最新进展。
- Tool Call 会引导到对应设施。
- 右击工作小狗会切换到对应 Session，并直接打开原生工作台。
社区插件安全流程¶
- 社区插件采用发现、收集、检查、明确确认的 dry-run 安全流程。
- 确认结果始终是 dry-run。
- DSHcraft 不会 spawn CLI，也不会自行修改任何 profile。
安装与启用¶
建议先安装到独立 canary profile，不要直接在正在使用的主 Web profile 中启用候选版本。
运行环境要求 Node.js 22+；packageManager 为 pnpm@11.7.0。
npm 推荐安装：
dsh plugin --profile <canary> add dsh-minecraft-ui
安装后查看配置：
dsh --profile <canary> --dump-config
Cordis 会用 Schemastery 校验配置并填充默认值；非法路径、协议和数值范围会在插件激活时直接报错。
如果使用 Git 安装，会运行 prepare 构建；pnpm 10+ 要求用户显式允许该安装脚本。
典型用法¶
首次点击画面后，浏览器会请求 Pointer Lock；打开任何设施时会立即释放鼠标锁定。
常用按键：
- 按
G打开原生工作台。 - 按
E打开背包。 - 按
Tab查看 Session 列表。 - 按
M打开模型箱。 - 按
P打开插件箱。 - 按
R打开附魔台。 - 按
N打开 Workspace 地图。 - 按
L打开社区插件宝箱。
适用场景与注意¶
适用于需要在一个可视化体素界面中查看 DSH 的 Workspace、Session、模型、插件、社区插件和 Agent 运行状态的场景。
注意：
- 作为 DSH 插件，它会在当前 dsh 进程权限下运行；安装前应检查源码和许可证。
- 许可证为 MIT。
- 不要直接在正在使用的主 Web profile 中启用候选版本；先安装到独立 canary profile。
- 社区插件确认只是 dry-run；DSHcraft 不会 spawn CLI，也不会自行修改任何 profile。
- 插件激活时会校验配置；非法路径、协议和数值范围会直接报错。
链接¶
- GitHub：https://github.com/TFboy1/dsh-minecraft-ui
- 目录页：https://www.skillhub.cn/plugins/TFboy1/dsh-minecraft-ui（该 URL 在素材中标记为来自插件线索，使用前请自行确认）
