SuperAPI AI 工具集

verify

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:验证 metadata-admin 设计器(预览)改动能否在真实浏览器中端到端工作,全程无需后端。

主要能力:console 内置仅开发用的预览画廊,会以编辑模式渲染每个已注册的 metadata 设计器(位于 packages/app-shell/src/views/metadata-admin/previews/*),并配代表性示例草稿。示例草稿存放在 apps/console/src/preview-samples.ts,按元数据类型(flow、workflow、object 等)作为键。

使用方式:启动开发服务器并打开画廊。命令为:cd apps/console && pnpm exec vite --port <free-port> --strictPort,然后访问 http://localhost:<free-port>/preview-gallery.html。可用查询参数只隔离一个设计器,例如 /preview-gallery.html?only=flow,或 ?only=dashboard、page 等。

无头驱动:chrome-devtools MCP 在远程会话可能缺少 Chrome 二进制,应改用仓库自带的 Playwright,预装可执行文件为稳定别名 /opt/pw-browsers/chromium;不要照抄探测到的带版本路径(如 chromium-NNNN/chrome-linux/chrome),镜像升级后别名仍有效,而失效的版本路径会被误判为无浏览器。示例:import { chromium } from '@playwright/test';const browser = await chromium.launch({ executablePath: '/opt/pw-browsers/chromium' })。注意驱动脚本必须位于仓库内(如 node_modules/.drive.mjs,已被 git 忽略),否则 Node 无法解析 @playwright/test;/tmp 下的脚本无法解析工作区依赖。

可用选择器:cmdk 内部可用 [cmdk-item]、[cmdk-group-heading]、[cmdk-empty]、[cmdk-item][data-selected="true"] 定位;流程画布节点卡片匹配 .group.absolute。

限制与说明:服务端驱动的功能(如流程调色板的 GET /api/v1/automation/actions)请求会失败并回退到硬编码默认值,这是预期的离线路径而非错误。清理时只结束自己启动的 vite 服务:kill $(lsof -ti tcp:<port>)。其余安装或平台要求资料未提供。