@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/lib/ingress/session-notice.js

@@ -1,66 +1,66 @@
-/**
- * lib/ingress/session-notice.js —— ingress 往「正在等的那个会话」推一句人话（08-21 晚）。
- *
- * 病：上游抖的时候（Zen 的 503 挂 50~140 秒才返回、network_error 慢败 185 秒），CLI 在退避重试，
- * 会话里**什么都不动** —— 用户看到的是一个转了三五分钟的绿点，不知道是卡死了还是在重试，
- * 也就不知道该等还是该点停止。
- *
- * 治法：ingress 每次上游失败就往会话推一条通知（前端弹 toast）。ingress 住 lib/、会话住 engine/，
- * 为了不让 lib 反向依赖 engine（session-loop 已经 import model-ingress），这里只做一个回调注册表：
- * session-loop 起会话时 register，结束时 unregister，ingress 只管 notice。
- *
- * 节流住在这里而不是调用方：一次失败 CLI 0.2 秒就重发，连着几发能刷出一串 toast。
- * 同一会话 MIN_INTERVAL_MS 内只推一条，够用户知道"在重试"，不至于变成噪音。
- */
-
-export const MIN_INTERVAL_MS = 20_000;
-
-export class SessionNotices {
-  constructor({ minIntervalMs = MIN_INTERVAL_MS, now = () => Date.now() } = {}) {
-    this.handlers = new Map();   // sid → fn(payload)
-    this.lastAt = new Map();     // sid → ts（节流）
-    this.minIntervalMs = minIntervalMs;
-    this.now = now;
-  }
-  register(sid, fn) { if (sid && typeof fn === 'function') this.handlers.set(sid, fn); }
-  /**
-   * 注销。`expected` 给了就只在**当前登记的就是它**时才删（跟 unregisterQuerySession 的 token 比对同一招）：
-   * 旧会话的 finally 跑在 `await commitWorkspace` 之后，可能已经隔了几秒，期间同 sid 的新会话
-   * 已经 register —— 不比对就会把新会话的通道删掉，新会话从此静默收不到上游提示。
-   */
-  unregister(sid, expected = null) {
-    if (!sid) return;
-    if (expected && this.handlers.get(sid) !== expected) return;
-    this.handlers.delete(sid);
-    this.lastAt.delete(sid);
-  }
-  /**
-   * 推一条。没有注册者（非会话请求 / 会话已结束）就静默丢弃。
-   * @param {string} sid
-   * @param {{ key?: string, text: string, priority?: string }} payload
-   * @param {{ throttle?: boolean }} [opts] throttle=false 强制推（默认 true）
-   * @returns {boolean} 真推出去了吗
-   */
-  notice(sid, payload, { throttle = true } = {}) {
-    const fn = sid ? this.handlers.get(sid) : null;
-    if (!fn || !payload?.text) return false;
-    const now = this.now();
-    if (throttle && this.lastAt.has(sid)) {
-      // ⚠️ 别写成 `(this.lastAt.get(sid) || 0)`：没推过时那是 0，真时钟下 now-0 巨大碰巧放行，
-      // 假时钟（测试里 now()=0）却把**第一条**吞掉 —— 同一段代码两种行为。
-      if (now - this.lastAt.get(sid) < this.minIntervalMs) return false;
-    }
-    this.lastAt.set(sid, now);
-    try { fn(payload); return true; } catch (err) {
-      console.warn(`[session-notice] handler failed for ${String(sid).slice(0, 8)}: ${err.message}`);
-      return false;
-    }
-  }
-}
-
-/** 进程内单例 */
-export const sessionNotices = new SessionNotices();
-
-export function registerSessionNotice(sid, fn) { sessionNotices.register(sid, fn); }
-export function unregisterSessionNotice(sid, expected) { sessionNotices.unregister(sid, expected); }
-export function noticeSession(sid, payload, opts) { return sessionNotices.notice(sid, payload, opts); }
+/**
+ * lib/ingress/session-notice.js —— ingress 往「正在等的那个会话」推一句人话（08-21 晚）。
+ *
+ * 病：上游抖的时候（Zen 的 503 挂 50~140 秒才返回、network_error 慢败 185 秒），CLI 在退避重试，
+ * 会话里**什么都不动** —— 用户看到的是一个转了三五分钟的绿点，不知道是卡死了还是在重试，
+ * 也就不知道该等还是该点停止。
+ *
+ * 治法：ingress 每次上游失败就往会话推一条通知（前端弹 toast）。ingress 住 lib/、会话住 engine/，
+ * 为了不让 lib 反向依赖 engine（session-loop 已经 import model-ingress），这里只做一个回调注册表：
+ * session-loop 起会话时 register，结束时 unregister，ingress 只管 notice。
+ *
+ * 节流住在这里而不是调用方：一次失败 CLI 0.2 秒就重发，连着几发能刷出一串 toast。
+ * 同一会话 MIN_INTERVAL_MS 内只推一条，够用户知道"在重试"，不至于变成噪音。
+ */
+
+export const MIN_INTERVAL_MS = 20_000;
+
+export class SessionNotices {
+  constructor({ minIntervalMs = MIN_INTERVAL_MS, now = () => Date.now() } = {}) {
+    this.handlers = new Map();   // sid → fn(payload)
+    this.lastAt = new Map();     // sid → ts（节流）
+    this.minIntervalMs = minIntervalMs;
+    this.now = now;
+  }
+  register(sid, fn) { if (sid && typeof fn === 'function') this.handlers.set(sid, fn); }
+  /**
+   * 注销。`expected` 给了就只在**当前登记的就是它**时才删（跟 unregisterQuerySession 的 token 比对同一招）：
+   * 旧会话的 finally 跑在 `await commitWorkspace` 之后，可能已经隔了几秒，期间同 sid 的新会话
+   * 已经 register —— 不比对就会把新会话的通道删掉，新会话从此静默收不到上游提示。
+   */
+  unregister(sid, expected = null) {
+    if (!sid) return;
+    if (expected && this.handlers.get(sid) !== expected) return;
+    this.handlers.delete(sid);
+    this.lastAt.delete(sid);
+  }
+  /**
+   * 推一条。没有注册者（非会话请求 / 会话已结束）就静默丢弃。
+   * @param {string} sid
+   * @param {{ key?: string, text: string, priority?: string }} payload
+   * @param {{ throttle?: boolean }} [opts] throttle=false 强制推（默认 true）
+   * @returns {boolean} 真推出去了吗
+   */
+  notice(sid, payload, { throttle = true } = {}) {
+    const fn = sid ? this.handlers.get(sid) : null;
+    if (!fn || !payload?.text) return false;
+    const now = this.now();
+    if (throttle && this.lastAt.has(sid)) {
+      // ⚠️ 别写成 `(this.lastAt.get(sid) || 0)`：没推过时那是 0，真时钟下 now-0 巨大碰巧放行，
+      // 假时钟（测试里 now()=0）却把**第一条**吞掉 —— 同一段代码两种行为。
+      if (now - this.lastAt.get(sid) < this.minIntervalMs) return false;
+    }
+    this.lastAt.set(sid, now);
+    try { fn(payload); return true; } catch (err) {
+      console.warn(`[session-notice] handler failed for ${String(sid).slice(0, 8)}: ${err.message}`);
+      return false;
+    }
+  }
+}
+
+/** 进程内单例 */
+export const sessionNotices = new SessionNotices();
+
+export function registerSessionNotice(sid, fn) { sessionNotices.register(sid, fn); }
+export function unregisterSessionNotice(sid, expected) { sessionNotices.unregister(sid, expected); }
+export function noticeSession(sid, payload, opts) { return sessionNotices.notice(sid, payload, opts); }

