扫描网站

scan 命令用于获取公共 URL，测量总页面大小，并审计页面的 i18n 和 SEO 健康状况。它会生成一份评分报告（0–100），涵盖 HTML 属性、规范链接、hreflang 标签、robots.txt、sitemap.xml、本地化内部链接以及 JavaScript 包中的语言包体积权重。

无需额外依赖。安装 puppeteer 后，扫描可以捕获延迟加载的 JavaScript 分包，以进行更精确的包体分析；否则，它将退化为检查 HTML 中声明的同步加载脚本。

用法

npx intlayer scan <url>

示例

npx intlayer scan https://example.com

示例输出：

🔍 Scanned https://example.com (basic mode)

Score: 90/100
Page size: 10.60 MB (HTML 42.31 KB)
Locales: en, fr, es, de, …

Checks:
  ✓ html lang attribute
  ✓ html dir attribute
  ✓ canonical link
  ✓ hreflang tags
  ✓ x-default hreflang
  ✓ localized internal links
  ⚠ all internal links localized
  ✓ current locale detected
  ✓ robots.txt present
  ✓ robots.txt keeps locale paths crawlable
  ✓ sitemap.xml present
  ✓ sitemap lists every locale
  ✓ sitemap has alternate links
  ✓ sitemap has x-default

Bundle locale weight:
  Translations shipped: 120.50 KB
  Unused (other locales): 45.20 KB (37%)

选项

<url> (必填)

要扫描的完整 URL（例如 https://example.com）。

--no-deep

禁用基于渲染的深度扫描。

默认情况下，该命令会尝试使用 puppeteer 在无头浏览器中渲染页面，捕获延迟加载的 JavaScript 分包，并测量实际传输大小。如果未安装 puppeteer，该命令将自动退回到基本模式。

传入 --no-deep 以强制使用基本模式，即使 puppeteer 可用。

示例：npx intlayer scan https://example.com --no-deep

--json

将完整的扫描结果输出为 JSON 对象，而不是格式化的报告。适用于程序消费或 CI 流水线。

示例：npx intlayer scan https://example.com --json

标准配置选项

• --base-dir — 用于定位 intlayer.config.* 文件的基目录。
• -e, --env — 目标环境（例如 development，production）。
• --env-file — 自定义 .env 文件的路径。
• --no-cache — 禁用配置缓存。
• --ci — 在 monorepo 的每个 Intlayer 项目中执行该命令（在项目目录内运行时仅处理当前项目）。可通过 INTLAYER_PROJECT_CREDENTIALS（将项目路径映射到 { "clientId", "clientSecret" } 的 JSON 对象）为每个项目注入凭据。
• --verbose — 启用详细日志记录（CLI 模式下默认开启）。
• --prefix — 自定义日志前缀。

检查内容

最终得分是所有通过的检查项的加权总和，以百分比（0-100）表示。

以编程方式使用扫描功能

scan 函数也从 @intlayer/cli 中导出，因此可以从您自己的脚本中调用：

import { scan } from "@intlayer/cli";

await scan("https://example.com", {
  deep: false,
  json: false,
});

对于更低级别的访问，来自 @intlayer/engine/scan 的 scanWebsite 会返回一个结构化的 ScanResult 对象：

import { scanWebsite } from "@intlayer/engine/scan";

const result = await scanWebsite("https://example.com", { deep: false });
console.log(result.score, result.totalPageSize, result.events);