跳到主要内容
版本:3.0

AI 开发与测试工作流

本页面面向在自己 Steedos 项目中使用 AI 助手的开发者。它不是当前文档站仓库的构建流程。

目标是让 AI 生成的改动可审查、可验证:先计划,再有针对性地修改元数据和 package 文件,启动 Steedos 项目,测试业务流程,然后把具体结果反馈给 AI 助手继续迭代。

1. 准备项目

从标准 Steedos 项目开始:

npx create-steedos-app my-project
cd my-project
yarn

为你的 AI 助手安装 Steedos Skills:

npx skills add steedos/steedos-platform --all

2. 先让 AI 给方案

在修改文件之前,先让 AI 助手分析需求并提出实现计划。

示例:

请使用 Steedos Skills。帮我设计一个 CRM 模块,包含客户、联系人、商机、权限、列表视图和演示数据。请先给出实现计划和文件清单,在我确认前不要编辑文件。

审查计划时,重点看命名、关系、必填字段、权限,以及这些改动应该放在 steedos-packages/ 下的新 package 还是已有 package 中。

3. 小步实施

确认计划后,让 AI 助手进行有针对性的改动。常见文件包括:

  • steedos-packages/<package>/main/default/objects/ 下的对象元数据。
  • applications/tabs/ 下的应用与导航元数据。
  • pages/ 下的页面元数据。
  • triggers/functions/ 下的触发器与函数元数据。
  • 权限、翻译等对应 metadata 目录下的文件。

相关改动应保持在一起,并仔细审查生成的 YAML。

4. 启动并验证

启动 Steedos 项目:

yarn start

打开控制台输出的地址,常见为:

http://localhost:5100

人工验证关键流程:

  • 应用和导航是否出现在预期位置。
  • 列表是否显示预期字段和过滤条件。
  • 表单是否包含必填字段和关系字段。
  • 权限是否符合目标用户。
  • 按钮、触发器、函数行为是否符合预期。

5. 带着证据迭代

如果功能不符合预期,请给 AI 助手提供具体证据:

  • 终端错误日志。
  • 浏览器截图或页面状态。
  • 失败的文件路径、记录或操作。
  • 期望行为和实际行为。

只提供本地/测试环境中可分享的信息,日志和截图应先脱敏,不要包含生产凭据、真实客户数据或其他敏感信息。

示例:

商机保存失败。下面是终端错误和对象文件路径。请定位原因,做最小修复,并告诉我需要重新测试什么。

6. 可选浏览器自动化

复杂流程可以在本地或测试环境中提供测试地址、临时、低权限测试账号、短期有效的密码和目标页面,让 AI 助手使用 Playwright MCP 或其他浏览器自动化工具测试。不要提供真实管理员账号或生产账号密码,也不要长期复用测试密码。

示例:

请使用浏览器自动化测试 CRM 模块。
地址:http://localhost:5100
账号:<本地或测试环境临时、低权限测试账号>
密码:<短期有效的测试账号密码>
目标流程:新建客户、新建联系人、新建商机,然后确认它们出现在列表视图中。

浏览器自动化测试应作为人工审查的补充。发布前,请继续审查生成文件,并与真实用户或产品负责人确认业务流程。