mirror of
https://gitcode.com/JianFeeeee/ModelRouter.git
synced 2026-11-07 09:47:23 +00:00
fix(channels): 能力元数据拉不到的真因说清楚(内核 4MiB 堆保护,非网络故障)
部署后发现 `capabilitiesMeta` 一直是空。逐层排查出来的真因: 1. `models.dev` 未在出站白名单 → 而 refreshCapabilities 的 `pcall` 把错误**静默 吞掉**了,表现是"能力永远是空",排查零线索。→ 失败必须留痕(已修)。 2. 批准该 host 后暴露第二层:**内核的 `__llmsproxy_http` 有 4 MiB 响应上限** (`httpMaxResponse`,刻意的堆保护),而 `models.dev/api.json` 实测 **5.64 MB**。 3. 参考提到的"轻量分片端点"(`/api/v1/opencode.json`)实测返回 **HTML 首页** (2.0 MB 的页面,不是 JSON)—— 参考也记录了这个坑。 ⇒ 决定:**不为一个插件的便利去放宽内核的堆保护上限**(那会让所有插件都能拉 5MB+ 进网关堆)。能力元数据定位为**可选增强**: - 拉得到 → isFree/上下文/模态用权威值; - 拉不到 → 如实退回兜底表,并把"响应超限"单独讲清楚(让运维知道这是**上限约束** 而不是网络坏了)。不把"查不到"说成别的原因。 ★ 这条本身也是本轮的一个教训:`pcall` 只写 `local ok = pcall(f)` 而不看返回值, 等于把一手诊断信息扔了。同类问题本轮已修两处(另一处是 host 授权静默失效)。 回归:9 个包全绿(能力增强不可用时功能不退化,判据已覆盖"冷启动退回兜底")。
This commit is contained in:
@ -1961,6 +1961,9 @@ local function declaredHosts()
|
||||
if p.models_remote then
|
||||
for _, m in ipairs(p.models_remote.endpoints or {}) do addHost(m.url) end
|
||||
end
|
||||
-- 能力元数据来源(照参考 opencode-capability)。必须声明,否则出站被拒
|
||||
-- 而 refreshCapabilities 的 pcall 会把错误吞掉 —— 表现是"能力永远是空"。
|
||||
if p.capability_key then addHost("https://models.dev/api.json") end
|
||||
if p.balance then addHost(p.balance.url) end
|
||||
if p.checkin_status then addHost(p.checkin_status.url) end
|
||||
if p.callback then addHost(p.callback.exchange_url) end
|
||||
@ -5085,6 +5088,17 @@ plugin.schedule = {
|
||||
-- 与模型目录刷新同一节拍。请求路径只读缓存。
|
||||
local MODELS_DEV_URL = "https://models.dev/api.json"
|
||||
local MODELS_DEV_TTL = 6 * 3600 -- 6 小时(照参考的 TTL 量级)
|
||||
--
|
||||
-- ⚠️ **已知取不到,属设计约束而非故障**:该端点实测 **5.64 MB**,而内核的
|
||||
-- `__llmsproxy_http` 有 **4 MiB 响应上限**(`httpMaxResponse`,刻意的堆保护 ——
|
||||
-- 不能让一个插件把整份数据拉进网关堆)。参考提到的"轻量分片端点"
|
||||
-- (`/api/v1/opencode.json`)实测返回的是 **HTML 首页**(2.0 MB),不是 JSON。
|
||||
--
|
||||
-- ⇒ 能力元数据定位为**可选增强**:
|
||||
-- * 拉得到 → isFree/上下文/模态用权威值;
|
||||
-- * 拉不到 → 如实退回兜底表,且失败信息说明是"响应超限"(让运维知道
|
||||
-- 这是上限约束,不是网络坏了)。
|
||||
-- **不**为了它去放宽内核上限(那会让所有插件都能拉 5MB+ 进堆)。
|
||||
|
||||
-- normalizeCapability(id, raw):照参考 normalizeEntry 的字段口径。
|
||||
--
|
||||
@ -5144,7 +5158,14 @@ local function refreshCapabilities()
|
||||
headers = { ["Accept"] = "application/json" },
|
||||
})
|
||||
if err or not resp or resp.status ~= 200 then
|
||||
return false, "拉取失败: " .. tostring(err or (resp and resp.status))
|
||||
local es = tostring(err or (resp and resp.status))
|
||||
-- 把"响应超限"单独说清楚:那是**内核的刻意的堆保护**(4 MiB),不是网络故障。
|
||||
-- 否则运维会去查网络、查白名单,而真正的原因是我们主动不放开这个上限。
|
||||
if es:find("byte cap") then
|
||||
return false, "能力元数据源 5.6MB 超过内核 4MiB 响应上限(刻意的堆保护,"
|
||||
.. "不为此放宽)—— 能力增强不可用,已退回兜底表"
|
||||
end
|
||||
return false, "拉取失败: " .. es
|
||||
end
|
||||
local ok, rec = pcall(json.decode, resp.body or "")
|
||||
if not ok or type(rec) ~= "table" then return false, "响应无法解析" end
|
||||
@ -5629,9 +5650,15 @@ function plugin.refresh_models()
|
||||
end
|
||||
-- 顺带刷新模型能力元数据(照参考 opencode-capability)。
|
||||
-- ⚠️ 必须在这里(后台定时任务)而不是请求路径 —— 见该节的"非阻塞"约定。
|
||||
local cok, cres = pcall(refreshCapabilities)
|
||||
if cok and cres == true then
|
||||
logEvent("模型能力元数据已刷新")
|
||||
local cok, cres, cerr = pcall(refreshCapabilities)
|
||||
if not cok then
|
||||
-- ⚠️ 失败**必须留痕**:此前这里只有 `pcall` 不管返回值,于是"出站未授权"
|
||||
-- 这类错误被静默吞掉,表现是"能力元数据永远是空",排查时零线索。
|
||||
logEvent("能力元数据刷新异常: " .. tostring(cres):sub(1, 120))
|
||||
elseif cres == true then
|
||||
logEvent("模型能力元数据已刷新(" .. tostring(cerr or 0) .. " 条)")
|
||||
elseif cerr then
|
||||
logEvent("能力元数据未刷新: " .. tostring(cerr):sub(1, 120))
|
||||
end
|
||||
if updated > 0 then
|
||||
logEvent("模型目录已刷新(" .. updated .. " 个平台)")
|
||||
|
||||
Reference in New Issue
Block a user