package/server/lib/ingress/session-routes.js

@@ -1,68 +1,68 @@
-/**
- * lib/ingress/session-routes.js — 会话级路由（08-22 从 model-ingress.js 拆出，行为见 resolveSessionWire）。
- *
- * SDK binary 的部分内部 helper 不看 ANTHROPIC_SMALL_FAST_MODEL，直接用它 config 目录里的默认 Claude 名
- * 发请求（_ingress-check 实测抓到 claude-sonnet-5 重试 8 次）。旧基建里这类请求静默打错通路烧钱；
- * fail-loud 之后它们会 502 = helper 功能死。这里给注册过的会话一条兜底：未知 model 名 → 本会话的 fast 模型。
- * session-loop 在 API 会话起 query 前注册、finally 注销。
- *
- * ⛔ 撞名雷（2026-08-19 审计标出、08-20 封死）：API 行的 sdkAlias 同时也是真实的 Claude 名。qwen 会话里的
- * binary 若用这类名字发一发 helper 请求，按全表反查会**命中别的行**、带着别家钥匙静默转发——事前无警报、
- * 成功转发不留日志。表级断言封不住（SDK 内部会用哪些名字没法枚举），所以是**会话级路由**：一个会话只认
- * 自己那行和自己的 fast 行，其它一概改道 fast 兜底，绝不跨行。
- *
- * 08-22 起**会话优先**而不是全表优先：本地分发版的外部插槽共用同一个 sdkAlias（表内只剩一个空着的 1M 订阅名，
- * 见 model-context.js EXTERNAL_SDK_ALIAS），全表反查分不出它们，只有会话知道自己是谁。先问会话、再查全表，
- * 对内置行结果不变（自己的 alias 反查到的就是自己）。
- */
-
-import { resolveWireModel, resolveModelRoute, wireNamesOf } from '../../engine/agent/model-context.js';
-
-const sessionRoutes = new Map();     // sessionId → { appModel, fastModel }
-/** `${sid}:${model}` 只告一次，防日志洪水（model-ingress.js 读写） */
-export const fallbackLogged = new Set();
-
-export function registerIngressSession(sessionId, appModel) {
-  const route = resolveModelRoute(appModel);
-  if (route.mode === 'api') sessionRoutes.set(sessionId, { appModel: route.appModel, fastModel: route.fastModel });
-}
-
-export function unregisterIngressSession(sessionId) {
-  sessionRoutes.delete(sessionId);
-  for (const k of fallbackLogged) {
-    if (k.startsWith(sessionId + ':')) fallbackLogged.delete(k);
-  }
-}
-
-/**
- * 会话级路由决策（纯函数，有单测）。
- *
- * - 没注册的会话 / 无会话前缀（探针、体检）：全表反查，查不到就是 null（502）。
- * - 注册过的 API 会话：只认**自己那行**和**自己的 fast 行**（按 wireNamesOf：id / alias / 剥 [1m] 的 alias）。
- *   其它名字一律改道 fast 兜底——不在表里的是 SDK helper 默认名（'fallback'），在表里但属于别的行的
- *   就是撞名雷（'collision'），后者尤其不能放过去（那是别家的钥匙、真钱）。
- *
- * role：'main' = 会话主行的请求（主 agent 一轮）；'helper' = fast 行 / 兜底 / 撞名改道
- * （标题、auto 分类器、摘要等一句话的活）。openai-chat 行按 role 选 reasoning_effort。
- *
- * @returns {{ wire: ReturnType<typeof resolveWireModel>, reason: 'table'|'fallback'|'collision'|'none', role: 'main'|'helper',
- *             fastModel?: string, sessionModel?: string, collidesWith?: string }}
- */
-export function resolveSessionWire(bodyModel, sessionTag) {
-  const sess = sessionTag ? sessionRoutes.get(sessionTag) : null;
-  if (!sess) {
-    const direct = resolveWireModel(bodyModel);
-    return { wire: direct, reason: direct ? 'table' : 'none', role: 'main' };
-  }
-  if (wireNamesOf(sess.appModel).includes(bodyModel)) return { wire: resolveWireModel(sess.appModel), reason: 'table', role: 'main' };
-  if (wireNamesOf(sess.fastModel).includes(bodyModel)) return { wire: resolveWireModel(sess.fastModel), reason: 'table', role: 'helper' };
-  const direct = resolveWireModel(bodyModel);
-  return {
-    wire: resolveWireModel(sess.fastModel),
-    role: 'helper',
-    reason: direct ? 'collision' : 'fallback',
-    fastModel: sess.fastModel,
-    sessionModel: sess.appModel,
-    ...(direct ? { collidesWith: direct.appModel } : {}),
-  };
-}
+/**
+ * lib/ingress/session-routes.js — 会话级路由（08-22 从 model-ingress.js 拆出，行为见 resolveSessionWire）。
+ *
+ * SDK binary 的部分内部 helper 不看 ANTHROPIC_SMALL_FAST_MODEL，直接用它 config 目录里的默认 Claude 名
+ * 发请求（_ingress-check 实测抓到 claude-sonnet-5 重试 8 次）。旧基建里这类请求静默打错通路烧钱；
+ * fail-loud 之后它们会 502 = helper 功能死。这里给注册过的会话一条兜底：未知 model 名 → 本会话的 fast 模型。
+ * session-loop 在 API 会话起 query 前注册、finally 注销。
+ *
+ * ⛔ 撞名雷（2026-08-19 审计标出、08-20 封死）：API 行的 sdkAlias 同时也是真实的 Claude 名。qwen 会话里的
+ * binary 若用这类名字发一发 helper 请求，按全表反查会**命中别的行**、带着别家钥匙静默转发——事前无警报、
+ * 成功转发不留日志。表级断言封不住（SDK 内部会用哪些名字没法枚举），所以是**会话级路由**：一个会话只认
+ * 自己那行和自己的 fast 行，其它一概改道 fast 兜底，绝不跨行。
+ *
+ * 08-22 起**会话优先**而不是全表优先：本地分发版的外部插槽共用同一个 sdkAlias（表内只剩一个空着的 1M 订阅名，
+ * 见 model-context.js EXTERNAL_SDK_ALIAS），全表反查分不出它们，只有会话知道自己是谁。先问会话、再查全表，
+ * 对内置行结果不变（自己的 alias 反查到的就是自己）。
+ */
+
+import { resolveWireModel, resolveModelRoute, wireNamesOf } from '../../engine/agent/model-context.js';
+
+const sessionRoutes = new Map();     // sessionId → { appModel, fastModel }
+/** `${sid}:${model}` 只告一次，防日志洪水（model-ingress.js 读写） */
+export const fallbackLogged = new Set();
+
+export function registerIngressSession(sessionId, appModel) {
+  const route = resolveModelRoute(appModel);
+  if (route.mode === 'api') sessionRoutes.set(sessionId, { appModel: route.appModel, fastModel: route.fastModel });
+}
+
+export function unregisterIngressSession(sessionId) {
+  sessionRoutes.delete(sessionId);
+  for (const k of fallbackLogged) {
+    if (k.startsWith(sessionId + ':')) fallbackLogged.delete(k);
+  }
+}
+
+/**
+ * 会话级路由决策（纯函数，有单测）。
+ *
+ * - 没注册的会话 / 无会话前缀（探针、体检）：全表反查，查不到就是 null（502）。
+ * - 注册过的 API 会话：只认**自己那行**和**自己的 fast 行**（按 wireNamesOf：id / alias / 剥 [1m] 的 alias）。
+ *   其它名字一律改道 fast 兜底——不在表里的是 SDK helper 默认名（'fallback'），在表里但属于别的行的
+ *   就是撞名雷（'collision'），后者尤其不能放过去（那是别家的钥匙、真钱）。
+ *
+ * role：'main' = 会话主行的请求（主 agent 一轮）；'helper' = fast 行 / 兜底 / 撞名改道
+ * （标题、auto 分类器、摘要等一句话的活）。openai-chat 行按 role 选 reasoning_effort。
+ *
+ * @returns {{ wire: ReturnType<typeof resolveWireModel>, reason: 'table'|'fallback'|'collision'|'none', role: 'main'|'helper',
+ *             fastModel?: string, sessionModel?: string, collidesWith?: string }}
+ */
+export function resolveSessionWire(bodyModel, sessionTag) {
+  const sess = sessionTag ? sessionRoutes.get(sessionTag) : null;
+  if (!sess) {
+    const direct = resolveWireModel(bodyModel);
+    return { wire: direct, reason: direct ? 'table' : 'none', role: 'main' };
+  }
+  if (wireNamesOf(sess.appModel).includes(bodyModel)) return { wire: resolveWireModel(sess.appModel), reason: 'table', role: 'main' };
+  if (wireNamesOf(sess.fastModel).includes(bodyModel)) return { wire: resolveWireModel(sess.fastModel), reason: 'table', role: 'helper' };
+  const direct = resolveWireModel(bodyModel);
+  return {
+    wire: resolveWireModel(sess.fastModel),
+    role: 'helper',
+    reason: direct ? 'collision' : 'fallback',
+    fastModel: sess.fastModel,
+    sessionModel: sess.appModel,
+    ...(direct ? { collidesWith: direct.appModel } : {}),
+  };
+}

