LLM 项目发布了 0.37.3 版本,这是一个以修复错误为主的更新,核心目标是解决新版 Homebrew 软件包给 LLM 日志功能带来的兼容性问题。LLM 是 Simon Willison 开发的命令行工具,用于从终端访问各类大语言模型,日志记录是其运行过程中的重要环节。
问题的根源在于 Homebrew 现在捆绑了最新的 SQLite 3.54.1。这个版本包含了一项修复,而该修复恰好改变了 LLM 日志代码所依赖的 SQL 行为。具体来说,在 SQLite 3.54.0 中,执行 select json_object('a', (select json_array(1))) 会得到 {"a":[1]},即嵌套的 JSON 数组被正确嵌入。但升级到 3.54.1 后,同样的查询返回 {"a":"[1]"},数组变成了一个字符串。
SQLite 作者 D. Richard Hipp 对此解释称,这实际上是一个 bug 修复。按照文档说明,(SELECT json_array(...)) 返回的是 SQL 文本,而不是 JSON 值,因此 3.54.1 的行为才是正确的,3.54.0 反而存在 bug。这一变更虽然符合规范,却让依赖旧行为的 LLM 日志代码出现了故障。
为了应对这一变化,LLM 0.37.3 采用了变通方案:在子查询外层再包裹一层 json() 函数,即写成 select json_object('a', json((select json_array(1))))。这样可以显式地将 SQL 文本转换为 JSON,从而恢复预期的嵌套结构。
此次发布提醒开发者,底层依赖库的细节变更可能对上层应用产生意想不到的影响,尤其是在 SQLite 这类被广泛嵌入的组件中。对于使用 LLM 并通过 Homebrew 安装的用户,升级到 0.37.3 即可避免日志功能异常。