dsh-tap 0.20.0

package/scripts/probe-qoder-null-content.mjs

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+/**
+ * Qoder CN — assistant.content 形态单变量差分（provider_error 真根因定位）
+ *
+ * 背景：踩坑 #39 把报错归因到"孤儿 tool 消息"，但网关侧 sanitizeToolPairing
+ * 上线后同一报错仍在。本探针只动一个变量——assistant 消息的 content 取值
+ * （null / "" / 文本 / 缺键），其余逐字段相同，打真实上游逐模型家族对比。
+ *
+ * 用法：
+ *   node scripts/probe-qoder-null-content.mjs                 # 默认 dmodel
+ *   node scripts/probe-qoder-null-content.mjs --models dmodel,kmodel,mmodel,qmodel,auto
+ *   node scripts/probe-qoder-null-content.mjs --gw            # 叠加"经生产网关"对照
+ * 证据落 docs/probes/qoder-null-content-<ts>.json
+ */
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const DSH_HOME = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+const AUTH_PATH = join(DSH_HOME, 'qoder-plugin-auth.json')
+const PROBES_DIR = join(ROOT, 'docs', 'probes')
+const INFER = process.env.QODER_INFER ?? 'https://gateway.qoder.com.cn'
+const GW_PORT = Number(process.env.QODER_GW_PORT ?? 3903)
+const GAP = Number(process.env.QODER_GAP_MS ?? 1200)
+
+const argv = process.argv.slice(2)
+const val = (f, d) => { const i = argv.indexOf(f); return i >= 0 ? argv[i + 1] : d }
+const MODELS = (val('--models', 'dmodel')).split(',').map((s) => s.trim()).filter(Boolean)
+const WITH_GW = argv.includes('--gw')
+// --gw-local：用**当前工作区代码**起一个临时网关（而非 :3903 上正在跑的旧进程），
+// 用来验证"修复后的网关出站体"在真实上游是否放行（前后对比）。
+const LOCAL_GW = argv.includes('--gw-local')
+
+const { readJson } = await import('../core/json-store.js')
+const { createCosyRuntime } = await import('../providers/qoder/cosy.js')
+const cosy = createCosyRuntime({ wasmPath: join(ROOT, 'providers', 'qoder', 'qoder_auth.wasm') })
+const store = readJson(AUTH_PATH)
+const cred = { accessToken: store?.auth?.accessToken, machineId: store?.machine?.machineId, uid: store?.account?.uid }
+if (!cred.accessToken) { console.error('未登录：先跑 probe-qoder-live.mjs --login'); process.exit(1) }
+
+const TOOLS = [{ type: 'function', function: { name: 'get_time', description: '查询时间', parameters: { type: 'object', properties: { tz: { type: 'string' } }, required: ['tz'] } } }]
+const call = (id) => [{ id, type: 'function', function: { name: 'get_time', arguments: '{"tz":"Asia/Shanghai"}' } }]
+const result = (id) => ({ role: 'tool', tool_call_id: id, content: '2026-09-22 09:00:00 +08:00' })
+const sysHead = { role: 'system', content: '你是助手' }
+const u = (t) => ({ role: 'user', content: t })
+
+/** 形态库：每个只动一个变量。 */
+const SHAPES = {
+  // —— content 单变量（其余完全一致的合法工具环）——
+  'A_call_content_null': [sysHead, u('几点'), { role: 'assistant', content: null, tool_calls: call('call_a1') }, result('call_a1'), u('谢谢，直接回答')],
+  'A_call_content_empty': [sysHead, u('几点'), { role: 'assistant', content: '', tool_calls: call('call_a1') }, result('call_a1'), u('谢谢，直接回答')],
+  'A_call_content_text': [sysHead, u('几点'), { role: 'assistant', content: '我查一下', tool_calls: call('call_a1') }, result('call_a1'), u('谢谢，直接回答')],
+  'A_call_content_absent': [sysHead, u('几点'), { role: 'assistant', tool_calls: call('call_a1') }, result('call_a1'), u('谢谢，直接回答')],
+  // —— 孤儿 tool（#39 形态）：无前置 assistant ——
+  'B_orphan_plain': [sysHead, u('几点'), result('call_b1'), u('谢谢')],
+  // —— 修复桩形态（sanitizeToolPairing 实际产出）：补的 assistant content:null ——
+  'B_orphan_stub_null': [sysHead, u('几点'), { role: 'assistant', content: null, tool_calls: call('call_b1') }, result('call_b1'), u('谢谢')],
+  'B_orphan_stub_empty': [sysHead, u('几点'), { role: 'assistant', content: '', tool_calls: call('call_b1') }, result('call_b1'), u('谢谢')],
+  // —— tool 消息本身 content 单变量 ——
+  'C_tool_content_null': [sysHead, u('几点'), { role: 'assistant', content: '', tool_calls: call('call_c1') }, { role: 'tool', tool_call_id: 'call_c1', content: null }, u('谢谢')],
+  'C_tool_content_empty': [sysHead, u('几点'), { role: 'assistant', content: '', tool_calls: call('call_c1') }, { role: 'tool', tool_call_id: 'call_c1', content: '' }, u('谢谢')],
+  // —— 不带 tools 数组的合法环（另一个候选变量）——
+  'D_pair_without_tools': [sysHead, u('几点'), { role: 'assistant', content: '', tool_calls: call('call_d1') }, result('call_d1'), u('谢谢')],
+  // —— 纯文本对照（无工具，确认通道本身健康）——
+  'E_plain_chat': [sysHead, u('只回复两个字：收到')],
+}
+
+// --only A,B：只跑名字前缀匹配的形态（省额度）
+const ONLY = (val('--only', '') || '').split(',').map((s) => s.trim()).filter(Boolean)
+const wantShape = (name) => !ONLY.length || ONLY.some((p) => name.startsWith(p))
+
+const evidence = { ts: new Date().toISOString(), infer: INFER, models: MODELS, gw: LOCAL_GW ? 'local(fixed code)' : `${GW_PORT}(running process)`, shapes: {}, results: [] }
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+function verdictOf(raw) {
+  const flat = raw.replace(/\\"/g, '"').replace(/\\\\/g, '\\')
+  const env = flat.match(/\{"code":"provider_error".*?"details":"(.*?)"\}/)
+  if (env) {
+    let inner = env[1]
+    try { inner = JSON.parse(`"${env[1]}"`).message ?? env[1] } catch { try { inner = JSON.parse(JSON.parse(`"${env[1]}"`)).error.message } catch {} }
+    return { kind: 'PROVIDER_ERROR', text: String(inner).replace(/\s+/g, ' ').slice(0, 300) }
+  }
+  const fail = flat.match(/\{"code":"[^"]*","message":"(\[FAIL\][^"]{0,200})/)
+  if (fail) return { kind: 'NODE_FAIL', text: fail[1] }
+  const text = (flat.match(/"content":"((?:[^"\\]|\\.)*)"/) ?? [])[1]
+  const done = raw.includes('[DONE]')
+  return { kind: text ? 'OK_TEXT' : (done ? 'OK_EMPTY' : 'NO_SIGNAL'), text: (text ?? '').slice(0, 120) }
+}
+
+async function direct(model, messages, withTools = true) {
+  const body = { model, stream: true, stream_options: { include_usage: true }, messages, ...(withTools ? { tools: TOOLS, tool_choice: 'auto' } : {}) }
+  const signed = await cosy.prepareChat(cred, { endpoint: INFER, body: JSON.stringify(body), modelKey: model, modelSource: 'system' })
+  const r = await fetch(signed.url, { method: 'POST', headers: { ...signed.headers, 'Content-Type': 'application/json', Accept: 'text/event-stream' }, body: signed.body })
+  const raw = await r.text()
+  const v = verdictOf(raw)
+  return { via: 'direct', model, httpStatus: r.status, ...v, requestShapes: messages.map((m) => `${m.role}${m.tool_calls ? '+tc' : ''}${'content' in m ? `:content=${JSON.stringify(m.content)?.slice(0, 12) ?? 'undef'}` : ':no-content-key'}`) }
+}
+
+// 本地临时网关（当前工作区代码）——验证修复后的出站体
+let gwBase = `http://127.0.0.1:${GW_PORT}`
+let stopLocalGw = null
+if (LOCAL_GW) {
+  const { createQoderGateway } = await import('../providers/qoder/gateway.js')
+  const runtime = { running: false, port: null, lastError: null }
+  const localGw = createQoderGateway({
+    settings: () => ({ qoderInferBaseURL: INFER, maxConcurrentPerSession: 2, upstreamFirstByteTimeoutMs: 90_000 }),
+    resolveCredential: async () => ({ authorization: `Bearer ${cred.accessToken}`, machineId: cred.machineId, uid: cred.uid }),
+    cosy, meter: { record() {} }, runtime, forensics: { logPath: () => undefined },
+    getCatalogProfiles: () => [], getCatalogEntry: () => null,
+    getModelSource: () => 'system', getModelPrefs: () => ({}),
+  })
+  stopLocalGw = localGw.listen(0)
+  for (let i = 0; i < 100 && !runtime.running; i++) await sleep(50)
+  if (!runtime.running) { console.error('本地网关起不来：', runtime.lastError); process.exit(1) }
+  gwBase = `http://127.0.0.1:${runtime.port}`
+}
+
+async function viaGw(model, messages, withTools = true) {
+  const body = { model, stream: true, stream_options: { include_usage: true }, messages, ...(withTools ? { tools: TOOLS, tool_choice: 'auto' } : {}) }
+  const r = await fetch(`${gwBase}/v1/chat/completions`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) })
+  const raw = await r.text()
+  return { via: `gw:${new URL(gwBase).port}`, model, httpStatus: r.status, ...verdictOf(raw) }
+}
+
+console.log(`真实上游差分：models=${MODELS.join(',')}  形态=${Object.keys(SHAPES).length}${WITH_GW ? '  +生产网关对照' : ''}\n`)
+for (const [name, messages] of Object.entries(SHAPES)) {
+  evidence.shapes[name] = messages
+  for (const model of MODELS) {
+    const withTools = !name.startsWith('D_')
+    const r = await direct(model, structuredClone(messages), withTools)
+    r.shape = name
+    evidence.results.push(r)
+    console.log(`  ${name.padEnd(22)} ${model.padEnd(8)} ${r.kind.padEnd(14)} ${r.kind === 'OK_TEXT' ? `"${r.text}"` : r.text.slice(0, 150)}`)
+    await sleep(GAP)
+  }
+  if ((WITH_GW || LOCAL_GW) && /^(A_call_content_null|B_orphan_plain|B_orphan_stub_null|C_tool_content_null)$/.test(name)) {
+    for (const model of MODELS) {
+      const r = await viaGw(model, structuredClone(messages))
+      r.shape = `${name} (gateway)`
+      evidence.results.push(r)
+      console.log(`  ${`${name} [GW]`.padEnd(22)} ${model.padEnd(8)} ${r.kind.padEnd(14)} ${r.kind === 'OK_TEXT' ? `"${r.text}"` : r.text.slice(0, 150)}`)
+      await sleep(GAP)
+    }
+  }
+}
+
+mkdirSync(PROBES_DIR, { recursive: true })
+const out = join(PROBES_DIR, `qoder-null-content-${Date.now()}.json`)
+writeFileSync(out, JSON.stringify(evidence, null, 2))
+console.log('\n证据 →', out)
+process.exit(0)

package/scripts/probe-qoder-pairing.mjs

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+/**
+ * Qoder CN — tool 配对不变量差分实验（踩坑 #39 复发调查）
+ *
+ * --offline  用宿主真实序列化器（@earendil-works/pi-ai convertMessages）跑 8 种
+ *            真实会话形态 → 打印出站 messages 序列 → 用严格校验器判违规 →
+ *            再判 sanitizeToolPairing 修复后是否仍违规（不花额度）。
+ * --live     把 offline 产出的**真实报文**打到真实上游严格模型家族：
+ *            direct = 绕过修复（阳性对照），gw = 经本机 :3903 生产网关（含修复）。
+ *
+ * 用法：
+ *   node scripts/probe-qoder-pairing.mjs --offline
+ *   node scripts/probe-qoder-pairing.mjs --live --model dmodel
+ *   node scripts/probe-qoder-pairing.mjs --live --gw-port 3903
+ * 证据落 docs/probes/qoder-pairing-<ts>.json
+ */
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const DSH_HOME = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+const AUTH_PATH = join(DSH_HOME, 'qoder-plugin-auth.json')
+const PROBES_DIR = join(ROOT, 'docs', 'probes')
+const INFER = process.env.QODER_INFER ?? 'https://gateway.qoder.com.cn'
+const PI_AI = process.env.PI_AI_PATH
+  ?? 'C:/Users/21613/dev/dsh-launcher/node_modules/@earendil-works/pi-ai/dist/api/openai-completions.js'
+
+const args = process.argv.slice(2)
+const val = (f, d) => { const i = args.indexOf(f); return i >= 0 ? args[i + 1] : d }
+const LIVE = args.includes('--live')
+const LIVE_MODEL = val('--model', 'dmodel')
+const GW_PORT = Number(val('--gw-port', '3903'))
+
+const { sanitizeToolPairing } = await import('../providers/tool-pairing.js')
+const { convertMessages } = await import(pathToFileURL(PI_AI).href)
+
+// ── 宿主侧真实 model 对象（settings.yaml llm-pi-ai.providers.qoder 的投影）──
+// 注意 reasoning:false——现网 qoder 模型条目**不声明** reasoning，故 pi-ai 把 system
+// prompt 序列化成 role:"system"（若为 true 会变 role:"developer"，那是另一条独立
+// 故障：上游在反序列化阶段整请求拒绝，见 probe-qoder-null-content.mjs 的 E 组）。
+const MODEL = {
+  id: LIVE_MODEL, name: 'probe', provider: 'qoder', api: 'openai-completions',
+  baseUrl: `http://127.0.0.1:${GW_PORT}/v1`, reasoning: false,
+  input: ['text', 'image'], contextWindow: 200000, maxTokens: 32768,
+}
+const TOOLS = [{
+  type: 'function', function: {
+    name: 'read', description: '读文件',
+    parameters: { type: 'object', properties: { f: { type: 'number' } }, required: ['f'] },
+  },
+}]
+const sysPrompt = 'You are a coding agent. Use tools when helpful.'
+
+/**
+ * pi-ai detectCompat() 对本 provider 的解析结果（provider="qoder" 不在任何
+ * isNonStandard 名单里、baseUrl 是回环地址 → 判定为"标准 OpenAI 面"）。
+ * getCompat 未导出，这里按 detectCompat 源码逐字段复刻（openai-completions.js
+ * :1234-1318），保证 offline 重放与宿主真实出站一致。
+ */
+const COMPAT = {
+  supportsStore: true,
+  supportsDeveloperRole: true,
+  supportsReasoningEffort: true,
+  supportsUsageInStreaming: true,
+  supportsFinishReason: true,
+  maxTokensField: 'max_completion_tokens',
+  requiresToolResultName: false,
+  requiresAssistantAfterToolResult: false,
+  requiresThinkingAsText: false,
+  requiresReasoningContentOnAssistantMessages: false,
+  thinkingFormat: 'openai',
+  openRouterRouting: {},
+  vercelGatewayRouting: {},
+  chatTemplateKwargs: {},
+  chatTemplateArgs: {},
+  zaiToolStream: false,
+  supportsThinkingTokenBudget: false,
+  thinkingTokenBudgetField: undefined,
+  supportsStrictMode: true,
+  supportsOpenAIGrammarTools: false,
+  cacheControlFormat: undefined,
+  sendSessionAffinityHeaders: false,
+  deferredToolsMode: undefined,
+  sessionAffinityFormat: 'openai',
+  supportsLongCacheRetention: true,
+}
+
+const tc = (id, name, a) => ({ type: 'toolCall', id, name, arguments: a })
+const asst = (content, stopReason) => ({
+  role: 'assistant', content, stopReason, provider: MODEL.provider, api: MODEL.api, model: MODEL.id,
+})
+const tr = (toolCallId, toolName, text) => ({
+  role: 'toolResult', toolCallId, toolName, isError: false,
+  content: [{ type: 'text', text }], timestamp: Date.now(),
+})
+const user = (text) => ({ role: 'user', content: [{ type: 'text', text }] })
+
+/** 8 种 dsh 真实可能产生的历史形态。 */
+const TRANSCRIPTS = {
+  normal_tool_round: [
+    user('读一下文件'),
+    asst([tc('call_A', 'read', { f: 1 })], 'tool_calls'),
+    tr('call_A', 'read', 'file content'),
+    asst([{ type: 'text', text: '内容如上' }], 'stop'),
+  ],
+  aborted_carrier: [
+    user('读一下文件'),
+    asst([{ type: 'thinking', thinking: '我要读文件' }, tc('call_B', 'read', { f: 2 })], 'aborted'),
+    tr('call_B', 'read', 'b content'),
+    user('继续'),
+  ],
+  error_carrier: [
+    user('读一下文件'),
+    asst([tc('call_E', 'read', { f: 5 })], 'error'),
+    tr('call_E', 'read', 'e content'),
+    user('再来'),
+  ],
+  mixed_multi_turn: [
+    user('step1'),
+    asst([tc('call_A', 'read', { f: 1 })], 'tool_calls'),
+    tr('call_A', 'read', 'ok'),
+    asst([tc('call_B', 'read', { f: 2 })], 'aborted'),
+    tr('call_B', 'read', 'ran anyway'),
+    asst([tc('call_C', 'read', { f: 3 })], 'tool_calls'),
+    tr('call_C', 'read', 'hits'),
+    asst([{ type: 'text', text: '完成' }], 'stop'),
+    user('next'),
+  ],
+  parallel_partial: [
+    user('parallel'),
+    asst([tc('call_A', 'read', { f: 1 }), tc('call_B', 'read', { f: 2 })], 'tool_calls'),
+    tr('call_A', 'read', 'only A'),
+    user('换个问题'),
+  ],
+  aborted_no_result: [
+    user('x'), asst([tc('call_B', 'read', { f: 1 })], 'aborted'), user('重来'),
+  ],
+  two_aborted_carriers: [
+    user('x'),
+    asst([tc('call_B', 'read', { f: 1 })], 'aborted'), tr('call_B', 'read', 'b'),
+    asst([tc('call_C', 'read', { f: 2 })], 'aborted'), tr('call_C', 'read', 'c'),
+    user('继续'),
+  ],
+  duplicate_result: [
+    user('x'),
+    asst([tc('call_B', 'read', { f: 1 })], 'aborted'), tr('call_B', 'read', 'first'), tr('call_B', 'read', 'second'),
+    user('继续'),
+  ],
+}
+
+/**
+ * 严格校验器（模拟上游 OpenAI 兼容面那条规则的最严读法）
+ *   flat          : role:tool 的 id 必须出现在更早某条 assistant.tool_calls
+ *   strict-group  : 且必须紧跟声明它的 assistant，该 assistant 的每个 call 都要有结果
+ */
+function validate(messages, mode) {
+  const problems = []
+  const seen = new Set()
+  let open = null
+  const close = (i) => {
+    if (open) {
+      for (const id of open.ids) if (!open.answered.has(id)) problems.push(`L${i}: tool_call ${id} 声明了却无结果`)
+      open = null
+    }
+  }
+  messages.forEach((m, i) => {
+    if (m.role === 'assistant') {
+      close(i)
+      const ids = (m.tool_calls ?? []).map((c) => c.id)
+      for (const id of ids) seen.add(id)
+      if (ids.length) open = { ids: new Set(ids), answered: new Set() }
+      return
+    }
+    if (m.role === 'tool') {
+      const id = m.tool_call_id
+      if (!seen.has(id)) problems.push(`L${i}: 孤儿 tool ${id}（更早历史没有声明它的 assistant）`)
+      else if (mode === 'strict-group' && (!open || !open.ids.has(id))) problems.push(`L${i}: tool ${id} 未紧跟声明它的 assistant`)
+      if (open?.ids.has(id)) open.answered.add(id)
+      return
+    }
+    close(i)
+  })
+  close(messages.length)
+  return problems
+}
+
+const seq = (ms) => ms.map((m) => (m.role === 'assistant'
+  ? `assistant${(m.tool_calls ?? []).length ? `[${m.tool_calls.map((c) => c.id).join('+')}]` : ''}`
+  : m.role === 'tool' ? `tool[${m.tool_call_id}]` : m.role)).join(' ')
+
+const evidence = { ts: new Date().toISOString(), piAi: PI_AI, model: MODEL, gwPort: GW_PORT, cases: [] }
+const built = {}
+
+for (const [name, messages] of Object.entries(TRANSCRIPTS)) {
+  const params = convertMessages(MODEL, { systemPrompt: sysPrompt, tools: TOOLS, messages }, COMPAT, {}) ?? []
+  const pair = sanitizeToolPairing(params)
+  const before = { flat: validate(params, 'flat'), group: validate(params, 'strict-group') }
+  const after = { flat: validate(pair.messages, 'flat'), group: validate(pair.messages, 'strict-group') }
+  built[name] = { raw: params, fixed: pair.messages }
+  evidence.cases.push({ name, sequenceBefore: seq(params), sequenceAfter: seq(pair.messages), repaired: pair.repaired, violationsBefore: before, violationsAfter: after, stillBroken: after.flat.length + after.group.length > 0, rawMessages: params, fixedMessages: pair.messages })
+  console.log(`\n### ${name}`)
+  console.log('  出站序列  :', seq(params))
+  console.log('  修复后序列:', seq(pair.messages), JSON.stringify(pair.repaired))
+  console.log('  修复前违规:', before.flat.length ? before.flat : 'none')
+  console.log('  修复后违规:', after.flat.length || after.group.length ? { ...after } : 'none', after.flat.length + after.group.length > 0 ? '  <<< 仍有违规' : '')
+}
+console.log(`\n总计 ${evidence.cases.length} 形态，修复后仍违规 ${evidence.cases.filter((c) => c.stillBroken).length}`)
+
+if (!LIVE) {
+  mkdirSync(PROBES_DIR, { recursive: true })
+  const out = join(PROBES_DIR, `qoder-pairing-${Date.now()}.json`)
+  writeFileSync(out, JSON.stringify(evidence, null, 2))
+  console.log('证据 →', out)
+  process.exit(0)
+}
+
+// ══════════════════ LIVE：真实上游（严格模型家族）══════════════════
+const { readJson } = await import('../core/json-store.js')
+const { createCosyRuntime } = await import('../providers/qoder/cosy.js')
+const cosy = createCosyRuntime({ wasmPath: join(ROOT, 'providers', 'qoder', 'qoder_auth.wasm') })
+const store = readJson(AUTH_PATH)
+const cred = { accessToken: store?.auth?.accessToken, machineId: store?.machine?.machineId, uid: store?.account?.uid }
+if (!cred.accessToken) { console.error('未登录：先跑 scripts/probe-qoder-live.mjs --login'); process.exit(1) }
+
+const wrap = (messages, extra = {}) => ({ model: LIVE_MODEL, stream: true, stream_options: { include_usage: true }, messages, tools: TOOLS, tool_choice: 'auto', ...extra })
+
+function record(label, note, status, raw) {
+  const flat = raw.replace(/\\{2,}"$/gm, '').replace(/\\"/g, '"').replace(/\\\\/g, '\\')
+  const errHit = flat.match(/\{"code":"provider_error".{0,300}/) ?? flat.match(/\{"code":"\d+","message":"\[FAIL\][^"]{0,200}"/) ?? flat.match(/"error":\s*\{[^{}]{0,300}/)
+  const hasText = /"content":"[^"]/.test(flat)
+  const done = raw.includes('[DONE]')
+  const verdict = errHit ? `ERROR ${errHit[0].slice(0, 180)}` : (hasText ? 'OK 有正文' : (done ? 'OK 空正文(有 DONE)' : '?? 无正文无 DONE'))
+  console.log(`  ${label.padEnd(36)} ${status} → ${verdict}${note ? `   [${note}]` : ''}`)
+  evidence.live.push({ label, note, status, verdict, errHit: errHit?.[0] ?? null, raw: raw.slice(0, 8000) })
+}
+
+/** 直连签名：绕过生产网关的修复（阳性对照）。 */
+async function direct(label, bodyObj, note) {
+  const signed = await cosy.prepareChat(cred, { endpoint: INFER, body: JSON.stringify(bodyObj), modelKey: LIVE_MODEL, modelSource: 'system' })
+  const r = await fetch(signed.url, { method: 'POST', headers: { ...signed.headers, 'Content-Type': 'application/json', Accept: 'text/event-stream' }, body: signed.body })
+  record(label, note, `HTTP ${r.status}`, await r.text())
+}
+
+/** 经生产网关 :3903（含 sanitizeToolPairing + 归因信封）。 */
+async function gw(label, bodyObj, note) {
+  try {
+    const r = await fetch(`http://127.0.0.1:${GW_PORT}/v1/chat/completions`, {
+      method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(bodyObj),
+    })
+    record(label, note, `HTTP ${r.status}`, await r.text())
+    return true
+  } catch (e) {
+    console.log(`  ${label.padEnd(36)} 网关 :${GW_PORT} 不可用（${e.message}）——该例跳过`)
+    evidence.live.push({ label, note, skipped: String(e.message) })
+    return false
+  }
+}
+
+evidence.live = []
+console.log(`\n──────── LIVE model=${LIVE_MODEL} 网关=:${GW_PORT} ────────`)
+
+// A. 阳性对照：同一份坏体，直连（不修）应当 400
+await direct('A1_raw_orphan_direct', wrap(built.aborted_carrier.raw), 'pi-ai 裸出站（孤儿 tool）')
+await direct('A2_raw_two_orphans_direct', wrap(built.two_aborted_carriers.raw), '两条连续孤儿 tool')
+
+// B. 生产路径：同一份坏体经网关（修复后应当 200）
+await gw('B1_gateway_aborted_carrier', wrap(built.aborted_carrier.raw), '网关修复孤儿→补桩')
+await gw('B2_gateway_mixed_multi_turn', wrap(built.mixed_multi_turn.raw), '多轮混合（孤儿夹在合法环中）')
+await gw('B3_gateway_two_aborted', wrap(built.two_aborted_carriers.raw), '连续两孤儿')
+await gw('B4_gateway_dup_result', wrap(built.duplicate_result.raw), '同 id 重复结果')
+await gw('B5_gateway_normal_round', wrap(built.normal_tool_round.raw), '对照：本就合法')
+
+// C. 修复桩形态直连（我们补出来的东西严格上游收不收）
+await direct('C1_stub_content_null', wrap([{ role: 'user', content: '读文件' },
+  { role: 'assistant', content: null, tool_calls: [{ id: 'call_s1', type: 'function', function: { name: 'read', arguments: '{}' } }] },
+  { role: 'tool', tool_call_id: 'call_s1', content: '(tool result unavailable: previous attempt was interrupted)' }]), '桩：assistant content:null')
+await direct('C2_stub_content_empty', wrap([{ role: 'user', content: '读文件' },
+  { role: 'assistant', content: '', tool_calls: [{ id: 'call_s2', type: 'function', function: { name: 'read', arguments: '{}' } }] },
+  { role: 'tool', tool_call_id: 'call_s2', content: '(unavailable)' }]), '桩：assistant content:""')
+await direct('C3_valid_pair', wrap([{ role: 'user', content: '读文件' },
+  { role: 'assistant', content: null, tool_calls: [{ id: 'call_ok', type: 'function', function: { name: 'read', arguments: '{"f":1}' } }] },
+  { role: 'tool', tool_call_id: 'call_ok', content: 'file body' }]), '对照：合法工具环')
+// D. 顺序读法：orphan 桩插在"合法环中间"后，前一条 tool 的结果被推到最后
+await direct('D1_group_order_edge', wrap([
+  { role: 'user', content: 'q' },
+  { role: 'assistant', content: null, tool_calls: [{ id: 'call_A', type: 'function', function: { name: 'read', arguments: '{"f":1}' } }] },
+  { role: 'assistant', content: null, tool_calls: [{ id: 'call_B', type: 'function', function: { name: 'read', arguments: '{}' } }] },
+  { role: 'tool', tool_call_id: 'call_B', content: 'B 的结果' },
+  { role: 'tool', tool_call_id: 'call_A', content: 'A 的结果' },
+]), 'assistant[A] assistant[B] tool[B] tool[A]（A 的结果不在紧跟组内）')
+// E. developer 角色（pi-ai 对 reasoning 模型把 system 序列化成 developer）
+await direct('E1_developer_role', wrap([{ role: 'developer', content: '你是编码助手' }, { role: 'user', content: '只回复：收到' }]), 'role:developer 是否被接受')
+await direct('E2_system_role', wrap([{ role: 'system', content: '你是编码助手' }, { role: 'user', content: '只回复：收到' }]), 'role:system 对照')
+// F. 只有 assistant.tool_calls 没结果 / tool 结果无 tools 数组
+await direct('F1_calls_without_result', wrap([{ role: 'user', content: '读文件' },
+  { role: 'assistant', content: null, tool_calls: [{ id: 'call_Z', type: 'function', function: { name: 'read', arguments: '{}' } }] }]), 'tool_calls 缺结果')
+await direct('F2_pair_without_tools_array', { model: LIVE_MODEL, stream: true, stream_options: { include_usage: true }, messages: [
+  { role: 'user', content: '读文件' },
+  { role: 'assistant', content: null, tool_calls: [{ id: 'call_Y', type: 'function', function: { name: 'read', arguments: '{}' } }] },
+  { role: 'tool', tool_call_id: 'call_Y', content: 'body' }] }, '合法配对但请求不带 tools 数组')
+
+mkdirSync(PROBES_DIR, { recursive: true })
+const outLive = join(PROBES_DIR, `qoder-pairing-${Date.now()}.json`)
+writeFileSync(outLive, JSON.stringify(evidence, null, 2))
+console.log('\n证据 →', outLive)
+process.exit(0)

package/scripts/probe-qoder-quota.mjs

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+/**
+ * Qoder CN — 用量计数器差分探针（真实网络、本人账号）。
+ *
+ * 用途：聊天前后各拉一遍统计端点做差分。读数语义（2026-09-22 臂 9 定论）：
+ *   - `quota/usage` 的 `addOnQuota.used` = **实时**配额计数器，但**只显整数**——
+ *     0.002 级小额聊天会被取整吞掉（"不计费"假阴性的来源）；判别须用大额
+ *     用量（单发 ≥0.5 credits）或与读数分辨率匹配的量级；
+ *   - `credits-heatmap` / `credits-summary` = **统计视图层**，延迟批处理
+ *     （官方客户端自己的聊天 20 分钟内也不动），由归因链（信封+business 块+
+ *     finish/tracking 上报）驱动——插件网关 0.9.9 起已对齐；
+ *   - 免费档模型（如 qfmodel，帧 billable:false）不耗 credits，任何计数器都不动。
+ *
+ * 用法：
+ *   node scripts/probe-qoder-quota.mjs             # 基线 → 1 次聊天 → 5s/20s 后复拉
+ *   node scripts/probe-qoder-quota.mjs --read-only # 只拉端点不聊天
+ */
+
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const DSH_HOME = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+const PROBES_DIR = join(ROOT, 'docs', 'probes')
+const OPENAPI = process.env.QODER_OPENAPI ?? 'https://openapi.qoder.com.cn'
+const INFER = process.env.QODER_INFER ?? 'https://gateway.qoder.com.cn'
+const CHAT_MODEL = process.env.QODER_QUOTA_MODEL ?? 'q37fmodel' // 对照健康、单价最低档
+const readOnly = process.argv.includes('--read-only')
+
+const { readJson } = await import('../core/json-store.js')
+const { createCosyRuntime } = await import('../providers/qoder/cosy.js')
+
+const store = readJson(join(DSH_HOME, 'qoder-plugin-auth.json'))
+if (!store?.auth?.accessToken) {
+  console.error('未登录：先跑 scripts/probe-qoder-live.mjs --login')
+  process.exit(1)
+}
+const token = store.auth.accessToken
+const cred = { accessToken: token, machineId: store.machine?.machineId, uid: store.account?.uid }
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+const ENDPOINTS = [
+  ['quotaUsage', 'GET', `${OPENAPI}/api/v2/quota/usage`],
+  ['quotaUsageOuter', 'GET', `${OPENAPI}/api/v2/quota/usage?outerProviders=cmcc`],
+  ['meUsage', 'GET', `${OPENAPI}/sash/api/v2/me/usage`],
+  ['creditsHeatmap', 'GET', `${OPENAPI}/sash/api/v1/ai-conversations/credits-heatmap?days=1`],
+  ['creditsSummary', 'GET', `${OPENAPI}/sash/api/v1/ai-conversations/credits-summary`],
+  ['userPlan', 'GET', `${OPENAPI}/api/v2/user/plan`],
+]
+
+async function pullAll(tag) {
+  const snap = { tag, at: new Date().toISOString(), endpoints: {} }
+  for (const [name, method, url] of ENDPOINTS) {
+    const rec = {}
+    try {
+      const res = await fetch(url, { method, headers: { Authorization: `Bearer ${token}` } })
+      rec.status = res.status
+      const text = await res.text()
+      rec.body = text.length <= 20_000 ? text : text.slice(0, 20_000) + '…(截断)'
+    } catch (e) {
+      rec.netErr = String(e?.message ?? e)
+    }
+    snap.endpoints[name] = rec
+    console.log(`  [${tag}] ${name.padEnd(16)} HTTP ${rec.status ?? '-'} ${rec.body ? String(rec.body).slice(0, 160) : (rec.netErr ?? '')}`)
+    await sleep(400)
+  }
+  return snap
+}
+
+/** 提取计数器摘要用于 diff（结构未知时原样保留原文）。 */
+function summarize(snap) {
+  const out = {}
+  for (const [name, rec] of Object.entries(snap.endpoints)) {
+    try {
+      const j = JSON.parse(rec.body)
+      out[name] = j
+    } catch { out[name] = rec.body ?? rec.netErr }
+  }
+  return out
+}
+
+const evidence = { at: new Date().toISOString(), openapi: OPENAPI, chatModel: CHAT_MODEL, steps: [] }
+
+console.log('① 基线拉取：')
+const before = await pullAll('before')
+evidence.steps.push({ step: 'before', data: summarize(before) })
+
+if (!readOnly) {
+  console.log('\n② 最小聊天（cosy 签名裸 OpenAI body，与插件网关出站同形态）：')
+  const cosy = createCosyRuntime({ wasmPath: join(ROOT, 'providers', 'qoder', 'qoder_auth.wasm') })
+  const body = JSON.stringify({
+    model: CHAT_MODEL, stream: true, stream_options: { include_usage: true },
+    messages: [{ role: 'user', content: '只回复两个字：收到' }],
+  })
+  const chatRec = { model: CHAT_MODEL }
+  try {
+    const signed = await cosy.prepareChat(cred, { endpoint: INFER, body, modelKey: CHAT_MODEL, modelSource: 'system' })
+    chatRec.url = signed.url
+    const res = await fetch(signed.url, {
+      method: 'POST',
+      headers: { ...signed.headers, 'Content-Type': 'application/json', Accept: 'text/event-stream' },
+      body: signed.body,
+    })
+    chatRec.status = res.status
+    const raw = await res.text()
+    chatRec.raw = raw.slice(0, 20_000)
+    // 取尾帧 usage
+    for (const line of raw.split('\n')) {
+      if (!line.startsWith('data:')) continue
+      let frame; try { frame = JSON.parse(line.slice(5)) } catch { continue }
+      if (typeof frame?.body !== 'string' || frame.body === '[DONE]') continue
+      let chunk; try { chunk = JSON.parse(frame.body) } catch { continue }
+      if (chunk.usage) chatRec.usage = chunk.usage
+      if (chunk.choices?.[0]?.delta?.content) chatRec.text = (chatRec.text ?? '') + chunk.choices[0].delta.content
+    }
+    console.log(`  chat HTTP ${chatRec.status} 正文=${JSON.stringify((chatRec.text ?? '').slice(0, 30))} usage=${JSON.stringify(chatRec.usage)}`)
+  } catch (e) {
+    chatRec.netErr = String(e?.message ?? e)
+    console.log('  chat 网络错误：', chatRec.netErr)
+  }
+  evidence.steps.push({ step: 'chat', data: chatRec })
+
+  console.log('\n③ 5s 后复拉：')
+  await sleep(5000)
+  const after5 = await pullAll('after5s')
+  evidence.steps.push({ step: 'after5s', data: summarize(after5) })
+
+  console.log('\n④ 20s 后复拉：')
+  await sleep(20_000)
+  const after25 = await pullAll('after25s')
+  evidence.steps.push({ step: 'after25s', data: summarize(after25) })
+
+  // 计数器 diff（只关心数字字段）
+  const num = (snap, path) => path.split('.').reduce((o, k) => (o && typeof o === 'object' ? o[k] : undefined), snap)
+  const counters = [
+    ['quotaUsage', 'addOnQuota.used'], ['quotaUsage', 'userQuota.used'],
+    ['quotaUsageOuter', 'addOnQuota.used'], ['quotaUsageOuter', 'userQuota.used'],
+  ]
+  console.log('\n【计数器 diff】')
+  const diffs = []
+  for (const [ep, path] of counters) {
+    const pick = (snap) => { const e = snap.data[ep]; const parts = path.split('.'); let v = e; for (const p of parts) v = v?.[p]; return typeof v === 'number' ? v : null }
+    const b = pick(evidence.steps[0]), a = pick(evidence.steps[evidence.steps.length - 1])
+    const line = `  ${ep}.${path}: ${b ?? '?'} → ${a ?? '?'} ${b != null && a != null ? (a > b ? '★ 涨了 +' + (a - b) : (a === b ? '（不变）' : '（降了？!）')) : ''}`
+    console.log(line)
+    diffs.push({ counter: `${ep}.${path}`, before: b, after: a })
+  }
+  evidence.diffs = diffs
+  const grew = diffs.some((d) => d.before != null && d.after != null && d.after > d.before)
+  evidence.verdict = grew
+    ? 'billing-ok-display-gap：扣费计数器在涨，缺的只是展示层归因（business 块/finish 上报）'
+    : 'not-counted：计数器不动——服务端对缺归因信封的请求可能不计入配额，需在聊天 body 明文补归因字段复测'
+  console.log('\n【结论】', evidence.verdict)
+}
+
+mkdirSync(PROBES_DIR, { recursive: true })
+const out = join(PROBES_DIR, `qoder-quota-${Date.now()}.json`)
+writeFileSync(out, JSON.stringify(evidence, null, 2))
+console.log('\n证据 →', out)
+process.exit(0)