dsh-tap 0.20.0

package/providers/openai-compat.js

@@ -0,0 +1,177 @@
+/**
+ * providers/openai-compat.js — key 型 OpenAI 兼容上游的共享骨架。
+ *
+ * 一个"适配器实例"= preset（id/displayName/baseURL/keyRef）+ 本模块的
+ * 通用行为：GET {baseURL}/models 拉模型清单、组装 llm-pi-ai provider 块。
+ * 上游特化（baseURL 方言、模型尺寸表等）放进 providers/<name>/index.js，
+ * 本模块与 core/ 一样不得出现具体上游名（静态扫描在 verify-core-generic）。
+ */
+
+/** 官方 CustomProviderCard 同款路由 id 规则（dsh-client-ui-settings-models）。 */
+export const PROVIDER_ID_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/
+
+/** 凭据命名惯例：<ROUTE>_API_KEY（大写、非字母数字折 _）。 */
+export function keyRefFor(id) {
+  return id.toUpperCase().replace(/[^A-Z0-9]/g, '_') + '_API_KEY'
+}
+
+/**
+ * GET {baseURL}/models（OpenAI 标准目录端点），Bearer key 直调。
+ * 返回 [{id}]；非 2xx 带上游摘要抛错（添加前先用它验 key）。
+ * HTTP 404 单独标记 err.code = 'MODELS_ENDPOINT_404'——部分真实上游
+ * （iFlow、portal.qwen.ai 等）根本没有 /models 路由，调用方可回落
+ * probeChatKey 验证（preset 声明 fallbackModels 时）。
+ */
+export async function fetchOpenAIModels(baseURL, apiKey, { timeoutMs = 15000 } = {}) {
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs)
+  try {
+    const res = await fetch(baseURL.replace(/\/+$/, '') + '/models', {
+      headers: { authorization: `Bearer ${apiKey}`, accept: 'application/json' },
+      signal: ctrl.signal,
+    })
+    const text = await res.text()
+    if (!res.ok) {
+      const err = new Error(`GET /models ${res.status}: ${text.slice(0, 200)}`)
+      if (res.status === 404) err.code = 'MODELS_ENDPOINT_404'
+      throw err
+    }
+    let data
+    try {
+      data = JSON.parse(text)
+    } catch {
+      throw new Error(`GET /models 返回非 JSON: ${text.slice(0, 120)}`)
+    }
+    const rows = Array.isArray(data?.data) ? data.data : []
+    const models = rows
+      .filter((m) => typeof m?.id === 'string' && m.id)
+      .map((m) => ({ id: m.id }))
+    if (!models.length) throw new Error('GET /models 返回空清单（key 可能无权限）')
+    return models
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+/**
+ * 组装 llm-pi-ai provider 块（写 settings.yaml 的形状）。
+ * apiKeyEnv 指向 ~/.dsh/.credentials.yaml 里的 keyRef；sizes 不给就吃
+ * dsh 默认值（defaultContextWindow 262144 / defaultMaxTokens 32768）。
+ *
+ * **思考档位（0.19.0）**：preset 可用 `modelEfforts`（`{ '<模型 id>': { <档位>: <线值> } }`）
+ * 声明逐模型档位表——写入时按模型 id 合并进条目的 `reasoningEfforts`，宿主
+ * 「推理等级」据此出档；`provider-refresh`（GET /models 重建清单）走同一函数，
+ * **声明不丢**。两条纪律：
+ *   a) **必须逐条有实测/厂商文档依据**（踩坑 #42：能力声明 ≠ 线值，不批量臆造；
+ *      上游没验证过的 provider 就保持不声明 = 不出档，而不是摆假档位）；
+ *   b) 档位拼写逐上游不同（OpenAI 官方 `low/medium/high`、OpenRouter 走
+ *      `reasoning:{effort}` 另一方言…）——本函数只透传声明，不做拼写映射；
+ *      OpenRouter 这类需要换 `thinkingFormat` 的上游要单独给 preset 加 compat。
+ * `reasoningCompat: true` 时块带 `compat.supportsReasoningEffort`：**缺它 pi-ai
+ * 出站不会把选中档位写成 `reasoning_effort`**（选择器出档但请求里没这个键）。
+ */
+export function providerBlock(preset, models) {
+  const efforts = preset.modelEfforts && typeof preset.modelEfforts === 'object' ? preset.modelEfforts : {}
+  const entries = models.map((m) => {
+    const declared = efforts[m.id]
+    return {
+      ...(m.name ? { id: m.id, name: m.name } : { id: m.id }),
+      ...(declared && typeof declared === 'object' && Object.keys(declared).length ? { reasoningEfforts: declared } : {}),
+    }
+  })
+  return {
+    displayName: preset.displayName,
+    api: 'openai-completions',
+    baseURL: preset.baseURL,
+    apiKeyEnv: keyRefFor(preset.id),
+    ...(preset.reasoningCompat === true
+      ? { compat: { thinkingFormat: 'openai', supportsReasoningEffort: true } }
+      : {}),
+    models: entries,
+  }
+}
+
+/**
+ * 认证失败的身体特征（各上游方言汇总，2026-08-19 实测）：
+ * - 标准：HTTP 401/403，或 body error.code = invalid_api_key 类
+ * - iFlow 方言：HTTP 200 + {"status":"434","msg":"Invalid apiKey…"}
+ */
+const AUTH_FAIL_RE = /invalid[_ ]?(api[_ ]?key|access token)|unauthorized|"status"\s*:\s*"?434/i
+
+/**
+ * 无 /models 端点上游的 key 验证：POST /chat/completions 最小探针
+ * （max_tokens 1，耗量可忽略；仅导入时用户确认后运行一次）。
+ * 认证失败抛错；其余一切响应（含模型错误等 4xx）视为 key 有效——
+ * 服务器拒绝的是请求内容而不是凭据。网络错误原样抛出（无法判定）。
+ */
+export async function probeChatKey(baseURL, apiKey, model, { timeoutMs = 20000 } = {}) {
+  const ctrl = new AbortController()
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs)
+  try {
+    const res = await fetch(baseURL.replace(/\/+$/, '') + '/chat/completions', {
+      method: 'POST',
+      headers: { authorization: `Bearer ${apiKey}`, 'content-type': 'application/json' },
+      body: JSON.stringify({ model, messages: [{ role: 'user', content: 'ping' }], max_tokens: 1, stream: false }),
+      signal: ctrl.signal,
+    })
+    const text = await res.text()
+    if (res.status === 401 || res.status === 403 || AUTH_FAIL_RE.test(text.slice(0, 400))) {
+      throw new Error(`key 验证失败（上游认证拒绝 ${res.status}）: ${text.slice(0, 160)}`)
+    }
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+/** 注册表入口：preset + 凭据引用 + 通用行为。 */
+export function createOpenAICompatProvider(preset) {
+  const fallback = Array.isArray(preset.fallbackModels) ? preset.fallbackModels.filter((m) => typeof m === 'string' && m) : []
+  const staticCatalog = !!preset.staticCatalog
+  return {
+    id: preset.id,
+    displayName: preset.displayName,
+    baseURL: preset.baseURL,
+    keyRef: keyRefFor(preset.id),
+    fallbackModels: fallback,
+    staticCatalog,
+    async fetchModels(apiKey) {
+      // 静态目录模式（公开目录型上游：/models 任意 key 都 200，
+      // 验不了 key，且全量 400+ 条进选择器不可用）：chat 探针验 key，
+      // 清单恒吃 fallbackModels 内置表（裁判 docs/rules/extra-providers.md E-P7）。
+      if (staticCatalog && fallback.length) {
+        await probeChatKey(preset.baseURL, apiKey, fallback[0])
+        return fallback.map((id) => ({ id }))
+      }
+      try {
+        return await fetchOpenAIModels(preset.baseURL, apiKey)
+      } catch (err) {
+        // 上游没有 /models 且 preset 给了兜底清单：chat 探针验 key，清单吃兜底。
+        if (err?.code === 'MODELS_ENDPOINT_404' && fallback.length) {
+          await probeChatKey(preset.baseURL, apiKey, fallback[0])
+          return fallback.map((id) => ({ id }))
+        }
+        throw err
+      }
+    },
+    modelBlock: (models) => providerBlock({ ...preset }, models),
+  }
+}
+
+/**
+ * 登记册条目重建 adapter（index.js 的 test/refresh 两路共用接缝）：registry
+ * entry 打底（displayName/baseURL 用添加时快照），preset 命中时合并先验
+ * 清单（fallbackModels/staticCatalog）与思考档位声明（modelEfforts/
+ * reasoningCompat）。refresh 拿重建的 adapter 重铺 provider 块——档位声明
+ * 必须随行，漏带 = 每次刷新把宿主「推理等级」的档位表洗掉（0.19.0 修：
+ * 此前 refresh 裸调 createOpenAICompatProvider 漏传两个声明字段；
+ * 回归 verify-providers 第 10 节）。
+ */
+export function rebuildAdapterForEntry(entry, preset) {
+  return createOpenAICompatProvider({
+    ...entry,
+    fallbackModels: preset?.fallbackModels,
+    staticCatalog: preset?.staticCatalog,
+    modelEfforts: preset?.modelEfforts,
+    reasoningCompat: preset?.reasoningCompat,
+  })
+}

package/providers/openrouter/index.js

@@ -0,0 +1,27 @@
+import { createOpenAICompatProvider } from '../openai-compat.js'
+
+/**
+ * OpenRouter preset。2026-09-11 实测：GET /models 是公开目录——任意 key
+ * （甚至无 key）都 200 返回全量 437 条，验不了 key 也不宜全量进选择器
+ * → staticCatalog：chat 探针验 key（标准 401 方言），清单吃内置精选表。
+ * 清单 = 当日目录实况里各厂商旗舰；探针用首项。刷新模型重跑同一逻辑，
+ * 目录漂移靠版本更新内置表（错误项聊天时显性暴露，裁判 E-P7）。
+ */
+export default createOpenAICompatProvider({
+  id: 'openrouter',
+  displayName: 'OpenRouter',
+  baseURL: 'https://openrouter.ai/api/v1',
+  staticCatalog: true,
+  fallbackModels: [
+    'openai/gpt-5.2',
+    'anthropic/claude-opus-4.8',
+    'anthropic/claude-sonnet-4.6',
+    'google/gemini-3.1-pro-preview',
+    'deepseek/deepseek-v3.2',
+    'moonshotai/kimi-k2.6',
+    'z-ai/glm-5.3',
+    'qwen/qwen3-max',
+    'minimax/minimax-m2.7',
+    'x-ai/grok-4.6',
+  ],
+})

package/providers/qoder/catalog.js

@@ -0,0 +1,145 @@
+/**
+ * providers/qoder/catalog.js — Qoder CN 模型目录（/algo/api/v2/model/list）。
+ *
+ * 2026-09-20 实测：签名 GET 返回明文 JSON（即便带 Encode=1——服务端对该
+ * 端点不加密；密文时走 cosy.decrypt 兜底）。条目取 `.chat` 数组：
+ *   { key, display_name, format, source, enable, is_vl, is_reasoning,
+ *     max_input_tokens, context_config: { "<档>": { token_count, is_default } },
+ *     thinking_config: { disabled: {...}, enabled: { efforts: { "<档>": {...} } } } }
+ * 只收 format==='openai' 且 enable!==false 的条目（实测 14 个全满足）。
+ * contextWindow 取 context_config 默认档（无则 max_input_tokens）；
+ * 目录不发布输出上限——maxTokens 取 32768 保守默认（可在 settings 镜像后手调）。
+ * 思考强度取 thinking_config 的逐模型能力声明（见 qoderReasoningEfforts）——
+ * 投影进 profile.reasoningEfforts，宿主 Model/Effort 选择器据此出档（同
+ * CodeBuddy 侧 catalogReasoningEfforts 的分层：目录声明 → 镜像 → 宿主选择器）。
+ */
+
+/**
+ * thinking_config → dsh `reasoningEfforts` 档位表（键 = 档位名，值 = 出站线值）。
+ *
+ * 2026-10-04 实测（14 模型全量目录，证据 docs/probes/qoder-thinking-config-*.json）：
+ *   { disabled: {...}, enabled: { efforts: { "<档>": { is_default? } }, is_default? } }
+ * - `disabled` 在场 = 该模型**声明**支持关思考 → `off: null`。null = 省略参数
+ *   （与网关 prefs 的 off 语义、codebuddy 侧 off 档同一条线），不是发 "off"
+ *   拼写——档位拼写的接受面逐模型不一致，不臆造（踩坑 #42）。
+ * - `enabled.efforts` 的键 = 可选档位，线值照抄档位名（与设置卡 prefs 的既有
+ *   拼写同源；网关只做"未带时补默认"，不翻译）。
+ * - 无 thinking_config、或 enabled 里没有命名档位（如 qmodel/qmodel_latest 只有
+ *   一个开关）→ 返回 null：llm-pi-ai 拒绝"只有 off"的档位表，且没有强度可选时
+ *   不该在宿主选择器里摆一个空档位。
+ * @param {object} entry 目录原始条目
+ * @returns {Record<string, string|null>|null} 档位表或 null
+ */
+export function qoderReasoningEfforts(entry) {
+  const tc = entry?.thinking_config
+  if (!tc || typeof tc !== 'object') return null
+  const enabled = tc.enabled && typeof tc.enabled === 'object' ? tc.enabled : null
+  const efforts = enabled?.efforts && typeof enabled.efforts === 'object' ? enabled.efforts : null
+  const levels = efforts
+    ? Object.keys(efforts).filter((k) => typeof k === 'string' && k)
+    : []
+  if (!levels.length) return null
+  const table = {}
+  if (tc.disabled && typeof tc.disabled === 'object') table.off = null
+  for (const level of levels) table[level] = level
+  return table
+}
+
+/**
+ * 该模型**展示用**档位清单——设置卡 select 与宿主「推理等级」的共同真源。
+ * = 线值表的键（顺序随目录声明）；含 `off` 仅当目录声明了 `disabled`。
+ * 目录没声明命名档位（如 auto/qmodel）→ `[]`：卡里不出该 select，也不接受
+ * effort 写入（宁可不给控件，也不摆假档位，踩坑 #42 同纪律）。
+ * @param {object} entry 目录原始条目
+ * @returns {string[]} 档位名数组（可能为空）
+ */
+export function qoderEffortTiers(entry) {
+  const table = qoderReasoningEfforts(entry)
+  return table ? Object.keys(table) : []
+}
+
+/** 目录条目 → dsh profile。 */
+export function projectQoderModel(entry) {
+  if (!entry || typeof entry.key !== 'string' || !entry.key) return null
+  const ctxVariants = entry.context_config && typeof entry.context_config === 'object'
+    ? Object.values(entry.context_config)
+    : []
+  const defaultVariant = ctxVariants.find((v) => v?.is_default) ?? ctxVariants[0] ?? null
+  const contextWindow = Number.isFinite(defaultVariant?.token_count)
+    ? defaultVariant.token_count
+    : (Number.isFinite(entry.max_input_tokens) ? entry.max_input_tokens : 128000)
+  const reasoningEfforts = qoderReasoningEfforts(entry)
+  return {
+    id: entry.key,
+    name: typeof entry.display_name === 'string' && entry.display_name ? entry.display_name : entry.key,
+    contextWindow,
+    maxTokens: 32768,
+    input: entry.is_vl === true ? ['text', 'image'] : ['text'],
+    ...(reasoningEfforts ? { reasoningEfforts } : {}),
+  }
+}
+
+/**
+ * 目录条目 → 上下文变体清单 [{name, tokenCount, isDefault}]（context_config
+ * 变体表，实测 Qwen3.8-Max：200K 默认/400K/1M）。无变体/全非法 → []——
+ * 设置卡据此隐藏该模型的上下文选择。
+ */
+export function projectQoderVariants(entry) {
+  const ctx = entry?.context_config
+  if (!ctx || typeof ctx !== 'object') return []
+  return Object.entries(ctx)
+    .filter(([, v]) => v && Number.isFinite(v.token_count))
+    .map(([name, v]) => ({ name, tokenCount: v.token_count, isDefault: v.is_default === true }))
+}
+
+/**
+ * 选中变体 → profile.contextWindow 覆盖（未选/变体名已不在目录 → 原样）。
+ * 纯函数单点：镜像（syncQoderModelsToDshSettings）与回归断言共用。
+ */
+export function applyQoderContextVariant(profile, variantName, variants) {
+  if (!variantName || !Array.isArray(variants)) return profile
+  const hit = variants.find((v) => v && v.name === variantName && Number.isFinite(v.tokenCount))
+  if (!hit) return profile
+  return { ...profile, contextWindow: hit.tokenCount }
+}
+
+/**
+ * 拉取目录 → { profiles, sources, variants, raw }。明文/密文两态自适应。
+ * @param {object} cosy  createCosyRuntime 实例
+ * @param {object} cred  { accessToken, machineId, uid }
+ * @param {string} inferBaseURL  例 https://gateway.qoder.com.cn
+ */
+export async function fetchQoderCatalog(cosy, cred, inferBaseURL) {
+  const base = String(inferBaseURL ?? '').replace(/\/+$/, '')
+  const req = await cosy.prepareGet(cred, { endpoint: base, path: '/api/v2/model/list?Encode=1' })
+  const res = await fetch(req.url, { headers: req.headers })
+  const text = await res.text()
+  if (!res.ok) {
+    throw new Error(`qoder 目录 HTTP ${res.status}：${text.slice(0, 120)}`)
+  }
+  let body
+  try {
+    body = JSON.parse(text)
+  } catch {
+    body = JSON.parse(cosy.decrypt(text))
+  }
+  const chat = Array.isArray(body?.chat) ? body.chat : []
+  const entries = chat.filter((e) => e && e.format === 'openai' && e.enable !== false)
+  const profiles = entries.map(projectQoderModel).filter(Boolean)
+  if (!profiles.length) throw new Error('qoder 目录为空（chat 数组无可用 openai 条目）')
+  // X-Model-Source 头取数（全部实测条目为 "system"，但保留逐条目映射以防分化）
+  const sources = {}
+  for (const e of entries) sources[e.key] = typeof e.source === 'string' && e.source ? e.source : 'system'
+  // 上下文变体清单逐模型保留（不进 profiles——镜像块形状不变，见 index.js 镜像纪律）
+  const variants = {}
+  for (const e of entries) variants[e.key] = projectQoderVariants(e)
+  // 展示用档位清单逐模型保留（同 variants：不进 profiles——镜像里的档位表由
+  // projectQoderModel 的 reasoningEfforts 决定；这里只服务设置卡 select）。
+  const efforts = {}
+  for (const e of entries) efforts[e.key] = qoderEffortTiers(e)
+  // 原始条目按键索引（网关出站信封的 model_config 需要 is_vl/is_reasoning/
+  // max_input_tokens 等未投影字段，2026-09-22 用量归因信封对齐官方客户端）
+  const byKey = {}
+  for (const e of entries) byKey[e.key] = e
+  return { profiles, sources, variants, efforts, entries: byKey, raw: body }
+}