@zhushanwen/pi-provider-live-sync0.2.1
Keep the running pi process's model snapshot in sync with on-disk provider/model/credential config changes.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
@zhushanwen/pi-provider-live-sync
让运行中的 pi 进程实时看到 provider / 模型 / 凭据的配置变更。
解决的问题
pi 的可用模型集合在进程启动时冻结：set_model 从内存快照 getAvailableSnapshot() 解析，
而 pi 自身没有文件 watcher、也没有 refresh RPC。于是「会话开着 → 在设置页新增 provider/模型/凭据 →
直接切到新模型」会失败并报 Model not found（缺凭据与缺模型是同一句文案），只能重开会话。
机制
- 每 2 秒读一次
<agentDir>/models.json与<agentDir>/auth.json（getAgentDir()解析， 尊重PI_CODING_AGENT_DIR），按字节内容比较； - 内容变化（或文件从无到有）→ 调
ctx.modelRegistry.refresh({ allowNetwork: false })： pi 的ModelRuntime.refresh()首行重读磁盘配置并重组 provider，allowNetwork:false保证 零网络请求（本地恢复相位，凭据解析/入网前返回）； - 刷新后读
ctx.modelRegistry.getError()：非空即原样落 ERROR 日志（模型配置被引擎拒绝的 唯一有效判据——该退化形态下refresh().errors为空）。
语义要点（易误解处）
| 情形 | 行为 |
|---|---|
models.json 一直不存在（catalog-only 安装的常态） |
视为非变化信号，不阻断 auth.json 的比较与刷新 |
| 文件曾存在、现在缺失（被隔离/外部删除） | 更新基线但抑制刷新（避免用空配置重建可用集合），只记一行日志 |
| 读失败（权限等非 ENOENT） | 该文件本拍不比较、基线不动；另一文件照常 |
| 刷新抛错 | 基线照常推进（同一内容不重复刷新），下一拍继续 |
安装
作为 taiji 内置扩展随应用打包（mandatory-extensions.json 中 tier=infrastructure）。
独立 pi 用户亦可安装：pi install @zhushanwen/pi-provider-live-sync。
排障
- 日志前缀
[provider-live-sync]：config change detected (...)表示检测到变更并已刷新；model config rejected by the engine: ...表示 pi 拒绝了配置文件（原文含字段路径）；config file disappeared: ...表示文件被隔离/删除（此拍不刷新，引擎保留上一份快照）。 - 配置无轮询开关：周期为设计标定值（2s）。