dsh_theme_minecraft
維護狀態: 活躍10086ggqq/dsh_theme_minecraft
把 DeepSeek Harness 變成 Minecraft Java Edition 風格——WebGL 旋轉全景主選單、存檔式會話選擇、四種遊戲模式對應 Agent 預設、世界內 HUD 聊天台、畫素風工具卡片與審批面板、AI 思考時觸發跑酷小遊戲、8-bit 合成音效與自定義背景音樂、五類互動桌寵與紅石粒子特效。零侵入 DSH 核心原始碼,經典介面一鍵切回。
$ dsh plugin add dsh_theme_minecraft3
星數
0
Fork
JavaScript
語言
MIT
授權條款
2026-09-02
建立於
2026-09-02
最近推送
README
dsh-theme-minecraft
把 DeepSeek Harness 变成一个像 Minecraft Java Edition 一样使用的 AI Coding Agent —— 打开 dsh web,第一眼不是「AI 编程工具」,而是「我打开了 Minecraft,这个世界里住着一个 AI」。
工作原理:本主题是一个标准 DSH 插件(bundle),不修改 DeepSeek Harness 任何核心源码。 会话、消息流、工具调用、审批、预设、工作区、凭据等真实能力全部通过 DSH 现有 JSON-RPC / WebSocket API 完成,界面上的每一帧状态都有真实数据来源,没有任何伪造。
✨ 功能特性
- [x] 原版主菜单 —— WebGL 旋转全景 + 像素 Logo + 黄色闪字 + 石板按钮,
dsh web打印的 URL 打开即是 - [x] 会话即世界存档 —— 「继续对话」渲染成存档选择页,重命名 / 归档 / 刷新都走真实
session/*调用 - [x] 模式选择 = Agent 预设 —— 生存 / 创造 / 冒险 / 专家四张像素皮肤,对应 DSH 的 standard / ptc / minimal / cordis 预设
- [x] 世界内聊天台 —— Steve 与「AI him」对话:流式输出、思考过程可折叠、模型 / Token / 工作区实时面板
- [x] 工具调用卡片 —— 📖 打开书、⚙️ 红石机关、⛏️ 挖掉方块……每个真实
tool/call/tool/result都有像素皮肤 - [x] 危险操作审批 —— 审批面板弹出时跑酷小游戏自动暂停,允许 / 拒绝后恢复(
approval/requestwaterfall) - [x] 村民提问 —— AI 的澄清问题以村民对话气泡呈现,回答直接回流 DSH(
user-questions/request) - [x] AI 思考跑酷 —— Chrome 离线小恐龙跑酷(T-Rex Runner,Chromium BSD 许可)只由真实 THINKING / STREAMING / TOOL_CALLING 状态驱动,空闲时绝不假装在思考
- [x] 五页设置中心 —— 游戏 / AI / 世界 / 音频 / 视觉:设置存 localStorage,音乐存 IndexedDB,API Key 存 DSH 凭据库
- [x] 音效与音乐 —— WebAudio 合成 8-bit 音效,支持导入自己的背景音乐(MP3 / WAV / OGG / FLAC / M4A / AAC / OPUS)
- [x] 桌宠与粒子 —— 互动桌宠(美西螈/猫/狼/苦力怕/恶魂,支持喂食、好感度、图鉴换宠)+ 经验球 / 红石粒子(限量 80 粒),独立开关
- [x] 零侵入 —— 经典 DSH Web 界面原样保留,
/index.html一键切回
📦 安装与使用
1. 环境要求
| 依赖 | 要求 |
|---|---|
| Node.js | ^22.19 或 >=24(DeepSeek Harness 运行要求) |
| DeepSeek Harness | 已安装,且 dsh 命令可用 |
| 浏览器 | 支持 WebGL 与 WebSocket 的现代浏览器 |
| DEEPSEEK_API_KEY | 真实对话必需,见下方「配置」步骤 |
2. 安装主题
方式一:安装到 web profile(标准用法)
dsh plugin --profile web add dsh-theme-minecraft # npm 发布后
dsh plugin --profile web add ./dsh-theme-minecraft # 或本地目录安装
安装后插件进入 ~/.dsh/profiles/web,随 dsh web 自动挂载,无需其他步骤。
方式二:仓库内源码运行(开发调试)
在 DeepSeek Harness 仓库根目录执行:
pnpm dsh web --patch ./dsh-theme-minecraft/cordis.source.patch.yml --no-open
# 浏览器打开 http://127.0.0.1:3080/
3. 配置
- 登录:使用
dsh web打印的带?token=的 URL 完成登录(与原版一致的签名 Cookie 流程,主题复用了connection.authorizeIndex,没有绕过任何认证)。 - API Key(二选一):
- 主题内:主菜单 → 设置… → AI 设置 → 保存(走
credentials/set写入 DSH 凭据库,值只进不出); - 环境变量:在
.env里提供DEEPSEEK_API_KEY。
- 主题内:主菜单 → 设置… → AI 设置 → 保存(走
4. 启动
dsh web
打开终端打印的 URL,即看到 Minecraft 主菜单。想回到经典界面,直接访问
http://<host>:<port>/index.html。主菜单的「模型选择」可切换新对话使用的模型
(session/modelCatalog 列出部署内全部可路由提供方,含非 DeepSeek 厂家;选择经
session/selectModel 安装到新会话)。
🛠 技术栈
| 技术 | 用途 | 版本 / 兼容范围 |
|---|---|---|
| JavaScript(ESM) | 插件与前端全部逻辑,零运行时依赖 | ES2022+ |
| Node.js | 宿主运行环境 | ^22.19 或 >=24 |
| Cordis 插件框架 | 插件生命周期与依赖注入 | >=0.x(peer 依赖) |
| WebSocket + JSON-RPC | 与 DSH 的全部真实通信(RPC / 流 / 事件) | DSH 内置 API |
| WebGL | 主菜单全景立方体贴图 | 浏览器原生(无 three.js) |
| Canvas 2D | AI 思考跑酷小游戏渲染(iframe 内 T-Rex) | 浏览器原生 |
| Web Audio API | 8-bit 音效合成与背景音乐播放 | 浏览器原生 |
| IndexedDB / localStorage | 设置与音乐文件持久化 | 浏览器原生 |
📁 项目结构
更多「主題與外觀」外掛
dsh-qq2006
作者 laplaceyoung
DSH (DeepSeek Harness) 的 QQ2006 皮膚外掛:註冊 qq2006 主題、映象 body[data-ds-skin]、全域性皮膚表與完整素材
dsh-beauty-skins
作者 xierw
給 DeepSeek Harness 用的美女系列皮膚:設定裡從 哲風桌布 拉預覽網格,點一張即應用,配色從桌布提取。支援動態桌布,也保留自定義選圖。
deepseek-harness-skin
作者 heigeai
DeepSeek Harness 換膚系統:21 套內建皮膚 + 一張圖生成整套配色的自定義皮膚。資料來源驅動,保對比度推導,構建期校驗可讀性。
whaleisle
作者 chisaalter
鯨嶼 Whale Isle · DeepSeek Harness 開源社群桌面版:AI 對話、終端與 Git、鯨橋 API/訂閱接入、主題桌布、鯨魚娘桌寵、用量統計與手機遠端連線。Community-enhanced DeepSeek Harness desktop client.
