用途:检查已安装 Electron 应用内部结构与打包代码。可从 app.asar 中提取资源与 JavaScript,并尽可能还原可读源码。
主要能力:一是自动发现应用,macOS 搜索 /Applications 与 ~/Applications,Windows 搜索 %LOCALAPPDATA%\Programs、%PROGRAMFILES%、%PROGRAMFILES(X86)%、%APPDATA%;二是 asar 解包;三是源码还原,若 .js.map 内嵌 sourcesContent 则重建原始源码树,否则用 Prettier 格式化压缩代码;四是路径还原,把 ../../src/main.ts 之类的打包相对路径还原为 restored/src/main.ts,避免哈希占位名。node_modules 始终跳过。
使用方式:脚本位于 scripts/ 子目录,{baseDir} 为 SKILL.md 所在目录;解析 ${BUN_X} 运行时,已装 bun 用 bun,否则用 npx -y bun。命令示例:${BUN_X} {baseDir}/scripts/main.ts "<app>" [--output <dir>] [--asar <path>] [--force]。可按应用名(如 Codex)或绝对路径(.app 目录、安装目录或 .asar 文件)运行;不确定时可先加 --dry-run 预览解析路径。结果默认输出到 ~/Downloads/<AppName>-electron-extract/,含 extract-report.json、extracted/、extracted.unpacked/ 及可能出现的 restored/。常用选项:--output/-o、--asar、--force/-f、--skip-format、--skip-restore、--no-unpacked、--dry-run、--json。
适用场景:想查看某个 Electron 桌面应用(如 VS Code、Discord、Slack、Obsidian 等)的打包代码与来源结构时使用。
限制:源码还原依赖 .js.map 内嵌 sourcesContent;若映射引用外部文件而未内嵌则跳过该映射,仅格式化对应 .js,并在 extract-report.json 的 warnings 中列出。多匹配时脚本列出候选并以非零退出,需用绝对路径重跑。已有非空输出目录时须加 --force。安全上拒绝写入 /、用户主目录或当前工作目录。Linux 等其他平台需显式传 --asar。不进行全局安装,@electron/asar 与 prettier 通过 npx -y 即时解析,首次运行较慢。