依赖解析不按平台过滤:macOS 上会去装只声明了 linux 的 runtime dep

[Sunrisepeak]

现象

在 macOS 上安装 ollama 时,xim 去解析并安装 xim:libcuda-host-link@0.0.1,然后失败:

[xim:xpkg]: [ERROR] cannot get install dir for xim:libcuda-host-link@0.0.1

为什么这不该发生

描述符两侧都已经表达清楚了:

1. pkgs/o/ollama.lua 把那条依赖写在 xpm.linux 段之内:

xpm = {
    linux = {
        deps = { runtime = {
            "xim:glibc@>=2.39",
            "xim:gcc-runtime@15.1.0",
            "xim:libcuda-host-link@0.0.1",   -- ← linux 段内
        }},
    },
    macosx = { ... },
    windows = { ... },
}

2. pkgs/l/libcuda-host-link.lua 的 xpm 只有 linux,没有 macosx。

也就是说,「这条依赖只属于 linux」被声明了两遍,而 macOS 的安装流程仍然去解析它。看起来是 deps.runtime 的收集没有按当前平台段过滤,把别的平台段里的依赖也一起取了。

这个包在 macOS 上本来就不可能装:它是宿主 NVIDIA 驱动的 sentinel,给出一个指向 /usr/lib/x86_64-linux-gnu/libcuda.so.1 的稳定符号链接。

诊断也把人带偏

报的是 cannot get install dir —— 一个内部状态,像是「安装目录算不出来」。真实情况是这个包在当前平台上不存在。这两件事排查方向完全不同;前者会让人去查路径/权限,后者一眼就能看出是平台过滤问题。

建议:遇到「解析到一个当前平台没有 xpm 段的包」时,直接说出来 —— 是哪个包、哪个平台、以及它是被谁拉进来的。

复现

在 macOS 上 xim install ollama(或任何会走 ollama 安装路径的 CI)。

我这边是在 xim-pkgindex 的 macos-install-test 里撞到的:
https://github.com/openxlings/xim-pkgindex/actions/runs/31050326117/job/92455731362

那次 CI 会跑到 ollama 是我的误操作(我往一个 PR 分支推了 merge commit,changed-files 因此把 main 上三个月的变更算成了该 PR 的),已还原。但被暴露出来的这个平台过滤问题与那次误操作无关 —— 只要在 macOS 上装 ollama 就会遇到。

[Sunrisepeak]

定位结果:两个缺陷,都不是"依赖解析不按平台过滤"

先说结论 —— issue 里的假设不成立,但报告的现象是真的,而且指向两个各自独立的缺陷。都已修复。

依赖解析确实是按平台过滤的

src/core/xim/resolver.cppm:

auto rtIt = pkg->xpm.runtime_deps.find(platform);
if (rtIt != pkg->xpm.runtime_deps.end()) node.runtime_deps = rtIt->second;

runtime_deps 是按平台键存的,ollama.lua 也确实只在 xpm.linux 段声明了 xim:libcuda-host-link。所以 macOS 上 resolver 从来没有把它拉进计划。

缺陷一:recipe 的 else 分支把 macOS 当成了 linux

pkgs/o/ollama.lua 的 install():

if is_host("windows") then
    ...
else                                  -- ← 这里包含 macOS
    tar -xzf ...
    __link_cuda_backends()            -- 要 xim:libcuda-host-link 的安装目录
    __install_systemd_user_service()  -- systemd,macOS 上也没有
end

__link_cuda_backends() 第一件事就是 pkginfo.install_dir("xim:libcuda-host-link", "0.0.1") —— 一个 macOS 永远不会解析的包。报错就是从这里出来的,是 hook 期,不是解析期。

同一个 recipe 的另外两个 hook 早就有 is_host("linux") 守卫,install() 是唯一漏掉的。扫了索引里所有带 is_host("windows") 分支的 recipe,同形状的只有 ollama 这一处。

修复:openxlings/xim-pkgindex#532 —— 把两个 linux-only 调用放进 if is_host("linux") then。

缺陷二:诊断信息说的是内部状态

你在 issue 里写的这段是对的,而且比现象本身更重要:

报的是 cannot get install dir —— 一个内部状态……这两件事排查方向完全不同。

这句话覆盖的两个原因指向相反的方向:

原因	该去看哪里
在当前平台上根本不是依赖	recipe 的平台段 / hook 的分支
是依赖,但载荷没落地	依赖包的安装

旧措辞哪边都没指,所以这个 issue 的第一反应是去查解析逻辑。

deps_list 是 resolver 为当前平台产出的结果,所以名字不在里面不等于"算不出来",而是"在这里就不是依赖"。现在的输出:

install dir for xim:libcuda-host-link@0.0.1: NOT a dependency of ollama on
this platform (macosx). Its deps here are: xim:glibc@>=2.39, ... A package
declared only under another platform's xpm section is never resolved on this
one -- guard the hook that asks for it with the platform it belongs to.

修复:openxlings/libxpkg#37(libxpkg 0.0.53),两个分支各一个测试。「已声明但载荷缺失」那个测试断言平台措辞不出现 —— 把安装未完成描述成平台不匹配,会把读者送到同一个错误方向的隔壁房间。

回归验证

xim-pkgindex#532 的 CI,macOS 上装 ollama 已通过(tested: 3, failures: 0),没有 cannot get install dir。这正是这个 issue 的复现路径。

客户端侧随 xlings 2026.8.6.3 发布(#490)。

[Sunrisepeak]

两半都已修复并发布:

• recipe 侧 —— B line: interpose every glvnd entry point, with provenance in the proof xim-pkgindex#532:ollama 的 install() 把两个 linux-only 调用移进 if is_host("linux"),不再让 macOS 走 else 分支
• 客户端侧 —— libxpkg 0.0.53(随 xlings 2026.8.6.3 发布):install_dir 现在说明是"在当前平台上不是依赖"还是"是依赖但载荷没落地",并列出该平台实际的依赖

回归验证:xim-pkgindex#532 的 CI 里 macOS 安装 ollama 通过(tested: 3, failures: 0),不再出现 cannot get install dir。这正是本 issue 的复现路径。

顺带更正 issue 里的假设:依赖解析是按平台过滤的(resolver.cppm 读 runtime_deps[platform]),recipe 的声明也没问题。真正的原因是那个 else 分支,而诊断信息把它说成了路径问题。