mslxdff 0.1.200 → 0.1.203

package/README.md

@@ -1,3 +1,3 @@
-# mslxdff
-
-测试项目，请勿使用
+# mslxdff
+
+测试项目，请勿使用

package/bin/mslxdff.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // thin adapter — all logic lives in src/cli (deep module, single inlet run)
 import { run } from "../src/cli/index.js";
 await run(process.argv.slice(2));

package/package.json

@@ -1,38 +1,38 @@
-{
-  "name": "mslxdff",
-  "version": "0.1.200",
-  "description": "测试项目，请勿使用。",
-  "type": "module",
-  "bin": {
-    "mslxdff": "bin/mslxdff.js"
-  },
-  "scripts": {
-    "start": "node bin/mslxdff.js",
-    "test": "node --test --test-concurrency=1 test/*.test.js",
-    "docs:check": "node scripts/docs-check.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "plugins/",
-    "README.md",
-    "docs/cli_help_mini.md"
-  ],
-  "keywords": [
-    "test",
-    "demo",
-    "placeholder"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "undici": "^5.28.4"
-  },
-  "optionalDependencies": {
-    "@ai-sdk/openai-compatible": "2.0.41",
-    "@ai-sdk/openai": "3.0.84",
-    "zod": "^3.25.76"
-  }
-}
+{
+  "name": "mslxdff",
+  "version": "0.1.203",
+  "description": "测试项目，请勿使用。",
+  "type": "module",
+  "bin": {
+    "mslxdff": "bin/mslxdff.js"
+  },
+  "scripts": {
+    "start": "node bin/mslxdff.js",
+    "test": "node --test --test-concurrency=1 test/*.test.js",
+    "docs:check": "node scripts/docs-check.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "plugins/",
+    "README.md",
+    "docs/cli_help_mini.md"
+  ],
+  "keywords": [
+    "test",
+    "demo",
+    "placeholder"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "undici": "^5.28.4"
+  },
+  "optionalDependencies": {
+    "@ai-sdk/openai-compatible": "2.0.41",
+    "@ai-sdk/openai": "3.0.84",
+    "zod": "^3.25.76"
+  }
+}

package/plugins/README.md

@@ -1,14 +1,14 @@
-# mslxdff 官方插件目录
-
-本目录随 mslxdff 包分发（`*.mjs` 会被自动加载）。**注意：auto-update 重装包时本目录会被重置**——你自己的正式插件请放 `~/.config/mslxdff/plugins/`（升级永不丢）。
-
-优先级：同名文件时用户目录（`~/.config/mslxdff/plugins/`）覆盖本目录。
-
-## 目录约定
-
-- `*.mjs` / `*.js` — 插件模块（default export `{ name, version, hooks, onEvent?, createUpstream? }`）
-- `*.example` — 示例模板，不会被加载；复制成 `.mjs` 并去掉后缀即可启用
-
-## Hook 全表
-
-见 `docs/plugins.md`。
+# mslxdff 官方插件目录
+
+本目录随 mslxdff 包分发（`*.mjs` 会被自动加载）。**注意：auto-update 重装包时本目录会被重置**——你自己的正式插件请放 `~/.config/mslxdff/plugins/`（升级永不丢）。
+
+优先级：同名文件时用户目录（`~/.config/mslxdff/plugins/`）覆盖本目录。
+
+## 目录约定
+
+- `*.mjs` / `*.js` — 插件模块（default export `{ name, version, hooks, onEvent?, createUpstream? }`）
+- `*.example` — 示例模板，不会被加载；复制成 `.mjs` 并去掉后缀即可启用
+
+## Hook 全表
+
+见 `docs/plugins.md`。

package/plugins/prefer-model.mjs.example

