Jundot Engine 文档

AI 助手

Jundot AI Assistant 是 Jundot 的核心工作入口。它不只是回答问题,而是从项目管理器开始帮助用户交流游戏想法、整理项目方向、自动生成项目;进入编辑器后,AI 会先创建一个可运行的 HTML 游戏原型,供玩家试玩、审核和验证。玩家确认方向通过后,AI 再把原型转换成 C# 游戏项目,并继续细化玩法、修复错误、检查结果,在必要时推动引擎改动。

核心定位

Jundot 的 AI 流程围绕四个目标:

  • 项目管理器 AI 生成项目:用户在项目管理器界面描述游戏想法,AI 总结项目类型、主题、核心玩法和第一版范围,并自动创建项目。
  • HTML 原型验证:进入编辑器后,AI 先创建可运行 HTML 游戏,玩家试玩并审核玩法方向。
  • 转换成 C# 游戏:玩家验证通过后,AI 将 HTML 原型转换成 C# 游戏项目,并继续生成和修改场景、脚本、UI、资源结构。
  • AI 解决问题:当项目报错、构建失败、性能异常或崩溃时,AI 读取现场并修复。
  • AI 改进引擎:当当前引擎能力不足以完成项目需求时,AI 可以在用户确认后修改引擎。
用户验证是边界

AI 可以创建项目、修改项目、修复问题、准备 GitHub 提交;但进入引擎改动、上传 GitHub、发布更新等关键动作,应在用户验证通过后进行。

1. 在项目管理器里和 AI 交流并生成项目

Jundot 的 AI 流程可以从项目管理器开始。用户不需要先手动创建空项目、进入编辑器后再找 AI;可以直接在项目管理器界面输入游戏想法,让 AI 帮你把想法整理成可执行的项目方向,并自动创建项目。

生成项目演示

演示在项目管理器中和 AI 交流,并生成项目的基础流程。

示例输入:

我想做一个霓虹餐厅题材的放置经营游戏。玩家接单、做菜、赚金币、升级店铺。帮我整理项目方向,并自动创建一个可继续迭代的项目。

AI 应先和用户细化:

  • 游戏类型、题材、核心循环和目标平台。
  • 项目名称、项目目录和第一版范围。
  • 第一版原型需要包含哪些场景、UI 和交互。
  • 哪些内容本次必须完成,哪些可以之后再做。
  • 如何判断第一版“可测试”。

2. 进入编辑器后先创建 HTML 游戏原型

项目生成后,AI Assistant 会继续作为编辑器内的协作入口。推荐流程不是立刻写正式 C# 项目,而是先生成一个可以运行、可以试玩的 HTML 游戏原型,让玩家先审核核心玩法、操作节奏和 UI 反馈。

先创建一个可运行的 HTML 游戏原型。玩家可以试玩核心循环,确认玩法方向后,再转换成 C# 游戏项目。

HTML 原型阶段适合快速验证:

  • 核心循环是否成立。
  • 操作手感和反馈是否清楚。
  • UI 布局是否可读,没有明显遮挡或重叠。
  • 哪些规则需要修改,哪些内容可以进入正式实现。

3. 玩家审核通过后转换成 C# 游戏

玩家确认 HTML 原型方向通过后,AI 再把原型转换成 Jundot/Godot 的 C# 游戏项目。转换时应保留已经验证过的玩法规则、交互节奏、UI 结构和验收标准。

HTML 原型方向已经确认。请把它转换成 C# 游戏项目,保留核心玩法和 UI 反馈,并在完成后检查脚本错误。

如果当前引擎能力足够,AI 会直接在项目内创建内容;如果当前引擎能力不足,AI 会说明需要引擎改动的原因。

4. 当前引擎做不到时,AI 可以改引擎

Jundot 的特殊之处在于:项目需求可以推动引擎能力变化。

项目需求
  ↓
AI 判断当前引擎是否能完成
  ↓
能完成:只修改项目
  ↓
不能完成:说明原因、影响和验证方式
  ↓
用户确认
  ↓
AI 修改引擎以适配该项目
  ↓
项目中验证
  ↓
足够通用:整理并丰富到主引擎

适合进入引擎改动的情况包括:

  • 编辑器缺少项目所需的专用工具。
  • 导入、构建、发布流程需要新增能力。
  • 项目需要新的节点、资源类型或检查工具。
  • 同类项目都可能需要的通用能力。

5. 报错和性能问题交给 AI 解决

当用户遇到报错、性能问题、崩溃、构建失败或功能无反应时,可以让 AI 接手排查。

运行时报这个错误,帮我定位原因并修复。修完后检查脚本错误。

[粘贴完整错误日志]

AI 的推荐处理流程:

  1. 读取错误信息、项目文件和相关场景。
  2. 判断是项目脚本、资源配置、引擎工具还是底层引擎问题。
  3. 提出最小修复方案。
  4. 修改后运行可用的检查或构建。
  5. 把验证结果告诉用户。
  6. 用户确认后,把修改提交并上传 GitHub。

工作模式

模式 用途 典型场景
项目管理器 AI 交流游戏想法、整理项目方向、自动创建项目。 还没有项目时,从一句想法开始生成项目。
聊天 讨论想法、解释代码、制定计划。 构思项目、学习 API、比较方案。
项目模式 先生成 HTML 原型,通过审核后转换成 C# 项目,再读取和修改项目文件、场景和脚本。 创建玩法、转换 C# 项目、修复项目错误、检查脚本。
引擎模式 在确认后修改 Jundot 引擎本身。 项目需求需要新编辑器工具、导入器或引擎能力。

常用指令示例

# 在项目管理器里创建游戏
我想做一个 2D 平台跳跃小游戏。请先整理项目方向、核心玩法和第一版范围,然后自动创建项目。

# 进入编辑器后先做 HTML 原型
先创建一个可运行 HTML 游戏原型,让玩家试玩核心玩法。玩家确认后再转换成 C# 游戏。

# HTML 原型通过后转换 C#
HTML 原型方向已经确认。请转换成 C# 游戏项目,并检查脚本错误。

# 修复错误
运行时报错了。请读取相关脚本和场景,找出原因,修复后检查脚本错误。

# 性能问题
这个场景帧率很低,请分析可能原因,先给出排查计划,再做最小修改。

# 引擎能力不足
如果当前项目层做不到,请说明为什么需要改引擎、要改哪些文件、怎么验证。

# 上传 GitHub
我已经验证可用了,请整理改动说明,提交并上传到 GitHub。

最佳实践

  • 从项目管理器开始说清想法:让 AI 先整理项目方向、名称、核心循环和第一版范围。
  • 先做 HTML 游戏原型:不要一开始就写正式 C# 项目,先让玩家试玩并确认核心方向。
  • 审核通过后再转 C#:把已经验证过的规则、节奏和 UI 反馈转换成 C# 游戏项目。
  • 让 AI 说明边界:每次修改前说明是项目改动还是引擎改动。
  • 用真实错误迭代:把完整报错、日志和复现步骤交给 AI。
  • 验证后再上传:AI 可以提交和推送,但应以用户验证结果为准。
  • 通用能力沉淀:如果某个引擎改动不只适合当前项目,可以整理进主引擎。