reverse-skills-max: initial public release (restored, redacted, hardened)
This commit is contained in:
baradok609hecl1pq6qi
@@ -0,0 +1,196 @@
|
||||
#!/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 };
|
||||
Reference in New Issue
Block a user