webcheck · 网页交付前检查|29 项自动检查,输出带证据的报告

作品简介

网页做好了,交付之前跑一遍

用 AI 把网页做出来之后,问题往往在交付那一刻才暴露:手机上多出一截、图片在窄屏没加载、按钮点下去没反应、链接还是 #。这些不是审美问题,是客户第一眼就会看到的问题。

webcheck 是一个装在本机的检查技能包:按「源码 + 真浏览器」两条线跑 29 项检查,输出一份带证据的报告——哪一项没通过、证据是什么、哪几项这次没查到,分开写清楚。

不需要注册账号,页面和材料不上传任何服务器,报告和截图都写在你自己的电脑上。

你会拿到什么

  • SKILL.md:交给 Agent 用的技能说明(怎么装、怎么跑、怎么读报告)
  • README.md:手动安装与运行步骤,附常见错误处理
  • scripts/check.mjs:检查器本体,29 项规则都在里面
  • package.json / package-lock.json:依赖清单,只有一个依赖 playwright-core
  • LICENSE.txt:使用许可与第三方声明

压缩包约 118 KB,解压即用。运行需要 Node.js 20 或更高版本、npm、Chrome 或 Edge。

29 项检查,归成 9 类

报告里每一项都带编号(S-01、R-01、E-01…),和下面这些类目对得上:

  • 源码 · 可访问性:图片缺 alt、输入框没有可读标签、删掉焦点框没有替代、html 缺 lang、标题层级跳跃
  • 源码 · 链接与交互:div 当按钮用、占位链接、空 mailto / tel、用 alert 当提示、外链缺 rel=noopener
  • 源码 · 安全与遗留物:疑似硬编码密钥(只点名位置,报告不写入具体值)、TODO / FIXME 残留、写死的固定宽度
  • 渲染 · 溢出与空页:1440 / 768 / 390 三档横向溢出,量出内容实际宽度并列出顶出去的元素;等 6 秒还是空页会直接报「无法确认页面正常」,不放行
  • 渲染 · 资源与图片:资源 4xx / 5xx 给出具体路径和状态码;渲染后仍缺 alt;背景图没有可读名称
  • 渲染 · 锚点、焦点与报错:锚点指向不存在的 id、键盘聚焦看不见位置、控制台报错逐条记录
  • 导出 · CSV 编码与结构:有没有 BOM(Excel 打开中文乱码的根源)、逐行列数是否一致
  • 导出 · 其他格式与连点:非 CSV 导出会明确标注「未做内容校验,需你手动打开确认」;连点两次会不会产出重复文件
  • 非法输入与提示:数字框填 abc 会不会显示 NaN、动画有没有适配减少动态、可点区域是否偏小

一次真实运行

拿一个演示用的花店落地页跑一遍:390px 下内容宽 464px,多出 74px,报告点名是 article.card 顶出去的;按报告改完重跑,这一项清零。

同一份报告里还写着「导出相关的 4 项没有运行,因为页面没有导出按钮」——既不算失败,也不能说检查过。这种「没查到什么」会单列一节,不混进「通过」。

站内商品页可以直接下载这份报告的原文,先看再做决定:maker.tuxutool.com/skills/webcheck

怎么用

  1. 装:解压到一个目录,执行 npm install(只有一个依赖,约几十 MB 的浏览器包另算)。
  2. 跑:把要检查的网页目录或网址交给 Agent,或自己执行一条命令。
  3. 读:报告分三段——必须修、建议修、这次没查到什么。改完再跑一次对比。

不写代码也能用:把它交给能读写本机文件、能执行终端的 Agent,按随包说明装好即可。Agent 能不能自动发现这个技能,取决于客户端和配置,装完需要实际试一次。

它不做什么

  • 不替你修。它只负责查出问题并给出证据,修改仍要人或 Agent 来做。
  • 不是安全审计,只扫密钥和明显的混合内容,不做渗透测试。
  • 不是无障碍合规认证,只能验证属性存在,验证不了读屏念得对不对。
  • 窄视口不等于真机。iOS Safari 的地址栏收放、100vh、字体渲染都不一样;Safari 和 Firefox 不跑。
  • 业务对不对、文案是不是真的,脚本不知道。退款规则写得对不对,得你自己看。

许可与交付

个人使用许可:你自己、你负责的项目可以随便用,也可以改;不能转售、不能公开分发这份技能包本身。要在团队内分发或用于对外交付,请先联系我。

一次买断:你拿到的是购买时这一版,之后的新版本不会再发给你。如果以后出了新版,会作为新商品单独上架,你按需决定要不要买。

电子文件,付款后直接下载附件,不需要等发货,也没有实物邮寄。

创作时间: