AppLens · 软件透视

让软件内部看得见。

AppLens 是本地运行的软件分析工具箱，提供命令行和 MCP 两种入口。 用它查看应用的文件结构、模块依赖、接口与数据流，并保留可追溯的证据。

快速开始 · 怎么用 · 能拆什么 · 常用指令 · 连接 AI 助手 · 常见问题 · 下载 Release

能拆什么

同一个软件可能同时包含 Web 页面、原生库和多种资源，通常需要组合分析。 识别文件格式、恢复静态结构和观察运行行为是不同层次，结果会保留证据位置、覆盖范围和无法确认的部分。

外部引擎与平台配置见 安装与配置； Android 分析、.NET 分析、 Flutter 构建识别 提供各自的使用范围。

Related MCP server: REA

Windows 快速开始

需要 Windows 10/11 x64、NTFS 磁盘和 Node.js 24.18.0（含 npm）。 无需为了基础 JavaScript 分析安装 C++ 编译器或 Ghidra。

git clone https://github.com/JichaoChen1123/app-lens.git
cd app-lens
powershell -NoProfile -ExecutionPolicy Bypass -File .\install\install.ps1
.\install\applens.cmd --help
.\install\applens.cmd analyze-javascript-application "C:\Your App" --json

安装脚本下载已发布的 Windows 原生组件，验证 SHA-256 与版本，安装锁定依赖并构建。 它不会修改 AI 助手配置，不会安装 Node、Java 或分析引擎。 已有源码和依赖的开发者可以手动下载同版本 Release 的 applens-windows-x64-native.zip，解压到 native/windows/build/，然后执行：

npm ci --ignore-scripts --registry=https://registry.npmjs.org
npm run build:cached
npm run verify:windows:smoke

连接 AI 助手

在 MCP 客户端中填写本机 Node 和源码入口的绝对路径：

{
  "mcpServers": {
    "applens": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\tools\\app-lens\\scripts\\rea.mjs", "mcp"]
    }
  }
}

也可以先查看配置计划，再决定是否应用：

.\install\applens.cmd setup --client codex --skill=false --dry-run

怎么用

接入 MCP 并重新打开 AI 助手后，直接说明 “用 AppLens”＋目标路径＋想弄清的问题。 可以从整体结构开始，再追问某个功能；不需要先记住所有命令。

一般会按这样的顺序推进：

确认目标与环境 → 盘点文件和组件 → 选择相关代码或工具 → 追踪具体问题 → 整理结论与证据

拿到初步结果后，可以继续追问：

这个结论在哪个文件里？还有哪些条件没有确认？如果自己实现同类功能，可以怎样设计？

基础静态分析不执行目标代码。涉及启动程序、连接运行中的进程、浏览器或设备时，应先明确操作目标和范围。 源码恢复与功能实现建议也会区分：能够解释同类功能怎样实现，不等于已经还原原软件全部源码。

常用指令

以下命令在 源码安装的 app-lens 根目录执行。使用 Release 完整包按发布页安装时， 将 .\install\applens.cmd 换成对应的 .\applens-local\node_modules\.bin\applens.cmd。

查看某条命令的参数，在它后面加 --help。例如，只分析包内指定脚本，并将结果保存为 JSON：

.\install\applens.cmd analyze-javascript-application "C:\targets\app.asar" --help

.\install\applens.cmd analyze-javascript-application "C:\targets\app.asar" --source-path "main.js" --format json |
  Out-File -FilePath .\analysis.json -Encoding utf8

--source-path 必须使用包内实际存在的相对路径；选中的文件不包含隐式依赖。 更新步骤见下方 常见问题，按源码或 Release 安装方式操作。

支持边界

Windows 已建立独立的原生组件构建、打包及验收链路。 JavaScript 分析是否可用，以 npm run verify:windows:smoke 的实际结果为准。 macOS 专用能力不会在 Windows 上伪装可用。原生反编译需要自备 Ghidra 等工具； 不承诺将任意软件恢复为原始源码，也不把静态推断当作运行事实。

• 安装与配置

• 命令与证据

• Windows 使用与验证

• 验证记录

• 完整文档

常见问题

先确认终端已经进入 app-lens 项目目录，并检查 Node.js 版本和架构：

node --version
node -p process.arch

Windows 推荐使用 Node.js 24.18.0 x64，架构应显示 x64。确认环境正确后，可以重新运行 install/install.ps1。

如果卡在下载组件，或不方便从源码构建，可以改用 Releases 中的完整 .tgz 安装包，安装步骤见发布页。仍然失败时，请在 Issues 附上执行的命令、完整报错和系统版本。

Windows 安装脚本只负责安装和构建，不会自动修改 AI 客户端的 MCP 配置。请先按上方「连接 AI 助手」填写本机 Node 和脚本入口的绝对路径，再完全退出并重新打开客户端。

以 Codex 为例，可以在源码安装目录检查配置，并预览接入计划：

.\install\applens.cmd doctor --client codex --format json
.\install\applens.cmd setup --client codex --skill=false --dry-run

