查CheckHere
CLI 文档

CheckHere CLI 使用文档：本地检查网站

CheckHere CLI 在你的电脑或 CI runner 中启动 Chromium，检查目标网站并把完整报告写入本地目录。网页内容、截图和检测结果全程留在执行环境内。

查看源码开始使用

安装与首次设置

安装脚本从 GitHub Release 下载固定版本的 npm 压缩包。setup 命令会安装与 CheckHere 版本匹配的 Chromium。

curl -fsSL https://checkhere.page/install.sh | bash
checkhere setup
checkhere doctor

检查一个网站

传入本地开发地址、预览地址或线上地址。CheckHere 会采集桌面与移动端截图、浏览器错误、资源失败和页面质量信号。

checkhere http://localhost:3000
checkhere https://preview.example.com
checkhere https://example.com --routes routes.txt

报告文件

一次检查会从同一份 report.json 生成面向人的 HTML 报告和面向 Agent 的 Markdown 报告。命令行会输出每个文件的绝对路径。

  • report.html：截图优先的可视化报告
  • report.md：适合 Coding Agent 阅读和执行的修复清单
  • report.json：适合脚本、CI 和二次分析的结构化数据
  • fix-prompt.md：兼容旧工作流的 Markdown 别名

把检查变成发布门槛

ci 子命令提供稳定退出码和可配置阈值，可按严重问题、总分或单页得分阻止有风险的发布。

checkhere ci https://preview.example.com --fail-on=critical
checkhere ci https://preview.example.com --fail-on=score:90
checkhere ci https://preview.example.com --fail-on=page-score:80

常见问题

CheckHere 会上传我的截图吗？

每次检查都在本机或你的 CI runner 内完成，截图和报告写入本地目录。

CheckHere 能检查 localhost 吗？

可以。开发服务器可从当前机器访问时，直接运行 checkhere http://localhost:端口。