reverse-skills-max/vendor-new/xbsReverseSkill/web-js-env-patcher/scripts/load_native_addon.js

#!/usr/bin/env node
'use strict';

const fs = require('fs');
const path = require('path');

const ADDON_COMPATIBLE_NODE_VERSION = '25.8.2';

const REQUIRED_EXPORTS = [
  'createNativeObject',
  'createNativeFunction',
  'createProtoChains',
  'getProtoChainRegistry',
  'deleteProtoChainRegistryEntry',
  'clearProtoChainRegistry',
  'getPrivate',
  'setPrivate',
  'hasPrivate',
  'deletePrivate',
  'createInterceptor',
  'createNativeCollection',
  'getMimeTypesAndPlugins',
  'createGetter',
  'createSetter',
  'createUndetectable',
  'throwTypeError',
];

function parseArgs(argv) {
  const args = { addon: '', json: false, strict: false, markdown: false };
  for (let i = 2; i < argv.length; i++) {
    const a = argv[i];
    if (a === '--addon' || a === '--path') args.addon = argv[++i] || '';
    else if (a === '--json') args.json = true;
    else if (a === '--markdown') args.markdown = true;
    else if (a === '--strict') args.strict = true;
    else if (a === '--help' || a === '-h') args.help = true;
    else throw new Error(`未知参数：${a}`);
  }
  if (!args.json && !args.markdown) args.markdown = true;
  return args;
}

function usage() {
  return `用法：
  node scripts/load_native_addon.js --json
  node scripts/load_native_addon.js --addon <path-to-addon.node> --json

说明：不指定 --addon 时，会尝试从当前 Skill 的 assets/native-addon/<platform>-<arch>/addon.node 加载；也可用 WEB_JS_ENV_PATCHER_ADDON 显式覆盖。`;
}

function exists(p) {
  try { fs.accessSync(p); return true; } catch { return false; }
}

function resolvePortablePath(input, skillDir) {
  if (!input) return '';
  if (path.isAbsolute(input)) return path.resolve(input);
  const cwdPath = path.resolve(input);
  if (exists(cwdPath)) return cwdPath;
  return path.resolve(skillDir, input);
}

function candidatePaths(explicitPath) {
  const out = [];
  const skillDir = path.resolve(__dirname, '..');
  if (explicitPath) out.push(resolvePortablePath(explicitPath, skillDir));
  if (process.env.WEB_JS_ENV_PATCHER_ADDON) out.push(resolvePortablePath(process.env.WEB_JS_ENV_PATCHER_ADDON, skillDir));
  const platformArch = `${process.platform}-${process.arch}`;
  out.push(path.join(skillDir, 'assets', 'native-addon', platformArch, 'addon.node'));
  out.push(path.join(skillDir, 'assets', 'native-addon', platformArch, `addon-${platformArch}.node`));
  out.push(path.join(skillDir, 'assets', 'native-addon', 'addon.node'));
  return [...new Set(out)];
}

function isAbiMismatchMessage(message) {
  return /NODE_MODULE_VERSION|different Node\.js version|compiled against|Module did not self-register|The module was compiled/i.test(String(message || ''));
}

