SuperAPI AI 工具集

devflow-automation

测试与质量

查看项目

更新于 10-15 21:12

技能介绍

用途:DevFlow Automation 让 .NET MAUI 应用把可复用的自动化快捷操作以 [DevFlowAction] 显式暴露给 DevFlow,用它们快速到达有用的应用状态,例如登录测试用户、填充数据、切换功能开关或跳转到深层页面。

主要能力与用法:开始时应尽早列出可用操作:maui_list_actions。常见命名模式包括 login-(认证)、seed-(数据填充)、navigate-(深层链接或页面准备)、set-(功能开关或配置)、reset-*(状态清理)。调用操作时参数按参数顺序以 JSON 数组传入,可省略尾部可选参数以使用默认值,例如:maui_invoke_action actionName="login-test-user";maui_invoke_action actionName="login-test-user" argsJson='["alice@test.com", "secret"]';maui_invoke_action actionName="seed-catalog" argsJson='[100]'。调用后可用截图、树查询等 DevFlow 工具验证状态,例如 maui_screenshot。批量场景可用 invoke-action 组合多个步骤。

热重载工作流:若没有合适操作且可编辑应用,可添加带 [DevFlowAction] 的 public static 方法,为每个参数加 [Description],保存后由 C# Hot Reload 应用改动,再次调用 maui_list_actions 并执行新操作。支持参数类型包括 string、bool、整数类型、浮点/十进制类型、枚举、数组或受支持的列表接口、可空类型。

限制与规则:操作必须显式选择,DevFlow 不暴露任意反射调用。方法必须为 public static;参数应使用受支持的简单类型;建议返回 void、Task、ValueTask、Task<T> 或 ValueTask<T>;操作名应唯一且表意清晰。DevFlow 分析器会校验:MAUI_DFA001(不支持的参数类型,错误)、MAUI_DFA002(方法必须为 public static,错误)、MAUI_DFA003(返回类型可能无法干净序列化,警告)、MAUI_DFA004(参数缺少 [Description],信息)、MAUI_DFA005(重复的 [DevFlowAction] 名称,警告)。可选会话反馈提示需询问用户后才运行 maui-devflow-session-review,不应自动运行。收费、价格、平台等其它信息暂未提供。