dsh-router-qoder 0.0.0-stage → 0.1.1

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "dsh-router-qoder",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "DSH plugin: Qoder supplier family for dsh-router. Provides two same-protocol suppliers through the router.suppliers cordis service: qoder (Qoder CN, gateway.qoder.com.cn) and qoder-global (api1.qoder.sh). Both share one implementation (cosy signer, jobToken exchange, SSE conversion); only the gateway profile differs.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CARVIN94/dsh-router-qoder.git"
+  },
+  "homepage": "https://github.com/CARVIN94/dsh-router-qoder#readme",
+  "bugs": {
+    "url": "https://github.com/CARVIN94/dsh-router-qoder/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "src",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "dsh-router",
+    "qoder",
+    "cosy"
+  ],
+  "scripts": {
+    "build": "rm -rf lib && tsdown",
+    "test": "node --test \"src/**/*.test.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "cordis": "^4.0.0-rc.7"
+  },
+  "peerDependenciesMeta": {
+    "cordis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "tsdown": "^0.23.1",
+    "typescript": "^7.0.2"
+  }
+}

package/src/cn.ts

@@ -0,0 +1,41 @@
+/**
+ * qoder（Qoder 国内版）供应商 profile —— 上游 https://gateway.qoder.com.cn。
+ *
+ * 全部共享逻辑在 core.ts；这里只声明这个部署的差异（区域、图标、名字、uid 前缀）。
+ * 区域决定的主机与端点表在 upstream.ts 的 `QODER_REGIONS` 里 —— 那是**唯一**一处
+ * 事实，profile 只说「我是哪个区域」，不重复写域名。
+ *
+ * ⚠️ `id = 'qoder'` **同时是凭证与配置的存储键**（`credentials.sqlite` 的
+ * `supplier` 列、`supplier-config.json` 的键，含积分缓存）。改它 = 已添加的
+ * 账号全部消失。
+ */
+import type { ModelInfo } from './types.ts'
+import type { QoderProfile } from './core.ts'
+import { QODER_ICON } from './icon.ts'
+
+/**
+ * 兜底模型列表：**故意留空**。
+ *
+ * Qoder 的模型 key 是上游下发的（形如 `qmodel_38max` 这类服务端标识），不是可以
+ * 照着模型名猜出来的。猜一个塞进去，用户点了只会拿到 404，而「没有 PAT 时列表
+ * 为空」本来就是正确状态 —— 加 PAT 后点一次「获取模型」就有了。宁可空着，也不
+ * 让面板列出一堆点不动的假模型。
+ */
+const FALLBACK_MODELS: ModelInfo[] = []
+
+export const profile: QoderProfile = {
+  id: 'qoder',
+  name: 'Qoder',
+  region: 'cn',
+  icon: QODER_ICON,
+  priority: -2, // 账户自带额度，排在免费通道之前
+  uidPrefix: 'qd',
+  defaultNickname: 'Qoder',
+  errPrefix: 'qoder',
+  // 弹窗里唯一能看到「去哪儿拿」的地方：只写令牌形状不写入口，用户只能自己去搜。
+  apiKeyHint: '粘贴 Qoder 个人访问令牌（PAT，形如 pt-…）。在哪拿：登录 qoder.cn / qoder.com.cn 控制台 → '
+    + '设置 → 个人访问令牌（旧版页面叫「API 令牌」）→ 创建令牌，复制只显示一次的 pt-…。'
+    + '令牌按区域签发，国内版的 pt-… 在国际版卡片上无效（反之亦然）。'
+    + '插件只在本机用它换 jobToken，之后的请求都带签名会话；PAT 不会发给 Qoder 网关以外的任何地方。',
+  fallbackModels: FALLBACK_MODELS,
+}

package/src/contract.ts

