dsh-router-qoder 0.0.0-stage → 0.1.1

package/src/global.ts

@@ -0,0 +1,38 @@
+/**
+ * qoder-global（Qoder 国际版）供应商 profile —— 上游 https://api1.qoder.sh。
+ *
+ * 与国内版**同协议同契约**（cosy 签名、jobToken、同一套模型/聊天端点），差异只有
+ * 主机与一件实测事实：**sash 面（积分 / 签到）需要设备风控头**，那三件套来自本机
+ * Qoder 客户端的 UMID 组件。本插件不伪造它 —— 拿不到时积分与签到会如实报
+ * 「该区域需要本机 Qoder 客户端的设备组件」，而不是显示「今天没有活动」。
+ *
+ * chat 与模型列表不受这条限制（它们走 cosy 面，不吃设备风控头）。
+ *
+ * ⚠️ `id = 'qoder-global'` **同时是凭证与配置的存储键**（`credentials.sqlite` 的
+ * `supplier` 列、`supplier-config.json` 的键），改它 = 账号全部消失。
+ */
+import type { ModelInfo } from './types.ts'
+import type { QoderProfile } from './core.ts'
+import { QODER_ICON } from './icon.ts'
+
+/** 兜底列表故意留空（理由见 cn.ts）。 */
+const FALLBACK_MODELS: ModelInfo[] = []
+
+export const profile: QoderProfile = {
+  id: 'qoder-global',
+  name: 'Qoder Global',
+  region: 'global',
+  icon: QODER_ICON,
+  priority: -2,
+  uidPrefix: 'qdg',
+  defaultNickname: 'Qoder Global',
+  errPrefix: 'qoder-global',
+  // 国际版控制台域名是 qoder.com（`qoder.sh` 只有网关/开放 API 主机名，没有网页）；
+  // 写成 qoder.sh 会让用户去访问一个解析不出来域名。
+  apiKeyHint: '粘贴 Qoder 国际版的个人访问令牌（PAT，形如 pt-…）。在哪拿：登录 qoder.com '
+    + '控制台 → Settings → Personal Access Tokens → 创建（复制只显示一次的 pt-…）。'
+    + '令牌按区域签发，国际版的 pt-… 在国内版卡片上无效（反之亦然）。'
+    + '国际版的积分与每日签到还需要本机安装 Qoder 客户端（设备风控组件），'
+    + '只有 PAT 时聊天与模型可用，积分/签到会如实报错。',
+  fallbackModels: FALLBACK_MODELS,
+}

package/src/icon.ts

@@ -0,0 +1,8 @@
+/**
+ * qoder 族供应商共用的面板图标 —— 内联 SVG data URI。
+ *
+ * 为什么内联：图标不该依赖另一个服务活着，更不该依赖特定端口。国内版与国际版
+ * 同族，共用同一张图（只有 name 不同）。
+ */
+export const QODER_ICON =
+  'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA2NCA2NCIgd2lkdGg9IjEyOCIgaGVpZ2h0PSIxMjgiPjxyZWN0IHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgcng9IjE0IiBmaWxsPSIjMmI2YmZmIi8+PGNpcmNsZSBjeD0iMzIiIGN5PSIzMSIgcj0iMTUiIGZpbGw9Im5vbmUiIHN0cm9rZT0iI2ZmZmZmZiIgc3Ryb2tlLXdpZHRoPSI2Ii8+PHJlY3QgeD0iMzgiIHk9IjM3IiB3aWR0aD0iMTIiIGhlaWdodD0iNiIgcng9IjMiIHRyYW5zZm9ybT0icm90YXRlKDQ1IDM4IDM3KSIgZmlsbD0iI2ZmZmZmZiIvPjwvc3ZnPg=='

package/src/index.ts

