Windows/ARM release 二进制加载外部扩展失败

你会遇到什么

独立 omp 安装加载外部扩展报 @oh-my-pi/pi-* is not host-provided（Windows），或扩展加载静默失败（darwin-arm64）。典型求助样本：omp-compact#8（2026-08-28 demand 捕获）。装好主程序，扩展却加载不了。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

CHANGELOG v17.1.0 到 v17.1.5 期间的两个 bug：

这类 bug 的共同根源是编译型二进制和源码运行不是一回事：bun build --compile 会把依赖打进单个可执行文件，模块解析规则随之改变——源码运行时，import "@oh-my-pi/pi-*" 能按 node_modules 解析；

编译后 bare import 在宿主环境里找不到对应包（Windows 场景），import.meta.dir 指向的路径也和源码布局不同（darwin-arm64 场景）。

这两处都不是用户配置能绕过的，属于上游打包产物缺陷，用户侧唯一可靠动作就是升级到修复版本并确认版本号——这也是为什么"先 omp --version 再谈排查"的顺序很重要。

一步步来

1. 确认当前版本 — 必做

omp --version

2. 升级 — 必做

bun install -g @oh-my-pi/pi-coding-agent@latest

3. 重试扩展加载 — 必做

升级后重装/重载外部扩展，确认不再报 is not host-provided 或静默失败。

怎么确认修好了

升级后版本与扩展加载正常（预期形态）：

omp --version → omp/18.0.9（≥17.1.5 即含修复）
外部扩展加载 → 正常（不再报 not host-provided）

其它环境的表现

症状

独立 omp 安装加载外部扩展报 @oh-my-pi/pi-* is not host-provided（Windows），或扩展加载静默失败（darwin-arm64）；典型求助样本：omp-compact#8（2026-08-28 demand 捕获）。

原因

CHANGELOG v17.1.0 到 v17.1.5：Windows 编译二进制加载外部扩展失败（bare @oh-my-pi/pi-* 值导入问题）；darwin-arm64 release 二进制扩展静默失败（import.meta.dir 处理 bug）。均于 v17.1.5 修复。

解法

升级到 >=17.1.5（当前最新 18.0.9 已含修复）：bun install -g @oh-my-pi/pi-coding-agent@latest（或按你的安装方式升级）。