SuperAPI AI 工具集

validate-block-markup

前端与建站

查看项目

更新于 10-16 06:50

技能介绍

用途:校验、诊断或修复由核心区块构成的独立序列化 WordPress Gutenberg 区块标记。判定基于 WordPress 7.0.2 附带的核心区块定义,需告知用户判定所依据的快照版本。

主要能力:区分结构有效性与跨站点可移植性两种结论,并将审查与修复视为不同任务。输出 JSON 报告,包含 valid、错误、警告及 notChecked 条目;解析后重新序列化若改变输入会给出 canonicalMarkup 建议。

使用方式:要求 Node.js 20.10 或更高版本且 npm 在 PATH 中。首次运行会在技能自身目录执行 npm ci 安装约 350 个包(约 545 MB,约 25 秒,需 npm registry 访问),后续离线即时运行;--help 与 --version 不安装任何内容。安装不修改用户项目,但常见 npx skills add 布局会把技能放入用户仓库,需提前说明。仅通过 scripts/validate-block-markup.cjs 运行校验,命令为 node <skill-directory>/scripts/validate-block-markup.cjs [options] [<file|directory|->...],支持多路径、stdin 与 --。目录参数仅校验其中直接包含的 .html 文件,不递归。退出码 0 全部通过、1 存在错误、2 用法或输入错误。

适用场景:审查或修复区块标记、检查跨站点可移植性、诊断编辑器中的区块恢复问题。

限制:valid: true 不代表发布安全;不评估 KSES 过滤、用户权限与目标站点清理;javascript:、data: URL、事件处理属性与内联 script 均不会被标记;链接检查仅针对以单个 / 开头的 href/src 及无匹配 id 的 # 片段。修复模式仅在用户要求修复或标记由自身生成时使用,且需每轮编辑后重跑校验。完整报告结构见 references/validation-contract.md。