跳到主要内容

15 分钟完成第一个 AI 应用

本教程建立一个不连接真实设备的“包装工作站”状态页。你会体验完整闭环:人工创建 app → AI 修改当前工程 → 人工检查 → 开始 → 打开运行页

完成后的结果

运行页应包含:

  • 标题“包装工作站”
  • “模拟模式”标记
  • 状态“未启动”和包装计数 0
  • 清晰的浅色或深色工业看板布局

本节只创建页面,不创建真实设备、不控制 IO,也不编排生产流程。

第 1 步:创建 app

AI 的 app-scoped 工具不会替你创建、导入或注册 app,因此第一步由你完成。

  1. 在应用中心选择创建
  2. 选择空白项目
  3. 名称输入 包装工作站
  4. 工作区路径中选择一个空项目目录。
  5. 暂时不要开启启心代码管理,确认创建。

Theseus 不再把项目创建到默认应用目录;你选择的空目录就是这个 app 的工作区。创建完成后,Theseus 会进入编辑器。空白项目不自带页面,资源(Resources)→ 页面(Pages)为空是正常现象。

第 2 步:打开 AI Command Center

  1. 在编辑器顶栏点击 AI 图标,或按 Cmd/Ctrl+I
  2. 如果还没有可用模型,先按提示前往 AI 设置完成配置。
  3. 新建一个对话。

第 3 步:把目标交给 AI

发送前先在 Git 面板或任务详情中记下工作区已有改动;任务详情显示整个工作区,不是本轮任务的独占清单。然后复制下面的提示词:

目标:为当前 app 创建 `pages/packaging-station.qxpage`,作为“包装工作站”状态页。

范围:只新增这个页面和必要的 app i18n 文案;不要创建 Object、Graph、Query 或自定义 C# 代码,也不要修改 manifest.json。

内容:
- 页面标题为“包装工作站”
- 明确显示“模拟模式”
- 状态显示“未启动”
- 包装计数显示 0
- 使用清晰、紧凑的工业看板布局

验收:
- 先说明准备修改哪些资源
- 修改后运行页面诊断
- 告诉我在编辑器里到哪里检查标题、模式、状态和计数

发送后先看 AI 给出的影响范围。如果它准备创建设备对象、Graph 或脚本,要求它收窄到本节范围后再继续。完成后把文件清单与刚才的基线比较,只处理确认由本轮任务产生的越界改动。

第 4 步:检查 AI 的实际修改

AI 完成不等于教程完成。按下面顺序确认:

  1. 在资源 → 页面中打开新出现的 packaging-station 页面。
  2. 确认中间工作区能看到标题、模拟模式、状态和计数。
  3. 依次选择这些控件,在右侧属性面板检查文本、层级和布局。
  4. 打开问题(Problems),确认当前页面没有错误。
  5. 如果 AI 使用了 i18n,前往设置(Settings)→ 多语言(I18n),确认中英文值都存在。

如果界面仍显示旧内容,先确认当前 tab 没有未保存草稿或磁盘冲突,再重新打开页面;不要直接重复让 AI 覆盖文件。

第 5 步:亲手完成首页设置

在资源 → 页面中右键 packaging-station,选择设为首页,并确认页面名称旁出现首页标记。

AI 创建的是可查看、可编辑的普通工程资产;但哪个页面作为应用入口,是本节由你亲自确认的产品决定。

第 6 步:运行并打开运行页

  1. 点击编辑器顶部的 开始(Start 图标)。
  2. 等待状态变为 运行中
  3. 返回应用中心,在应用卡片上选择打开运行页

运行页应显示“包装工作站”“模拟模式”“未启动”和计数 0,并且没有真实设备控制入口。

验收清单

  • 本节主要工程产物只有 Page 和可选的 i18n;如 AGENTS.md 自动管理区更新,已单独检查内容
  • 问题中没有页面错误
  • 页面已保存并设为首页
  • 应用可以进入运行中状态
  • 运行页内容与编辑器一致
  • 没有创建未经确认的设备动作

出问题时

现象先检查什么
AI 没有模型可选配置并使用 AI Command Center
页面打不开或问题报错把具体错误和当前页面 @ 引用给 AI,请它先诊断再修复
开始失败打开控制台(Console)和问题,按构建与运行检查
运行页提示未设置首页在资源 → 页面中把当前页面设为首页
运行页仍是旧内容确认页面已保存;涉及 Graph 或自定义代码时还需要重新构建或开始

下一步

你完成的结果与完整教程第 1 课一致。可以直接继续页面变量、按钮与 Page Method,加入安全的页面交互;如果想从空白项目重新完整练习,再从完整教程第 1 课开始。