@@ -1,14 +1,14 @@
-// 示例：把首选模型排到最前（复制为 prefer-model.mjs 即生效；或放 ~/.config/mslxdff/plugins/ 永久生效）
-const PREFER = "big-pickle";
-
-export default {
-  name: "prefer-model",
-  version: "1.0.0",
-  description: `auto 时优先使用 ${PREFER}`,
-  hooks: {
-    "model:select": (ctx) => {
-      if (!ctx.order.includes(PREFER)) return;
-      return [PREFER, ...ctx.order.filter((m) => m !== PREFER)];
-    },
-  },
-};
+// 示例：把首选模型排到最前（复制为 prefer-model.mjs 即生效；或放 ~/.config/mslxdff/plugins/ 永久生效）
+const PREFER = "big-pickle";
+
+export default {
+  name: "prefer-model",
+  version: "1.0.0",
+  description: `auto 时优先使用 ${PREFER}`,
+  hooks: {
+    "model:select": (ctx) => {
+      if (!ctx.order.includes(PREFER)) return;
+      return [PREFER, ...ctx.order.filter((m) => m !== PREFER)];
+    },
+  },
+};

package/src/anthropic/count-tokens.js

@@ -1,61 +1,61 @@
-// /v1/messages/count_tokens 的 token 估算（从 translate.js 拆出，控单文件体积 ≤20KB 硬门）。
-// 精度非目标：Anthropic 官方说明该端点缺失时客户端本来就退回字符估算。
-// 权重口径的单一来源在 ../text-tokens.js（ADR-0055）：旧版整段 `chars/4` 把中文低报约 4 倍，而客户端
-// 正是拿这个读数决定何时压实上下文 —— 读数偏低就一路不压实，撞上游「上下文超限」才炸。
-import { toolResultTextOf } from "./translate.js";
-import { estimateTextTokens, createTokenCounter } from "../text-tokens.js";
-
-// 图片不吃字符但占真实上下文，按固定面值计；总长设硬上限防极端请求把估算推到天文数字
-const IMAGE_TOKENS = 2000;
-const CHAR_CAP = 32_000_000;
-
-// 请求侧按「一条消息」聚成一段再套一次公式：粒度对齐参照实现 wb_proxy.py:14267-14278
-// （每条消息 content 整段一次 + 每个 tool_call 一次）。逐块各套会把「非空至少 1」下限乘上块数
-// —— 几十个 1 字符 text 块能被高报几十倍（评审 P3：方向虽偏高安全，但与生成侧口径分叉就是第二个真相源）。
-function add(acc, text) {
-  // 超限后停止累计（chars 与 tokens 一起停）：只护 chars 会让 tokens 无界增长，
-  // 客户端拿这个读数决定何时压实上下文 ⇒ 超长请求触发一次毫无必要的激进压缩。
-  if (acc.chars > CHAR_CAP) return;
-  const s = text == null ? "" : String(text);
-  const c = createTokenCounter();
-  c.add(s);
-  acc.chars += s.length;
-  acc.tokens += c.tokens();
-}
-
-function countMessage(m, acc) {
-  if (!m || typeof m !== "object") return;
-  const blocks = typeof m.content === "string" ? [{ type: "text", text: m.content }] : Array.isArray(m.content) ? m.content : null;
-  if (!blocks) { add(acc, JSON.stringify(m.content ?? "")); return; }
-  const c = createTokenCounter();
-  let chars = 0;
-  const put = (s) => { c.add(s); chars += s.length; };
-  for (const b of blocks) {
-    if (!b || typeof b !== "object") continue;
-    if (typeof b.text === "string") put(b.text);
-    else if (b.type === "tool_use") put(String(b.name || "") + JSON.stringify(b.input ?? {}));
-    else if (b.type === "tool_result") put(toolResultTextOf(b.content)); // 工具结果是大头，必须算
-    else if (b.type === "thinking") put(String(b.thinking || ""));
-    else if (b.type === "image") acc.images += 1;
-  }
-  // tokens 与 chars 必须**同受 CHAR_CAP 约束**：只护 chars 不护 tokens 时，超长请求（readBody 无大小上限，
-  // 实测 10 条 4000 万字符消息 → 1.11 亿 tokens）会把读数推到天文数字，而客户端正是拿它决定何时压实上下文
-  // ⇒ 一次毫无必要的激进压缩。超限后不再累加，保留已计部分。
-  if (acc.chars <= CHAR_CAP) {
-    acc.chars += chars;
-    acc.tokens += c.tokens();
-  }
-}
-
-/** 字符估算版 token 计数（Anthropic 官方：端点缺失时客户端本来就退回字符估算，精度非目标）。 */
-export function estimateTokens(req = {}) {
-  const acc = { chars: 0, tokens: 0, images: 0 };
-  const sys = typeof req.system === "string" ? [{ type: "text", text: req.system }] : Array.isArray(req.system) ? req.system : [];
-  for (const b of sys) add(acc, b && typeof b.text === "string" ? b.text : "");
-  for (const m of Array.isArray(req.messages) ? req.messages : []) countMessage(m, acc);
-  if (Array.isArray(req.tools)) add(acc, JSON.stringify(req.tools));
-  // 字段名以 Anthropic 线上为准：`POST /v1/messages/count_tokens` 回 `{"input_tokens": N}`；
-  // 额外带一份 count_tokens 仅作人读兼容（Claude Code 读的是 input_tokens）。
-  const n = Math.max(1, acc.tokens) + acc.images * IMAGE_TOKENS;
-  return { input_tokens: n, count_tokens: n };
-}
+// /v1/messages/count_tokens 的 token 估算（从 translate.js 拆出，控单文件体积 ≤20KB 硬门）。
+// 精度非目标：Anthropic 官方说明该端点缺失时客户端本来就退回字符估算。
+// 权重口径的单一来源在 ../text-tokens.js（ADR-0055）：旧版整段 `chars/4` 把中文低报约 4 倍，而客户端
+// 正是拿这个读数决定何时压实上下文 —— 读数偏低就一路不压实，撞上游「上下文超限」才炸。
+import { toolResultTextOf } from "./translate.js";
+import { estimateTextTokens, createTokenCounter } from "../text-tokens.js";
+
+// 图片不吃字符但占真实上下文，按固定面值计；总长设硬上限防极端请求把估算推到天文数字
+const IMAGE_TOKENS = 2000;
+const CHAR_CAP = 32_000_000;
+
+// 请求侧按「一条消息」聚成一段再套一次公式：粒度对齐参照实现 wb_proxy.py:14267-14278
+// （每条消息 content 整段一次 + 每个 tool_call 一次）。逐块各套会把「非空至少 1」下限乘上块数
+// —— 几十个 1 字符 text 块能被高报几十倍（评审 P3：方向虽偏高安全，但与生成侧口径分叉就是第二个真相源）。
+function add(acc, text) {
+  // 超限后停止累计（chars 与 tokens 一起停）：只护 chars 会让 tokens 无界增长，
+  // 客户端拿这个读数决定何时压实上下文 ⇒ 超长请求触发一次毫无必要的激进压缩。
+  if (acc.chars > CHAR_CAP) return;
+  const s = text == null ? "" : String(text);
+  const c = createTokenCounter();
+  c.add(s);
+  acc.chars += s.length;
+  acc.tokens += c.tokens();
+}
+
+function countMessage(m, acc) {
+  if (!m || typeof m !== "object") return;
+  const blocks = typeof m.content === "string" ? [{ type: "text", text: m.content }] : Array.isArray(m.content) ? m.content : null;
+  if (!blocks) { add(acc, JSON.stringify(m.content ?? "")); return; }
+  const c = createTokenCounter();
+  let chars = 0;
+  const put = (s) => { c.add(s); chars += s.length; };
+  for (const b of blocks) {
+    if (!b || typeof b !== "object") continue;
+    if (typeof b.text === "string") put(b.text);
+    else if (b.type === "tool_use") put(String(b.name || "") + JSON.stringify(b.input ?? {}));
+    else if (b.type === "tool_result") put(toolResultTextOf(b.content)); // 工具结果是大头，必须算
+    else if (b.type === "thinking") put(String(b.thinking || ""));
+    else if (b.type === "image") acc.images += 1;
+  }
+  // tokens 与 chars 必须**同受 CHAR_CAP 约束**：只护 chars 不护 tokens 时，超长请求（readBody 无大小上限，
+  // 实测 10 条 4000 万字符消息 → 1.11 亿 tokens）会把读数推到天文数字，而客户端正是拿它决定何时压实上下文
+  // ⇒ 一次毫无必要的激进压缩。超限后不再累加，保留已计部分。
+  if (acc.chars <= CHAR_CAP) {
+    acc.chars += chars;
+    acc.tokens += c.tokens();
+  }
+}
+
+/** 字符估算版 token 计数（Anthropic 官方：端点缺失时客户端本来就退回字符估算，精度非目标）。 */
+export function estimateTokens(req = {}) {
+  const acc = { chars: 0, tokens: 0, images: 0 };
+  const sys = typeof req.system === "string" ? [{ type: "text", text: req.system }] : Array.isArray(req.system) ? req.system : [];
+  for (const b of sys) add(acc, b && typeof b.text === "string" ? b.text : "");
+  for (const m of Array.isArray(req.messages) ? req.messages : []) countMessage(m, acc);
+  if (Array.isArray(req.tools)) add(acc, JSON.stringify(req.tools));
+  // 字段名以 Anthropic 线上为准：`POST /v1/messages/count_tokens` 回 `{"input_tokens": N}`；
+  // 额外带一份 count_tokens 仅作人读兼容（Claude Code 读的是 input_tokens）。
+  const n = Math.max(1, acc.tokens) + acc.images * IMAGE_TOKENS;
+  return { input_tokens: n, count_tokens: n };
+}

