Jundot Engine 文档

AI 助手

Jundot AI Assistant 是 Jundot 的核心工作入口。它不只是回答问题,而是帮助用户创建项目、细化玩法、修复错误、检查结果,并在必要时推动引擎改动。

核心定位

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

  • AI 创建项目:用户描述游戏想法,AI 生成项目结构、场景、脚本和可测试原型。
  • AI 解决问题:当项目报错、构建失败、性能异常或崩溃时,AI 读取现场并修复。
  • AI 改进引擎:当当前引擎能力不足以完成项目需求时,AI 可以在用户确认后修改引擎。
用户验证是边界

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

1. 用 AI 创建并细化项目

用户可以从一个模糊想法开始:

我想做一个霓虹餐厅题材的放置经营游戏,帮我先做一个能运行的原型。

AI 应先和用户细化:

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

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

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

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

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

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

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

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

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

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

[粘贴完整错误日志]

AI 的推荐处理流程:

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

工作模式

模式 用途 典型场景
聊天 讨论想法、解释代码、制定计划。 刚开始构思项目、学习 API、比较方案。
项目模式 读取和修改项目文件、场景和脚本。 创建玩法、修复项目错误、检查脚本。
引擎模式 在确认后修改 Jundot 引擎本身。 项目需求需要新编辑器工具、导入器或引擎能力。

常用指令示例

# 创建游戏
帮我创建一个 2D 平台跳跃原型,先做玩家移动、地面、摄像机和失败重试。

# 细化玩法
现在把这个项目细化成可测试版本:列出要做的功能,然后一步一步实现。

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

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

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

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

最佳实践

  • 先做可测试版本:不要一开始追求完整游戏,先让核心循环跑起来。
  • 让 AI 说明边界:每次修改前说明是项目改动还是引擎改动。
  • 用真实错误迭代:把完整报错、日志和复现步骤交给 AI。
  • 验证后再上传:AI 可以提交和推送,但应以用户验证结果为准。
  • 通用能力沉淀:如果某个引擎改动不只适合当前项目,可以整理进主引擎。