Function main

document/script/checkDocRefs.js:251–314

()

}

function main() {
  const args = process.argv.slice(2).filter(Boolean);
  const targetFiles = args.length
    ? args
        .map((p) => path.resolve(p))
        .filter((p) => MDX_EXTS.includes(path.extname(p).toLowerCase()) && fileExists(p))
    : getAllMdxFiles(CONTENT_DIR);

  const refErrors = [];
  for (const mdx of targetFiles) {
    const content = fs.readFileSync(mdx, 'utf-8');
    const refs = extractRefs(content);
    for (const { url, type, index } of refs) {
      const result = isValidRef(url, mdx);
      if (!result.ok) {
        refErrors.push({
          file: mdx,
          line: lineOf(content, index),
          url,
          type,
          expected: result.expected
        });
      }
    }
  }

  // meta 覆盖校验始终全量执行（与 args 无关）
  const metaErrors = checkMetaCoverage();

  const total = refErrors.length + metaErrors.length;
  if (total === 0) {
    console.log(`✅ 已校验 ${targetFiles.length} 个 mdx 文件 + 全部 meta.json，未发现问题`);
    process.exit(0);
  }

  if (refErrors.length > 0) {
    console.error(`❌ 发现 ${refErrors.length} 处无效引用：\n`);
    for (const e of refErrors) {
      const src = path.relative(DOCUMENT_ROOT, e.file);
      console.error(`  ${src}:${e.line}`);
      console.error(`    [${e.type}] ${e.url}`);
      console.error(`    ↳ 不存在: ${e.expected}`);
      console.error('');
    }
  }

  if (metaErrors.length > 0) {
    console.error(`❌ 发现 ${metaErrors.length} 个 meta 文件存在问题：\n`);
    for (const e of metaErrors) {
      const src = path.relative(DOCUMENT_ROOT, e.file);
      if (e.parseError) {
        console.error(`  ${src}`);
        console.error(`    ↳ JSON 解析失败: ${e.parseError}`);
      } else {
        console.error(`  ${src}`);
        console.error(`    ↳ pages 中遗漏 ${e.missing.length} 项:`);
        for (const m of e.missing) console.error(`        - ${m}`);
      }