package/src/anthropic/request-body.js

@@ -1,126 +1,126 @@
-// 请求侧翻译：Anthropic Messages 请求体 → OpenAI chat 请求体（/v1/messages 外壳，ADR-0047）。
-// 从 translate.js 拆出（ADR-0055）：translate.js 贴 20KB 体积硬门，且「入站请求形状」与
-// 「出站响应/usage 翻译」本就是两向关注点，拆后 translate.js 单向 import 本文件，不回环。
-// 对外接口不变：调用方与测试仍从 anthropic/translate.js import（那边 re-export）。
-//
-// 纪律（别改回去）：
-//  * 思考档位**原样透传**（thinking/effort/reasoning_effort/reasoningEffort/extra_body），语义归一交给
-//    各 provider 与 src/thinking-effort.js —— 旧版在此丢掉，下游被迫补默认值（workbuddy 恒 high，ADR-0053）；
-//  * 但**必须主动丢** output_config 原始对象 / context_management / 消息块内 thinking：Claude Code 对
-//    不认识的 model ID 照发全套字段，块内 thinking 无法签发 signature，回传必被上游拒（ADR-0047）。
-import { isServerTool } from "./web-search.js";
-import { newToolUseId } from "./shared.js";
-
-// system 允许字符串或 text 块数组；块间空行连接（缓存语义不保留，上游是 OpenAI）
-function systemTextOf(system) {
-  if (typeof system === "string") return system;
-  if (!Array.isArray(system)) return "";
-  return system.map((b) => (b && typeof b.text === "string" ? b.text : "")).filter(Boolean).join("\n\n");
-}
-
-function imagePartOf(block) {
-  const src = block?.source || {};
-  if (src.type === "base64" && src.data) {
-    return { type: "image_url", image_url: { url: `data:${src.media_type || "image/png"};base64,${src.data}` } };
-  }
-  if (src.type === "url" && src.url) return { type: "image_url", image_url: { url: String(src.url) } };
-  return null;
-}
-
-export function toolResultTextOf(content) {
-  if (typeof content === "string") return content;
-  if (Array.isArray(content)) {
-    return content
-      .map((p) => (typeof p === "string" ? p : p && typeof p.text === "string" ? p.text : ""))
-      .filter(Boolean)
-      .join("\n");
-  }
-  return content == null ? "" : String(content);
-}
-
-/** Anthropic Messages 请求体 → OpenAI chat 请求体（直接喂既有 ChatPipeline）。 */
-export function messagesToChatBody(req = {}) {
-  const model = String(req.model || "").trim();
-  if (!model) throw new Error("messages: 缺少 model");
-  const messages = [];
-  const sys = systemTextOf(req.system);
-  if (sys) messages.push({ role: "system", content: sys });
-
-  // 重复 tool_use_id 保首个、丢后续：客户端重试/重放历史会把同一工具结果存两份，
-  // 部分上游按 call_id 查重直接 400（同 responses/translate.js:57-59 的实测教训）。
-  const seenToolResult = new Set();
-
-  for (const m of Array.isArray(req.messages) ? req.messages : []) {
-    if (!m || typeof m !== "object") continue;
-    // role=system/developer 必须保留：Claude Code ≥2.1.286 的 mid-conversation system beta 就往 messages[] 里塞系统指令，
-    const role = m.role === "assistant" ? "assistant" : m.role === "system" || m.role === "developer" ? "system" : "user";
-    const blocks = typeof m.content === "string" ? [{ type: "text", text: m.content }] : Array.isArray(m.content) ? m.content : [];
-    let text = "";
-    const imgs = [];
-    const toolCalls = [];
-    for (const b of blocks) {
-      if (!b || typeof b !== "object") continue;
-      if (b.type === "text") text += typeof b.text === "string" ? b.text : "";
-      else if (b.type === "image") { const p = imagePartOf(b); if (p) imgs.push(p); }
-      else if (b.type === "tool_use") {
-        let args = "{}";
-        try { args = JSON.stringify(b.input ?? {}); } catch { args = "{}"; }
-        toolCalls.push({ id: String(b.id || newToolUseId()), type: "function", function: { name: String(b.name || ""), arguments: args } });
-      } else if (b.type === "tool_result") {
-        // tool 消息必须先于同轮 user 文本进数组：OpenAI 侧要求 role:tool 紧跟其 assistant
-        const key = String(b.tool_use_id || "");
-        if (key) { if (seenToolResult.has(key)) continue; seenToolResult.add(key); }
-        const body = toolResultTextOf(b.content);
-        messages.push({ role: "tool", tool_call_id: key, content: b.is_error ? `[tool_error] ${body}` : body });
-      }
-      // thinking / redacted_thinking 忽略：我们无法签发 signature，回传必被上游拒（ADR-0047）
-    }
-    if (!text && !imgs.length && !toolCalls.length) continue;
-    const msg = { role, content: imgs.length ? [...(text ? [{ type: "text", text }] : []), ...imgs] : text };
-    if (toolCalls.length) msg.tool_calls = toolCalls;
-    messages.push(msg);
-  }
-  // 空会话直接 400：绝不伪造一句 "hi" 打上游（那会把假提问写进用户上下文并白烧一发额度）
-  if (!messages.some((x) => x.role !== "system")) throw new Error("messages: 缺少用户消息");
-
-  const body = { model, messages, stream: Boolean(req.stream) };
-  // 流式必须让上游把 usage 放进收尾帧，否则 message_delta.usage 恒 0（OpenAI 规范字段）。
-  // 个别上游不认 stream_options 会 400 → `MSLXDFF_ANTHROPIC_STREAM_USAGE=0` 关掉。
-  if (body.stream && process.env.MSLXDFF_ANTHROPIC_STREAM_USAGE !== "0") body.stream_options = { include_usage: true };
-  // Anthropic 的 server tool（web_search_*/web_fetch_*/…）没有 input_schema，折成假 function 会
-  // 让上游收到「空参数空描述」的工具（严格端点直接 422），本网关不实现的发前一律剥除（ADR-0049）。
-  const fnTools = (Array.isArray(req.tools) ? req.tools : []).filter((t) => !isServerTool(t));
-  if (fnTools.length) {
-    body.tools = fnTools.map((t) => ({
-      type: "function",
-      function: { name: String(t?.name || ""), description: String(t?.description || ""), parameters: t?.input_schema || {} },
-    }));
-  }
-  const keptNames = new Set(fnTools.map((t) => String(t?.name || "")));
-  const tc = req.tool_choice;
-  if (tc === "auto" || (tc && typeof tc === "object" && tc.type === "auto")) body.tool_choice = "auto";
-  else if (tc && typeof tc === "object" && tc.type === "any") body.tool_choice = "required";
-  // 点名一个已被剥掉的工具时降为 auto：上游会按不存在的函数强制点名，那样一定拿不到有用回答
-  else if (tc && typeof tc === "object" && tc.type === "tool") body.tool_choice = keptNames.has(String(tc.name || "")) ? { type: "function", function: { name: String(tc.name || "") } } : "auto";
-  else if (tc && typeof tc === "object" && tc.type === "none") body.tool_choice = "none";
-  if (req.max_tokens != null && Number.isFinite(Number(req.max_tokens))) body.max_tokens = Number(req.max_tokens);
-  if (req.temperature != null) body.temperature = req.temperature;
-  if (req.top_p != null) body.top_p = req.top_p;
-  if (Array.isArray(req.stop_sequences) && req.stop_sequences.length) body.stop = req.stop_sequences;
-  // 思考档位原样透传（不解释语义，语义归一交给各 provider / src/thinking-effort.js）：
-  // 客户端显式声明必须一路带到上游，旧版在此丢掉 → 下游被迫补默认值（workbuddy 恒 high）。
-  if (req.thinking != null) body.thinking = req.thinking;
-  // 档位载体只收「非空 trimmed 字符串」：空串声明不算声明，不该发出去顶掉下游默认值。
-  for (const k of ["effort", "reasoning_effort", "reasoningEffort"]) {
-    const v = typeof req[k] === "string" ? req[k].trim() : "";
-    if (v) body[k] = v;
-  }
-  if (req.extra_body != null) body.extra_body = req.extra_body;
-  // output_config.effort 是 Claude Code 的另一档位载体（beta），原始对象上游不认故不外发，
-  // 但档位本身不能丢 → 归一到 reasoning_effort（客户端已显式声明时以声明为准）。
-  const ocEffort = req.output_config && typeof req.output_config === "object" ? req.output_config.effort : undefined;
-  if (ocEffort != null && body.reasoning_effort == null && body.reasoningEffort == null) {
-    body.reasoning_effort = ocEffort;
-  }
-  return body;
-}
+// 请求侧翻译：Anthropic Messages 请求体 → OpenAI chat 请求体（/v1/messages 外壳，ADR-0047）。
+// 从 translate.js 拆出（ADR-0055）：translate.js 贴 20KB 体积硬门，且「入站请求形状」与
+// 「出站响应/usage 翻译」本就是两向关注点，拆后 translate.js 单向 import 本文件，不回环。
+// 对外接口不变：调用方与测试仍从 anthropic/translate.js import（那边 re-export）。
+//
+// 纪律（别改回去）：
+//  * 思考档位**原样透传**（thinking/effort/reasoning_effort/reasoningEffort/extra_body），语义归一交给
+//    各 provider 与 src/thinking-effort.js —— 旧版在此丢掉，下游被迫补默认值（workbuddy 恒 high，ADR-0053）；
+//  * 但**必须主动丢** output_config 原始对象 / context_management / 消息块内 thinking：Claude Code 对
+//    不认识的 model ID 照发全套字段，块内 thinking 无法签发 signature，回传必被上游拒（ADR-0047）。
+import { isServerTool } from "./web-search.js";
+import { newToolUseId } from "./shared.js";
+
+// system 允许字符串或 text 块数组；块间空行连接（缓存语义不保留，上游是 OpenAI）
+function systemTextOf(system) {
+  if (typeof system === "string") return system;
+  if (!Array.isArray(system)) return "";
+  return system.map((b) => (b && typeof b.text === "string" ? b.text : "")).filter(Boolean).join("\n\n");
+}
+
+function imagePartOf(block) {
+  const src = block?.source || {};
+  if (src.type === "base64" && src.data) {
+    return { type: "image_url", image_url: { url: `data:${src.media_type || "image/png"};base64,${src.data}` } };
+  }
+  if (src.type === "url" && src.url) return { type: "image_url", image_url: { url: String(src.url) } };
+  return null;
+}
+
+export function toolResultTextOf(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content
+      .map((p) => (typeof p === "string" ? p : p && typeof p.text === "string" ? p.text : ""))
+      .filter(Boolean)
+      .join("\n");
+  }
+  return content == null ? "" : String(content);
+}
+
+/** Anthropic Messages 请求体 → OpenAI chat 请求体（直接喂既有 ChatPipeline）。 */
+export function messagesToChatBody(req = {}) {
+  const model = String(req.model || "").trim();
+  if (!model) throw new Error("messages: 缺少 model");
+  const messages = [];
+  const sys = systemTextOf(req.system);
+  if (sys) messages.push({ role: "system", content: sys });
+
+  // 重复 tool_use_id 保首个、丢后续：客户端重试/重放历史会把同一工具结果存两份，
+  // 部分上游按 call_id 查重直接 400（同 responses/translate.js:57-59 的实测教训）。
+  const seenToolResult = new Set();
+
+  for (const m of Array.isArray(req.messages) ? req.messages : []) {
+    if (!m || typeof m !== "object") continue;
+    // role=system/developer 必须保留：Claude Code ≥2.1.286 的 mid-conversation system beta 就往 messages[] 里塞系统指令，
+    const role = m.role === "assistant" ? "assistant" : m.role === "system" || m.role === "developer" ? "system" : "user";
+    const blocks = typeof m.content === "string" ? [{ type: "text", text: m.content }] : Array.isArray(m.content) ? m.content : [];
+    let text = "";
+    const imgs = [];
+    const toolCalls = [];
+    for (const b of blocks) {
+      if (!b || typeof b !== "object") continue;
+      if (b.type === "text") text += typeof b.text === "string" ? b.text : "";
+      else if (b.type === "image") { const p = imagePartOf(b); if (p) imgs.push(p); }
+      else if (b.type === "tool_use") {
+        let args = "{}";
+        try { args = JSON.stringify(b.input ?? {}); } catch { args = "{}"; }
+        toolCalls.push({ id: String(b.id || newToolUseId()), type: "function", function: { name: String(b.name || ""), arguments: args } });
+      } else if (b.type === "tool_result") {
+        // tool 消息必须先于同轮 user 文本进数组：OpenAI 侧要求 role:tool 紧跟其 assistant
+        const key = String(b.tool_use_id || "");
+        if (key) { if (seenToolResult.has(key)) continue; seenToolResult.add(key); }
+        const body = toolResultTextOf(b.content);
+        messages.push({ role: "tool", tool_call_id: key, content: b.is_error ? `[tool_error] ${body}` : body });
+      }
+      // thinking / redacted_thinking 忽略：我们无法签发 signature，回传必被上游拒（ADR-0047）
+    }
+    if (!text && !imgs.length && !toolCalls.length) continue;
+    const msg = { role, content: imgs.length ? [...(text ? [{ type: "text", text }] : []), ...imgs] : text };
+    if (toolCalls.length) msg.tool_calls = toolCalls;
+    messages.push(msg);
+  }
+  // 空会话直接 400：绝不伪造一句 "hi" 打上游（那会把假提问写进用户上下文并白烧一发额度）
+  if (!messages.some((x) => x.role !== "system")) throw new Error("messages: 缺少用户消息");
+
+  const body = { model, messages, stream: Boolean(req.stream) };
+  // 流式必须让上游把 usage 放进收尾帧，否则 message_delta.usage 恒 0（OpenAI 规范字段）。
+  // 个别上游不认 stream_options 会 400 → `MSLXDFF_ANTHROPIC_STREAM_USAGE=0` 关掉。
+  if (body.stream && process.env.MSLXDFF_ANTHROPIC_STREAM_USAGE !== "0") body.stream_options = { include_usage: true };
+  // Anthropic 的 server tool（web_search_*/web_fetch_*/…）没有 input_schema，折成假 function 会
+  // 让上游收到「空参数空描述」的工具（严格端点直接 422），本网关不实现的发前一律剥除（ADR-0049）。
+  const fnTools = (Array.isArray(req.tools) ? req.tools : []).filter((t) => !isServerTool(t));
+  if (fnTools.length) {
+    body.tools = fnTools.map((t) => ({
+      type: "function",
+      function: { name: String(t?.name || ""), description: String(t?.description || ""), parameters: t?.input_schema || {} },
+    }));
+  }
+  const keptNames = new Set(fnTools.map((t) => String(t?.name || "")));
+  const tc = req.tool_choice;
+  if (tc === "auto" || (tc && typeof tc === "object" && tc.type === "auto")) body.tool_choice = "auto";
+  else if (tc && typeof tc === "object" && tc.type === "any") body.tool_choice = "required";
+  // 点名一个已被剥掉的工具时降为 auto：上游会按不存在的函数强制点名，那样一定拿不到有用回答
+  else if (tc && typeof tc === "object" && tc.type === "tool") body.tool_choice = keptNames.has(String(tc.name || "")) ? { type: "function", function: { name: String(tc.name || "") } } : "auto";
+  else if (tc && typeof tc === "object" && tc.type === "none") body.tool_choice = "none";
+  if (req.max_tokens != null && Number.isFinite(Number(req.max_tokens))) body.max_tokens = Number(req.max_tokens);
+  if (req.temperature != null) body.temperature = req.temperature;
+  if (req.top_p != null) body.top_p = req.top_p;
+  if (Array.isArray(req.stop_sequences) && req.stop_sequences.length) body.stop = req.stop_sequences;
+  // 思考档位原样透传（不解释语义，语义归一交给各 provider / src/thinking-effort.js）：
+  // 客户端显式声明必须一路带到上游，旧版在此丢掉 → 下游被迫补默认值（workbuddy 恒 high）。
+  if (req.thinking != null) body.thinking = req.thinking;
+  // 档位载体只收「非空 trimmed 字符串」：空串声明不算声明，不该发出去顶掉下游默认值。
+  for (const k of ["effort", "reasoning_effort", "reasoningEffort"]) {
+    const v = typeof req[k] === "string" ? req[k].trim() : "";
+    if (v) body[k] = v;
+  }
+  if (req.extra_body != null) body.extra_body = req.extra_body;
+  // output_config.effort 是 Claude Code 的另一档位载体（beta），原始对象上游不认故不外发，
+  // 但档位本身不能丢 → 归一到 reasoning_effort（客户端已显式声明时以声明为准）。
+  const ocEffort = req.output_config && typeof req.output_config === "object" ? req.output_config.effort : undefined;
+  if (ocEffort != null && body.reasoning_effort == null && body.reasoningEffort == null) {
+    body.reasoning_effort = ocEffort;
+  }
+  return body;
+}

