dsh_theme_minecraft
メンテナンス: 活発10086ggqq/dsh_theme_minecraft
DeepSeek Harness を Minecraft Java Edition 風にするテーマ。回転パノラマメニュー・ゲームモード別エージェント・8-bit サウンドなど、DSH コアに無侵入で切替可能。
$ dsh plugin add dsh_theme_minecraft3
スター
0
フォーク
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
by laplaceyoung
DSH Web UI 向け切替可能 QQ2006 スキン:コーラルブルーテーマとレトロ素材
dsh-beauty-skins
by xierw
DSH 向け美女シリーズスキン:壁紙プレビュー選択、配色自動抽出
deepseek-harness-skin
by heigeai
21 組み込みスキン+1 枚画像から配色生成。コントラスト自動導出、ビルド期可読性検証
whaleisle
by chisaalter
公式機能を備えたDeepSeek Harnessのコミュニティ強化デスクトップ版です。テーマ・壁紙、デスクトップペット、使用量表示、スマホからのリモート接続を追加します。