@@ -0,0 +1,64 @@
+/**
+ * dsh-router-qoder —— DSH 插件 host half，一次注册**两个** Qoder 供应商。
+ *
+ * 通过 cordis service `router.suppliers`（聚合表 `{ [supplierId]: (env) => SupplierModule }`）
+ * 把 qoder 族供应商工厂暴露给 dsh-router：
+ *   - `qoder`        Qoder 国内版（gateway.qoder.com.cn）
+ *   - `qoder-global` Qoder 国际版（api1.qoder.sh）
+ * 两者共用 core.ts 的同一份实现，差异只在 cn.ts / global.ts 的 profile。
+ *
+ * cordis 的 `ctx.provide` 每个 service name 只允许一个插件注册，多个供应商插件不能
+ * 各自 provide `router.suppliers`（会抛 "service has been registered"）。本插件用
+ * 共享表模式：`inject` 等待该 service（由核心 dsh-router 持有空表），把工厂追加进
+ * 共享表后广播一次 `internal/service`，让 dsh-router 重新扫描。该模式与插件加载
+ * 顺序无关。
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import { createSupplier } from './core.ts'
+import { profile as cnProfile } from './cn.ts'
+import { profile as globalProfile } from './global.ts'
+import type { SupplierEnv, SupplierModule } from './contract.ts'
+
+export const name = 'dsh-router-qoder'
+
+/** 暴露给 dsh-router 的供应商工厂表。 */
+export interface RouterSuppliersService {
+  [supplierId: string]: (env: SupplierEnv) => SupplierModule
+}
+
+/** 本插件注册的全部供应商（profile → 工厂）。 */
+const SUPPLIERS: ReadonlyArray<readonly [string, (env: SupplierEnv) => SupplierModule]> = [
+  [cnProfile.id, createSupplier(cnProfile)],
+  [globalProfile.id, createSupplier(globalProfile)],
+]
+
+/** 读取当前 router.suppliers 聚合表（同一 live 对象，可追加）。 */
+function currentSuppliers(ctx: Context): RouterSuppliersService | undefined {
+  const c = ctx as unknown as {
+    get?: (key: string) => unknown
+    router?: { suppliers?: RouterSuppliersService }
+  }
+  return (c.get?.('router.suppliers') ?? c.router?.suppliers) as RouterSuppliersService | undefined
+}
+
+export function apply(ctx: Context): void {
+  // 等 router.suppliers 可用后，把两个供应商追加进共享聚合表并通知 dsh-router 重扫。
+  ctx.inject(['router.suppliers'], (sctx) => {
+    const suppliers = currentSuppliers(sctx)
+    if (!suppliers) return undefined
+    const added: string[] = []
+    for (const [id, factory] of SUPPLIERS) {
+      if (suppliers[id]) continue
+      suppliers[id] = factory
+      added.push(id)
+    }
+    if (added.length > 0) {
+      // 复用 dsh-router 的 internal/service 监听（读 live 表、幂等），增量加载。
+      ctx.emit('internal/service', 'router.suppliers', suppliers)
+      ctx.logger?.info?.(`[dsh-router-qoder] registered router.suppliers: ${added.join(', ')}`)
+    }
+    return () => {
+      for (const [id] of SUPPLIERS) delete suppliers[id]
+    }
+  })
+}

package/src/messages.ts

