SuperAPI AI 工具集

umbraco-validation-checks

测试与质量

查看项目

更新于 10-15 21:05

技能介绍

用途:这是 Umbraco 后台扩展手动浏览器验证的参考技能,开始验证测试前应先加载。它说明“该检查什么”,按类别提供检查清单和常见症状对照。

主要能力与检查分类:配置(configuration-checks.md,VC-1 至 VC-2,如新分区不可见、扩展仅部分用户可见);导航(navigation-checks.md,VN-1 至 VN-3,如树不渲染、找不到按钮、菜单项不显示);API 调试(api-debugging-checks.md,VA-1 至 VA-3,如 400 错误、请求负载结构错误、CORS 与鉴权问题);表单控件(form-control-checks.md,VF-1 至 VF-2,如 Select 未填充导致 400、输入绑定不更新);工作区(workspace-checks.md,VW-1 至 VW-3,如缺少保存按钮、数据未加载、提交无反应)。

使用方式:验证新扩展时读取全部检查文件,或按症状聚焦对应类别,例如“看不到扩展”加载配置与导航检查,“API 不工作”加载 API 调试检查,“表单不工作”加载表单控件检查,“树问题”加载导航检查,“工作区问题”或“没有保存按钮”加载工作区检查。验证流程:测试前确保扩展已构建并清除浏览器缓存;交互前打开 Chrome DevTools(F12);在 Network 标签按 Fetch/XHR 过滤查看 API 调用;根据观察读取相关检查文件。若用 Claude-in-Chrome 驱动后台,还应加载 umbraco-chrome-navigation,因为后台是 Lit/shadow-DOM,需要其穿透 shadow-DOM 的辅助工具才能导航、操作和读取状态。

限制与补充:遇到未覆盖的问题时,立即记录到 discovered-issues.md,包含症状、根因、解决方案和建议分类,后续会被审查并提升为正式检查。相关技能包括 umbraco-chrome-navigation、umbraco-tree、umbraco-sections、umbraco-openapi-client、umbraco-workspace。具体检查文件内容与命令资料未提供。