前言¶

在 DeepSeek Harness（DSH）里做智能体工作流时，常见做法是接模型、接 MCP、接文件系统。若想在同一宿主里先验证一种互动形态，再让对话把规则落到工作区文件，往往需要自己拼 UI、写导出逻辑、再单独对接本地 DCC 或游戏引擎。dsh-game-workshop（社区目录名 a348579184/dsh-game-workshop）把「可玩的卡牌模板 + 会话内生成单文件 HTML + 可选的本机编辑器 MCP」收成一套工作流插件，维护者为 GitHub 用户 a348579184，分类为工作流。下文按安装、试玩、对话造游戏、编辑器接入的顺序说明，事实以仓库 README 与 package.json 为准。

这是什么¶

dsh-game-workshop 是 DSH 社区插件，版本 0.1.0，许可证 MIT。它在侧栏增加 「游戏工坊 / Game workshop」（随 DSH 中英文语言设置），内置原创中文卡牌游戏 《雾岭灵契》，并提供宿主工具 game_workshop_create_cards（在当前会话工作目录生成自定义 HTML，不覆盖已有文件）与 game_workshop_editors（发现并对读本机会话中的 Unity、Unreal、Blender 相关 MCP，编辑前需经策略核对）。简介所述「在 Harness 里做可玩卡牌游戏并连接本地 Unity、Unreal、Blender」中，卡牌与 HTML 生成不依赖编辑器；三套编辑器 MCP 预设随包提供，安装时默认全部关闭。

实测宿主范围为 DSH 0.2.2-rc.1；package.json 声明 dsh 引擎为 >=0.2.2-rc.1 <0.3.0，README 写明其他版本需自行重跑测试。

核心功能¶

侧栏游戏工坊与内置试玩¶

安装并刷新 DSH 后，从左侧打开游戏工坊。内置《雾岭灵契》包含 6 种灵兽、种子随机抽卡、三张同种同星卡合成、4 件灵器、4 人出阵、三个逐步解锁秘境与自动回合战斗。开局有三张青岚鹿，可立即体验合成；README 称默认流程无需付费、联网或刷资源即可通关。

「开始试玩」在 DSH 内直接打开游戏；「下载游戏 HTML」导出可离线玩的单文件。卡面、图标与山景为项目原创 SVG，README 说明卡牌游戏与插件自身没有 CDN、遥测、远程字体和游戏资源请求（另行启用的编辑器及其 CLI 有各自的联网与隐私设置）。

对话中生成自己的卡牌 HTML¶

game_workshop_create_cards 在当前会话工作目录创建自定义 HTML，通过宿主 createIfAbsent 原子写入：已存在同名文件时返回换名提示，不覆盖、不重命名旧文件。生成物为卡牌游戏模板，不是通用任意规则引擎；可在仓库 game/engine.js、game/render.js 基础上继续改。

参数约束（摘自 README）：

• title 最多 80 字；cards 为 1–6 种，依序覆盖六个原创模板。
• 单卡名称最多 32 字、描述最多 160 字；attack 12–45，health 60–180；颜色仅 #RRGGBB。
• seed 为字符串或数字，相同配置与操作序列得到相同结果。
• language 为 zh 或 en，默认中文。
• filename 只能是当前目录下的 .html 文件名，不接受路径穿越。

本机编辑器 MCP（可选）¶

三个独立预设已打进主 bundle，安装时均关闭，需在插件设置里填写真实路径/配置后再单独启用：

game_workshop_editors 支持 list 发现工具、inspect 只读核对工程/场景，修改前需 prepare 绑定一次性确认（60 秒过期）。Unity 需在主配置提供经审核的 unityProbe；Unreal 需配置 unrealProbe。README 的验收表注明：Unity/Blender stdio 与 UE HTTP 的 协议已在 DSH MCP 客户端侧验证，真实 Unity / UE / Blender 安装与工程操作未在维护者环境中验证。

安装与启用¶

插件以当前 DSH 进程的权限运行；安装前应阅读仓库源码与 MIT 许可证。社区目录站 SkillHub 插件页 与 GitHub 仓库相互独立索引，并非 DeepSeek / 幻方官方应用商店。

macOS 桌面版（README 验证方式）¶

使用应用自带 CLI，不要求 dsh 已在 PATH：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add 'github:a348579184/dsh-game-workshop#v0.1.0'