package/src/anthropic/shared.js

@@ -1,18 +1,18 @@
-// /v1/messages 外壳的公共原语：消息/工具 id 与 Anthropic 协议错误体。
-// ADR-0055 把请求侧拆去 request-body.js 时独立成档，让 request-body.js 与 translate.js 单向依赖它，
-// 避免两文件互相 import 成环（函数提升虽能跑，顶层常量会 TDZ，属定时炸弹）。
-// 共用面：src/anthropic/request-body.js（newToolUseId）、src/anthropic/translate.js（newMessageId/
-// newToolUseId，并对外 re-export 三个符号，调用方与测试的 import 路径不变）。
-
-let seq = 0;
-export function newMessageId() {
-  return `msg_${Date.now().toString(36)}${(seq++).toString(36)}`;
-}
-export function newToolUseId() {
-  return `toolu_${Date.now().toString(36)}${(seq++).toString(36)}`;
-}
-
-/** Anthropic 协议错误体形状（非流式 JSON 与流式 in-band error 帧共用）。 */
-export function anthropicError(type, message) {
-  return { type: "error", error: { type: String(type || "api_error"), message: String(message || "error").slice(0, 500) } };
-}
+// /v1/messages 外壳的公共原语：消息/工具 id 与 Anthropic 协议错误体。
+// ADR-0055 把请求侧拆去 request-body.js 时独立成档，让 request-body.js 与 translate.js 单向依赖它，
+// 避免两文件互相 import 成环（函数提升虽能跑，顶层常量会 TDZ，属定时炸弹）。
+// 共用面：src/anthropic/request-body.js（newToolUseId）、src/anthropic/translate.js（newMessageId/
+// newToolUseId，并对外 re-export 三个符号，调用方与测试的 import 路径不变）。
+
+let seq = 0;
+export function newMessageId() {
+  return `msg_${Date.now().toString(36)}${(seq++).toString(36)}`;
+}
+export function newToolUseId() {
+  return `toolu_${Date.now().toString(36)}${(seq++).toString(36)}`;
+}
+
+/** Anthropic 协议错误体形状（非流式 JSON 与流式 in-band error 帧共用）。 */
+export function anthropicError(type, message) {
+  return { type: "error", error: { type: String(type || "api_error"), message: String(message || "error").slice(0, 500) } };
+}