function loadNativeAddon(options = {}) {
  const paths = candidatePaths(options.addon || options.path || '');
  const attempts = [];
  for (const p of paths) {
    if (!exists(p)) {
      attempts.push({ path: p, ok: false, reason: '文件不存在' });
      continue;
    }
    try {
      const addon = require(p);
      const exports = Object.keys(addon).sort();
      const missingExports = REQUIRED_EXPORTS.filter(k => !(k in addon));
      return {
        available: true,
        addon,
        path: p,
        exports,
        missingExports,
        platform: process.platform,
        arch: process.arch,
        node: process.version,
        modules: process.versions.modules,
        abiMismatch: false,
        compatibleNodeVersion: ADDON_COMPATIBLE_NODE_VERSION,
        requiresUserConfirmation: false,
        attempts,
      };
    } catch (err) {
      const reason = err && err.message ? err.message : String(err);
      attempts.push({ path: p, ok: false, reason, abiMismatch: isAbiMismatchMessage(reason) });
    }
  }
  const abiMismatch = attempts.some(a => a.abiMismatch || isAbiMismatchMessage(a.reason));
  return {
    available: false,
    addon: null,
    path: '',
    exports: [],
    missingExports: REQUIRED_EXPORTS.slice(),
    platform: process.platform,
    arch: process.arch,
    node: process.version,
    modules: process.versions.modules,
    abiMismatch,
    compatibleNodeVersion: ADDON_COMPATIBLE_NODE_VERSION,
    requiresUserConfirmation: abiMismatch,
    attempts,
    reason: abiMismatch
      ? `addon.node 与当前 Node ABI 不兼容；兼容 Node.js 版本为 v${ADDON_COMPATIBLE_NODE_VERSION}`
      : '未找到可加载的 addon.node，或当前平台缺少随包产物',
    recovery: abiMismatch ? {
      rule: '不得直接降级；先询问用户是否通过 nvm 安装 / 切换兼容 Node。用户拒绝后才允许 NativeProtect / JS fallback。',
      commands: [
        `nvm install ${ADDON_COMPATIBLE_NODE_VERSION}`,
        `nvm use ${ADDON_COMPATIBLE_NODE_VERSION}`,
        'node -v',
        'node -p "process.versions.modules"',
        'node scripts/load_native_addon.js --json',
      ],
    } : null,
  };
}

function publicResult(result) {
  const { addon, ...rest } = result;
  return rest;
}

function renderMarkdown(result) {
  const lines = [];
  lines.push('# native addon 加载检查');
  lines.push('');
  lines.push(`- 是否可用：${result.available ? '是' : '否'}`);
  lines.push(`- 平台：${result.platform}-${result.arch}`);
  lines.push(`- Node.js：${result.node}`);
  lines.push(`- Node ABI：${result.modules}`);
  if (result.path) lines.push(`- 加载路径：${result.path}`);
  if (result.reason) lines.push(`- 原因：${result.reason}`);
  lines.push(`- addon 兼容 Node：v${result.compatibleNodeVersion || ADDON_COMPATIBLE_NODE_VERSION}`);
  if (result.abiMismatch) lines.push('- ABI 不兼容：是，必须先征得用户同意是否通过 nvm 安装 / 切换兼容 Node，不得直接降级');
  if (result.exports && result.exports.length) lines.push(`- 导出 API：${result.exports.join(', ')}`);
  if (result.missingExports && result.missingExports.length) lines.push(`- 缺少预期 API：${result.missingExports.join(', ')}`);
  if (result.attempts && result.attempts.length) {
    lines.push('');
    lines.push('## 尝试记录');
    for (const a of result.attempts) lines.push(`- ${a.path}：${a.reason}${a.abiMismatch ? '（疑似 ABI 不兼容）' : ''}`);
  }
  if (result.recovery && result.recovery.commands) {
    lines.push('');
    lines.push('## ABI 恢复流程');
    lines.push('');
    lines.push(result.recovery.rule);
    lines.push('');
    lines.push('```bash');
    for (const cmd of result.recovery.commands) lines.push(cmd);
    lines.push('```');
  }
  return lines.join('\n') + '\n';
}

if (require.main === module) {
  try {
    const args = parseArgs(process.argv);
    if (args.help) { console.log(usage()); process.exit(0); }
    const result = loadNativeAddon({ addon: args.addon });
    const output = publicResult(result);
    if (args.json) console.log(JSON.stringify(output, null, 2));
    if (args.markdown) process.stdout.write(renderMarkdown(output));
    if (args.strict && !result.available) process.exit(2);
  } catch (err) {
    console.error(err.message || String(err));
    console.error(usage());
    process.exit(1);
  }
}

module.exports = { loadNativeAddon, REQUIRED_EXPORTS, ADDON_COMPATIBLE_NODE_VERSION, isAbiMismatchMessage };