package/server/lib/ingress/slot-probe.js

@@ -1,130 +1,130 @@
-/**
- * lib/ingress/slot-probe.js — 模型插槽体检（08-22，探针脚本转正）。
- *
- * 配置页「体检」按钮打的就是它：对一行 API 模型，**穿过进程内入口**（model-ingress → 转换层 → 上游）
- * 发五发最小请求，回一张红绿表。为什么必须穿入口而不是直打上游：quirk 表按上游写（gproxy 的
- * network_error、refusal 映射、空体 5xx），用户自带的新端点踩的坑和内置行不一样，直打上游测不出转换层
- * 那一段；而真会话里 CLI 发的就是经过入口的请求（body.model 是剥了 [1m] 的 sdkAlias）。
- *
- * 五项：text（非流式）/ stream（SSE）/ tool_use（工具调用 + 入参能解析）/ vision（64×64 纯红图问颜色）/
- * count_tokens。vision 与 count_tokens 标 info：上游不支持不算这行不能当主力，但用户该知道。
- *
- * 订阅行不经入口（CLI 自己的登录态），这里不探，回一条说明。
- */
-
-import sharp from 'sharp';
-import { getOrStartIngress } from '../model-ingress.js';
-import { registerIngressSession, unregisterIngressSession } from './session-routes.js';
-import { resolveModelRoute } from '../../engine/agent/model-context.js';
-
-const PEEK_TOOL = {
-  name: 'peek',
-  description: 'Return the secret number. Call it with a one-sentence reason.',
-  input_schema: { type: 'object', properties: { reason: { type: 'string' } }, required: ['reason'] },
-};
-
-async function redPng() {
-  return (await sharp({ create: { width: 64, height: 64, channels: 3, background: { r: 220, g: 20, b: 20 } } }).png().toBuffer()).toString('base64');
-}
-
-function parseSse(text) {
-  const events = [];
-  for (const chunk of text.split(/\n\n+/)) {
-    const line = chunk.split('\n').find((l) => l.startsWith('data:'));
-    if (!line) continue;
-    try { events.push(JSON.parse(line.slice(5).trim())); } catch { /* 非 JSON 行（ping 等）跳过 */ }
-  }
-  return events;
-}
-
-const textOf = (json) => (json?.content || []).filter((b) => b.type === 'text').map((b) => b.text).join('').trim();
-
-/**
- * @param {string} appModel
- * @param {{ timeoutMs?: number, vision?: boolean }} [opts]
- * @returns {Promise<{ appModel: string, mode: 'api'|'subscription', checks: Array<{ id, label, ok: boolean|null, level: 'core'|'info', ms: number, note: string }> }>}
- */
-export async function probeModel(appModel, { timeoutMs = 45_000, vision = true } = {}) {
-  const route = resolveModelRoute(appModel);
-  if (route.mode !== 'api') {
-    return { appModel, mode: 'subscription', checks: [{ id: 'subscription', label: '订阅/直连行', ok: null, level: 'info', ms: 0,
-      note: '这一行由 Claude Code 自己的登录态或 ANTHROPIC_API_KEY 驱动，不经入口，这里不探；开个项目发一句话就能验' }] };
-  }
-  const ingress = await getOrStartIngress();
-  const tag = `probe-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
-  registerIngressSession(tag, appModel);
-  const model = route.sdkAlias.replace(/\[1m\]$/i, '');   // CLI 序列化时剥 [1m]，体检照它发
-  const base = `${ingress.baseUrl}/__nd/${encodeURIComponent(tag)}`;
-  const checks = [];
-
-  async function post(path, body) {
-    const ac = new AbortController();
-    const timer = setTimeout(() => ac.abort(), timeoutMs);
-    const t0 = Date.now();
-    try {
-      const res = await fetch(base + path, {
-        method: 'POST', signal: ac.signal,
-        headers: { 'content-type': 'application/json', 'x-api-key': 'nd-ingress-managed', 'anthropic-version': '2023-06-01' },
-        body: JSON.stringify({ model, ...body }),
-      });
-      const text = await res.text();
-      let json = null; try { json = JSON.parse(text); } catch { /* SSE 或非 JSON */ }
-      return { status: res.status, text, json, ms: Date.now() - t0 };
-    } catch (err) {
-      return { status: 0, text: '', json: null, ms: Date.now() - t0, error: err.name === 'AbortError' ? `超时 ${timeoutMs / 1000}s` : err.message };
-    } finally { clearTimeout(timer); }
-  }
-  const errNote = (r) => r.error || `HTTP ${r.status}${r.text ? `：${r.text.slice(0, 160)}` : ''}`;
-
-  try {
-    // 1 text
-    {
-      const r = await post('/v1/messages', { max_tokens: 32, messages: [{ role: 'user', content: 'Reply with exactly the word pong and nothing else.' }] });
-      const ok = r.status === 200 && !!textOf(r.json);
-      checks.push({ id: 'text', label: '非流式文本', ok, level: 'core', ms: r.ms,
-        note: ok ? `答「${textOf(r.json).slice(0, 40)}」 stop=${r.json.stop_reason} in/out=${r.json.usage?.input_tokens ?? '?'}/${r.json.usage?.output_tokens ?? '?'}` : errNote(r) });
-    }
-    // 2 stream
-    {
-      const r = await post('/v1/messages', { max_tokens: 32, stream: true, messages: [{ role: 'user', content: 'Reply with exactly the word pong and nothing else.' }] });
-      const ev = r.status === 200 ? parseSse(r.text) : [];
-      const types = new Set(ev.map((e) => e.type));
-      const delta = ev.filter((e) => e.type === 'content_block_delta' && e.delta?.type === 'text_delta').map((e) => e.delta.text).join('');
-      const ok = r.status === 200 && types.has('message_start') && types.has('message_stop') && !!delta.trim();
-      const errEv = ev.find((e) => e.type === 'error');
-      checks.push({ id: 'stream', label: '流式（SSE）', ok, level: 'core', ms: r.ms,
-        note: ok ? `${ev.length} 个事件，文本「${delta.trim().slice(0, 40)}」` : (r.status === 200 ? `事件类型 ${[...types].join(',') || '(空)'}${errEv ? ` error=${JSON.stringify(errEv.error || errEv).slice(0, 120)}` : ''}` : errNote(r)) });
-    }
-    // 3 tool_use
-    {
-      const r = await post('/v1/messages', { max_tokens: 200, tools: [PEEK_TOOL], tool_choice: { type: 'any' },
-        messages: [{ role: 'user', content: 'Call the peek tool now with a short reason. Do not answer in text.' }] });
-      const tu = (r.json?.content || []).find((b) => b.type === 'tool_use');
-      const ok = r.status === 200 && !!tu && tu.name === 'peek' && tu.input && typeof tu.input === 'object';
-      checks.push({ id: 'tool_use', label: '工具调用', ok, level: 'core', ms: r.ms,
-        note: ok ? `stop=${r.json.stop_reason} input=${JSON.stringify(tu.input).slice(0, 80)}` : (r.status === 200 ? `没发起 tool_use（stop=${r.json?.stop_reason}，内容=${textOf(r.json).slice(0, 80) || JSON.stringify(r.json?.content || []).slice(0, 80)}）` : errNote(r)) });
-    }
-    // 4 vision
-    if (vision) {
-      const png = await redPng();
-      const r = await post('/v1/messages', { max_tokens: 32, messages: [{ role: 'user', content: [
-        { type: 'image', source: { type: 'base64', media_type: 'image/png', data: png } },
-        { type: 'text', text: 'What color is this image? Answer with one English word.' },
-      ] }] });
-      const ans = textOf(r.json);
-      const ok = r.status === 200 && /red/i.test(ans);
-      checks.push({ id: 'vision', label: '看图', ok, level: 'info', ms: r.ms,
-        note: r.status === 200 ? `纯红图答「${ans.slice(0, 40)}」${ok ? '' : '（没认出 red：这行看不了图，截图自检会瞎）'}` : errNote(r) });
-    }
-    // 5 count_tokens
-    {
-      const r = await post('/v1/messages/count_tokens', { messages: [{ role: 'user', content: 'hello there' }] });
-      const ok = r.status === 200 && Number.isFinite(r.json?.input_tokens);
-      checks.push({ id: 'count_tokens', label: 'count_tokens', ok, level: 'info', ms: r.ms,
-        note: ok ? `input_tokens=${r.json.input_tokens}（上游没有该端点时入口本地估算，数会偏）` : errNote(r) });
-    }
-  } finally {
-    unregisterIngressSession(tag);
-  }
-  return { appModel, mode: 'api', upstream: route.upstreamId, wireModel: route.upstream && undefined, checks };
-}
+/**
+ * lib/ingress/slot-probe.js — 模型插槽体检（08-22，探针脚本转正）。
+ *
+ * 配置页「体检」按钮打的就是它：对一行 API 模型，**穿过进程内入口**（model-ingress → 转换层 → 上游）
+ * 发五发最小请求，回一张红绿表。为什么必须穿入口而不是直打上游：quirk 表按上游写（gproxy 的
+ * network_error、refusal 映射、空体 5xx），用户自带的新端点踩的坑和内置行不一样，直打上游测不出转换层
+ * 那一段；而真会话里 CLI 发的就是经过入口的请求（body.model 是剥了 [1m] 的 sdkAlias）。
+ *
+ * 五项：text（非流式）/ stream（SSE）/ tool_use（工具调用 + 入参能解析）/ vision（64×64 纯红图问颜色）/
+ * count_tokens。vision 与 count_tokens 标 info：上游不支持不算这行不能当主力，但用户该知道。
+ *
+ * 订阅行不经入口（CLI 自己的登录态），这里不探，回一条说明。
+ */
+
+import sharp from 'sharp';
+import { getOrStartIngress } from '../model-ingress.js';
+import { registerIngressSession, unregisterIngressSession } from './session-routes.js';
+import { resolveModelRoute } from '../../engine/agent/model-context.js';
+
+const PEEK_TOOL = {
+  name: 'peek',
+  description: 'Return the secret number. Call it with a one-sentence reason.',
+  input_schema: { type: 'object', properties: { reason: { type: 'string' } }, required: ['reason'] },
+};
+
+async function redPng() {
+  return (await sharp({ create: { width: 64, height: 64, channels: 3, background: { r: 220, g: 20, b: 20 } } }).png().toBuffer()).toString('base64');
+}
+
+function parseSse(text) {
+  const events = [];
+  for (const chunk of text.split(/\n\n+/)) {
+    const line = chunk.split('\n').find((l) => l.startsWith('data:'));
+    if (!line) continue;
+    try { events.push(JSON.parse(line.slice(5).trim())); } catch { /* 非 JSON 行（ping 等）跳过 */ }
+  }
+  return events;
+}
+
+const textOf = (json) => (json?.content || []).filter((b) => b.type === 'text').map((b) => b.text).join('').trim();
+
+/**
+ * @param {string} appModel
+ * @param {{ timeoutMs?: number, vision?: boolean }} [opts]
+ * @returns {Promise<{ appModel: string, mode: 'api'|'subscription', checks: Array<{ id, label, ok: boolean|null, level: 'core'|'info', ms: number, note: string }> }>}
+ */
+export async function probeModel(appModel, { timeoutMs = 45_000, vision = true } = {}) {
+  const route = resolveModelRoute(appModel);
+  if (route.mode !== 'api') {
+    return { appModel, mode: 'subscription', checks: [{ id: 'subscription', label: '订阅/直连行', ok: null, level: 'info', ms: 0,
+      note: '这一行由 Claude Code 自己的登录态或 ANTHROPIC_API_KEY 驱动，不经入口，这里不探；开个项目发一句话就能验' }] };
+  }
+  const ingress = await getOrStartIngress();
+  const tag = `probe-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+  registerIngressSession(tag, appModel);
+  const model = route.sdkAlias.replace(/\[1m\]$/i, '');   // CLI 序列化时剥 [1m]，体检照它发
+  const base = `${ingress.baseUrl}/__nd/${encodeURIComponent(tag)}`;
+  const checks = [];
+
+  async function post(path, body) {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    const t0 = Date.now();
+    try {
+      const res = await fetch(base + path, {
+        method: 'POST', signal: ac.signal,
+        headers: { 'content-type': 'application/json', 'x-api-key': 'nd-ingress-managed', 'anthropic-version': '2023-06-01' },
+        body: JSON.stringify({ model, ...body }),
+      });
+      const text = await res.text();
+      let json = null; try { json = JSON.parse(text); } catch { /* SSE 或非 JSON */ }
+      return { status: res.status, text, json, ms: Date.now() - t0 };
+    } catch (err) {
+      return { status: 0, text: '', json: null, ms: Date.now() - t0, error: err.name === 'AbortError' ? `超时 ${timeoutMs / 1000}s` : err.message };
+    } finally { clearTimeout(timer); }
+  }
+  const errNote = (r) => r.error || `HTTP ${r.status}${r.text ? `：${r.text.slice(0, 160)}` : ''}`;
+
+  try {
+    // 1 text
+    {
+      const r = await post('/v1/messages', { max_tokens: 32, messages: [{ role: 'user', content: 'Reply with exactly the word pong and nothing else.' }] });
+      const ok = r.status === 200 && !!textOf(r.json);
+      checks.push({ id: 'text', label: '非流式文本', ok, level: 'core', ms: r.ms,
+        note: ok ? `答「${textOf(r.json).slice(0, 40)}」 stop=${r.json.stop_reason} in/out=${r.json.usage?.input_tokens ?? '?'}/${r.json.usage?.output_tokens ?? '?'}` : errNote(r) });
+    }
+    // 2 stream
+    {
+      const r = await post('/v1/messages', { max_tokens: 32, stream: true, messages: [{ role: 'user', content: 'Reply with exactly the word pong and nothing else.' }] });
+      const ev = r.status === 200 ? parseSse(r.text) : [];
+      const types = new Set(ev.map((e) => e.type));
+      const delta = ev.filter((e) => e.type === 'content_block_delta' && e.delta?.type === 'text_delta').map((e) => e.delta.text).join('');
+      const ok = r.status === 200 && types.has('message_start') && types.has('message_stop') && !!delta.trim();
+      const errEv = ev.find((e) => e.type === 'error');
+      checks.push({ id: 'stream', label: '流式（SSE）', ok, level: 'core', ms: r.ms,
+        note: ok ? `${ev.length} 个事件，文本「${delta.trim().slice(0, 40)}」` : (r.status === 200 ? `事件类型 ${[...types].join(',') || '(空)'}${errEv ? ` error=${JSON.stringify(errEv.error || errEv).slice(0, 120)}` : ''}` : errNote(r)) });
+    }
+    // 3 tool_use
+    {
+      const r = await post('/v1/messages', { max_tokens: 200, tools: [PEEK_TOOL], tool_choice: { type: 'any' },
+        messages: [{ role: 'user', content: 'Call the peek tool now with a short reason. Do not answer in text.' }] });
+      const tu = (r.json?.content || []).find((b) => b.type === 'tool_use');
+      const ok = r.status === 200 && !!tu && tu.name === 'peek' && tu.input && typeof tu.input === 'object';
+      checks.push({ id: 'tool_use', label: '工具调用', ok, level: 'core', ms: r.ms,
+        note: ok ? `stop=${r.json.stop_reason} input=${JSON.stringify(tu.input).slice(0, 80)}` : (r.status === 200 ? `没发起 tool_use（stop=${r.json?.stop_reason}，内容=${textOf(r.json).slice(0, 80) || JSON.stringify(r.json?.content || []).slice(0, 80)}）` : errNote(r)) });
+    }
+    // 4 vision
+    if (vision) {
+      const png = await redPng();
+      const r = await post('/v1/messages', { max_tokens: 32, messages: [{ role: 'user', content: [
+        { type: 'image', source: { type: 'base64', media_type: 'image/png', data: png } },
+        { type: 'text', text: 'What color is this image? Answer with one English word.' },
+      ] }] });
+      const ans = textOf(r.json);
+      const ok = r.status === 200 && /red/i.test(ans);
+      checks.push({ id: 'vision', label: '看图', ok, level: 'info', ms: r.ms,
+        note: r.status === 200 ? `纯红图答「${ans.slice(0, 40)}」${ok ? '' : '（没认出 red：这行看不了图，截图自检会瞎）'}` : errNote(r) });
+    }
+    // 5 count_tokens
+    {
+      const r = await post('/v1/messages/count_tokens', { messages: [{ role: 'user', content: 'hello there' }] });
+      const ok = r.status === 200 && Number.isFinite(r.json?.input_tokens);
+      checks.push({ id: 'count_tokens', label: 'count_tokens', ok, level: 'info', ms: r.ms,
+        note: ok ? `input_tokens=${r.json.input_tokens}（上游没有该端点时入口本地估算，数会偏）` : errNote(r) });
+    }
+  } finally {
+    unregisterIngressSession(tag);
+  }
+  return { appModel, mode: 'api', upstream: route.upstreamId, wireModel: route.upstream && undefined, checks };
+}