aura-bridge（npx）

一条命令安装 / 升级 / 卸载 AuraBridge——给 Node 18+ 用户和 CI 的入口，和双击包里的 .bat / .command 调用的是同一个 bridge.py，不是第二套实现。

npx aura-bridge install          # 首次安装（Windows 用随包的 python/，macOS 用系统 python3）
npx aura-bridge upgrade          # 先 npx aura-bridge@latest，再 upgrade
npx aura-bridge uninstall        # 默认保留状态；--purge 连状态一起删
npx aura-bridge status | doctor

它做了什么

• 把产品复制到稳定目录 ~/.aura-bridge/app（$AURA_STATE_DIR/app），然后运行 bridge.py install / upgrade / uninstall。不从 npx 缓存里直接加载扩展——npx 会清缓存， Chrome 的「加载已解压」卡片会因此失效。
• 升级保留 extension/config.js（配对 token），登录、站点策略、面板设置都不丢；要强制重来就 先 npx aura-bridge uninstall。
• Windows 使用包内的 python/python.exe；macOS/Linux 使用系统 python3（需要 3.11+）。 macOS 上没有 Python 时先 xcode-select --install 或到 python.org/downloads/macos 安装。

还需要手动做的一步

Chrome 不允许任何安装器替用户加载未打包扩展。装完后打开 chrome://extensions（Edge：edge://extensions）→ 开发者模式 → 加载已解压的扩展程序 → 选择：

~/.aura-bridge/app/extension

平台

• Windows 10/11：已实测（打包、安装、升级、卸载）。
• macOS 12+：入口与 python3 分支已写，未在真实 Mac 上验证；OS 指针/原生 OS 弹窗兜底仍是 Windows-only，会结构化拒绝。日常导航/读/点击/输入/截图/下载走 CDP/DOM 车道。
• Linux：未验证。

和双击包的关系

npx 需要 Node，适合开发者、服务器、CI；普通用户仍然双击 安装.bat（Windows）或 安装.command（macOS），不需要 Node。两条入口不要同时维护逻辑：npx 只是把同一份产品放到稳定 位置再调用同一组命令。