--dry-run 只显示计划，不会完成接入；doctor 检查配置和运行条件，也不等于客户端已经建立连接。其他客户端的配置方式见 安装与配置。

Windows 分析需要配套的原生组件。请使用与当前 package.json 版本一致的 Release 附件；不要把不同版本的组件混用。

源码安装可以重新运行 install/install.ps1，由脚本下载并校验组件。也可以手动下载同版本的 applens-windows-x64-native.zip，将其中的 manifest.json 和 rea-windows-x64.node 放到 native/windows/build/，再检查：

node scripts/verify-windows-native-artifact.mjs

完整 .tgz 包已经包含原生组件，正常情况下不需要再单独下载。版本与 SHA-256 校验应通过后再使用，不需要关闭校验来解决安装问题。

AppLens 目前是 命令行工具和 MCP 服务，没有独立的桌面图形界面。可以在终端运行命令，也可以把它接入支持 MCP 的 AI 助手。

源码安装后，运行 .\install\applens.cmd --help 查看命令；使用完整包按发布页安装后，对应入口是 .\applens-local\node_modules\.bin\applens.cmd --help。

本页的安装步骤和发布的原生组件面向 Windows 10/11 x64。Linux、macOS 的核心逻辑有独立 CI 检查，但不代表所有功能都已在三个系统上完整验证。

Windows 原生组件不能用于其他系统；macOS 专用能力也不能直接在 Windows 上使用。与系统或外部引擎相关的功能，请先查看 支持说明 和 doctor 返回的检查结果。

基础 JavaScript / Electron / ASAR 静态分析不需要先装 Ghidra。原生反编译、安卓分析、浏览器运行态分析等功能，则需要对应的引擎、运行环境或设备连接。

如果某个引擎不可用，可以单独检查，例如：

.\install\applens.cmd doctor --provider ghidra --format json

某个可选引擎缺失，不代表所有分析功能都不可用。具体依赖见 安装与配置，Windows 的使用范围见 Windows 使用与验证。

AppLens 以 MIT 许可证开源，本身不收取使用费，也不提供模型额度。直接运行本地静态分析命令，不需要为了分析额外填写模型 API Key。

通过 MCP 让 AI 助手调用 AppLens 时，模型由你使用的 AI 客户端提供；账号、订阅或 API 费用按该客户端及服务商的规则计算。

静态分析主要读取你指定的文件；运行程序、调试进程、操作设备等工具会执行实际动作，使用前需要确认目标和参数，不能把所有工具都理解成只读操作。

AppLens 在本地运行，但接入 AI 后，交给客户端的文件片段、路径和分析结果，可能会被客户端发送给模型服务。数据如何处理取决于所用客户端、模型服务和启用的工具，不等于所有内容都始终留在本机。

Windows 安装脚本不会自动修改 AI 客户端配置；使用 setup 接入时，可以先通过 --dry-run 查看计划。

当前版本通过 GitHub Release 分发，请先查看 最新发布。

• **源码安装：**更新源码后，重新运行 install/install.ps1，安装与该版本匹配的组件和依赖。

• **完整包安装：**下载新版 .tgz，按发布页命令安装到原来的安装目录。

更新后重新启动 MCP 服务或 AI 客户端，让正在运行的进程加载新版文件。源码副本和本地 .tgz 安装不应按 npm 全局安装的方式执行 applens update。

先停止 AppLens 的 CLI / MCP 进程，并在 AI 客户端中移除手动添加的 AppLens MCP 条目。如果通过 setup 添加过集成，先用对应的 AppLens 启动入口执行 uninstall，清理由 AppLens 管理的配置与技能文件；源码安装的命令是 .\install\applens.cmd uninstall。这个命令不等于删除安装包本体。

使用发布页的本地 npm 安装方式时，可以在对应目录运行：

npm uninstall --prefix .\applens-local --ignore-scripts --no-audit --no-fund @jichaochen1123/app-lens

源码安装则可以在停止相关进程后移除自己克隆的 app-lens 目录。

项目目录

app-lens/
├─ src/          核心功能与接口
├─ tests/        测试与验证样例
├─ install/      安装、卸载与 Windows 启动入口
├─ config/       辅助检查配置
├─ docs/         使用、架构和版本文档
├─ scripts/      构建与维护工具
├─ native/       Windows 原生组件源码
├─ bridge/       外部分析引擎桥接
├─ experiments/  实验与性能验证
├─ third_party/  第三方集成材料
└─ licenses/     版权、来源和第三方许可

贡献指南和安全报告方式在 .github/。根目录保留 Node / TypeScript 工具自动发现的配置。

开发

npm run build:cached
npm run check:fast
npm run test:fast
npm run test:windows

CI 分别验证 Linux / macOS 核心逻辑、Windows 实际分析流程与原生资源边界。 尚未发布到 npm；请使用源码安装或 GitHub Release，避免安装同名第三方包。

许可

MIT · 版权与来源记录 · 第三方许可。 仅分析你拥有或获准分析的软件。