akira399/dsh-godot-skill 预览 preview

akira399/dsh-godot-skill

Godot Engine 4.x 全栈游戏开发技能插件,适用于 DeepSeek Harness(DSH)——在运行时注册 godot-4-development 技能。

Project Overview项目介绍

This repository holds a DSH-native skill plugin for full-stack game development with Godot Engine 4.x. Once installed and activated in DSH, it automatically registers the pre-built godot-4-development skill as a runtime available skill for any DSH session. Users can load the skill via the skill tool in a session, allowing the DeepSeek AI to handle the entire Godot game development workflow from planning to export. To install, you can use the DSH command line tool with one of three supported installation methods: npm, Git HTTPS, or GitHub short name. Each method works with the standard DSH web profile that most users run.

The skill content is structured around Godot’s official Chinese feature list, with detailed reference information for 20 different development domains, core engine concepts, common code templates, and a full end-to-end development workflow from initial design to final export. It is designed for game developers of all experience levels who want to use AI assistance to build games with Godot 4.x. New developers can get up to speed quickly with the provided troubleshooting table and pre-built templates, while experienced developers can speed up their development iteration cycle and reduce time spent looking up basic engine references.

The plugin is released under the open source MIT license, and the referenced Godot official documentation content is used under the Creative Commons CC BY 3.0 license retained by the Godot community. If you run into authentication errors during installation from GitHub, the README provides two easy workarounds: either configure GitHub SSH keys on your local machine, or update your global git config to use HTTPS instead of SSH for GitHub requests. You can also run a built-in verification script with pnpm verify to check the plugin’s syntax, file integrity, and runtime registration behavior after installation.

这是一款专为 DeepSeek Harness(DSH)打造的原生 Godot Engine 4.x 全栈游戏开发技能插件。安装激活后,插件会自动将内置的 godot-4-development 技能注册为 DSH 运行时技能,任何会话都可以通过 skill 工具加载该技能,让 AI 独立完成 Godot 游戏的规划、项目搭建、编码、调试、优化与导出全流程。插件遵循 DSH 插件打包规范,自带完整的 bundle 清单,便于通过 DSH 官方命令行工具安装。

该技能内容基于Godot官方中文特性列表整理,覆盖节点、场景、资源等核心概念,渲染器选型、从平台导出到GDScript编码等20个开发领域,从设计到发布的完整开发工作流,还提供了常用代码模板和错误排查表。它面向希望借助AI辅助Godot游戏开发的开发者,能够降低新手接触Godot开发的门槛,帮助有经验的开发者提升开发效率。

该插件支持三种官方DSH安装方式,分别是npm安装、Git HTTPS安装和GitHub短名安装,安装完成后需要重启DSH才能激活技能。插件采用MIT许可证开放授权,引用的Godot官方文档内容版权归Godot社区所有,遵循CC BY 3.0许可。README中也提供了常见安装问题(如Git认证失败、pnpm构建权限问题)的临时解决方案,方便用户排查。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 32 stars - an early-stage project星标 32,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:akira399/dsh-godot-skill

把 akira399/dsh-godot-skill 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-godot-skill

Godot Engine 4.x 全栈游戏开发技能插件 for DeepSeek Harness(DSH)。

安装后,插件在激活时把仓库内自带的 godot-4-development 技能注册为运行时技能 —— 任何会话都可以通过 skill 工具加载它,让 AI 独立完成 Godot 游戏的规划、搭建、编码、调试、优化与导出。

DeepSeek Harness License 类型 技能

技能内容

依据 Godot 官方特性列表(简体中文)整理并补充实现细节:

  • 核心概念:节点 / 场景 / 资源 / 信号 / 组
  • 渲染器选型:Forward+ / Mobile / Compatibility(GL)
  • 特性 → 实现速查(20 个领域):平台与导出、编辑器、2D/3D 图形与工具与物理、着色器、GDScript/C#/GDExtension、音频、导入、输入、导航、网络、国际化、窗口与 OS、移动端/XR、GUI、动画、文件格式、杂项(Movie Maker、无头服务器、CI)
  • 完整开发工作流:设计决策 → 项目脚手架 → 核心玩法原型 → 内容实现 → 打磨与性能 → 测试调试 → 导出发布
  • 代码模板与错误排查表:玩家移动、相机跟随、生成、HTTP、暂停、存档、ENet 联机、常见错误速查

安装(官方路径)

方式一:npm 安装(推荐,发布后可用)

npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-godot-skill

方式二:Git HTTPS 安装

npx -p @deepseek-ai/dsh dsh plugin --profile web add git+https://github.com/akira399/dsh-godot-skill.git

方式三:GitHub 短名安装(需要本机已配置 GitHub SSH key)

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:akira399/dsh-godot-skill

安装完成后重启 DSH(重新运行 dsh web)。重启后会话技能目录中即出现 godot-4-development。

如果遇到 git+ssh://git@github.com 认证失败

DSH 通过 pnpm 安装 git 依赖时,可能把 Git 地址解析成 git+ssh://git@github.com,此时本机必须已有 GitHub SSH key;否则会报:

fatal: Could not read from remote repository.

临时规避方案(二选一):

  1. 让 git 用 HTTPS 替代 SSH(无需配置 SSH key):
    git config --global url."https://github.com/".insteadOf "git@github.com:"
    git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
    
  2. 配置 GitHub SSH key 后重试。

另外,pnpm 对 git 托管的插件会执行 prepare 类脚本并提示: add the exact key pnpm printed above under allowBuilds in <profile>/pnpm-workspace.yaml, then re-run 按提示把对应 build key 加入该 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试即可。

使用

插件生效后,会话中会提示可用技能 godot-4-development。直接说:

用 godot-4-development 技能帮我做一个 2D 平台跳跃游戏

AI 会先加载技能,再按技能内的工作流与 API 速查完成开发。

验证

pnpm verify

检查:插件语法、技能文件完整性、运行时注册行为(mock ctx 断言)。

文件结构

dsh-godot-skill/
├── package.json          # cordis 插件清单(dsh.bundle.patch → cordis.patch.yml)
├── cordis.patch.yml      # 配置层:把插件挂进 profile 的 host 组合
├── lib/index.js          # Host 插件:读取 SKILL.md 并注册为运行时技能
├── .dsh/skills/godot-4-development/SKILL.md   # 技能本体(frontmatter + 正文)
├── scripts/verify.mjs    # 验证脚本
└── README.md / LICENSE

许可

MIT © 2026 dsh-godot-skill contributors

Godot 官方文档内容版权归 Godot 社区所有(CC BY 3.0),本插件仅整理引用。

← 上一个 Prev dsh-model-context-catalog 下一个 Next Smart-DSH →