AI 系统
编辑器 AI 工作台
用任务合同、资源查询、工具写入、预览和版本完成纯 AI 创作闭环。
AI 系统 · 创作入口
AI 工作台负责改项目，预览负责证明结果
编辑器 AI 能查询资源、调用编辑工具、拆分任务、读取图片与知识、调试脚本和恢复长会话。它不是聊天式教程，而是项目修改工作台。
# 打开位置与工作区域
在 Editor V2 中打开 AI 助手。桌面端可将对话展开为工作区，移动端使用独立 AI 面板。
主要区域包括：
- 对话列表、新建对话和对话管理；
- 当前任务进度、工具调用和专项子任务记录；
- 消息输入、附件、模型档位和消息队列；
- 配置、记忆、翻译、技能市场与可用工具；
- 本地知识库和系统通知设置。
# 一次完整修改
# 1. 写任务合同
一条可执行请求包含：
- 结果：玩家最终能完成什么；
- 范围：目标场景、资源或功能；
- 保护项：不能改变的数据、样式或兼容行为；
- 设备：桌面、移动端、触摸和键盘；
- 边界：失败、重复、刷新、离线和未登录；
- 验收：可以实际操作的检查步骤。
不要只说“优化一下页面”。说明目标对象与完成证据。
# 2. 强制先查询
输入 @ 可引用属性、组合属性、控件、事件、类、对象筛选器、插件、AI 智能体、场景、动态字符串和表格。引用携带稳定 ID，可避免同名资源和“这个按钮”的歧义。
让 AI 先查询目标、引用和现有脚本，再决定复用、迁移或新建。大范围修改前让它列出影响资源。
# 3. 观察工具写入
AI 通过编辑器工具修改工程数据，而不是只返回代码片段。任务面板显示计划、工具调用和专项子任务；工具成功返回才说明对应写入完成。
停止生成只会停止后续工作，已经完成的工具写入仍保留。
# 4. 用预览验收
打开调试预览实际点击。可使用“选择预览元素”点取渲染元素，AI 会收到控件身份、元素类型、HTML 和最终样式。适合定位溢出、对齐、错误样式和具体控件。
报告问题时提供：操作步骤、预期、实际、日志、截图和目标资源。
# AI 可以直接编辑什么
| 能力面 | 可处理内容 |
|---|---|
| 数据与规则 | 属性、组合属性、控件、事件、类与对象、表格、动态字符串、场景和插件配置 |
| 界面与样式 | 页面与控件样式、绝对布局、图标、图片、客户端视觉和音频脚本 |
| 专项工作 | AI 智能体玩法、地图、全项目翻译、Skill 编写和项目知识整理 |
| 查询与调试 | 引用查询、脚本语法检查、预览调试执行和依据日志修正 |
复杂任务中，主智能体会建立任务计划，并把适合的部分交给专项子任务。通过“显示任务”检查完成项和下一项；子任务对话是只读的执行记录。
# 上下文输入
| 能力 | 适用内容 | 边界 |
|---|---|---|
@ 引用 |
项目实体与稳定 ID | 不替代查询依赖 |
| 图片附件 | 截图、参考图、报错 | 每条消息有数量限制 |
| 画板 | 草图和截图标注 | 说明目标设备和区域 |
| 预览元素 | 实际 HTML 与计算样式 | 只代表所选运行状态 |
| 项目图片 | 已上传资源名和 URL | 先查询再复用 |
| 知识文件 | 设定集、表格、规范、代码参考 | 按需搜索，不自动全量注入 |
# 用 @ 引用项目资源
输入 @ 可以搜索属性、组合属性、控件、事件、对象类、筛选器、插件、AI 智能体、场景、动态字符串和表格。引用会携带稳定资源 ID，可消除同名资源和“这个按钮”之类的歧义；发送后的资源标签还能跳回编辑位置。
引用只锁定目标，不会自动带入全部依赖。仍要要求 AI 查询调用者、被引用资源、脚本槽和运行时上下文。
# 从预览选择实际元素
打开调试预览，启用“选择预览元素”并点击渲染结果。编辑器会把控件身份、元素类型、HTML 与计算样式加入输入区，适合处理具体的居中、溢出、样式覆盖和移动端问题。
预览元素只代表当前存档、设备宽度和交互状态。修复后仍要验证其他状态与响应式断点。
每条消息最多附加 4 张图片。画板可以直接绘制或标注本地图片；上传图片会压缩并上传；个人图片库与“当前项目图片”可提供真实资源名和 URL。让 AI 复用图片前，先让它查询项目资产并明确目标场景或控件。
知识库支持 PDF、Word（.docx）、Excel（.xlsx / .xls）以及 Markdown、JSON、CSV、源码等 UTF-8 文本。PDF、Word 和表格由浏览器先提取成文本，再保存在当前浏览器的项目本地存储中，不自动同步到另一台设备。
# 命令与技能
输入 / 可查看当前可用命令：
| 命令 | 用途 |
|---|---|
/skill <skillId> |
从在线技能市场下载并注入一个 Skill |
| 内置 Skill 命令 | 加载某类编辑任务的专用流程和参考资料 |
/compact |
立即压缩当前上下文并提取长期记忆 |
Skill 是可复用的工作方法和资料，不等于一次工具写入。加载 Skill 后仍需让 AI 查询当前项目资源，并在预览中验收结果。
# 会话、记忆和知识库
| 内容 | 生命周期 |
|---|---|
| 当前会话 | 本次任务消息、工具结果和临时决策 |
| AI 生成记忆 | 压缩时提取的长期项目认知 |
| 用户系统提示词 | 项目级风格、禁区和固定规则 |
| 本地知识库 | 当前浏览器按项目保存的大段资料 |
新会话会获得长期记忆，但不会带走旧会话的每个细节。一个会话只处理一个相对完整的目标，出现长度警告或任务方向变化时新建会话。
# 多会话与后台执行
会话可新建、切换、改名、导出和批量删除；运行中的会话不能删除。保存数量和并发运行数取决于当前权益。
切换浏览器标签时任务会尽量继续，系统通知可报告完成或失败；关闭页面、结束浏览器或系统冻结网页不等于服务器后台任务。长任务保持编辑器打开。
# 消息队列与插话
AI 运行时发送的新消息进入队列，可调整顺序或删除。普通队列适合后续任务；“下一次请求前插话”适合尽快补充约束。插话不会中断正在执行的工具调用。
发现方向错误时先停止或插话，不要排入一串互相冲突的命令。
# 模型、服务与思考
默认 LPAI 服务提供 Max、Advanced 和 Standard 等模型档位，具体可用范围由平台配置与权益决定；档位只影响本条消息的路由，不替代任务合同。
设置 -> 配置 中还可选择默认服务或自定义兼容接口、Chat Completions/Responses、自定义 base URL、模型、API key、思考模式与思考强度。Responses 模式可提供原生推理、工具事件和提示缓存；自定义服务不兼容工具或 Responses 时切回 Chat Completions 或受支持的服务。
# 长会话、压缩与恢复
长会话会创建上下文压缩检查点：旧内容变成摘要，长期认知写入记忆，近期消息保留。/compact 可主动压缩。压缩不是项目版本，也不能证明工具写入正确。
编辑器会持续保存对话和进行中的回合状态。刷新或连接中断后会尝试恢复未完成工作；短暂流式错误也可能重试或续接。如果无法恢复，先读取错误，再发送“继续”，让 AI 重新查询当前项目状态。
出现长度警告时新建会话。新会话会获得持久记忆，但不会获得旧会话里的全部临时决策、未发送队列或尚未写入的计划。
# 恢复、回溯与分支
| 操作 | 会话影响 | 项目数据影响 |
|---|---|---|
| 停止 | 停止当前生成 | 已完成写入保留 |
| 刷新恢复 | 尝试恢复进行中的回合 | 以当前工程为准继续 |
| 回溯 | 删除所选消息之后的会话历史 | 不撤销已写入数据 |
| 创建分支 | 复制此前上下文到新会话 | 两个会话编辑同一项目 |
| 读取版本 | 恢复项目快照 | 真正替换工程数据 |
大改前在 项目设置 -> 版本管理 保存快照；需要回滚时读取版本，不要只回溯聊天。
# 完整验收流程
- 大改前保存项目快照，写清目标、保护项和验收条件。
- 使用
@引用、预览元素、图片或画板消除目标歧义。 - 检查任务面板和每个工具结果；方向偏离时插话或停止。
- 让 AI 检查脚本和首个错误日志，再由作者实际操作关键流程。
- 覆盖成功、失败、重复、刷新、存档恢复、移动端和联网边界。
- 验收通过后再保存版本，记录本次交付结果。
# 验收清单
- AI 查询了真实资源和引用，没有猜 ID；
- 工具结果覆盖计划中的每项修改；
- 预览通过成功、失败、重复、刷新和窄屏；
- 脚本日志没有被忽略的首个错误；
- 项目快照在大改前后都可恢复；
- 新会话能从长期记忆继续，但不会依赖未保存的临时上下文。