waygate-qoder 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zhanghaojie513
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,152 @@
-# Temporary Holding Version
+# waygate-qoder
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<div align="center">
+
+**途关 · Qoder CN 反代**
+
+把 Qoder CN 客户端的订阅，变成你自己的本地 API
+
+![Node](https://img.shields.io/badge/Node-%E2%89%A520-3C873A?style=flat-square&logo=node.js&logoColor=white)
+![Platform](https://img.shields.io/badge/Platform-Windows-0078D4?style=flat-square&logo=windows&logoColor=white)
+![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)
+
+[快速开始](#快速开始) · [客户端配置](#客户端怎么填) · [工作原理](#工作原理) · [常见问题](#常见问题) · [相关项目](#相关项目)
+
+</div>
+
+---
+
+**读取本机 Qoder 客户端的登录态，在本机起一个 Anthropic / OpenAI 兼容的聊天端点** ——
+Cursor、Claude Code、Cherry Studio、任何能改 base_url 的工具，都能直接用你的订阅额度。
+
+- **零配置接入** —— 一条命令起服务，打印出「代理地址 + 密钥 + 模型 ID」，复制粘贴即可
+- **两个协议都认** —— `POST /v1/chat/completions`（OpenAI 兼容）与 `POST /v1/messages`（Anthropic 兼容）
+- **只在本机转** —— 读本机客户端文件、写 `~/.waygate/`、本机转发；不向任何第三方上传数据
+
+## 快速开始
+
+```bash
+# 全局安装（之后命令就是 qoc）
+npm i -g waygate-qoder
+
+# 启动
+qoc
+```
+
+```
+途关 · Qoder CN 反代 v0.1.0
+
+凭证    ✓ 你的账号（uid 01a0d156…）
+上游    https://gateway.qoder.com.cn  (COSY 签名协议)
+代理    http://127.0.0.1:8789
+密钥    sk-qoc-3f8a…c21d
+
+模型 ID（填进你的客户端）：
+  qmodel_38max   Qwen3.8-Max
+  qfmodel        Qwen3.8-Flash
+  qmodel         Qwen3.7-Plus
+  …（共 14 个）
+
+把上面的「代理地址 + 密钥」填进 Cursor / Claude Code / Cherry Studio 等客户端即可。
+按 Ctrl+C 停止。
+```
+
+> 不想全局装：`git clone` 后 `npm install && npm run build && node dist/index.js`。
+
+**要求**：Node.js ≥ 20；本机装有 Qoder CN 桌面客户端**且已登录**。
+
+## 命令
+
+```bash
+qoc                  # 启动反代（同 qoc serve），打印模型 ID 与代理地址
+qoc models           # 只列出模型 ID（不起服务）
+qoc doctor           # 自检：端口 / 凭证 / 模型清单 / 上游连通
+qoc login            # 重新读取客户端登录态（令牌过期时用）
+```
+
+| 参数 | 说明 |
+| --- | --- |
+| `--port <n>` | 监听端口（默认 8789） |
+| `--host <addr>` | 监听地址（默认 `127.0.0.1`） |
+| `--key <sk-…>` | 指定入站密钥（默认自动生成并缓存） |
+| `--json` | 机器可读输出 |
+| `--verbose` | 打印每个请求的路由日志 |
+
+## 客户端怎么填
+
+**Cursor / Cherry Studio / OpenAI SDK**
+
+- Base URL：`http://127.0.0.1:8789/v1`
+- API Key：启动时打印的 `sk-qoc-…`
+- 模型：模型 ID（如 `qfmodel`）
+
+**Claude Code**
+
+```bash
+ANTHROPIC_BASE_URL=http://127.0.0.1:8789
+ANTHROPIC_API_KEY=sk-qoc-…
+```
+
+暴露的端点：`POST /v1/chat/completions` · `POST /v1/messages` · `GET /v1/models` · `GET /healthz`
+
+支持流式（SSE）与非流式（`stream: false` 时自动聚合为单个 JSON）两种响应模式。
+
+## 工作原理
+
+```mermaid
+flowchart LR
+  C[你的客户端<br/>Cursor / Claude Code]
+  Q[qoc<br/>本机 8789]
+  G[Qoder 网关]
+
+  C -->|OpenAI / Anthropic 协议| Q
+  Q -->|COSY 签名协议| G
+
+  subgraph local [本机]
+    Q
+    F[~/.waygate/qoc/credential.json]
+  end
+  F -.->|qoc login 写入| Q
+
+  style Q fill:#EDE9FE,stroke:#8B5CF6,color:#1F2328
+  style F fill:#FFFFFF,stroke:#D0D7DE,color:#1F2328
+  style C fill:#FFFFFF,stroke:#D0D7DE,color:#1F2328
+  style G fill:#FFFFFF,stroke:#D0D7DE,color:#1F2328
+  style local fill:#F6F8FA,stroke:#D0D7DE
+```
+
+- **凭证**：Qoder 客户端把登录态存在 Chromium 的 `auth.v1.dat`（os_crypt **v10**，密钥由 Windows **DPAPI** 保护）。`qoc login` 用本机 DPAPI 解出令牌，写到 `~/.waygate/qoc/credential.json`（0600）。
+- **协议**：Qoder 网关用一套自研签名（**COSY** bearer + 自定义 base64 编码）与 SSE 帧格式；本工具把它翻译成标准 OpenAI SSE 形状下发。
+- **模型清单**：真拉网关 `/model/list`（不是内置假清单），模型 `id` 即客户端请求要填的 key。
+
+> [!NOTE]
+> **遇到大上下文时偶发「HTTP 200 但零字节」** —— 这是 Qoder 网关的已知现象（实测 2.7 万 token 时会先空转近 30 秒才断流）。本工具会自动重发一次（最多 1 次），客户端只会感到响应稍慢，不会收到半截内容。
+
+## 常见问题
+
+**要装 Qoder 客户端吗？** 要。本工具不提供账号，只是把你**已有**的客户端登录态转成本地 API。
+
+**令牌过期了怎么办？** 在 Qoder 客户端重新登录，然后跑一次 `qoc login`；`qoc doctor` 会告诉你凭证是否还有效。
+
+**会不会把我的令牌上传？** 不会。全程只在本机读写：读客户端文件 → 写 `~/.waygate/` → 本机转发。代码开源可查。
+
+**端口被占用？** `qoc --port 9790`，或 `qoc doctor` 看是哪一项没过。
+
+**支持 macOS / Linux 吗？** 暂只支持 Windows —— 客户端用 **DPAPI**（Windows 专有）保护密钥。
+
+> [!WARNING]
+> **想给局域网其他设备用？** 加 `--host 0.0.0.0` —— 请想清楚：那等于把你订阅的额度开放给能访问该端口的所有人。
+
+## 免责声明
+
+仅供**个人学习与研究**使用，请遵守 Qoder 的服务条款。上游接口随时可能变更，届时本工具可能失效（`qoc doctor` 是排查入口）。作者不对使用后果负责。
+
+## 相关项目
+
+- **waygate-mmcode** —— 同款工具，对应 MiniMax Code（*即将发布*）
+- **[waygate-core](https://github.com/zhanghaojie513/waygate-core)** —— 两个工具共用的骨架（`npm i waygate-core`）
+- **[relay-station](https://github.com/zhanghaojie513/relay-station)** —— 同一作者的完整多提供商反代（含控制台、用量统计）
+
+## License
+
+MIT

package/dist/adapter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Qoder CN 适配器：把「本机客户端登录态」变成「本地 Anthropic/OpenAI 兼容反代」。
+ *
+ * 职责：凭证（读客户端登录态）→ 协议（COSY 签名 + 翻译 + 流解码）→ 交给 core 的 HTTP 服务。
+ * 上游知识全在本文件与 protocol/ 里，core 不含任何 Qoder 细节。
+ */
+import { type Adapter } from 'waygate-core';
+import { type QoderIdentity } from './credential.js';
+import { CredentialError } from './errors.js';
+/** 凭证落盘位置（`~/.waygate/qoc/credential.json`）—— 首次 login 后复用，避免每次读客户端文件。 */
+export declare function credentialPath(): string;
+export declare function resolveIdentity(): QoderIdentity;
+/** 落盘身份材料（0600）并更新内存缓存。 */
+export declare function saveIdentity(identity: QoderIdentity): string;
+export declare function createQoderAdapter(opts?: {
+    baseUrl?: string;
+    chatPath?: string;
+}): Adapter;
+export { CredentialError };

package/dist/adapter.js

@@ -0,0 +1,169 @@
+/**
+ * Qoder CN 适配器：把「本机客户端登录态」变成「本地 Anthropic/OpenAI 兼容反代」。
+ *
+ * 职责：凭证（读客户端登录态）→ 协议（COSY 签名 + 翻译 + 流解码）→ 交给 core 的 HTTP 服务。
+ * 上游知识全在本文件与 protocol/ 里，core 不含任何 Qoder 细节。
+ */
+import { chmodSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { commandDir } from 'waygate-core';
+import { readQoderIdentity } from './credential.js';
+import { CredentialError, UpstreamError } from './errors.js';
+import { loadModels } from './models.js';
+import { buildCosyBearer, cosyChatHeaders, DEFAULT_QODER_BASE_URL, DEFAULT_QODER_CHAT_PATH, newCosySession, qEncode, } from './protocol/cosy.js';
+import { qoderToOpenAiSse } from './protocol/stream-decode.js';
+import { toQoderRequest } from './protocol/translate.js';
+/** 凭证落盘位置（`~/.waygate/qoc/credential.json`）—— 首次 login 后复用，避免每次读客户端文件。 */
+export function credentialPath() {
+    return join(commandDir('qoc'), 'credential.json');
+}
+/**
+ * 取身份材料：优先本地缓存副本（login 落盘），否则现读客户端登录态。
+ * [复核修正] 加内存缓存 —— 此前每个聊天请求都调本函数；凭证文件不存在时
+ * 每次都会走 DPAPI 解密（起 PowerShell 进程），代价极高。
+ */
+let identityCache = null;
+export function resolveIdentity() {
+    if (identityCache)
+        return identityCache;
+    const cached = credentialPath();
+    if (existsSync(cached)) {
+        const parsed = JSON.parse(readFileSync(cached, 'utf8'));
+        if (parsed.token && parsed.uid) {
+            identityCache = parsed;
+            return parsed;
+        }
+    }
+    identityCache = readQoderIdentity();
+    return identityCache;
+}
+/** 落盘身份材料（0600）并更新内存缓存。 */
+export function saveIdentity(identity) {
+    const path = credentialPath();
+    writeFileSync(path, JSON.stringify(identity, null, 2) + '\n', { mode: 0o600 });
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        /* Windows 语义有限 */
+    }
+    identityCache = identity;
+    return path;
+}
+function mask(s) {
+    return s.length > 10 ? `${s.slice(0, 6)}…(${s.length}B)` : '***';
+}
+export function createQoderAdapter(opts = {}) {
+    const baseUrl = opts.baseUrl ?? DEFAULT_QODER_BASE_URL;
+    const chatPath = opts.chatPath ?? DEFAULT_QODER_CHAT_PATH;
+    return {
+        command: 'qoc',
+        displayName: 'Qoder CN',
+        defaultPort: 8789,
+        upstreamLabel: `${baseUrl}  (COSY 签名协议)`,
+        async credentialStatus() {
+            try {
+                const id = resolveIdentity();
+                return { ok: true, detail: `${id.name}（uid ${id.uid.slice(0, 8)}…，令牌 ${mask(id.token)}）`, source: existsSync(credentialPath()) ? credentialPath() : undefined };
+            }
+            catch (err) {
+                return { ok: false, detail: err.message };
+            }
+        },
+        async login() {
+            const id = readQoderIdentity();
+            const path = saveIdentity(id);
+            process.stdout.write(`已读取客户端登录态：${id.name}（uid ${id.uid}）\n已保存到 ${path}\n`);
+        },
+        async listModels() {
+            return loadModels(baseUrl, resolveIdentity());
+        },
+        async doctorChecks() {
+            /* [复核修正] 此前 .catch(()=>null) 吞掉了所有网络错误 → 「上游连通」恒报 ✓。
+               fetch 只在网络不可达（DNS/超时/拒连）时抛错；HTTP 404/502 不抛（反而证明可达）。 */
+            try {
+                await fetch(`${baseUrl}/healthz`, { signal: AbortSignal.timeout(8000) });
+                return [{ name: '上游连通', ok: true, detail: `${baseUrl} 可达` }];
+            }
+            catch (err) {
+                return [{ name: '上游连通', ok: false, detail: err.message }];
+            }
+        },
+        async chat(body, signal) {
+            const identity = resolveIdentity();
+            /* [零内容重试] Qoder 网关在大上下文时会「HTTP 200 但零字节断流」（实测 2026-10-12：
+               2.7 万 token 时 27.8s 零字节；同日同模型重发 4.9s 成功）。客户端此时什么都还没收到，
+               重发完全无感 —— 上限 1 次，避免上游真故障时把延迟翻倍。
+               必须**在把流交给客户端前**探首块：一旦 core 提交了 200 响应头就没法重发了。 */
+            const MAX_RETRY = 1;
+            let lastErr = null;
+            for (let attempt = 0; attempt <= MAX_RETRY; attempt += 1) {
+                if (attempt > 0)
+                    await new Promise((r) => setTimeout(r, 1000));
+                const session = newCosySession(identity);
+                const qoderBody = toQoderRequest(body, body.model, identity.userType);
+                /* 请求体必须走网关的自定义 base64（Encode=1）—— 直接发 JSON 会被上游
+                   CustomBase64Util.decode0 拒绝（实测：event:error + Java 栈）。 */
+                const encoded = qEncode(JSON.stringify(qoderBody));
+                const pathOnly = chatPath.split('?')[0];
+                const date = String(Math.floor(Date.now() / 1000));
+                const bearer = buildCosyBearer(session, date, encoded, pathOnly);
+                const res = await fetch(`${baseUrl}${chatPath}`, {
+                    method: 'POST',
+                    headers: cosyChatHeaders(session, identity, bearer, date, 'text/event-stream'),
+                    body: encoded,
+                    signal,
+                });
+                if (!res.ok) {
+                    const text = await res.text().catch(() => '');
+                    if (res.status === 401 || res.status === 403) {
+                        throw new UpstreamError(`上游鉴权失败（HTTP ${res.status}）—— 令牌可能已过期：在 Qoder 客户端重新登录后跑一次 qoc login`);
+                    }
+                    throw new UpstreamError(`上游 HTTP ${res.status}${text ? `：${text.slice(0, 200)}` : ''}`);
+                }
+                if (!res.body) {
+                    lastErr = new UpstreamError('上游返回 200 但响应体为空');
+                    continue;
+                }
+                /* 探首块：拿到就把它塞回新流（不能丢首帧内容）；拿不到 → 零内容断流 → 重试。 */
+                const reader = res.body.getReader();
+                let first;
+                try {
+                    first = await reader.read();
+                }
+                catch (err) {
+                    lastErr = err;
+                    if (attempt < MAX_RETRY)
+                        continue;
+                    throw new UpstreamError(`读取上游流失败：${err.message}`);
+                }
+                if (first.done || !first.value || first.value.length === 0) {
+                    lastErr = new UpstreamError('零内容断流（耗时较长或上下文过大）');
+                    if (attempt < MAX_RETRY)
+                        continue;
+                    throw lastErr;
+                }
+                const withFirst = new ReadableStream({
+                    start(controller) {
+                        controller.enqueue(first.value);
+                    },
+                    async pull(controller) {
+                        const { done, value } = await reader.read();
+                        if (done) {
+                            controller.close();
+                            return;
+                        }
+                        controller.enqueue(value);
+                    },
+                    cancel(reason) {
+                        void reader.cancel(reason);
+                    },
+                });
+                /* 网关 SSE → OpenAI SSE（core 只负责把流吐给客户端）。 */
+                return { stream: withFirst.pipeThrough(qoderToOpenAiSse(body.model)), status: 200 };
+            }
+            throw lastErr ?? new UpstreamError('上游调用失败');
+        },
+    };
+}
+export { CredentialError };

package/dist/credential.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Qoder CN 客户端登录态 → 凭证明文。
+ *
+ * 客户端把登录态放在 Chromium 的 `auth.v1.dat`（os_crypt v10：AES-256-GCM，密钥由
+ * Windows DPAPI 保护）。解密链（与社区实现同源、本项目生产验证过）：
+ *   Local State 的 `os_crypt.encrypted_key`（base64，去 5 字节前缀 "DPAPI"）
+ *     → PowerShell 调 DPAPI Unprotect（CurrentUser）→ 32 字节 AES key
+ *     → 解 auth.v1.dat：[3B "v10"][12B nonce][ct…][16B tag]
+ *
+ * 只读本机文件、只在本机解密；令牌仅写到本机 `~/.waygate/qoc/`，不上传任何地方。
+ */
+/** Qoder 客户端身份材料（`providers/<id>.key` 的同形 JSON）。 */
+export interface QoderIdentity {
+    /** 访问令牌（`dt-…`）。 */
+    token: string;
+    /** 刷新令牌（`drt-…`）。 */
+    refreshToken: string;
+    uid: string;
+    name: string;
+    userType: string;
+}
+/** 客户端数据目录（可用 QODER_APP_DIR 覆盖，便于便携部署/异机取证）。 */
+export declare function qoderAppDir(): string;
+/** 平台是否支持（DPAPI 是 Windows 专有）。 */
+export declare function isSupportedPlatform(): boolean;
+/**
+ * 从本机客户端登录态解出身份材料。
+ * 失败一律抛 `CredentialError`（人话描述，CLI 直接展示，不抛栈）。
+ */
+export declare function readQoderIdentity(): QoderIdentity;

package/dist/credential.js

@@ -0,0 +1,97 @@
+/**
+ * Qoder CN 客户端登录态 → 凭证明文。
+ *
+ * 客户端把登录态放在 Chromium 的 `auth.v1.dat`（os_crypt v10：AES-256-GCM，密钥由
+ * Windows DPAPI 保护）。解密链（与社区实现同源、本项目生产验证过）：
+ *   Local State 的 `os_crypt.encrypted_key`（base64，去 5 字节前缀 "DPAPI"）
+ *     → PowerShell 调 DPAPI Unprotect（CurrentUser）→ 32 字节 AES key
+ *     → 解 auth.v1.dat：[3B "v10"][12B nonce][ct…][16B tag]
+ *
+ * 只读本机文件、只在本机解密；令牌仅写到本机 `~/.waygate/qoc/`，不上传任何地方。
+ */
+import { execFileSync } from 'node:child_process';
+import { createDecipheriv } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { CredentialError } from './errors.js';
+/** 客户端数据目录（可用 QODER_APP_DIR 覆盖，便于便携部署/异机取证）。 */
+export function qoderAppDir() {
+    const override = (process.env.QODER_APP_DIR ?? '').trim();
+    if (override)
+        return override;
+    const roaming = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+    return join(roaming, 'com.qodercn.app.stable');
+}
+/** 平台是否支持（DPAPI 是 Windows 专有）。 */
+export function isSupportedPlatform() {
+    return process.platform === 'win32';
+}
+/** 用 DPAPI 解出 os_crypt 的 AES key（Windows；走 PowerShell 免原生依赖）。 */
+function osCryptKey(appDir) {
+    const localStatePath = join(appDir, 'Local State');
+    if (!existsSync(localStatePath)) {
+        throw new CredentialError(`找不到客户端文件：${localStatePath}（客户端未安装或未运行过？可用 QODER_APP_DIR 指定目录）`);
+    }
+    const ls = JSON.parse(readFileSync(localStatePath, 'utf8'));
+    const b64 = ls.os_crypt?.encrypted_key;
+    if (!b64)
+        throw new CredentialError('Local State 里没有 os_crypt.encrypted_key —— 客户端版本可能变了');
+    const encrypted = Buffer.from(b64, 'base64');
+    const hex = execFileSync('powershell', [
+        '-NoProfile',
+        '-Command',
+        `$enc = [Convert]::FromBase64String('${encrypted.toString('base64')}'); $enc = $enc[5..($enc.Length-1)]; Add-Type -AssemblyName System.Security; ([Security.Cryptography.ProtectedData]::Unprotect($enc, $null, 'CurrentUser') | ForEach-Object { $_.ToString('x2') }) -join ''`,
+    ], { encoding: 'utf8' }).trim();
+    if (!hex)
+        throw new CredentialError('DPAPI 解密返回空（当前用户与写入该文件的用户不一致？）');
+    return Buffer.from(hex, 'hex');
+}
+/** 解 `auth.v1.dat`（v10 形态）。 */
+function decryptV10(blob, key) {
+    if (blob.subarray(0, 3).toString() !== 'v10') {
+        throw new CredentialError('auth.v1.dat 不是 v10 格式（客户端加密方案变了？）');
+    }
+    const nonce = blob.subarray(3, 15);
+    const tag = blob.subarray(blob.length - 16);
+    const ct = blob.subarray(15, blob.length - 16);
+    const d = createDecipheriv('aes-256-gcm', key, nonce);
+    d.setAuthTag(tag);
+    return Buffer.concat([d.update(ct), d.final()]).toString('utf8');
+}
+/**
+ * 从本机客户端登录态解出身份材料。
+ * 失败一律抛 `CredentialError`（人话描述，CLI 直接展示，不抛栈）。
+ */
+export function readQoderIdentity() {
+    if (!isSupportedPlatform()) {
+        throw new CredentialError(`当前平台（${process.platform}）暂不支持自动读取 Qoder 登录态（DPAPI 为 Windows 专有）；请手动导出 identity JSON 后放入 ~/.waygate/qoc/credential.json`);
+    }
+    const appDir = qoderAppDir();
+    const authFile = join(appDir, 'auth.v1.dat');
+    if (!existsSync(authFile)) {
+        throw new CredentialError(`找不到登录态文件 ${authFile} —— 请先在 Qoder 客户端登录；或用 QODER_APP_DIR 指定客户端数据目录`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(decryptV10(readFileSync(authFile), osCryptKey(appDir)));
+    }
+    catch (err) {
+        if (err instanceof CredentialError)
+            throw err;
+        throw new CredentialError(`解密登录态失败：${err.message}（客户端未登录，或文件被其他程序占用？）`);
+    }
+    const user = (parsed.user ?? {});
+    const identity = {
+        token: String(parsed.token ?? ''),
+        refreshToken: String(parsed.refreshToken ?? ''),
+        uid: String(user.id ?? ''),
+        name: String(user.name ?? 'qoder-user'),
+        userType: 'personal_standard',
+    };
+    for (const [k, v] of Object.entries(identity)) {
+        if (!v && k !== 'name')
+            throw new CredentialError(`登录态缺字段 ${k} —— 客户端未登录？请在客户端登录后重试`);
+    }
+    return identity;
+}

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 上游错误（core 会把它兜成 502 + OpenAI 形状错误体给客户端）。
+ */
+export declare class UpstreamError extends Error {
+    readonly name = "UpstreamError";
+    constructor(message: string);
+}
+/** 凭证类错误（启动/doctor 用：提示用户跑 login 而不是抛栈）。 */
+export declare class CredentialError extends Error {
+    readonly name = "CredentialError";
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,16 @@
+/**
+ * 上游错误（core 会把它兜成 502 + OpenAI 形状错误体给客户端）。
+ */
+export class UpstreamError extends Error {
+    name = 'UpstreamError';
+    constructor(message) {
+        super(message);
+    }
+}
+/** 凭证类错误（启动/doctor 用：提示用户跑 login 而不是抛栈）。 */
+export class CredentialError extends Error {
+    name = 'CredentialError';
+    constructor(message) {
+        super(message);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * waygate-qoder —— Qoder CN 本地反代（命令 `qoc`）。
+ *
+ * 读取本机 Qoder 客户端的登录态，在本机提供一个 Anthropic/OpenAI 兼容的聊天端点，
+ * 供 Cursor / Claude Code / Cherry Studio 等客户端使用。只在本机读写与转发，不上传任何数据。
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * waygate-qoder —— Qoder CN 本地反代（命令 `qoc`）。
+ *
+ * 读取本机 Qoder 客户端的登录态，在本机提供一个 Anthropic/OpenAI 兼容的聊天端点，
+ * 供 Cursor / Claude Code / Cherry Studio 等客户端使用。只在本机读写与转发，不上传任何数据。
+ */
+import { runCli } from 'waygate-core';
+import { createQoderAdapter } from './adapter.js';
+const VERSION = '0.1.0';
+const code = await runCli(createQoderAdapter(), { version: VERSION });
+process.exit(code);

package/dist/models.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 模型清单：拉 Qoder 网关的 `/algo/api/v2/model/list`（真接口，非本地种子）。
+ *
+ * 关键设计（沿用 relay 的取舍）：网关给的是「显示名 ↔ 内部 key」映射，而**客户端请求里
+ * 传的是内部 key**。所以模型 id = 内部 key（路由键），displayName = 显示名给人看。
+ */
+import { type CosySession } from './protocol/cosy.js';
+import type { QoderIdentity } from './credential.js';
+import type { ModelEntry } from 'waygate-core';
+export declare const QODER_MODEL_LIST_PATH = "/algo/api/v2/model/list?Encode=1";
+/** 从网关响应里抽模型（取 chat 场景；enable=false 的跳过）。 */
+export declare function parseQoderModels(payload: unknown): ModelEntry[];
+/** 拉取模型清单（真打网关）。 */
+export declare function fetchQoderModels(opts: {
+    baseUrl: string;
+    identity: QoderIdentity;
+    session: CosySession;
+    timeoutMs?: number;
+}): Promise<ModelEntry[]>;
+/** 便捷：从身份材料建会话 + 拉模型（适配器与 doctor 共用）。 */
+export declare function loadModels(baseUrl: string, identity: QoderIdentity): Promise<ModelEntry[]>;

package/dist/models.js

@@ -0,0 +1,64 @@
+/**
+ * 模型清单：拉 Qoder 网关的 `/algo/api/v2/model/list`（真接口，非本地种子）。
+ *
+ * 关键设计（沿用 relay 的取舍）：网关给的是「显示名 ↔ 内部 key」映射，而**客户端请求里
+ * 传的是内部 key**。所以模型 id = 内部 key（路由键），displayName = 显示名给人看。
+ */
+import { buildCosyBearer, cosyChatHeaders, newCosySession } from './protocol/cosy.js';
+import { UpstreamError } from './errors.js';
+export const QODER_MODEL_LIST_PATH = '/algo/api/v2/model/list?Encode=1';
+/** 从网关响应里抽模型（取 chat 场景；enable=false 的跳过）。 */
+export function parseQoderModels(payload) {
+    if (!payload || typeof payload !== 'object')
+        return [];
+    const scenes = payload;
+    /* 形状：{ sceneName: [ {key, display_name, enable, …} ] }；取 chat，缺失时取第一个非空场景。 */
+    const raw = Array.isArray(scenes.chat)
+        ? scenes.chat
+        : Object.values(scenes).find((v) => Array.isArray(v) && v.length > 0) ?? [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const rec = item;
+        if (rec.enable === false)
+            continue;
+        const id = typeof rec.key === 'string' ? rec.key : null;
+        if (!id)
+            continue;
+        const displayName = typeof rec.display_name === 'string' && rec.display_name ? rec.display_name : id;
+        out.push({ id, displayName });
+    }
+    return out;
+}
+/** 拉取模型清单（真打网关）。 */
+export async function fetchQoderModels(opts) {
+    const path = QODER_MODEL_LIST_PATH;
+    const pathOnly = path.split('?')[0];
+    const date = String(Math.floor(Date.now() / 1000));
+    const bearer = buildCosyBearer(opts.session, date, '', pathOnly);
+    const headers = cosyChatHeaders(opts.session, opts.identity, bearer, date, 'application/json');
+    const res = await fetch(`${opts.baseUrl}${path}`, {
+        method: 'GET',
+        headers,
+        signal: AbortSignal.timeout(opts.timeoutMs ?? 15_000),
+    });
+    if (!res.ok)
+        throw new UpstreamError(`模型清单 HTTP ${res.status}（凭证过期？在客户端重新登录后跑一次 qoc login）`);
+    const text = await res.text();
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new UpstreamError('模型清单响应不是 JSON（网关协议变了？）');
+    }
+    const models = parseQoderModels(parsed);
+    if (models.length === 0)
+        throw new UpstreamError('模型清单解析出 0 个模型（响应形状变化？）');
+    return models;
+}
+/** 便捷：从身份材料建会话 + 拉模型（适配器与 doctor 共用）。 */
+export async function loadModels(baseUrl, identity) {
+    return fetchQoderModels({ baseUrl, identity, session: newCosySession(identity) });
+}