mirror of
https://gitcode.com/JianFeeeee/ModelRouter.git
synced 2026-11-07 09:47:23 +00:00
a189c4f61c
## 缺陷（潜伏，从未被触发）
`channels-zcode` 适配器的手法是把 `anthropic.lua` 源码读进来执行、只覆盖
`transform_request`（身份块注入），其余协议转换全部复用基座。
但那句读取写在**适配器内部**。实测：
- 适配器运行在**另一个沙箱 VM** —— 那里 `__llmsproxy_plugin_dir` 与
`LLMSPROXY_PLUGIN_DIR` **都不存在**、**也没有文件系统访问**；
- ⇒ `loadAnthropic()` 必然返回 nil，**且静默降级**：适配器照常装载，
但只有它自己定义的 **2** 个函数，缺
`transform_response` / `transform_stream_chunk` / `serialize_*` /
`deserialize_request` 共 **7** 个。
**后果**：内核 `Transform()` 对缺失函数**响亮报错**（不是静默透传）⇒
非流式在响应阶段 502，流式**逐帧**报错 ⇒ 该渠道**完全不可用**。
**为什么一直没暴露**：zcode 从来没有凭据（0 账号）⇒ 源未注册
⇒ 该路径从未被调用过。拿到账号的那一刻才会炸，且报错指向内核而非配置。
## 修法
基座源码改由**插件主体**读好并**内联**进适配器源码（插件 VM 有 io，
实测可读）。与 v2.0.35 buddy 适配器同一手法。
两处必须注意的坑：
1. **不能拼接后 gsub 替换**：gsub 的替换串里 `%` 有特殊含义（`%1` 是捕获
引用），而适配器源码含 `%s`/`%d` 等格式化串 ⇒ 会破坏语法。
改用 `find(ph, 1, true)` + `sub` 的纯字符串替换。
2. **占位符 token 不能在注释里出现字面量**（第一版就栽在这：gsub 先命中了
解释它的那行注释，替换掉注释、代码里仍留着未定义全局）。
3. 顺带补上**插件主体缺失的 `plugin.adaptersDir()`** —— 原先这个函数只
存在于 zcode 适配器源码**内部**，插件主体从来没有过。
## 判据
- `internal/core`（**真实路径**，会咬变异）：
- `TestZcodeAdapterInjectsOfficialIdentityBlocks`
- `TestZcodeAdapterKeepsAnthropicProtocolConversion`（工具调用 / 图像块存活）
- `TestZcodeAdapterFailsLoudlyWithoutAnthropicBase` —— 语义已随设计更新：
基座不可得现在应在**安装期**失败（新增 `adapters_dir` 测试缝隙把
"基座缺失"从运行期逐帧炸变成安装期一条明确错误）
- `internal/lua/adapter_zcode_base_test.go`：验证源码模板 + 合并逻辑，
**并如实标注边界** —— 它在测试里自己做替换，所以**不能**证明安装处内联了
非空基座（实测：把 `asrc` 换成空串它不报红；那份由上面的 core 判据覆盖）。
**变异验证**：把安装处的 `asrc` 换成空基座 ⇒ core 三条判据全部报红；
用重构前的适配器源码 ⇒ `TestZcodeAdapterInheritsAnthropicBase` 报红（缺 7 个）。
98 lines
3.9 KiB
Go
98 lines
3.9 KiB
Go
package lua
|
||
|
||
import (
|
||
"os"
|
||
"regexp"
|
||
"strings"
|
||
"testing"
|
||
)
|
||
|
||
// ★ zcode 适配器**源码模板**必须真的能把 anthropic 基座合并进来。
|
||
//
|
||
// 背景：此前适配器在**沙箱里自己读 anthropic.lua** ⇒ 必然失败（沙箱无 fs、
|
||
// 无 plugin_dir）且**静默降级** ⇒ 只有它自己定义的 2 个函数，缺 7 个
|
||
// ⇒ 每次调用内核报 "missing transform_response" ⇒ 渠道**完全不可用**。
|
||
// 该缺陷一直潜伏，因为 zcode 从来没有凭据 ⇒ 源未注册 ⇒ 从未被调用过。
|
||
//
|
||
// ⚠️ **本判据的边界（务必如实理解）**：它在测试里**自己**做占位符替换，
|
||
//
|
||
// 所以它证明的是「**模板形态**正确 + 合并逻辑能吃下基座」，
|
||
// 而**不能**证明「installZcodeAdapter 真的内联了非空基座」——
|
||
// 把安装处的 `asrc` 换成空串，本判据**不会**报红（已实测）。
|
||
// 安装接线由 internal/core 的端到端判据覆盖：
|
||
// TestZcodeAdapterInjectsOfficialIdentityBlocks
|
||
// TestZcodeAdapterKeepsAnthropicProtocolConversion（工具调用/图像块存活）
|
||
// TestZcodeAdapterFailsLoudlyWithoutAnthropicBase（基座不可得 ⇒ 安装期报错）
|
||
// 这三条**会**咬住"内联空基座"这个变异（已实测）。
|
||
// ⇒ 教训：判据自己复现被测逻辑时，必须说清它到底覆盖了哪一段。
|
||
func TestZcodeAdapterInheritsAnthropicBase(t *testing.T) {
|
||
psrc, _ := os.ReadFile("plugins/channels.lua")
|
||
s := string(psrc)
|
||
diag := regexp.MustCompile(`(?s)local ZCODE_DIAG_SRC = \[===\[(.*?)\]===\]`).FindStringSubmatch(s)[1]
|
||
ad := regexp.MustCompile(`(?s)local ZCODE_ADAPTER_SRC = \[===\[(.*?)\]===\]`).FindStringSubmatch(s)[1]
|
||
asrc, err := bundledAdapters.ReadFile("adapters/anthropic.lua")
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
|
||
full := "local Z = (function()\n" + diag + "\nend)()\n" + ad
|
||
// ⚠ 占位符不等于"适配器里能读到基座"：真正要验的是**装载后 9 个函数都在**。
|
||
// 故这里按 installZcodeAdapter 的同一手法内联，再逐函数断言。
|
||
if strings.Contains(full, "__INLINE_ANTHROPIC_SRC__") {
|
||
full = strings.ReplaceAll(full, "__INLINE_ANTHROPIC_SRC__", quoteLua(string(asrc)))
|
||
} else {
|
||
t.Fatal("适配器源码必须有基座占位符（基座由插件主体内联；" +
|
||
"适配器沙箱里读不到文件）")
|
||
}
|
||
|
||
vm := NewVM(t.TempDir())
|
||
defer vm.Stop()
|
||
if err := vm.LoadAdapterSource("channels-zcode", full); err != nil {
|
||
t.Fatalf("装载失败: %v", err)
|
||
}
|
||
want := []string{"transform_request", "transform_response", "transform_stream_chunk",
|
||
"transform_error", "serialize_chunk", "serialize_close", "serialize_open_preamble",
|
||
"serialize_response", "deserialize_request"}
|
||
var lack []string
|
||
for _, f := range want {
|
||
if !vm.HasFn("channels-zcode", f) {
|
||
lack = append(lack, f)
|
||
}
|
||
}
|
||
if len(lack) > 0 {
|
||
t.Fatalf("★ zcode 仍缺 %d 个函数（%v）⇒ 基座继承失败 ⇒ "+
|
||
"每次调用都会报 'missing <fn>' ⇒ 渠道完全不可用", len(lack), lack)
|
||
}
|
||
// 行为验证：基座的 transform_response 必须真的能转换 anthropic 响应
|
||
out, err := vm.Transform("channels-zcode", "transform_response",
|
||
`{"id":"m1","type":"message","role":"assistant","content":[{"type":"text","text":"hi"}],"stop_reason":"end_turn","usage":{"input_tokens":1,"output_tokens":2}}`)
|
||
if err != nil {
|
||
t.Fatalf("transform_response 调用失败: %v", err)
|
||
}
|
||
if !strings.Contains(out, "hi") {
|
||
t.Errorf("基座 transform_response 未产出内容: %s", out)
|
||
}
|
||
t.Logf("✓ zcode 继承基座成功（9/9 函数），transform_response → %s", out)
|
||
}
|
||
|
||
func quoteLua(s string) string {
|
||
var b strings.Builder
|
||
b.WriteByte('"')
|
||
for i := 0; i < len(s); i++ {
|
||
switch c := s[i]; c {
|
||
case '"':
|
||
b.WriteString(`\"`)
|
||
case '\\':
|
||
b.WriteString(`\\`)
|
||
case '\n':
|
||
b.WriteString(`\n`)
|
||
case '\r':
|
||
b.WriteString(`\r`)
|
||
default:
|
||
b.WriteByte(c)
|
||
}
|
||
}
|
||
b.WriteByte('"')
|
||
return b.String()
|
||
}
|