umbraco-validation-checks

Umbraco 扩展验证检查

用于手动浏览器测试 Umbraco 后台扩展的参考技能。开始验证测试前，请加载此技能。

检查类别

类别	文件	检查项
配置	configuration-checks.md	VC-1 至 VC-2
导航	navigation-checks.md	VN-1 至 VN-3
API 调试	api-debugging-checks.md	VA-1 至 VA-3
表单控件	form-control-checks.md	VF-1 至 VF-2
工作区	workspace-checks.md	VW-1 至 VW-3

快速参考

ID	检查项	常见症状
配置
VC-1	区块权限	新区块不可见
VC-2	用户组访问权限	只有部分用户能看到扩展
导航
VN-1	树复杂度	树未渲染或缺少项目
VN-2	隐藏的树操作	找不到预期的按钮／操作
VN-3	菜单项可见性	菜单项未显示
API 调试
VA-1	400 错误排查	API 调用失败但没有提示
VA-2	请求负载验证	发送的数据结构有误
VA-3	CORS 和身份验证问题	请求被阻止或未获授权
表单控件
VF-1	Select/Combobox 行为	Select 未填充数据并导致 400 错误
VF-2	输入绑定问题	值未更新或保存
工作区
VW-1	缺少保存按钮	可编辑工作区中没有保存按钮
VW-2	数据未加载	工作区已打开，但显示的值为空
VW-3	提交不起作用	点击保存后没有任何反应

用法

开始手动浏览器验证前，请务必加载此技能。

此技能介绍检查什么。如果你使用 Claude-in-Chrome （mcp__claude-in-chrome 工具）操作后台，还需加载 umbraco-chrome-navigation，了解如何操作 — 后台使用 Lit/shadow-DOM，因此其可穿透 shadow-DOM 的辅助工具才能让你实际导航、操作并读取这些检查所涉及的状态。

验证新扩展时，请阅读所有检查文件；也可以根据观察到的症状，重点查看特定类别。

症状	加载文件
“看不到我的扩展”	configuration-checks、navigation-checks
“API 不工作”	api-debugging-checks
“表单无法使用”	form-control-checks
“树有问题”	navigation-checks
“工作区有问题”	workspace-checks
“没有保存按钮”	workspace-checks

验证工作流

1. 测试前：确保扩展已构建，并清除浏览器缓存
2. 检查 DevTools 控制台：交互前打开 Chrome DevTools（F12）
3. 检查 Network 标签页：按 Fetch/XHR 筛选以查看 API 调用
4. 根据观察结果阅读相关检查文件

记录新问题

遇到现有检查未涵盖的验证问题时：

1. 立即记录到 discovered-issues.md
2. 包含：症状、根本原因、解决方案、建议类别
3. 后续会审查这些问题，并将其纳入正式检查项

这样可以逐步积累知识——每次验证都会改进后续验证。

相关技能

模式领域	技能
通过 Claude-in-Chrome 操作后台	umbraco-chrome-navigation
树的实现	umbraco-tree
区块设置	umbraco-sections
API 客户端设置	umbraco-openapi-client
工作区结构	umbraco-workspace