@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）。