[控场AI]
· 6 分钟阅读· 3,251 字

Datasette Lite重写:浏览器里跑完整Python应用

Datasette Lite重写:浏览器里跑完整Python应用

Datasette Lite 基于 Service Worker 重写,让浏览器运行完整 Python 应用并支持 URL 配置。

Datasette Lite 是 Datasette 的浏览器移植版,借助 WebAssembly 与 Pyodide 在客户端运行 Python 应用。作者 Simon Willison 发布了基于 Service Worker 的完全重写版本,解决了初版通过 innerHTML 注入 HTML 导致 JavaScript 功能失效的问题。新版用作用于整个域名的 Service Worker 拦截请求,并通过 `/app/<session>/` 前缀隔离多标签页,使每个标签页拥有独立的 Datasette 实例。URL 参数可组合指定插件、数据库、metadata、视图状态乃至 SQLite 版本,让单个链接成为完整的应用配置,便于复现 bug 和演示功能。该架构不限于 Datasette,几乎任何 Python 应用都可照搬,而 PEP 783 与 AI 工具链正进一步降低浏览器端 Python 的门槛。

Datasette Lite重写:浏览器里跑完整Python应用

Datasette Lite 是 Datasette 的浏览器移植版,借助 WebAssembly 和 Pyodide 让这个服务端 Python 应用直接在客户端运行。作者 Simon Willison 刚刚发布了基于 Service Worker 的完全重写版本,用他的话说,现在的体验"几乎与真正的服务端应用无法区分"。

Datasette Lite接口截图

从"黑科技"到生产级架构

初版 Datasette Lite 诞生于 2022 年,作者自嘲那是个"玩笑"——在浏览器里跑服务端应用确实有点滑稽,但它很快展现出实用价值。问题在于实现方式过于取巧:在一个 Pyodide Web Worker 中运行 Datasette,模拟请求栈,再把生成的 HTML 通过 innerHTML 注入顶层页面。

这种做法的直接后果是:任何依赖 JavaScript 的功能都失效。innerHTML 中的 script 标签不会执行,Worker 里的技巧也无法加载额外的 JS 和 CSS 文件。于是大量 Datasette 插件和交互功能成了摆设。

新版彻底换了一条路:注册一个作用于整个 lite.datasette.io 域名的 Service Worker,拦截页面与资源的 HTTP 请求,转由客户端代码响应。父页面创建一个 iframe,向形如 /app/aa94e6851595/data/places 的地址发起请求——这仍是标准的 Datasette URL,只是多了 /app/<session>/ 前缀。

WebAssembly(Wasm) 是一种可在现代浏览器中高效执行的二进制指令格式,它允许 C、C++、Rust 等语言编译出的代码以接近原生速度运行。Pyodide 则是将 CPython 解释器编译为 WebAssembly 的项目,使完整的 Python 运行时及其科学计算栈(NumPy、pandas 等)能在浏览器里加载执行。Datasette Lite 正是利用 Pyodide 在客户端创建一个隔离的 Python 环境,从而无需后端服务器就能运行 Datasette 这个原本依赖服务端 I/O 的 ASGI 应用。

URL 驱动的定制化实例

/app/<session>/ 前缀不是装饰,而是为了多标签页隔离。Service Worker 在所有标签页之间共享,如果只路由到单一 Datasette 实例,每个标签页配置的插件和参数就会互相干扰。因此父页面为每个标签页生成随机会话 ID,Service Worker 据此把请求路由到该会话专属 Web Worker 中运行的 Datasette 实例。

这套机制让 URL 本身成为完整的应用配置。以官方示例为例,一条 lite.datasette.io 链接可以同时完成:

  • ?install=datasette-maplibre 从 PyPI 安装插件,且可重复传入多个 install 参数
  • ?url=... 加载任意提供开放 CORS 头的 SQLite 数据库(作者习惯托管在 Gist 上)
  • ?metadata=... 加载 metadata.yml,为表和首页添加 HTML 描述
  • #/demo/capitals_and_countries%23map=0/4.2/180&color=continent 作为片段哈希定位到具体视图,再用二次 URL 编码的哈希控制地图插件缩放位置和着色字段