@@ -0,0 +1,337 @@
+/**
+ * OpenAI 请求 → Qoder `agent_chat_generation` 请求体。
+ *
+ * Qoder 网关说「半个 OpenAI」：**出站**（网关 → 我们）的 SSE delta 就是 OpenAI 形状
+ * （`choices[].delta.{role,content,reasoning_content,tool_calls}`），但**入站**的
+ * 请求体是它自己的一套（`chat_context` / `model_config` / `business` / `session_id` …），
+ * 消息也不是 `{role, content}` 而是带 `contents` parts 的结构。
+ *
+ * 模板取自 dingminhua/dsh-connect-qoder（MIT）的 `src/messages.ts`，其来源是
+ * fengyinxia/qoder2api 的 `baseprompt.json`（MINIMAL 变体，实测可用：不带系统
+ * 提示词，messages 完全由调用方替换）。
+ *
+ * @module dsh-router-qoder/messages
+ */
+
+/** 请求体模板（字段名与上游逐字一致，别重命名）。 */
+export interface QoderChatTemplate {
+  request_id: string
+  request_set_id: string
+  chat_record_id: string
+  stream: boolean
+  chat_task: string
+  chat_context: {
+    extra: {
+      modelConfig: { is_reasoning: boolean; key: string }
+      originalContent: { type: string; text: string }
+    }
+    text: { type: string; text: string }
+  }
+  session_id: string
+  source: number
+  version: string
+  aliyun_user_type: string
+  session_type: string
+  agent_id: string
+  task_id: string
+  model_config: { key: string; is_vl: boolean; is_reasoning: boolean; source: string }
+  /**
+   * 思考强度档位（`low` / `high` / `max` …）。
+   *
+   * 实测自官方客户端：档位在这个**顶层**字段上，同时还会写一份到
+   * `parameters.reasoning_effort`。官方两个都写，所以我们也两个都写 ——
+   * 只写一个可能被网关忽略（各区域行为不完全一致）。
+   */
+  reasoningEffort?: string
+  parameters?: Record<string, unknown>
+  messages: unknown[]
+  business: { id: string; name: string; begin_at: number }
+  [key: string]: unknown
+}
+
+/**
+ * 一份全新的请求体。**每个请求都要新建**（ID 字段必须各自唯一，复用会被上游
+ * 当成重复请求）。
+ */
+export function createChatBodyTemplate(): QoderChatTemplate {
+  return {
+    request_id: '',
+    request_set_id: '',
+    chat_record_id: '',
+    stream: true,
+    chat_task: 'FREE_INPUT',
+    chat_context: {
+      extra: {
+        modelConfig: { is_reasoning: false, key: 'lite' },
+        originalContent: { type: 'text', text: '' },
+      },
+      text: { type: 'text', text: '' },
+    },
+    session_id: '',
+    source: 1,
+    version: '3',
+    aliyun_user_type: 'personal_standard',
+    session_type: 'qodercli',
+    agent_id: 'agent_common',
+    task_id: 'common',
+    model_config: { key: 'lite', is_vl: false, is_reasoning: false, source: 'system' },
+    messages: [],
+    business: { id: '', name: 'hi', begin_at: 0 },
+  }
+}
+
+/** 模型 key / 图像能力 / 用户类型三处一起改（漏一处就会被网关当成别的模型）。 */
+export function applyModelKey(body: QoderChatTemplate, key: string, userType: string, isVl: boolean): void {
+  body.model_config.key = key
+  body.model_config.is_vl = isVl
+  body.chat_context.extra.modelConfig.key = key
+  body.aliyun_user_type = userType
+}
+
+/** 一条转换后的入站消息。 */
+interface QoderMessage {
+  role: string
+  content?: string
+  contents?: Array<{ type?: string; text?: string; image_url?: { url?: string } }>
+  tool_calls?: unknown[]
+  name?: string
+  tool_call_id?: string
+  reasoning_content_signature?: string
+  response_meta?: Record<string, unknown>
+}
+
+/**
+ * 每条消息都要带的「假回执」。
+ *
+ * 上游把消息当成**历史回执**读：缺 `response_meta` / `reasoning_content_signature`
+ * 的 assistant 消息会被当成格式异常的记录。这里给一份全零的合法骨架，与官方
+ * 客户端的形状一致。
+ */
+function blankResponseMeta(): Record<string, unknown> {
+  return {
+    id: '',
+    usage: {
+      prompt_tokens: 0,
+      completion_tokens: 0,
+      total_tokens: 0,
+      completion_tokens_details: { reasoning_tokens: 0 },
+      prompt_tokens_details: { cached_tokens: 0 },
+    },
+  }
+}
+
+function structuredMessage(role: string, text: string): QoderMessage {
+  return { role, content: text, response_meta: blankResponseMeta(), reasoning_content_signature: '' }
+}
+
+function userMessage(text: string, images: string[] = []): QoderMessage {
+  const parts: Array<{ type: string; text?: string; image_url?: { url: string } }> = []
+  for (const url of images) parts.push({ type: 'image_url', image_url: { url } })
+  if (text.trim()) parts.push({ type: 'text', text })
+  if (parts.length === 0) parts.push({ type: 'text', text: '' })
+  return {
+    role: 'user',
+    content: '',
+    contents: parts,
+    response_meta: blankResponseMeta(),
+    reasoning_content_signature: '',
+  }
+}
+
+function toolMessage(message: Record<string, unknown>, text: string): QoderMessage {
+  const out = structuredMessage('tool', text)
+  if (typeof message.name === 'string') out.name = message.name
+  if (typeof message.tool_call_id === 'string') out.tool_call_id = message.tool_call_id
+  return out
+}
+
+/** 取一条 OpenAI 消息的纯文本（content 字符串 / parts 数组 / value 字段）。 */
+export function normalizeMessageText(message: Record<string, unknown>): string {
+  const content = message.content
+  if (typeof content === 'string') return content
+  if (Array.isArray(content)) {
+    const parts: string[] = []
+    for (const part of content as unknown[]) {
+      if (typeof part === 'string') {
+        parts.push(part)
+        continue
+      }
+      if (part !== null && typeof part === 'object') {
+        const p = part as Record<string, unknown>
+        if (typeof p.text === 'string') parts.push(p.text)
+        else if (typeof p.value === 'string') parts.push(p.value)
+      }
+    }
+    return parts.join('')
+  }
+  return ''
+}
+
+/** user 消息里的图片 URL（只认 `image_url.url` part）。 */
+export function extractMessageImages(message: Record<string, unknown>): string[] {
+  if (message.role !== 'user') return []
+  const content = message.content
+  if (!Array.isArray(content)) return []
+  const urls: string[] = []
+  for (const part of content as unknown[]) {
+    if (part === null || typeof part !== 'object') continue
+    const iu = (part as Record<string, unknown>).image_url
+    if (iu !== null && typeof iu === 'object') {
+      const url = (iu as Record<string, unknown>).url
+      if (typeof url === 'string') urls.push(url)
+    }
+  }
+  return urls
+}
+
+const TOOL_CALLS_TEXT_RE = /Tool calls:\s*(\[[\s\S]*?\])/
+
+/** 从文本里认回 `Tool calls: [...]`（有的宿主把 tool_calls 渲染成了文本）。 */
+export function parseToolCallsText(text: string | null | undefined): unknown[] | undefined {
+  if (!text) return undefined
+  const m = TOOL_CALLS_TEXT_RE.exec(text)
+  if (!m?.[1]) return undefined
+  try {
+    const parsed = JSON.parse(m[1]) as unknown
+    if (Array.isArray(parsed) && parsed.every((item) => item !== null && typeof item === 'object')) {
+      return normalizeToolCalls(parsed)
+    }
+  } catch {
+    return undefined
+  }
+  return undefined
+}
+
+/** `{id, name, input}` 形状 → OpenAI 的 `{id, type, function:{name, arguments}}`。 */
+function normalizeToolCalls(raw: unknown[]): unknown[] {
+  return raw.map((tc) => {
+    if (tc !== null && typeof tc === 'object' && !('function' in tc)) {
+      const r = tc as Record<string, unknown>
+      if (r.id && r.name && r.input) {
+        return { id: r.id, type: 'function', function: { name: r.name, arguments: JSON.stringify(r.input) } }
+      }
+    }
+    return tc
+  })
+}
+
+/**
+ * 这条 assistant 消息后面有没有**真的** tool 结果。
+ *
+ * 只有「有回执」的 tool_calls 才能结构化下发：网关要求 assistant 的 tool_calls
+ * 与 tool 消息配对出现，一条没有回执的 tool_calls 会被判成断链（与 OpenAI 的
+ * 422 同类）。没有回执时改渲染成文本，模型仍然读得到。
+ */
+function hasResolvedToolResponse(messages: Array<Record<string, unknown>>, assistantIndex: number): boolean {
+  const message = messages[assistantIndex]
+  if (message === undefined || message.role !== 'assistant') return false
+  const tc = message.tool_calls
+  if (!(Array.isArray(tc) && tc.length > 0) && !parseToolCallsText(normalizeMessageText(message))) return false
+  for (let i = assistantIndex + 1; i < messages.length; i += 1) {
+    const next = messages[i]
+    if (next?.role === 'tool') return true
+    if (next !== undefined && (next.role === 'assistant' || next.role === 'user' || next.role === 'system')) return false
+  }
+  return false
+}
+
+function renderToolCalls(toolCalls: unknown[]): string {
+  return `Tool calls:\n${JSON.stringify(toolCalls)}`
+}
+
+function renderToolResult(message: Record<string, unknown>, text: string): string {
+  const name = typeof message.name === 'string' ? message.name : ''
+  const toolCallId = typeof message.tool_call_id === 'string' ? message.tool_call_id : ''
+  let out = 'Tool result'
+  if (name) out += ` (${name})`
+  if (toolCallId) out += ` [${toolCallId}]`
+  if (text.trim()) out += `:\n${text}`
+  return out
+}
+
+/**
+ * 一条 OpenAI 消息 → Qoder 消息。`null` = 这条不携带任何内容（跳过）。
+ *
+ * `toolsEnabled` 表示这个请求带了 tools；`allowStructuredToolCalls` 表示这条
+ * assistant 的 tool_calls 有配对回执、可以结构化下发（见
+ * {@link hasResolvedToolResponse}）。
+ */
+export function convertIncomingMessage(
+  message: Record<string, unknown>,
+  toolsEnabled: boolean,
+  allowStructuredToolCalls: boolean,
+): QoderMessage | null {
+  const role = typeof message.role === 'string' ? message.role : 'user'
+  const text = normalizeMessageText(message)
+
+  let structuredToolCalls: unknown[] | undefined
+  if (toolsEnabled && allowStructuredToolCalls) {
+    const tc = Array.isArray(message.tool_calls) && message.tool_calls.length > 0
+      ? message.tool_calls
+      : parseToolCallsText(text)
+    if (tc) structuredToolCalls = tc
+  }
+
+  if (role === 'assistant' && structuredToolCalls) {
+    const out = structuredMessage('assistant', text)
+    out.tool_calls = structuredToolCalls
+    return out
+  }
+
+  if (role === 'tool') {
+    if (toolsEnabled) return toolMessage(message, text)
+    // 没有 tools 通道时，把结果渲染成 user 话术：不渲染就是**丢**了工具结果
+    return structuredMessage('user', renderToolResult(message, text))
+  }
+
+  let finalText = text
+  if (role === 'assistant' && !toolsEnabled && Array.isArray(message.tool_calls) && message.tool_calls.length > 0) {
+    finalText = [text, renderToolCalls(message.tool_calls)].filter(Boolean).join('\n\n')
+  }
+
+  const images = role === 'user' ? extractMessageImages(message) : []
+  if (!finalText.trim() && images.length === 0) return null
+
+  if (role === 'user') {
+    // 图片走真实 parts 时，去掉文本里的 `[image] <url>` 兜底占位（否则同一张图两遍）
+    const cleaned = images.length > 0
+      ? finalText.split('\n\n').filter((s) => !s.trim().startsWith('[image] ')).join('\n\n')
+      : finalText
+    return userMessage(cleaned, images)
+  }
+
+  return structuredMessage(role, finalText)
+}
+
+/** OpenAI messages → Qoder messages。 */
+export function buildQoderMessages(
+  incoming: Array<Record<string, unknown>>,
+  prompt: string,
+  toolsEnabled: boolean,
+): QoderMessage[] {
+  const rebuilt: QoderMessage[] = []
+  for (let i = 0; i < incoming.length; i += 1) {
+    const allowStructured = toolsEnabled && hasResolvedToolResponse(incoming, i)
+    const converted = convertIncomingMessage(incoming[i]!, toolsEnabled, allowStructured)
+    if (converted !== null) rebuilt.push(converted)
+  }
+  if (rebuilt.length === 0 && prompt.trim()) rebuilt.push(userMessage(prompt))
+  return rebuilt
+}
+
+/** 最后一条 user 消息的纯文本（`business.name` 用它，官方客户端也这么填）。 */
+export function extractLatestUserPrompt(messages: Array<Record<string, unknown>>): string {
+  for (let i = messages.length - 1; i >= 0; i -= 1) {
+    const m = messages[i]
+    if (m?.role === 'user') {
+      const text = normalizeMessageText(m)
+      if (text.trim()) return text
+    }
+  }
+  return ''
+}
+
+/** 深拷贝（模板必须逐请求独立，否则并发请求会互相改对方的 ID）。 */
+export function deepClone<T>(value: T): T {
+  return structuredClone(value)
+}

