前言¶
在 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