@bd7pil/reeve 0.1.13 → 0.1.14

package/default-fallback.json

@@ -30,7 +30,8 @@
     "prefer": ["glm-5.3-flash-free", "mimo-v2.6-flash-free", "deepseek-v4.1-flash-free"],
     "deny": [],
     "require_image": true,
-    "image_models": ["glm-5.3-flash-free", "deepseek-v4.1-flash-free", "mimo-v2.6-flash-free", "nemotron-3.5-super-vl-free"],
+    "modality_url": "https://models.dev/api.json",
+    "modality_ttl_seconds": 21600,
     "static": {}
   },
   "chains": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bd7pil/reeve",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "REEVE 编排层（opencode v2 插件）：agent/skill 注册 + 子任务台账 + GATE 代理层（路由/回退/台账）+ 性能统计",
   "type": "module",
   "main": "index.js",

package/provision.json

@@ -1,7 +1,7 @@
 {
   "schema": 1,
   "name": "reeve",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "license": "MIT",
   "//": "REEVE 在 ocrc 实例里的装配说明。**没有二进制工件** —— 代理层是插件内的 GATE（纯 JS），不需要任何本地服务（Bifrost 时代已结束）。",
   "host": {
@@ -15,7 +15,7 @@
     ]
   },
   "enginePlugin": {
-    "spec": "@bd7pil/reeve@0.1.13",
+    "spec": "@bd7pil/reeve@0.1.14",
     "kind": "package",
     "entry": "~/.ocrc/components/reeve/node_modules/@bd7pil/reeve",
     "requiresPeer": []

package/src/gate/config.js

@@ -45,9 +45,10 @@ export const FREE_DEFAULTS = Object.freeze({
   failure_cooldown_seconds: 600,
   prefer: Object.freeze([]),
   deny: Object.freeze([]),
-  // 免费池只要多模态模型：开启后只保留 image_models 里的 ID（纯文本免费模型不进池）
+  // 免费池只保留 image-capable 模型：模态从 models.dev 动态读取（不再维护静态白名单）
   require_image: false,
-  image_models: Object.freeze([]),
+  modality_url: 'https://models.dev/api.json',
+  modality_ttl_seconds: 21_600,
   static: Object.freeze({}),
   sources: Object.freeze({
     // 公开模型列表（不需要键；拉不到只影响该 provider，请求照常降级到付费）
@@ -125,7 +126,8 @@ export function normalizeGateConfig(raw) {
     prefer: asStrings(fSrc.prefer),
     deny: asStrings(fSrc.deny),
     require_image: fSrc.require_image === true,
-    image_models: asStrings(fSrc.image_models),
+    modality_url: typeof fSrc.modality_url === 'string' && fSrc.modality_url.length > 0 ? fSrc.modality_url : FREE_DEFAULTS.modality_url,
+    modality_ttl_seconds: asInt(fSrc.modality_ttl_seconds, 60, 604_800, FREE_DEFAULTS.modality_ttl_seconds),
     static: {},
     sources: { ...FREE_DEFAULTS.sources },
   }

package/src/gate/free.js

@@ -37,6 +37,8 @@ export function createFreeLane({ getConfig, getAuth = () => ({}), now = Date.now
   /** ref -> { fails: number, until: number }（全局，跨 session：坏模型对所有人都坏） */
   const cooldowns = new Map()
   const inflight = new Map()
+  /** models.dev 的 modalities：{ at, map: Map<ref, boolean>|null, error, inflight } */
+  const modalityCache = { at: 0, map: null, error: null, inflight: null }
 
   const freeCfg = () => {
     const f = getConfig()?.free
@@ -107,6 +109,52 @@ export function createFreeLane({ getConfig, getAuth = () => ({}), now = Date.now
     return inflight.get(id)
   }
 
+  /**
+   * 免费池的模态元数据（models.dev）：只拉一次，TTL 6h；失败保留上一份好数据。
+   * 不能用 Zen 的 `/models`：它只有 id/object/created/owned_by，没有 modalities。
+   */
+  const loadModalities = async () => {
+    const free = freeCfg()
+    if (free.require_image !== true) return modalityCache
+    const ttlMs = Math.max(60, Number(free.modality_ttl_seconds ?? 21_600)) * 1000
+    if (modalityCache.map && now() - modalityCache.at < ttlMs) return modalityCache
+    if (modalityCache.inflight) return modalityCache.inflight
+    const url = typeof free.modality_url === 'string' && free.modality_url.length > 0 ? free.modality_url : 'https://models.dev/api.json'
+    modalityCache.inflight = (async () => {
+      try {
+        const res = await fetchImpl(url, {
+          headers: { accept: 'application/json' },
+          signal: AbortSignal.timeout(Math.max(timeoutMs, 15_000)),
+        })
+        if (!res.ok) throw new Error(`HTTP ${res.status}`)
+        const body = await res.json()
+        const map = new Map()
+        for (const [pid, provider] of Object.entries(body ?? {})) {
+          const models = provider?.models
+          if (!models || typeof models !== 'object') continue
+          for (const [mid, model] of Object.entries(models)) {
+            const input = Array.isArray(model?.modalities?.input)
+              ? model.modalities.input
+              : Array.isArray(model?.input)
+                ? model.input
+                : null
+            map.set(`${pid}/${mid}`, input ? input.includes('image') : model?.attachment === true)
+          }
+        }
+        modalityCache.map = map
+        modalityCache.at = now()
+        modalityCache.error = null
+      } catch (err) {
+        modalityCache.error = String(err?.message ?? err).slice(0, 140)
+        logger?.debug?.(`[gate] 免费池模态元数据拉取失败（保留上一份）：${modalityCache.error}`)
+      } finally {
+        modalityCache.inflight = null
+      }
+      return modalityCache
+    })()
+    return modalityCache.inflight
+  }
+
   const isCooling = (ref) => {
     const c = cooldowns.get(ref)
     if (!c) return false
@@ -127,17 +175,22 @@ export function createFreeLane({ getConfig, getAuth = () => ({}), now = Date.now
     const free = freeCfg()
     if (!free.enabled) return []
     const requireImage = free.require_image === true
-    const imageModels = new Set(asList(free.image_models))
+    let modalities = null
+    if (requireImage) {
+      const m = await loadModalities()
+      modalities = m.map
+      // 元数据从未成功拿到 → 没有可靠证据证明哪个免费模型能吃图；宁可走付费，也不退回纯文本。
+      if (!modalities) return []
+    }
     const out = []
     for (const id of asList(free.providers)) {
       const provider = providers()[id]
       if (!provider?.base_url || !hasKey(provider)) continue
       const st = await load(id)
       for (const model of st.models ?? []) {
-        // 只要多模态免费模型：纯文本的 big-pickle/minimax 等不进池。
-        // 白名单为空时按“没有可用免费候选”处理（降级到付费），绝不退回纯文本。
-        if (requireImage && !imageModels.has(model) && !imageModels.has(`${id}/${model}`)) continue
-        out.push({ provider: id, model, ref: `${id}/${model}` })
+        const ref = `${id}/${model}`
+        if (requireImage && modalities.get(ref) !== true) continue
+        out.push({ provider: id, model, ref })
       }
     }
     return out
@@ -244,6 +297,9 @@ export function createFreeLane({ getConfig, getAuth = () => ({}), now = Date.now
       cooling,
       prefer: asList(free.prefer),
       deny: asList(free.deny),
+      require_image: free.require_image === true,
+      modality_ready: Boolean(modalityCache.map),
+      modality_error: modalityCache.error,
     }
   }
 
@@ -269,6 +325,7 @@ export function createFreeLane({ getConfig, getAuth = () => ({}), now = Date.now
   const warm = () => {
     const free = freeCfg()
     if (free.enabled === false) return
+    if (free.require_image === true) void loadModalities().catch(() => {})
     for (const id of asList(free.providers)) {
       if (providers()[id]?.base_url && hasKey(providers()[id])) void load(id).catch(() => {})
     }