前言¶
如果你用 DeepSeek Harness（DSH）做過「讓 agent 寫個小玩意兒」的嘗試，大概會遇到兩件事：agent 生成了一堆代碼或 Markdown，你沒法立刻玩起來；想讓畫面好看一點，就得自己準備美術資源、調尺寸、對齊風格。DSH 的解法是插件化——把生成、預覽、試玩、導出這些環節打包成一個插件交給 agent 調用，而不是讓它自由發揮。
DSH Game Studio 就是這類插件，由 ZSeven-W 維護，包名 @zseven-w/dsh-game-studio，分類在社區目錄裏歸爲「趣味換裝」一類的輕量玩樂方向，許可證 MIT，當前插件版本 0.1.0-rc.2，已在 DSH 0.2.1-rc.5 上測試。它解決的問題很具體：你用一句話描述一個小遊戲，agent 從模板生成、自動試玩確認能跑、在側欄裏實時渲染給你看，之後可以按編號替換 AI 生成的美術，最後導出成一個離線 HTML。
下面按功能、安裝、用法、注意事項依次介紹。
它是什麼¶
一句話定位：DSH Game Studio 是一個 DSH 插件，輸入一句遊戲描述，輸出一個可玩的遊戲。
它面向兩類人：一是想在對話裏直接得到能玩的東西、不想離開終端去開編輯器的 agent 使用者；二是想要一個可被 agent 反覆修改、有版本可回退、能單文件交付的輕量遊戲原型工具的人。它不是遊戲引擎，不面向需要複雜物理、多人聯機或資產管線的項目。
核心功能¶
兩個模板起步¶
插件內置兩個模板：2D 俯視角（collector）和同一玩法邏輯的 3D 體素世界（voxel，基於 three.js）。agent 拿到一句話後，改的是角色、規則、關卡和界面，不是從零寫渲染。也就是說，如果你要的是「收集 + 躲避」這類玩法，模板的命中率很高；其他類型也能做，但需要更多迭代。
側欄實時預覽¶
遊戲運行在對話旁的沙箱 iframe 裏，每次改動觸發重建並刷新預覽，面板下方列出美術槽位、候選圖和版本。橫屏遊戲會用寬舞臺顯示。這是它和「讓 agent 生成一個 HTML 文件自己打開」最大的差別：改代碼的過程中就能看到結果。
AI 美術，花錢前先審批¶
角色初始是代碼畫的模型。想喫到正式美術時，game_studio_generate_asset 用 OpenAI 圖像接口或本機 Codex CLI 爲每個槽位生成 1–4 張帶編號的候選圖，可選參考圖。在產生任何費用之前，會彈出審批卡，寫明服務、張數和預估費用；你批准後才執行。你在聊天裏附的圖片可以作爲參考圖。
自動試玩¶
game_studio_playtest 在無界面的 Chrome 或 Edge 裏跑最新代碼，報告階段、最高分、剩餘生命、幀率、腳本錯誤並附截圖。不靠方向鍵操作的遊戲（格子、卡牌、瞄準、節奏類）需要在 window.__autoplay 裏定義自動駕駛邏輯，試玩纔會走到真實玩法循環。這是「agent 說做好了」和「確實能玩」之間的那道驗證。
版本與導出¶
每次讓遊戲發生變化的構建都會存成版本，game_studio_restore_version 把代碼、規則和美術一起回退；game_studio_export 生成一個不聯網、自包含的 HTML 文件，任何瀏覽器都能打開，也可以放在任意靜態託管上。game_studio_share 在本地網絡上開一個臨時只讀鏈接，側欄顯示二維碼，適合手機上試玩。
安裝與啓用¶
在 DSH 裏將插件裝到 profile，裝完啓動網頁端：
dsh plugin --profile web add @zseven-w/dsh-game-studio@latest
dsh web
環境要求：
- DeepSeek Harness
0.2.1或更新（網頁版或桌面版） - Node.js
24.11或更新（package.json 裏engines聲明的是>=24.11.0） - 同一臺電腦上裝有 Google Chrome 或 Microsoft Edge，用於自動試玩
生圖是可選的：沒有 OpenAI API key 也沒有登錄 Codex 時，遊戲仍以代碼繪製的角色運行。安裝 AI 美術需要二選一：
| 服務 | 需要什麼 | 說明 |
|---|---|---|
| OpenAI（GPT Image） | DSH 憑據或環境變量裏的 key（默認 OPENAI_API_KEY） |
按張計費，審批卡顯示預估；openaiBaseUrl 可以指向兼容 OpenAI 的網關 |
| Codex CLI | 已安裝並登錄 Codex（codex login） |
計入 Codex 訂閱額度，不需要 API key；每張幾分鐘，後臺運行 |
配置寫在 profile 的 cordis.patch.yml 的 config 下，常用項：
| 選項 | 默認值 | 含義 |
|---|---|---|
imageProvider |
auto |
auto、openai 或 codex；auto 在有 OpenAI key 時用 OpenAI，否則用 Codex |
openaiModel |
gpt-image-2.5-flare |
OpenAI 圖像模型 |
openaiBaseUrl |
OpenAI | 兼容 OpenAI 的接口地址 |
openaiCredential |
OPENAI_API_KEY |
存放 key 的憑據名或環境變量名 |
codexPath |
從 PATH 或登錄 shell 中查找 |
Codex CLI 可執行文件 |
codexReasoningEffort |
low |
Codex 生圖的推理強度 |
confirmSpending |
true |
每次生成前都請求批准 |
典型用法¶
在一個工作區文件夾裏開會話，直接用自然語言提需求，不用記工具名：
做一個小遊戲：小貓在廚房裏偷魚乾，別被掃地機器人撞到。做一個 3D 小遊戲：小騎士在城堡裏收集金幣，躲開骷髏兵，60 秒內收集 20 枚金幣就算勝利。做一個消除小遊戲：在 6×6 的格子裏交換相鄰的寶石，60 秒內拿到 1000 分就贏。
之後可以在同一會話裏繼續：
用 AI 給主角生成 2 張新美術，我在右欄挑。主角照着我附的這張圖來畫。導出成一個 HTML 文件。
側欄上的應用、撤回、構建、導出、恢復、分享按鈕，通過 /game-studio 命令調用的是同一批操作，也就是說人工按鈕和 agent 調用走同一套邏輯，不會各改一份。
agent 實際調用的是 10 個工具，主要的幾個：
| 工具 | 作用 |
|---|---|
game_studio_create |
從模板創建遊戲，參數含標題、美術風格、orientation（豎屏或橫屏）和 slots（遊戲自己的美術槽位，用用戶的語言命名） |
game_studio_build |
改完 game.json 或 game.js 後重建、刷新預覽，並附一句說明存成一個版本 |
game_studio_playtest |
無界面試玩，報告階段、最高分、生命、幀率、錯誤和截圖 |
game_studio_generate_asset |
給一個槽位生成 1–4 張候選圖，可選參考圖，花錢前先審批 |
game_studio_apply_asset |
按編號把候選圖放進遊戲並重建 |
game_studio_revert_asset |
把某個槽位恢復成上一張美術 |
game_studio_versions |
列出已保存版本，最新在前 |
game_studio_restore_version |
把整個遊戲恢復到較早版本 |
game_studio_export |
導出自包含、可離線遊玩的 HTML |
game_studio_share |
開啓或關閉本地網絡上的臨時只讀鏈接 |
遊戲項目在磁盤上的樣子¶
每個遊戲就是工作區裏的一個普通文件夾：
game.json：標題、美術風格、橫豎屏、美術槽位和規則。規則是自由格式，任何鍵都會以window.GAME.rules傳給遊戲。game.js：agent 編輯的遊戲代碼。提供window.__gameState()供試玩讀取；不用方向鍵操作的遊戲可選提供window.__autoplay(state)；提供window.__renderSlots(size)後，側欄能顯示代碼繪製的角色。assets/：每個槽位的圖片，加記錄每張圖來源的ASSETS.json。直接改槽位文件會被記爲你的修改。dist/index.html：當前構建產物；.studio/存放版本、候選圖和試玩記錄。
這意味着工作區以外的依賴幾乎爲零，遊戲目錄可以直接複製、提交或搬家。
適用場景與注意¶
適合的場景：
- 想在對話裏直接得到能玩的東西，不想開編輯器
- 「收集 + 躲避」這類收集玩法的原型，模板覆蓋度高
- 需要可回退、可單文件交付的輕量遊戲產物
需要留意的：
- 插件以當前 DSH 進程的權限運行。它會讀寫工作區目錄、按配置調用生圖服務、在本地網絡上監聽分享端口，裝之前應先讀一遍源碼，確認這些行爲符合你的預期。許可證是 MIT。
- 這是
0.1.0-rc.2，屬於 rc 階段，接口和模板還可能變。README 裏「實際效果」一節給出的數據是作者自己在真實 DSH 裏用 DeepSeek-V4.1-Flash 做的一輪測試（2026-11-04/05，樣本量 20）：收集加躲避類 10 個需求首輪都能玩，中位用時約 14 分鐘；其他十種類型都能做出能玩的遊戲，但中位用時約 26 分鐘，加入__autoplay、自定義美術槽位和橫屏支持後復跑其中 4 個，用時降到 8–18 分鐘。作者自己也標註了樣本較小，不要把這一輪數據當作普遍結論。 - 生圖會離開本機：發往所選服務的只有提示詞和你提供的參考圖。分享鏈接只在本地網絡監聽、默認 30 分鐘後自動關閉。這些設計降低了風險，但不是免疫，走代理或公司網關時注意
openaiBaseUrl指向哪裏。
結尾¶
DSH Game Studio 的價值在於把「描述—生成—試玩—換美術—導出」壓成一次對話，中間省掉的是手動打開瀏覽器、手動找素材的來回。適合做小玩意和原型驗證，不適合做正經遊戲項目。
- 社區目錄頁：https://www.skillhub.cn/plugins/ZSeven-W/dsh-game-studio
- GitHub：https://github.com/ZSeven-W/dsh-game-studio
目錄頁歸爲「趣味換裝」分類，倉庫自帶 README 中/英等 15 種語言版本，README.zh.md 是中文一手文檔。
