模型列表同步 mpetruc/dsh-model-sync

dsh-model-sync

把每个已配置的 llm-pi-ai 服务商对外公布的模型列表，镜像到「设置 → 模型」区域，这样模型下拉框就能显示服务商的完整模型列表，不用手动录入。发现过程走 llm 服务的 discoverModels('llm-pi-ai', …) —— OpenAI 兼容路由用 GET {baseURL}/models，目录路由用已安装的目录。

手动同步

插件每次激活都会跑一遍同步：首次启动，以及任何一次手动重新启用。想按需刷新模型列表，打开「插件」页面（侧边栏 → 插件），展开 dsh-model-sync 卡片，把 model-sync 那一行的开关关掉再打开 —— 重新启用会重启插件，于是约 1.5 s 后跑一遍，重新读取每个服务商对外公布的列表。只有当某次同步至少改动了一个服务商的模型时，才会写入设置区域。

每次激活还会按服务商记录一条结果摘要：[dsh-model-sync] activation summary: … 列出本次新增（或删除，带 prune: true）的模型 id；某个服务商没有任何变化时则打印 no models added or removed。定时同步不打印摘要。

同样的结果会持久化到 model-sync 设置命名空间（lastSync），并直接渲染在插件包的「插件」页面上：打开 dsh-model-sync 卡片，描述和「组件」列表之间会有一个 Last sync 面板，显示运行时间，以及每个服务商一行 —— 新增/删除的 id 列表，或 no models added or removed。面板跟随设置文档，所以触发同步的那次重新启用约 1.5 s 后，它会自己刷新。

同步规则

- 新增 —— 已发现但尚未配置的 id 会被追加，并带上 owner: 'model-sync' 标记（列表里报告了 name / contextWindow / maxTokens / input 元数据时也一并带上）。手动录入的条目不带 owner；已有条目永远不会被改写 —— id、顺序，以及任何手动录入的容量，每次同步后都原样保留。
- 删除（prune: true）—— 标记为 owner: 'model-sync'、但已不再对外公布的条目会被移除。手动录入的条目永远不会被删除。
- 拒绝 —— 某个仍在外公布的归属 id 在两次同步之间消失了，就当作是刻意删除，记进插件状态文件（见下），不再重新添加。手动重新添加被拒绝的 id 会清除拒绝记录。检测只比较同一次激活内连续的两次同步，所以手动重新启用永远不会触发它 —— 重新启用会重置内存里的基线，单次激活同步会把删掉的 id 重新加回来。只有 intervalMinutes 为正数时，删除检测才持续生效。

删除所依据的来源，就靠每条目的 owner 标记（单一来源 —— 不重复维护模型列表）。每个服务商那份小小的 rejected id 列表是同步自己的记账，所以放在插件状态文件里 —— 一份 JSON 文档，位于 <dshHome>/storages/model-sync/state.json（可通过 stateFile）——绝不写进 settings 文档。settings 文档属于用户配置，只保存 Plugins 页面渲染的 lastSync 结果。在这个版本之前配置的条目没有归属者，算作手工录入；把服务商的 models 列表清空一次，让插件重新构建，每个条目就能获得完整追踪。

配置

bundle 会插入一行 model-sync：

- id: model-sync
name: dsh-model-sync
config:
intervalMinutes: 0 # 0 = once per activation (boot or re-enable);
N = also repeat every N minutes
NB: a positive interval also enables deletion detection (rejected)
prune: false # true = remove auto-added ids no longer advertised
providers: [amd-server] # optional: restrict which providers to sync
stateFile: # optional: rejection-baseline state file
(default: <dshHome>/storages/model-sync/state.json)

每次激活——首次启动，或从 Plugins 页面手动重新启用——都会在 llm/settings 服务就绪约 1.5 s 后跑一次同步；intervalMinutes 为正数时，还会按这个周期重复执行。

说明

- 服务商端点不可用时会被跳过并给出警告；发现错误绝不会让这一行失败。
- 每一轮都会记录触发来源——启动/重新启用记作 [dsh-model-sync] activation sync: …，重复定时器记作 … interval sync: …，这样手动切换在宿主日志里就能看到。激活轮次还会追加一行结果摘要：[dsh-model-sync] activation summary: …。
- 拒绝基线在 0.7.0 移出 settings 文档：如果在 model-sync 命名空间里发现 0.7.0 之前的 providers 键，会在下一次同步时迁移进状态文件，并从 settings 文档中删除。
- npm test（node:test 假定时器）需要 Node ≥ 20.4，要消除 --disable-warning 标志则需 ≥ 21.3；插件本身只要求 engines 的 >=18。