package/src/sse.ts

@@ -0,0 +1,176 @@
+/**
+ * Qoder SSE → OpenAI SSE。
+ *
+ * 上游的帧是**一个信封套一层 OpenAI 形状**：
+ *
+ * ```text
+ * data: {"headers":{…},"body":"{\"choices\":[{\"delta\":{\"content\":\"你\"}}]}","statusCodeValue":200}
+ * ```
+ *
+ * 而 dsh-router 只接受 OpenAI SSE（它会把这个流 pipe 给客户端，也会在客户端要
+ * 非流式时自己聚合）。所以这一层把信封拆开、把 delta 重新包成 OpenAI chunk，
+ * 并在收尾补上 usage 与 `[DONE]`。
+ *
+ * 为什么要自己拼满这些字段：宿主聚合非流式响应时读的是
+ * `choices[0].delta.tool_calls[].function.name` 与 `usage`，缺 `id`/`model`/
+ * `created` 会让它拼出一个没有名字的工具调用（下游报 `unknown tool ""`）。
+ */
+import { isQoderError, parseStreamDelta, type QoderDelta, type QoderError } from './upstream.ts'
+
+export interface SseOptions {
+  /** 响应里的 `model` 字段（客户端会拿它做展示，用请求的模型 id）。 */
+  model: string
+  /**
+   * 流已经写出若干字节之后上游才报错（Qoder 会把 provider 故障包在 200 的
+   * 信封里）时回调。HTTP 状态已经发不出去了，但「这个号今天额度用尽」对**后续**
+   * 请求仍然有用 —— 核心的 `onLateFailure` 正是为这种时刻准备的。
+   */
+  onLateError?: (error: QoderError) => void
+}
+
+/** 把一条 delta 转成 OpenAI chunk。 */
+function chunkOf(
+  id: string,
+  created: number,
+  model: string,
+  delta: Record<string, unknown>,
+  finishReason: string | null = null,
+): string {
+  return `data: ${JSON.stringify({
+    id,
+    object: 'chat.completion.chunk',
+    created,
+    model,
+    choices: [{ index: 0, delta, finish_reason: finishReason }],
+  })}\n\n`
+}
+
+/** delta → OpenAI `delta` 对象（只带上游真的给了的字段）。 */
+function deltaPayload(delta: QoderDelta, first: boolean): Record<string, unknown> | undefined {
+  const out: Record<string, unknown> = {}
+  if (first && delta.role !== '') out.role = delta.role
+  if (delta.content !== '') out.content = delta.content
+  if (delta.reasoningContent !== '') out.reasoning_content = delta.reasoningContent
+  if (delta.toolCalls !== undefined) out.tool_calls = delta.toolCalls
+  return Object.keys(out).length === 0 ? undefined : out
+}
+
+/** usage 帧：OpenAI 的最后一帧 `choices: []` + `usage`。 */
+function usageFrame(
+  id: string,
+  created: number,
+  model: string,
+  delta: QoderDelta,
+): string {
+  const usage: Record<string, unknown> = {
+    prompt_tokens: delta.inputTokens,
+    completion_tokens: delta.outputTokens,
+    total_tokens: delta.inputTokens + delta.outputTokens,
+  }
+  // cached_tokens 是 prompt_tokens 的子集，不是额外增量；上游没报就不写，
+  // 别用 0 顶替「不知道」（那会让宿主的缓存命中率变成不可信的 0%）。
+  if (delta.cachedTokens !== undefined) usage.prompt_tokens_details = { cached_tokens: delta.cachedTokens }
+  return `data: ${JSON.stringify({
+    id,
+    object: 'chat.completion.chunk',
+    created,
+    model,
+    choices: [],
+    usage,
+  })}\n\n`
+}
+
+/**
+ * 包装上游响应体。返回的流**始终**以 `data: [DONE]\n\n` 收尾（正常与被拒都一样），
+ * 这样客户端不会挂在那儿等一个永远不来的结束帧。
+ */
+export function toOpenAiSse(body: ReadableStream<Uint8Array>, options: SseOptions): ReadableStream<Uint8Array> {
+  const encoder = new TextEncoder()
+  const decoder = new TextDecoder()
+  const id = `chatcmpl-${globalThis.crypto.randomUUID()}`
+  const created = Math.floor(Date.now() / 1000)
+  let reader: ReadableStreamDefaultReader<Uint8Array> | undefined
+
+  return new ReadableStream<Uint8Array>({
+    start: async (ctrl) => {
+      const emit = (text: string): void => {
+        try {
+          ctrl.enqueue(encoder.encode(text))
+        } catch {
+          // 客户端已断开
+        }
+      }
+      // 第一帧先声明 role：有的客户端要求 assistant 角色先到，否则不认后续 delta
+      emit(chunkOf(id, created, options.model, { role: 'assistant' }))
+      reader = body.getReader()
+      let buffer = ''
+      let sawUsage = false
+      let finished = false
+      try {
+        for (;;) {
+          const { done, value } = await reader.read()
+          if (done) break
+          buffer += decoder.decode(value, { stream: true })
+          const lines = buffer.split('\n')
+          buffer = lines.pop() ?? ''
+          for (const line of lines) {
+            const trimmed = line.trim()
+            if (trimmed === '' || !trimmed.startsWith('data:')) continue
+            const payload = trimmed.slice('data:'.length).trim()
+            if (payload === '' || payload === '[DONE]') continue
+            let delta: QoderDelta | undefined
+            try {
+              delta = parseStreamDelta(payload)
+            } catch (error: unknown) {
+              // 信封里的业务错误：把 OpenAI 形状的 error 帧发出去再收尾
+              const qoderError = isQoderError(error) ? error : undefined
+              emit(`data: ${JSON.stringify({
+                error: {
+                  message: error instanceof Error ? error.message : String(error),
+                  type: qoderError?.kind ?? 'upstream_error',
+                  code: qoderError?.code ?? null,
+                },
+              })}\n\n`)
+              if (qoderError !== undefined) options.onLateError?.(qoderError)
+              finished = true
+              break
+            }
+            if (delta === undefined) continue
+            if (delta.inputTokens > 0 || delta.outputTokens > 0) sawUsage = true
+            const payloadDelta = deltaPayload(delta, true)
+            if (payloadDelta !== undefined) emit(chunkOf(id, created, options.model, payloadDelta))
+            if (delta.inputTokens > 0 || delta.outputTokens > 0) {
+              emit(usageFrame(id, created, options.model, delta))
+            }
+          }
+          if (finished) break
+        }
+        if (!finished) {
+          // 正常收尾：补一帧 finish_reason（上游不保证给），再补 [DONE]
+          emit(chunkOf(id, created, options.model, {}, 'stop'))
+          if (!sawUsage) void sawUsage
+        }
+      } catch (error: unknown) {
+        const qoderError = isQoderError(error) ? error : undefined
+        emit(`data: ${JSON.stringify({
+          error: { message: error instanceof Error ? error.message : String(error), type: qoderError?.kind ?? 'stream_error' },
+        })}\n\n`)
+        if (qoderError !== undefined) options.onLateError?.(qoderError)
+      } finally {
+        try {
+          reader.releaseLock()
+        } catch {
+          // 有挂起 read 时会抛，忽略
+        }
+        emit('data: [DONE]\n\n')
+        try {
+          ctrl.close()
+        } catch {
+          // 已取消
+        }
+      }
+    },
+    /** 取消必须往下传：不实现它，客户端断开后上游 TCP 连接会一直挂着。 */
+    cancel: (reason) => reader?.cancel(reason),
+  })
+}

package/src/types.ts

@@ -0,0 +1,42 @@
+/**
+ * 供应商通用类型 —— 自含（不依赖 dsh-router 包）。
+ * 与 dsh-router 的 router/types.ts 保持同步。
+ */
+import type { ServerResponse } from 'node:http'
+
+/** 面板展示的账号状态（脱敏）。 */
+export interface SupplierAccount {
+  uid: string
+  nickname?: string
+  credits: number
+  cooling: boolean
+  until?: string
+  reason?: string
+  err_count?: number
+}
+
+/** 供应商面板状态。 */
+export interface SupplierStatus {
+  id: string
+  name: string
+  accounts: SupplierAccount[]
+}
+
+/** OpenAI 模型条目。 */
+export interface ModelInfo {
+  /** 上游模型 key（`qmodel_38max`）——组合、路由、请求都用它。 */
+  id: string
+  /**
+   * 可读名（上游目录的 `display_name`，如 `Qwen3.8-Max`），**只用于显示**。
+   * 核心把它画在主标签上；请求仍然只认 `id`。
+   */
+  name?: string
+  context_length?: number
+}
+
+/** 一次 /v1/chat/completions 请求。 */
+export interface ChatRequest {
+  rawBody: string
+  stream: boolean
+  model: string
+}