15 分钟完成第一个 AI 应用
本教程建立一个不连接真实设备的“包装工作站”状态页。你会体验完整闭环:人工创建 app → AI 修改当前工程 → 人工检查 → 开始 → 打开运行页。
完成后的结果
运行页应包含:
- 标题“包装工作站”
- “模拟模式”标记
- 状态“未启动”和包装计数 0
- 清晰的浅色或深色工业看板布局
本节只创建页面,不创建真实设备、不控制 IO,也不编排生产流程。
第 1 步:创建 app
AI 的 app-scoped 工具不会替你创建、导入或注册 app,因此第一步由你完成。
- 在应用中心选择创建。
- 选择空白项目。
- 名称输入
包装工作站。 - 在工作区路径中选择一个空项目目录。
- 暂时不要开启启心代码管理,确认创建。
Theseus 不再把项目创建到默认应用目录;你选择的空目录就是这个 app 的工作区。创建完成后,Theseus 会进入编辑器。空白项目不自带页面,资源(Resources)→ 页面(Pages)为空是正常现象。
第 2 步:打开 AI Command Center
- 在编辑器顶栏点击 AI 图标,或按
Cmd/Ctrl+I。 - 如果还没有可用模型,先按提示前往 AI 设置完成配置。
- 新建一个对话。
第 3 步:把目标交给 AI
发送前先在 Git 面板或任务详情中记下工作区已有改动;任务详情显示整个工作区,不是本轮任务的独占清单。然后复制下面的提示词:
目标:为当前 app 创建 `pages/packaging-station.qxpage`,作为“包装工作站”状态页。
范围:只新增这个页面和必要的 app i18n 文案;不要创建 Object、Graph、Query 或自定义 C# 代码,也不要修改 manifest.json。
内容:
- 页面标题为“包装工作站”
- 明确显示“模拟模式”
- 状态显示“未启动”
- 包装计数显示 0
- 使用清晰、紧凑的工业看板布局
验收:
- 先说明准备修改哪些资源
- 修改后运行页面诊断
- 告诉我在编辑器里到哪里检查标题、模式、状态和计数
发送后先看 AI 给出的影响范围。如果它准备创建设备对象、Graph 或脚本,要求它收窄到本节范围后再继续。完成后把文件清单与刚才的基线比较,只处理确认由本轮任务产生的越界改动。
第 4 步:检查 AI 的实际修改
AI 完成不等于教程完成。按下面顺序确认:
- 在资源 → 页面中打开新出现的
packaging-station页面。 - 确认中间工作区能看到标题、模拟模式、状态和计数。
- 依次选择这些控件,在右侧属性面板检查文本、层级和布局。
- 打开问题(Problems),确认当前页面没有错误。
- 如果 AI 使用了 i18n,前往设置(Settings)→ 多语言(I18n),确认中英文值都存在。
如果界面仍显示旧内容,先确认当前 tab 没有未保存草稿或磁盘冲突,再重新打开页面;不要直接重复让 AI 覆盖文件。
第 5 步:亲手完成首页设置
在资源 → 页面中右键 packaging-station,选择设为首页,并确认页面名称旁出现首页标记。
AI 创建的是可查看、可编辑的普通工程资产;但哪个页面作为应用入口,是本节由你亲自确认的产品决定。
第 6 步:运行并打开运行页
- 点击编辑器顶部的 开始(Start 图标)。
- 等待状态变为 运行中。
- 返回应用中心,在应用卡片上选择打开运行页。
运行页应显示“包装工作站”“模拟模式”“未启动”和计数 0,并且没有真实设备控制入口。
验收清单
- 本节主要工程产物只有 Page 和可选的 i18n;如
AGENTS.md自动管理区更新,已单独检查内容 - 问题中没有页面错误
- 页面已保存并设为首页
- 应用可以进入运行中状态
- 运行页内容与编辑器一致
- 没有创建未经确认的设备动作
出问题时
| 现象 | 先检查什么 |
|---|---|
| AI 没有模型可选 | 配置并使用 AI Command Center |
| 页面打不开或问题报错 | 把具体错误和当前页面 @ 引用给 AI,请它先诊断再修复 |
| 开始失败 | 打开控制台(Console)和问题,按构建与运行检查 |
| 运行页提示未设置首页 | 在资源 → 页面中把当前页面设为首页 |
| 运行页仍是旧内容 | 确认页面已保存;涉及 Graph 或自定义代码时还需要重新构建或开始 |
下一步
你完成的结果与完整教程第 1 课一致。可以直接继续页面变量、按钮与 Page Method,加入安全的页面交互;如果想从空白项目重新完整练习,再从完整教程第 1 课开始。