@@ -0,0 +1,169 @@
+/**
+ * 供应商契约 —— dsh-router-codebuddy 自含（不依赖 dsh-router 包）。
+ * 与 dsh-router 的 suppliers/contract.ts 契约保持同步：
+ * 通用能力（连接池/模型管理/别名/凭证）由 dsh-router 核心统一管，
+ * 本插件只提供**差异化能力**。
+ */
+import type { ChatRequest, ModelInfo, SupplierAccount } from './types.ts'
+
+/** 通用配置存储（dsh-router 核心注入；连接池/模型管理/别名/积分缓存）。 */
+export interface SupplierConfigStoreLike {
+  get(id: string): {
+    alias: string
+    disabled: string[]
+    custom: string[]
+    poolOrder: string[]
+    poolStrategy: 'fallback' | 'round-robin'
+    /** 积分缓存：uid → 剩余额度（-1 = 还没拿到过）。 */
+    credits: Record<string, number>
+  }
+  setAlias(id: string, alias: string): void
+  setPoolOrder(id: string, uids: string[]): void
+  setPoolStrategy(id: string, strategy: string): void
+  setModelEnabled(id: string, modelId: string, enabled: boolean): void
+  addCustomModel(id: string, modelId: string): void
+  removeCustomModel(id: string, modelId: string): void
+  setAllModelsEnabled(id: string, enabled: boolean, modelIds: string[]): void
+  /** 读积分缓存；没缓存过返回 -1。 */
+  getCredits(id: string, uid: string): number
+  /** 合并插件报的积分：-1（未知）回落到缓存值，非 -1 写入并返回它。 */
+  putCredits(id: string, uid: string, reported: number): number
+  /** 删链接时清掉它的积分缓存。 */
+  clearCredits(id: string, uid: string): void
+}
+
+/** 通用凭证存储（dsh-router 核心注入；不透明凭证 blob）。 */
+export interface CredentialStoreLike {
+  list(supplierId: string): string[]
+  get<T = unknown>(supplierId: string, uid: string): T | undefined
+  save(supplierId: string, uid: string, blob: unknown): void
+  remove(supplierId: string, uid: string): void
+}
+
+/**
+ * 账户此刻的状态 —— 插件**解读**上游信号后的语义状态。
+ * 插件只报「现在怎么了」，不说「该怎么办」：冷却多久、是否禁用、要不要换号
+ * 都是核心的策略。
+ */
+export type AccountState =
+  | 'ok'            // 正常
+  | 'rate_limit'    // 限流（429 类）
+  | 'quota'         // 额度/权益不足
+  | 'session_dead'  // 凭证彻底失效，必须重新登录才能恢复
+  | 'unavailable'   // 上游不可用（404 / 服务下线）
+  | 'transport'     // 网络/连接层失败（没拿到 HTTP 状态）
+  | 'unknown'       // 说不清是什么错
+  /** 这个模型不属于本供应商（不是账号的失败）。核心据此跳过整个供应商换下一个，
+   *  而不是记在账号头上——否则组合里每有一个别人家的模型，就会给无关账号攒
+   *  一次错误，攒够阈值把它冷却掉。 */
+  | 'no_such_model'
+  /** 请求本身不合法被上游拒（参数错/图片认不出/tool_call 配对断裂）——同一个
+   *  请求对每个号都一样失败，不是账号的错。核心不惩罚账号，直接换下一个。 */
+  | 'bad_request'
+
+/** 账号「现在状态」（插件只报它观察到的部分）。 */
+export interface SupplierAccountNow {
+  uid: string
+  nickname?: string
+  /**
+   * 剩余额度。**拿不到就报 `-1`**，不是 0：
+   * 插件刚重启（内存缓存空）、积分拉取失败、或压根不支持积分时都是 `-1`。
+   * 核心据此保留上一次持久化下来的值 —— 报 0 会把缓存冲成 0（0 是真值
+   * 「用完了」，核心分不清「拿到 0」和「没拿到」）。
+   */
+  credits: number
+  state: AccountState
+  message?: string
+}
+
+/** 插件报的供应商状态。 */
+export interface SupplierStatusNow {
+  id: string
+  name: string
+  accounts: SupplierAccountNow[]
+}
+
+/** 一次上游调用的结果。 */
+export type ChatOnceResult =
+  /** 流式：插件已把上游协议转成 OpenAI SSE，核心只负责 pipe 到 res。 */
+  | { ok: true; stream: ReadableStream<Uint8Array> }
+  /** 非流式：核心写 JSON。 */
+  | { ok: true; status: number; body: string }
+  /**
+   * 失败：核心据此做冷却/禁用/换号。
+   * `resetAt` = 上游自己声明的重置时刻（epoch ms，可选）：限流类错误带它时
+   * 核心冷却到该点而不是指数退避（6004「将在 … 重置」就属于这类）。
+   */
+  | { ok: false; state: AccountState; message: string; resetAt?: number }
+
+/** 供应商配置：dsh-router 核心注入的运行时环境。 */
+export interface SupplierEnv {
+  dataDir: string
+  log: (msg: string) => void
+  store: SupplierConfigStoreLike
+  credentials: CredentialStoreLike
+  /**
+   * 迟到的失败上报（可选）——**只在响应已提交之后**才用。
+   *
+   * 流式请求一旦写出第一个字节就绑死（HTTP 语义），此时上游再报错已经换不了
+   * 号、也改不了状态码。但「这个号坏了」对**后续**请求仍有用：不报上来它就会
+   * 继续留在池里被轮转选中。核心实现 = `pool.noteFailure`，按状态冷却/禁用。
+   * 插件拿不到也不用兜底：不调用就退化成今天的行为。
+   */
+  onLateFailure?: (uid: string, model: string, state: AccountState, message: string) => void
+}
+
+/** 供应商模块 —— 契约（核心必须，差异化可选）。 */
+export interface SupplierModule {
+  readonly id: string
+  readonly name: string
+  readonly priority?: number
+  /** 图标（URL 或 SVG data URI），面板供应商卡片显示。可选。 */
+  readonly icon?: string
+  /**
+   * 「添加 API key」弹窗的提示文案。可选：缺省时前端用通用文案。
+   *
+   * 走 `addApiKey` 的供应商应该提供它 —— 否则所有供应商的弹窗都显示同一句
+   * 通用提示，用户不知道该去哪儿拿这个 key。
+   */
+  readonly apiKeyHint?: string
+
+  // ---- 核心（必须） ----
+  /** 报账号「现在状态」（插件只报它观察到的）。冷却/禁用/错误累计由核心叠加。 */
+  status(): SupplierStatusNow
+  listModels(force?: boolean): Promise<ModelInfo[]> | ModelInfo[]
+  /**
+   * 对**单个账号**调一次上游。插件不遍历账号、不管冷却、不写 res——
+   * 选号/回退/健康判定全是核心的活。
+   *
+   * 失败原因通过返回值的 `message` 报（核心测试模型时直接拿它做诊断提示），
+   * 插件不必维护「上次失败」的状态。
+   */
+  chatOnce(uid: string, lv: string, req: ChatRequest): Promise<ChatOnceResult>
+  dispose(): void
+
+  // ---- 差异化能力（可选） ----
+
+  generateLoginUrl?(): string | { ok: boolean; error?: string; loginUrl?: string } | Promise<string | { ok: boolean; error?: string; loginUrl?: string }>
+  completeLogin?(callbackUrl: string): Promise<{ uid: string; nickname: string }>
+  /**
+   * 添加 API key 账号（弹窗填名字 + key，而不是走 URL 登录）。有它同样显示连接池。
+   *
+   * 本插件用它承载 Qoder 的 PAT：上游没有 OAuth，用户粘贴一个 `pt-…` 就是
+   * 全部认证材料。
+   */
+  addApiKey?(input: { name: string; apiKey: string }): Promise<{
+    ok: boolean
+    error?: string
+    account?: { uid: string; nickname: string }
+  }>
+  removeLink?(uid: string): Promise<boolean>
+  /** 轮询式登录标记：有它 → 面板隐藏「粘贴回调链接」步骤，登录后直接点完成（后台轮询）。 */
+  pollLogin?(): boolean
+
+  /** 单个链接签到。遍历所有链接 + 结果汇总是 dsh-router 核心的活。
+   *  status: 'ok'(签到成功) / 'already'(今日已签到) / 'error'(失败)。 */
+  checkinNow?(uid: string): Promise<{ ok: boolean; status: string; message?: string }>
+}
+
+export type { SupplierAccount }