应用安装路径不同时请改前缀；若已有桌面 CLI 快捷命令，可将完整路径替换为 dsh。

Web profile¶

dsh plugin --profile web add 'github:a348579184/dsh-game-workshop#v0.1.0'
dsh --profile web

也可在 DSH 插件管理界面的社区包入口使用同一 GitHub 标识。web 与 desktop profile 勿混用。

Release 安装包¶

从 v0.1.0 Release 下载 dsh-game-workshop-0.1.0.tgz，将安装命令末尾的 GitHub 标识换成本机 tarball 绝对路径，例如：

dsh plugin --profile web add /absolute/path/dsh-game-workshop-0.1.0.tgz

Release 提供 SHA-256 校验文件。包内已含构建好的 dist/client.js，无 postinstall / prepare，安装不编译、不装编辑器、不自动启用 MCP。

安装后刷新 DSH 页面并打开游戏工坊。首次新增 bundle 可由宿主加载；更新已有安装时请重启对应 profile / 桌面应用再刷新，避免旧模块缓存。

典型用法¶

试玩《雾岭灵契》与离线存档¶

1. 打开 游戏工坊 → 开始试玩。
2. 点击 「青岚鹿 ×3 → 2★」完成第一次升星。
3. 把赤金牙佩给烬尾狐、凝露护符给玄苔龟，自动布阵，挑战「苔径初行」。
4. 首通后继续合成、装备，挑战「月溪回响」「云巅归契」。

工坊页 下载游戏 HTML 是全新样例；游戏内右上角 离线珍藏 在同一份 HTML 里嵌入当前存档。浏览器直接打开即可，进度在 localStorage；DSH 内、离线文件、不同浏览器各自独立存档空间。

用对话在工作区新建游戏¶

先在 DSH 中选择工作区，再将侧栏中的可编辑中文指令复制到对话，例如：

请调用 game_workshop_create_cards，在当前工作区新建《星海灵契》。卡组使用星鲸、月狐、晶鹿、云鹤、岩龟、萤蝶，请给出原创中文描述。种子为「星海-2026」，文件名为「星海灵契.html」。如文件已存在，请让我换名，不要覆盖。

工具参数示例：

{
  "title": "星海灵契",
  "cards": [
    { "name": "星鲸", "description": "在星潮中听见远方的回声。", "attack": 28, "health": 120, "color": "#82c8e5" },
    { "name": "月狐", "description": "把一束月光藏进尾尖。" }
  ],
  "seed": "星海-2026",
  "filename": "星海灵契.html",
  "language": "zh"
}

返回值为可打开的绝对路径与字节数；标题与卡牌文字经转义，生成的 HTML 不加载远程代码。

跨编辑器工作流（需自行启用 MCP 与配置）¶

README 给出 Blender 渲染透明装备图再导入指定 Unity 工程的长任务示例，强调每次修改前用 game_workshop_editors 的 prepare 做精确调用，Unity 须先配置 unityProbe，不能仅凭项目列表猜测目标工程。该用例为维护者提供的使用指导，文档标明未在本机真实编辑器中联调；操作前请自行备份工程。

适用场景与注意¶

适合希望在 DSH 内快速体验原创离线卡牌玩法、并用对话在同一工作区导出单文件 HTML 模板的开发者；若要把美术或关卡接到 Unity、Unreal、Blender，可在理解 MCP 与 unityProbe / unrealProbe 限制的前提下按需启用预设。

注意：

• 生成自定义游戏需要可用 DSH 模型；试玩内置游戏 README 称无需模型 API、编辑器或额外账号。
• 插件使用 DSH 当前会话文件系统与工作目录及 sandbox policy，不绕过宿主权限。
• Node 引擎要求 >=22（见 package.json）。
• 社区目录当前星标为 0，不代表功能范围；以仓库版本与验收记录为准。

结尾¶

dsh-game-workshop 把侧栏试玩、工作区 HTML 生成与可选的本机编辑器 MCP 合成一条工作流：先在内置《雾岭灵契》里验证玩法，再用 game_workshop_create_cards 落到文件，必要时通过 game_workshop_editors 对接 Unity、Unreal 或 Blender。进一步了解可从 SkillHub 目录页 进入，源码与安装说明见 GitHub 仓库。