SuperAPI AI 工具集

platform-apex-anonymous-run

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:在已连接的 Salesforce 组织上执行匿名 Apex,支持 .apex 文件或对话中粘贴的代码片段,并回传编译与运行结果。它是 VS Code Execute Anonymous Apex 的智能体侧等价物,只负责运行,不负责生成或测试代码。

主要能力:解析目标组织别名;区分文件模式与片段模式;用 sf apex run --file 执行并始终加 --json;解析返回的 compiled、success、compileProblem、exceptionMessage、exceptionStackTrace、line、column、logs 等字段;按编译失败、运行异常、成功三种情况分别呈现;提取日志中的 LIMIT_USAGE_FOR_NS、EXCEPTION_THROWN、FATAL_ERROR、循环内 SOQL、未批量 DML 等信号;短日志内联、长日志写入 .sfdx/tmp/anon-<ts>.log 并附尾部摘要。

使用方式:先用 sf config get target-org --json 解析别名,未设置时询问开发者,不静默默认;片段模式先用 Write 工具写入 .sfdx/tmp/anon-<ts>.apex 再执行,因为当前 CLI 只支持 --file,不支持内联代码标志;执行命令为 sf apex run --file <path> --target-org <alias> --json;如需日志可另开终端运行 sf apex tail log --target-org <alias> --color 以自动创建短期 TraceFlag。

适用场景:运行种子数据脚本、执行只读查询并读取 System.debug 输出、用 Savepoint 加 rollback 包裹的验证型脚本等。

限制与注意:匿名 Apex 以运行用户权限执行,可做 DML、callout 和平台事件,应视为写操作;生产组织仅提示警告,不自动阻止,破坏性脚本需开发者明确确认后才执行;不得运行未生成或未展示过的代码,粘贴片段须先回显确认;临时文件不自动清理;深度日志分析应交给 platform-apex-logs-debug,编写 .cls/.trigger 交给 platform-apex-generate,单元测试交给 platform-apex-test-run。