这种"URL 即应用"的思路,作者此前在《URL-addressable Pyodide Python environments》一文中已有系统阐述。对开发者而言,这意味着复现 bug 或演示未完成特性时,不必再启动完整 Web 服务器——一个链接就够了。作者本人在 Datasette 的分页 bug 讨论中就是这样做的:用 ?ref=1.0a42 和 ?ref=1.0a43 两个链接分别展示修复前后的行为。

CORS(跨源资源共享) 是浏览器的一项安全机制,默认禁止网页脚本读取不同源(协议、域名、端口任一不同)的资源。?url= 参数要加载的 SQLite 文件通常托管在第三方服务(如 Gist)上,因此该文件所在服务器必须返回 Access-Control-Allow-Origin 响应头,浏览器才允许 Pyodide 的 fetch 请求读取其内容。这解释了为什么示例强调“提供开放 CORS 头的数据库”——缺少该头时,即便 URL 正确,客户端也无法取得数据。

可以挑选任意 SQLite 版本

另一个值得关注的新特性是 ?sqlite= 参数。Datasette 声称兼容自 3.25 以来的所有 SQLite 版本,而此后 SQLite 又发布了 87 个版本。过去在 Mac 上折腾不同 SQLite 版本与 Python 的搭配并不轻松,WebAssembly 恰好是理想载体:在浏览器里加载自定义 SQLite 构建,测试完关掉标签页即可丢弃。

作者新建了 datasette/pysqlite3-wasm-wheels 仓库,为 163 个不同 SQLite 版本提供 WebAssembly 编译的 pysqlite3 wheel。传入版本号后,Datasette Lite 会解析对应 wheel 路径、下载并安装到 Pyodide 环境。配套的对比工具可以并排运行同一条 SQL,直观呈现不同版本的结果差异——例如 json_object 嵌套 json_array 的返回值在相邻版本间发生了类型变化。

PEP 783 是 Python 社区正在推进的提案,旨在为 WebAssembly 平台(如 Pyodide 和 PyScript)建立标准的二进制 wheel 分发格式与 PyPI 发布规范。目前,包含 C 扩展的 Python 包通常需要针对不同平台单独构建;有了 PEP 783,包作者可以像发布普通 wheel 一样,发布预编译的 WebAssembly wheel,用户无需本地编译工具链即可在浏览器环境中安装。这对 Datasette Lite 的 ?sqlite= 参数至关重要:作者为 163 个 SQLite 版本构建的 pysqlite3 wheel 目前需自行托管,未来可直接通过 PyPI 解析和安装,大幅简化版本管理与分发。

这套方案不只属于 Datasette

作者的野心不止于此。他指出,Datasette Lite 的实现没有任何一处是 Datasette 专属的,几乎所有 Python 应用都能照搬这套思路:完全在浏览器中运行,作为低成本的预览环境、功能演示和 bug 复现手段。

C 和 Rust 扩展曾是障碍,但如今编码智能体足以将它们编译为 Pyodide 兼容的 WebAssembly,PEP 783 落地后还可以直接发布到 PyPI。真正剩下的短板是数据库——SQLite 毫无压力,而 PostgreSQL 或 MySQL 跑在 WebAssembly 里虽然可行,仍是少有人走的路。

值得一提的是,这套系统最初是作者用 Claude Opus 生成的研究原型,直到后来对整体机制足够熟悉,才敢正式投入生产。从架构图到 wheel 构建,AI 在其中扮演了相当重的角色。这或许也说明:浏览器端 Python 运行时的门槛,正在被工具链和智能体一起拉低。

#Datasette Lite#Pyodide#Service Worker#WebAssembly#SQLite#浏览器端Python#URL驱动应用
分享:

相关推荐