前言¶
在 DeepSeek Harness(DSH)裏做 Godot 遊戲開發,常見做法是每次會話都手動粘貼文檔片段、反覆說明節點/場景/信號等概念,或讓 AI 憑通用知識猜 GDScript API。Godot 4.x 特性面很廣——渲染器選型、2D/3D 物理、着色器、網絡、導出路徑各不相同,缺少結構化工作流時,規劃、編碼、調試容易脫節。
akira399/dsh-godot-skill 是一個 Host 插件:安裝並在 DSH 中激活後,會把倉庫自帶的 godot-4-development 技能註冊爲運行時技能。會話裏可通過 skill 工具加載它,讓 AI 按技能內整理的工作流與 API 速查,獨立完成 Godot 遊戲的規劃、搭建、編碼、調試、優化與導出。
這是什麼¶
- 插件名稱:dsh-godot-skill(GitHub:
akira399/dsh-godot-skill) - 維護者:akira399
- 分類:工作流(SkillHub 目錄)
- 定位:Godot Engine 4.x 全棧遊戲開發技能插件 for DeepSeek Harness —— 在運行時註冊
godot-4-development技能 - 許可:MIT © 2026 dsh-godot-skill contributors(Godot 官方文檔內容版權歸 Godot 社區,CC BY 3.0,本插件僅整理引用)
插件本身不替代 Godot 編輯器,而是把面向 Godot 4.x 的開發知識與工作流注入 DSH 會話,供 AI 按需加載。
核心功能¶
技能內容依據 Godot 官方特性列表(簡體中文)整理並補充實現細節,主要包括:
概念與渲染器¶
- 核心概念:節點、場景、資源、信號、組
- 渲染器選型:Forward+、Mobile、Compatibility(GL)
特性速查(20 個領域)¶
平臺與導出、編輯器、2D/3D 圖形與工具與物理、着色器、GDScript/C#/GDExtension、音頻、導入、輸入、導航、網絡、國際化、窗口與 OS、移動端/XR、GUI、動畫、文件格式,以及雜項(Movie Maker、無頭服務器、CI 等)。
開發工作流¶
設計決策 → 項目腳手架 → 核心玩法原型 → 內容實現 → 打磨與性能 → 測試調試 → 導出發佈。
代碼模板與排查¶
內置玩家移動、相機跟隨、生成、HTTP、暫停、存檔、ENet 聯機等代碼模板,以及常見錯誤速查表。
運行時註冊機制¶
Host 插件入口在 lib/index.js:激活時讀取 .dsh/skills/godot-4-development/SKILL.md,將其註冊爲會話可用的運行時技能。配置通過 cordis.patch.yml 掛入 profile 的 host 組合。
安裝與啓用¶
下面使用 README 中的官方安裝命令。安裝完成後需重啓 DSH(重新運行 dsh web),重啓後會話技能目錄中會出現 godot-4-development。
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:akira399/dsh-godot-skill
插件要求 Node.js >= 20(見 package.json 的 engines 字段)。
典型用法¶
插件生效後,會話中會提示可用技能 godot-4-development。直接向 AI 說明任務即可,例如:
用 godot-4-development 技能幫我做一個 2D 平臺跳躍遊戲
AI 會先通過 skill 工具加載該技能,再按技能內的工作流與 API 速查完成開發。
維護者在倉庫中提供了驗證腳本,用於檢查插件語法、技能文件完整性與運行時註冊行爲(mock ctx 斷言):
pnpm verify
適用場景與注意¶
適合誰
- 已在 DSH 中進行智能體或自動化開發,需要 Godot 4.x 全棧能力(2D/3D、腳本、着色器、網絡、導出等)的開發者
- 希望減少重複粘貼 Godot 文檔、統一開發工作流的團隊或個人
使用前注意
- 插件以當前 DSH 進程的權限運行;安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證,確認符合你的安全與合規要求
- SkillHub(https://www.skillhub.cn/plugins/akira399/dsh-godot-skill)是社區目錄站點,與 DeepSeek / 幻方無官方從屬關係;DSH 生態理念是「一切皆插件」,本插件是其中的工作流類 Host 插件
- 技能內容是對 Godot 官方文檔的整理引用,具體 API 行爲以 Godot 4.x 官方文檔與編輯器版本爲準
結尾¶
dsh-godot-skill 把 Godot 4.x 的概念速查、完整開發工作流和常用代碼模板打包成 DSH 運行時技能,安裝一條命令、重啓 DSH 後即可在會話中加載。若你正在 DSH 裏做 Godot 遊戲,可從目錄頁或 GitHub 進一步瞭解:
- 目錄頁:https://www.skillhub.cn/plugins/akira399/dsh-godot-skill
- GitHub:https://github.com/akira399/dsh-godot-skill