dsh-godot-ai：DeepSeek Harness 的 Godot 遊戲開發模式

前言¶

DeepSeek Harness (DSH) 是一個插件化架構。dsh-godot-ai 插件爲 DSH 增加了一個專門針對 Godot 遊戲開發的 Godot Creator 模式。它通過原版 Godot AI 操作編輯器，實現從場景搭建、腳本編寫、UI 製作到運行驗證的全流程自動化。

插件介紹¶

該插件由 gosomea 維護，旨在解決 Godot 開發中頻繁切換工具、手動編輯場景與腳本效率低的問題。它不替代遊戲引擎，而是作爲一個模式層，集中管理 Godot 專屬規則、技能和工作流。

核心功能¶

插件具備以下能力：

工程操作：創建和修改場景、節點、GDScript/C# 腳本、資源、信號及輸入設置。
資源製作：製作 UI、動畫、材質、Shader、粒子、音頻、相機和環境。
運行與驗證：運行遊戲，檢查場景樹、運行狀態、報錯、警告、日誌和畫面；在工具支持範圍內模擬輸入。
工作流：遵循“讀取 → 小批次修改 → 回讀 → 運行 → 驗證”的循環，失敗時可從已驗證階段恢復。
創作臺與市場：在創作臺查看項目、Addon、後端和版本狀態；在 Skill 市場審閱、安裝、更新及回滾第三方知識。

安裝與啓用¶

1. 環境準備¶

需要滿足以下環境要求：
* DSH 版本：0.2.0-rc.2 Web
* Node.js：22.19+ 的 22.x 或 24+（不使用 Node 23）
* 工具：uvx
* Godot：最低 4.5，推薦 4.7+

首先檢查 uvx 版本：

uvx --version

2. 安裝插件¶

使用與你的 Web 實例相同的 profile 進行安裝。例如本地 web-rc2：

dsh plugin --profile web-rc2 add dsh-godot-ai@0.7.0

安裝完成後，在當前任務結束時重啓原來的 Web 命令。Godot Creator 會自動出現在 Agent 預設列表中，無需額外點擊“安裝遊戲創造模式”。

3. 在 Godot 項目中啓用 Addon¶

插件依賴原版 Godot AI，需手動安裝：

用 Godot 打開目標項目。
在 AssetLib 搜索 Godot AI，安裝與後端兼容的 3.1.5 版本。
打開 Project → Project Settings → Plugins，啓用 Godot AI。
保持項目在編輯器中打開。

典型用法¶

在 DSH 中新建會話並選擇 Godot Creator。打開頂部的遊戲創作臺，確認連接狀態和目標項目，然後輸入需求。

例如，創建一個 480×720 的 2D 躲避遊戲：

創建一個 480×720 的 2D 躲避遊戲。
玩家可以左右移動和跳躍，碰到障礙後重生，走到終點顯示勝利，
並提供重新開始按鈕。完成後運行遊戲，檢查日誌和畫面。

適用場景與注意¶

適用場景：需要通過 AI 協助搭建 Godot 場景、編寫 GDScript/C# 腳本、調試運行狀態的開發者。
注意：
- Godot AI 後端固定在已驗證的 3.1.5 版本，不自動更換。
- 所有能力集中在一個 godot-creator preset，不再提供 Adaptive 模式。
- 第三方 Skill 不運行腳本或安裝器，critical 風險硬阻斷；市場數據保存在 $DSH_HOME/dsh-godot-ai/skill-market/v1。
- 舊 godot-creator-adaptive 會話不做無損恢復承諾。

結尾¶

該插件採用 MIT 許可證，所有能力集成在 godot-creator 預設中。如需更多信息，可訪問插件目錄或 GitHub 倉庫。