2 Commits

Author	SHA1	Message	Date
JianFeeeee	3ac4b35eb1	fix(channels): 8 个平台 base_url 侵占 endpoint 路径 ⇒ 上游 404 Route Not Found ... ## 真实缺陷（用户可见） 内核的上游 URL 是 `base_url + endpoint`（provider.go ChatURL），而适配器默认 `endpoint = "/chat/completions"`。多个渠道平台把**完整路径**写进了 `base_url` ⇒ 实际请求变成 https://copilot.tencent.com/v2/chat/completions/chat/completions ⇒ 上游回 `{"error_msg":"404 Route Not Found"}`（APISIX 的措辞，**不是**模型错误）。 受影响 8 个平台：buddy / cline / lobsterai / opencode / qoder / loomy / raccoon （zcode 当时已用 `endpoint` 覆盖，形态正确）。 另有 loomy 的**第二处**错误：host 用了 `loomy.xunfei.cn`（Web 前端/OAuth 回调域）， 实测该 host 的 /chat/completions 返回 **HTML 网页**；正确推理域是参考的 `loomyad.xunfei.cn/api/v1`（返回正常 JSON）。 ## ★ 为什么这个缺陷活了很久（最重要的教训） **模型名被多个源服务**。`deepseek-v4.1-flash` 同时由 4 个源提供 （alittokenplan/vela/oin/channels-buddy）⇒ buddy 源失败后网关**继续尝试下一个源** 并成功 ⇒ 用户看到"能回话" ⇒ "buddy 通道是好的"这个结论**完全没有证据**。 本轮我一度正是这么误判的。而 `hy3` **只由 buddy 一个源**提供 ⇒ 一调就暴露真因。 ⇒ **判据必须断言源的结构不变量（URL 形态），不能靠"某个模型能调通"** —— 后者会被多源冗余掩盖。已按此写判据。 ## 排查手法（可复用） 怀疑"某模型不可用"时，先列**该模型由几个源服务**： 1 个 ⇒ 该模型是那条源的健康探针（用它测） >1 个 ⇒ 它调通**不能**证明任何单一源可用（换独有模型再测） 另：非流式请求会被 buddy 直接 400 拒绝 （`{"code":11101,"msg":"Non-stream chat request is currently not supported"}`）， 我第一次用 stream=false 时四个模型全 400，**看不出**模型差异，差点把结论下成 "头组合无区别"就收工。 ## 修法 `base_url` 只留 host（或协议公共前缀），路径移入该平台的 `endpoint`。 逐平台按参考的 `apiBase` + `chatPath` 取值核对，并**实测**修正后的 URL： buddy/cline/lobsterai/qoder/raccoon → 401（缺凭据，正确） loomy → 200 `{"code":"100002","desc":"缺少 token"}`（正确） opencode → 500（路由存在；`https://opencode.ai/v1/...` 是 404+HTML，已证伪） 测试注入平台也一并对齐（免被当范例复制）。 ## 判据（2 条 + 变异 2/2） - `TestChannelSourceBaseURLHasNoChatPath`：静态扫描全部 `base_url`，不得含 `/chat/completions` `/v1/messages` `/generateContent` `/api/chat`。 - `TestChannelBaseURLJudgeBitesOnBadInput`：用**故意坏数据**验证判据的判别力 （防判据自己写歪成恒真）。 变异：把 buddy 恢复成旧形态 → 报红。 ## 顺带修正 `TestUpstreamGapsAreDocumented` 原先钉死 qoder 的**整串 URL 字面量** ⇒ 这次纯形态重构（语义未变）把它弄红了 —— **判据在咬自己**。改为断言 `base_url` 与 `endpoint` **两半**，语义不变但对形态重构免疫。	2026-10-16 13:52:02 +08:00
JianFeeeee	1e6b4864ec	feat(zcode): 身份块适配器 + 修复调度器泄漏 + codearts 目录 + 备份裁剪泛化 ... ## 1. ★ zcode 身份块适配器（channels-zcode）—— 准入的唯一开关 参考实测（三账号 17 次请求）：zcode 的 /zcode-plan/anthropic 通道做**请求体 内容检查**，system 缺官方身份块结构时直接 HTTP 405 + {"code":3012}： 无 system → 3012 ✗ 仅 cliPrefix（42 字符） → 3012 ✗ cliPrefix + stable（约 2898 字符）→ 200 ✓ ⇒ 判据是「身份块结构是否存在」，与 HTTP 头、版本号、频率、多轮历史、tools 声明、运行时全部无关。我们此前用通用 anthropic 适配器 ⇒ **即使拿到 zcode 账号也必然被拒**（现在 0 账号，但这是能不能用起来的前提）。 实现：插件自装 channels-zcode —— 读内核 anthropic.lua 执行取基座，**只覆盖 transform_request** 注入身份块（协议转换始终与 anthropic 那一份一致，不漂移）： block[1] cliPrefix(42) / block[2] stable(2852) / block[3] Environment 段 / block[4] 调用方 system（**必须追加在最后**：上游看的是前缀结构） 只给最后一块打 cache_control（Anthropic 上限 4 断点，逐块打会占满预算） 日期块插入首条 user 的 content **数组**最前（拼进字符串会改变结构） 文本与参考**逐字节一致**（已核对：42 + 2856 = 2898）。 ★ 基座读不到时**响亮失败**，不静默退化 —— 否则会产出"身份块看着对、工具/图像 全没转换"的请求，上游可能 200 但模型拿不到工具定义，症状是"模型变笨了"， 与准入毫不相干、排查完全跑偏。 判据 4 条 + 变异 2/2：不注入 → 报红；截断到 100 字符 → 报红。 另加"协议转换不退化"判据（工具 input_schema / 图像块存活）。 ## 2. ★★ 同一缺陷家族第 3 个实例：Close() 不停调度器 修完 on_unload 后全量回归 internal/lua **600s 超时**，goroutine 快照显示 **69 个卡在 stateSaver.loop 与 PluginRuntime.loop**。 根因：Runtime.Stop() **只在单插件 Unload 里调**，Close() 不调 ⇒ 每个插件的 调度循环在"进程关闭/测试结束"路径上永不停止。与 on_unload 完全同一形状。 修法：Close() 新增 stopSchedulersAll()，顺序 = 停调度 → 落盘 → on_unload （调度器必须停在落盘之前，否则它写一个已收尾的 state）。 ★ 顺带：Stop() 不幂等（裸 close 会 panic: close of closed channel）， 两处都调之后可达 —— 用 sync.Once 加固。给函数加第二个调用点前先查幂等性。 实测 internal/lua 从 600s 超时 → 62s 通过。 ## 3. codearts 模型目录：补两个**必须 AK/SK 签名**的端点 codearts 有 10 个账号但目录里只有硬编码 1 个模型。参考打两个端点： ① opengw.../gateway/config → result.models（benefit） ② snap-access.../v1/model/builtin → builtinModels（常规） 而 refreshRemoteModels **只支持 Bearer** ⇒ 这两端点从来没被打过。 已加 ep.sign="codearts" 分支 + 两个解析形态 + opengw host 白名单。 判据：两端点各自真实命中 + 每请求带 SDK-HMAC-SHA256 头 + **合并**（非取其一）。 ## 4. TRAE PKCE 候选来源补齐（3 → 5） 参考 authCodeCandidates 有 5 个来源，我们只有 3（漏了 authCodeInfo 为 JSON 的 authCode 字段、以及**纯字符串**形态）。★ 且不能写成 `a or b or c` 链 —— jsonField 取不到时返回**空串**，Lua 里空串是真值，链会在第一个空串处短路。 判据 5 个参数化用例 + 变异 2/2 咬住（正是 or 链取不到的两个形态）。 ## 5. ★ 部署脚本：备份裁剪只修了一半（"两处只修一处"再现） prune_adapter_backups 有完整实现（含数量硬上限），但**只针对 adapters.bak**； sync_plugins 同样每次建 plugins.bak.* —— 修了 adapters 的堆积、plugins 继续涨。 实测线上 plugins.bak **36 个**、/etc/llmsproxy 192M。 泛化为 prune_backups <prefix> + prune_all_backups（两个前缀都裁），加空前缀守卫。 判据不止逐字检查，而是**扫描脚本里所有 .bak.$(date) 创建点**，要求每个前缀都在 裁剪范围内 —— 将来新增第三种备份目录会立刻报红，而不是等它涨到几百兆。 变异 2/2 咬住（只裁 adapters / 去掉守卫）。 ## 6. 上游客观缺口钉成可执行判据（TestUpstreamGapsAreDocumented） qoder 加密端点需 .wasm（**参考仓库里也不存在**）、TRAE PKCE 参考**明确不支持**、 zcode 滑块需真实浏览器交互。写成判据：任何人（包括未来的我）想"补"这些能力， 必须先让判据失败 —— 即先推翻事实再动手。防的正是我前两轮的反复误判。 清理：channels-buddy.lua（0 字节历史遗留，每次启动报 must return a table）。	2026-10-16 00:56:35 +08:00