前言¶
DeepSeek Harness (DSH) 是一个编程 Agent 工具。其标准 Web 界面功能完备，但视觉风格较为通用。dsh-theme-minecraft 插件将 DSH 的 Web UI 重新设计为 Minecraft Java Edition 的风格。它不修改 DSH 核心源码，而是通过现有 API 挂载一层 UI 变换，提供沉浸式的像素风交互体验。
插件定位¶
- 项目名称:
dsh-theme-minecraft - 维护者: 10086ggqq
- 开源协议: MIT
- 核心价值: 将 DSH 的会话管理、Agent 预设、工具调用与审批流程，映射为 Minecraft 的世界存档、游戏模式、物品卡片与红石机关。
- 零侵入: 不修改 DSH 源码，仅通过插件机制扩展。经典 DSH 界面原样保留，可一键切回。
核心功能¶
该插件将 DSH 的核心能力游戏化，具体映射如下：
-
主菜单与全景
- 使用 WebGL 渲染旋转全景背景，配合像素 Logo 与闪字效果。
- 会话列表以“世界存档”形式呈现，支持重命名与归档（调用真实 API）。
-
模式选择与 Agent 预设
- 四种 Minecraft 游戏模式（生存/创造/冒险/专家）对应四种 DSH Agent 预设（standard/ptc/minimal/cordis）。
-
世界内交互
- 聊天台: 在世界内以 HUD 形式展示对话，实时显示模型与 Token 使用情况。
- 工具卡片: 将
tool/call与tool/result渲染为像素风格物品卡片。 - 思考跑酷: 当 AI 处于思考或流式输出状态时，触发 Chrome 离线小恐龙跑酷小游戏（T-Rex Runner）。
- 危险操作审批: 审批面板弹出时跑酷暂停，操作完成后恢复。
- 村民提问: AI 的澄清问题以村民对话气泡呈现。
-
视听与特效
- 音效: 使用 WebAudio 合成 8-bit 复古音效。
- 音乐: 支持导入 MP3/WAV/OGG 等格式背景音乐。
- 桌宠: 提供美西螈、猫等互动桌宠与红石粒子特效。
- 设置中心: 分为游戏/AI/世界/音频/视觉五页，配置持久化存储。
安装与启用¶
环境要求¶
- Node.js
^22.19或>=24 - 已安装并配置好的 DeepSeek Harness
安装命令¶
通过 DSH 的插件管理器安装：
dsh plugin --profile web add dsh-theme-minecraft
启动与登录¶
安装后，主题随 dsh web 自动挂载。启动服务：
dsh web
终端会打印带有 ?token= 参数的登录 URL，访问该 URL 完成登录。
回退方案¶
若需使用原版 DSH 界面，直接访问 http://<host>:<port>/index.html。
典型用法¶
-
配置 API Key
- 在主菜单进入“设置”，将 API Key 保存至 DSH 凭据库。
- 或在环境变量
.env中提供DEEPSEEK_API_KEY。
-
选择模式
- 在主菜单点击模式图标，选择对应的 Agent 预设（如“生存模式”对应 standard 预设）。
-
操作审批
- 当 Agent 需要执行危险操作（如删除文件）时，审批面板弹出，跑酷小游戏自动暂停。允许后恢复。
注意事项¶
- 版权声明: 本项目以 MIT 协议开源。Minecraft 名称与官方素材版权归 Mojang AB / Microsoft 所有。本主题仅作非商用粉丝使用，请勿用于商业产品。
- 运行机制: 插件通过 DSH 的 JSON-RPC/WebSocket API 获取真实数据，界面上的状态均为真实数据来源，无伪造内容。
- 适用人群: 适合希望将 DSH 界面定制为 Minecraft 风格的开发者与用户。
