让普通用户免装 Python 使用桌面应用
作者通过内置可迁移的 CPython 运行时,让 Python 桌面助手无需终端和预装解释器即可安装使用。实现涉及固定运行时版本、SHA-256 校验,以及新目录解压后切换的更新方式。
AI 深度解读
让一个没装过 Python、没用过 GitHub 的人用上 Python 桌面应用,难点往往在第一次启动之前。JARVIS 作者给自己设了一个验收标准:用户能独立找到下载包、完成安装并发出第一条指令,全程不用终端,也不用找作者帮忙。
他的做法是把解释器随应用一起交付,再围绕 Windows 安装、macOS 路径隔离和真实安装包测试逐个补洞。这篇值得读的地方,是它把「代码能跑」推进到了「别人拿到就能用」,同时也交代了尚未解决的签名问题。
用户不该先学会安装 Python
JARVIS 是一个只使用 Python 标准库的桌面助手。过去,安装说明的第一步是安装 Python 3.11。对开发者来说很普通,对非开发者来说却足以让流程中断。
作者选择用 python-build-standalone 提供的可重定位 CPython 构建,把解释器装进应用包。可重定位的意思是:解释器换个目录,仍能运行,不依赖用户预先配置好的系统环境。
Windows 运行时压缩后为 22 MB,每个 Mac 版本约 25 MB。构建脚本下载固定版本,并用仓库 installer/runtime.py 中记录的 SHA-256 校验,再把它放进安装包。用户安装时,解释器解压到应用旁边,不修改系统 Python。
把运行环境一起交付,才能让安装成功少依赖用户电脑上的偶然条件。
更新也要考虑中途失败。作者只在版本变化时解压解释器,先放进新目录,再切换目录,避免留下替换到一半的解释器。
不过,应用内更新器本身也运行在这份 Python 上。安装器原本会停止安装目录里的所有 JARVIS 进程,差点把正在执行更新的进程链一起终止。修复方式是跳过安装器自身的祖先进程。自动清理旧进程之前,必须先弄清谁在负责这次更新。
安装器为什么必须服从平台规则
Windows 端的 JARVIS-Setup.exe 使用系统内置 IExpress,把 zip 和一个小脚本封装起来。它检查剩余空间、停止正在运行的副本,按用户安装,无须管理员权限,然后注册到 Settings > Apps 并启动 JARVIS。
卸载时,用户可以选择把数据和笔记移到 Recycle Bin。这里处理的不只是程序文件,还包括用户已经投入时间生成的内容。
macOS 的坑更隐蔽。作者最初提供 Install JARVIS.command,双击会打开 Terminal;后来改成用 osacompile 生成的小型 AppleScript 应用。
第一版把安装资源放在应用旁边。作者发现,这种布局会被应用转移机制(app translocation)打破:带有隔离标记、在下载位置打开的应用,可能从一个隐藏的只读副本运行,而副本里只有应用本身,旁边的文件不会跟过去。
解决办法是把所有安装资源放进应用包的 Contents/Resources。资源装好后,还要重新进行临时签名(ad hoc signing),否则包内容与签名不一致,会被系统报告为「已损坏」。
这也是桌面交付容易误判的地方:开发目录里路径可用,不代表用户双击下载文件时路径仍然可用。
CI 要验证用户下载的那个包
作者以前从源码目录执行安装测试,后来改成让 CI 构建真实安装包,再在全新的 GitHub runners 上走安装流程。
Windows 运行 Setup.exe;Mac 执行安装器应用自身的脚本。随后打开 JARVIS,通过窗口使用的同一套 API 发送首条指令 open calculator,检查目标程序是否运行,最后卸载,并核对笔记是否去了用户指定的位置。原文没有给出这套 API 的具体名称。
这条链路覆盖了安装、启动、指令执行和卸载后的数据去向,比单独验证源码能启动更接近交付目标。
但测试仍有边界。Mac 测试直接执行应用内部脚本,不能据此认定已经覆盖 Finder 双击、隔离属性和全部系统提示。原文也没有提供真实非技术用户完成安装的成功率。
我的判断
作者最有价值的选择,是把验收终点设在「用户完成第一条指令」,而不是安装器显示成功。捆绑解释器、校验下载、切换运行时目录、验证卸载数据,都服务于这个目标。
不过,这仍是一份项目经验记录。原文没有给出与其他打包方案的对照数据,也没有比较包体积、启动速度和维护成本,不能据此认定 IExpress 或捆绑完整解释器适合所有 Python 应用。JARVIS 只依赖标准库,带有第三方依赖的项目还需要另行验证。
最后一段也不能略过:正式代码签名尚未完成。作者表示,缺少 Apple Developer membership 和 Windows certificate 时,Gatekeeper 与 SmartScreen 仍会警告,下载页需要解释如何继续。前面的 ad hoc 签名解决了包内容一致性问题,却没有消除这里的分发阻力。
因此,「用户全程不用求助」仍是作者追求的验收目标,原文尚不足以证明它已经对普通用户稳定成立。
能拿来做什么
- 给非开发者交付 Python 工具时,把「安装 Python」算进产品成本,评估随包提供固定运行时,并保留版本固定与 SHA-256 校验。
- 检查桌面应用的更新流程,尤其是停止进程和替换运行时的顺序,确认更新器不会终止自己依赖的进程。
- 把 CI 的入口改成最终安装包,至少验证安装、启动、执行一条真实指令、卸载及用户数据去向。
- 如果用 AI 辅助生成安装脚本,把安装资源位置、签名时机和进程关系写进验收条件,再用实际下载包验证这些条件。