webaiapi 0.0.0-stage → 0.1.0

package/dist/browser/credentials.js

@@ -0,0 +1,209 @@
+/**
+ * 凭证读取 —— `legacy-python/src/browser/cdp_capture.py` 中**运行时用到**的那部分。
+ *
+ * 拆出本模块的原因：凭证路径/格式是 `manager`（注入 Cookie）、`router`（挑账号、判身份）
+ * 与 CLI（登录并保存）三处共用的；Python 版把它们散在 `cdp_capture.py`（1,040 行）里，
+ * 而那个文件大部分是**只在登录流程用**的 `AuthCapture` 类。
+ *
+ * 只移植运行时需要的：路径解析、`loadAuth`、`listAccounts`、`isAuthAvailable`、
+ * JWT/Cookie 身份提取。
+ * ⬜ **登录捕获流程（`AuthCapture` / `capturePlatformAuth`）推迟到 M5**（只被 CLI 使用）。
+ *
+ * ⚠️ 与 Python 版的差异：Python 的 `load_auth()` 把目录写死成 `~/.ai-api/auth`，
+ * 而 `settings.auth_dir` 配置项形同虚设。这里统一走 `settings.authDir`
+ * （默认值就是 `~/.ai-api/auth`，所以实际行为一致，但配置项从此真的生效）。
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { expandHome, settings } from '../config.js';
+import { logger } from '../log/logger.js';
+/* ------------------------------------------------------------------ */
+/* 路径                                                                */
+/* ------------------------------------------------------------------ */
+/** 凭证根目录（`~/.ai-api/auth`）。 */
+export function authBaseDir(authDir) {
+    return expandHome(authDir ?? settings.authDir ?? '~/.ai-api/auth');
+}
+/** 某账号的凭证文件路径（新格式 `{base}/{platform}/{account}.json`）。 */
+export function authFilePath(platform, accountId = 'default', authDir) {
+    return join(authBaseDir(authDir), platform, `${accountId}.json`);
+}
+/** 旧格式单文件路径（`{base}/{platform}.json`）。 */
+export function legacyAuthFilePath(platform, authDir) {
+    return join(authBaseDir(authDir), `${platform}.json`);
+}
+/* ------------------------------------------------------------------ */
+/* 读取                                                                */
+/* ------------------------------------------------------------------ */
+/**
+ * 加载某账号的凭证；不存在或没有 cookies 时返回 `null`。
+ *
+ * ⚠️ **必须真的检查 cookies**：Python 版这里曾经整段读取/校验逻辑丢失，
+ * 函数体退化成「打开文件 → 打一条 warning → 返回 None」，
+ * 导致 `load_auth()` 永远返回 None，登录检查全部误报「凭证缺少 cookies」。
+ * 这个校验不能再丢。
+ */
+export function loadAuth(platform, options = {}) {
+    const { accountId = 'default', authDir } = options;
+    let file = authFilePath(platform, accountId, authDir);
+    if (!existsSync(file)) {
+        // 向后兼容：旧格式单文件（仅 default 账号）
+        const legacy = legacyAuthFilePath(platform, authDir);
+        if (accountId === 'default' && existsSync(legacy)) {
+            file = legacy;
+        }
+        else {
+            return null;
+        }
+    }
+    try {
+        const auth = JSON.parse(readFileSync(file, 'utf8'));
+        const cookies = auth.cookies ?? [];
+        if (cookies.length === 0) {
+            logger.warn(`[credentials] ${platform}/${accountId} 凭证缺少 cookies`);
+            return null;
+        }
+        auth._account_id = accountId;
+        return auth;
+    }
+    catch (error) {
+        logger.error(`[credentials] 加载 ${platform}/${accountId} 凭证失败: ${String(error)}`);
+        return null;
+    }
+}
+/**
+ * 列出某平台已捕获的账号 ID。
+ *
+ * 会跳过捕获过程中的临时文件（`__tmp__<ts>.json` / `__new__*`）——
+ * 崩溃残留不是真实账号。
+ */
+export function listAccounts(platform, authDir) {
+    const platformDir = join(authBaseDir(authDir), platform);
+    const accounts = [];
+    if (existsSync(platformDir)) {
+        for (const entry of readdirSync(platformDir)) {
+            if (!entry.endsWith('.json'))
+                continue;
+            const stem = entry.slice(0, -'.json'.length);
+            if (stem.startsWith('__tmp__') || stem.startsWith('__new__'))
+                continue;
+            accounts.push(stem);
+        }
+    }
+    // 向后兼容：旧格式单文件
+    if (accounts.length === 0 && existsSync(legacyAuthFilePath(platform, authDir))) {
+        accounts.push('default');
+    }
+    return accounts.sort();
+}
+/** 指定平台/账号是否有可用凭证。 */
+export function isAuthAvailable(platform, options = {}) {
+    return loadAuth(platform, options) !== null;
+}
+/* ------------------------------------------------------------------ */
+/* 身份提取                                                            */
+/* ------------------------------------------------------------------ */
+/** 解码 JWT payload（不验签，仅用于读用户标识）。 */
+export function decodeJwt(token) {
+    if (!token)
+        return {};
+    const raw = token.startsWith('Bearer ') ? token.slice(7) : token;
+    const parts = raw.split('.');
+    if (parts.length !== 3)
+        return {};
+    try {
+        let payload = parts[1];
+        // 补齐 base64 padding
+        payload += '='.repeat((4 - (payload.length % 4)) % 4);
+        const decoded = Buffer.from(payload.replace(/-/g, '+').replace(/_/g, '/'), 'base64').toString('utf8');
+        const parsed = JSON.parse(decoded);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch (error) {
+        logger.debug(`[credentials] JWT 解码失败: ${String(error)}`);
+        return {};
+    }
+}
+/** 从 cookie 列表里取指定名称的值。 */
+export function getCookieValue(cookies, name) {
+    for (const c of cookies ?? []) {
+        if (c?.name === name)
+            return c.value;
+    }
+    return undefined;
+}
+/*
+ * ⬜ `extractAccountInfoSync` 已**迁到 `platforms.ts`**：
+ * 它按平台名分支，属于「平台元数据」而不是「凭证读写」。
+ * 留在这里会造成 `credentials ⇄ platforms` 循环 import。
+ * 需要它请从 `./platforms.js` 引入。
+ */
+/**
+ * 计算 Cookie 指纹（用于判断「两份凭证是不是同一个会话」）。
+ *
+ * 用途：`ModelRouter` 启用辅助通道前的三重校验之一。
+ * 实测踩坑：把 `default.json` 复制成 `acc2.json` 后，账号数变成 2，
+ * 但其实是同一个人的登录态 → 辅助通道「并行」时立刻撞
+ * 「请等待其他对话生成完毕」。只看账号数看不出来，必须比 Cookie 值。
+ *
+ * 用 Node 内置 crypto，返回稳定的十六进制摘要。
+ */
+export function cookieFingerprint(cookies) {
+    const pairs = (cookies ?? [])
+        .filter((c) => c && typeof c.name === 'string')
+        .map((c) => `${c.name}=${c.value ?? ''}`)
+        .sort();
+    return createHash('sha256').update(pairs.join(';')).digest('hex').slice(0, 32);
+}
+/**
+ * 把抓到的 cookie 规范成 Playwright `addCookies` 能接受的形态。
+ *
+ * 为什么需要：Playwright 会校验 `sameSite`（只认 Strict/Lax/None）与
+ * `expires`（必须是数值）。从 cookie jar / 扩展导出的数据里常见
+ * `"no_restriction"` / `"unspecified"` 这类字面量，直接透传会**抛异常**导致
+ * 整批 Cookie 注入失败（表现为「莫名其妙未登录」）。
+ * Python 版直接透传，因为它的数据源恰好都是合规的 —— 这里做一层兜底。
+ */
+export function normalizeCookies(cookies) {
+    const out = [];
+    for (const c of cookies ?? []) {
+        if (!c || typeof c.name !== 'string' || typeof c.value !== 'string')
+            continue;
+        const cookie = { name: c.name, value: c.value };
+        if (typeof c.domain === 'string')
+            cookie.domain = c.domain;
+        if (typeof c.path === 'string')
+            cookie.path = c.path;
+        if (typeof c.url === 'string')
+            cookie.url = c.url;
+        if (typeof c.expires === 'number' && Number.isFinite(c.expires))
+            cookie.expires = c.expires;
+        if (typeof c.httpOnly === 'boolean')
+            cookie.httpOnly = c.httpOnly;
+        if (typeof c.secure === 'boolean')
+            cookie.secure = c.secure;
+        if (typeof c.sameSite === 'string') {
+            const mapped = mapSameSite(c.sameSite);
+            if (mapped)
+                cookie.sameSite = mapped;
+        }
+        out.push(cookie);
+    }
+    return out;
+}
+function mapSameSite(raw) {
+    switch (raw.trim().toLowerCase()) {
+        case 'strict':
+            return 'Strict';
+        case 'lax':
+            return 'Lax';
+        case 'none':
+        case 'no_restriction':
+            return 'None';
+        default:
+            // 'unspecified' 等无法映射的值直接丢弃该字段（用浏览器默认）
+            return undefined;
+    }
+}
+//# sourceMappingURL=credentials.js.map

package/dist/browser/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/browser/credentials.ts"],"names":[],"mappings":"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"}

package/dist/browser/js-eval.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 页面脚本求值辅助。
+ *
+ * ## ⚠️⚠️ 存在的唯一理由：Playwright Node 与 Python 的一处**不兼容**
+ *
+ * `page.evaluate(x)` 的语义在两个语言里不一样：
+ *
+ * | 传入 | Python | Node |
+ * |---|---|---|
+ * | `"() => ({a:1})"` | **自动调用**该函数 → `{a:1}` | 当作**表达式**求值 → **`undefined`** |
+ * | `"(() => ({a:1}))()"` | `{a:1}` | `{a:1}` ✅ |
+ * | `() => ({a:1})`（真函数） | `{a:1}` | `{a:1}` ✅ |
+ *
+ * 实测（Playwright 1.64 / Node 24）：
+ * ```
+ * evaluate('() => ({a: 1})')            -> undefined
+ * evaluate('(() => ({a: 1}))()')        -> {"a":1}
+ * evaluate(() => ({a: 1}))              -> {"a":1}
+ * ```
+ *
+ * 这是从 Python 移植时**最危险的一个陷阱**：整条链路上所有 DOM/SSE 操作都会
+ * 静默拿到 `undefined`，**不抛异常、不打日志**。表现是「服务起来了、
+ * 请求也返回 200，但永远没有正文 / 永远探测不出登录态」——
+ * 排查时几乎不可能想到是「函数没被调用」。
+ *
+ * 因此本文件强制：**凡是要在页面里执行的函数表达式，都必须经 {@link iife} 包装**。
+ */
+import type { Page } from 'playwright';
+/**
+ * 把「函数表达式字符串」包装成可求值的 IIFE 表达式。
+ *
+ * 输入 `() => { return 1; }` → 输出 `(() => { return 1; })()`。
+ *
+ * ⚠️ 必须保留外层括号：箭头函数直接加 `()` 在 `=>` 与 `{` 之间会被解析错
+ * （`() => {}()` 会被当成「返回 undefined 的函数」而不是「调用」）。
+ */
+export declare function iife(expression: string): string;
+/**
+ * 在页面里执行函数表达式并取回结果。
+ *
+ * 语义等价于 Python 的 `page.evaluate("() => {...}")`。
+ */
+export declare function evaluateFn<T>(page: Page, fnExpression: string): Promise<T>;
+//# sourceMappingURL=js-eval.d.ts.map

package/dist/browser/js-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-eval.d.ts","sourceRoot":"","sources":["../../src/browser/js-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1E"}

package/dist/browser/js-eval.js

@@ -0,0 +1,20 @@
+/**
+ * 把「函数表达式字符串」包装成可求值的 IIFE 表达式。
+ *
+ * 输入 `() => { return 1; }` → 输出 `(() => { return 1; })()`。
+ *
+ * ⚠️ 必须保留外层括号：箭头函数直接加 `()` 在 `=>` 与 `{` 之间会被解析错
+ * （`() => {}()` 会被当成「返回 undefined 的函数」而不是「调用」）。
+ */
+export function iife(expression) {
+    return `(${expression})()`;
+}
+/**
+ * 在页面里执行函数表达式并取回结果。
+ *
+ * 语义等价于 Python 的 `page.evaluate("() => {...}")`。
+ */
+export function evaluateFn(page, fnExpression) {
+    return page.evaluate(iife(fnExpression));
+}
+//# sourceMappingURL=js-eval.js.map

package/dist/browser/js-eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-eval.js","sourceRoot":"","sources":["../../src/browser/js-eval.ts"],"names":[],"mappings":"AA6BA;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,UAAkB;IACrC,OAAO,IAAI,UAAU,KAAK,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAI,IAAU,EAAE,YAAoB;IAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAe,CAAC;AACzD,CAAC"}

package/dist/browser/login-flow.d.ts

@@ -0,0 +1,171 @@
+import { type Choice } from '../utils/prompt.js';
+/** 判断「是不是同一个人 / 同一个登录态」所需的最小信息集。 */
+export interface IdentityPrint {
+    /** 平台内的稳定身份标识（`extractAccountInfoSync` 的 `identifier`）。 */
+    identity: string;
+    /** 人类可读标签（用户名 / 邮箱）。 */
+    label: string;
+    /** Cookie 指纹（{@link cookieFingerprint}）。 */
+    fingerprint: string;
+    /** Cookie 数量（用来判断指纹是不是「空集指纹」）。 */
+    cookies: number;
+}
+/** 磁盘上已有的账号。 */
+export interface ExistingAccount extends IdentityPrint {
+    id: string;
+    capturedAt: number;
+}
+/** 对「新捕获的凭证」与「已有账号」关系的判定。 */
+export type DuplicateVerdict = 
+/** 全新账号。 */
+{
+    kind: 'fresh';
+}
+/** Cookie 完全一致 —— **同一个登录态**（同一个人的同一份会话）。 */
+ | {
+    kind: 'same-session';
+    accountId: string;
+}
+/** 身份一致但 Cookie 不同 —— **同一个人重新登录**（如 cookie 过期后重登）。 */
+ | {
+    kind: 'same-identity';
+    accountId: string;
+};
+/**
+ * 判断新捕获的凭证和已有账号是不是同一个人。
+ *
+ * 判定顺序（**先指纹后身份**，强度递减）：
+ * 1. Cookie 指纹完全相同 → `same-session`。这比身份更硬：身份标识可能因为
+ *    平台改字段而提取不到，但 Cookie 值对了就是同一份会话。
+ * 2. 身份标识（`identifier`）相同 → `same-identity`。同一个人换了会话
+ *    （重登、cookie 轮换）。
+ *
+ * ⚠️ `identity` 是 `'unknown'` 时**不算匹配**：兜底值对所有提取失败的平台都一样，
+ * 拿它比对会把两个毫不相干的账号判成同一个人，反而制造出「并行打同一个账号」
+ * 那个它本该防止的问题。
+ *
+ * ⚠️ 指纹比对要求 `cookies > 0`：空 Cookie 列表的指纹是个常量，
+ * 两个「没抓到 cookie」的凭证会互相匹配。
+ */
+export declare function detectDuplicate(captured: IdentityPrint, existing: ReadonlyArray<ExistingAccount>): DuplicateVerdict;
+/**
+ * 把任意字符串（用户名 / uid / 用户输入）洗成能当文件名的形式。
+ *
+ * 规则：非 `[A-Za-z0-9._-]` 的字符全部折成 `-`，合并连续分隔符、去掉首尾分隔符、
+ * 转小写、截断到 32 字符。
+ *
+ * ⚠️ 洗不出东西时返回**空串**（而不是兜底成某个词）：中文用户名就属于这种，
+ * 调用方需要知道「这个候选废了」才能退到下一个候选（见 {@link deriveAccountId}）。
+ *
+ * ⚠️ 返回值一定满足 `^[A-Za-z0-9._-]*$` 且不含 `/` —— 账号 ID 会被当作文件名
+ * 拼接，这是防路径穿越的第一道闸（`AuthCapture.saveAs` 还有第二道硬校验）。
+ */
+export declare function toSlug(raw: string): string;
+/**
+ * 洗成**唯一**的账号 ID，可直接当文件名。
+ *
+ * ⚠️ **必须去重**：`existing` 里已有的名字要避开（`alice` → `alice-2`）。
+ * 否则第二次登录同一个平台会把第一个账号的文件**原地覆盖**。
+ */
+export declare function slugAccountId(raw: string, existing?: readonly string[]): string;
+/**
+ * 按优先级给账号挑一个名字。
+ *
+ * 顺序：用户显式给的 → 身份标签（用户名）→ 身份标识（uid）→ `account`。
+ * 逐个尝试而不是只用第一个，是因为中文用户名洗完是空串，
+ * 那时应该退到 uid，而不是直接落到无意义的 `account`。
+ */
+export declare function deriveAccountId(candidates: ReadonlyArray<string | undefined>, existing?: readonly string[]): string;
+/**
+ * 读出某平台已有的全部账号（含身份与指纹）。
+ *
+ * ⚠️ **只返回「能用的」账号**：`loadAuth` 会挡掉没有 cookie 或 JSON 损坏的文件，
+ * 而那些文件不应该参与「这是不是同一个人」的判断（它们根本没会话可比）。
+ * 需要**列出全部文件**（用来删除）请用 `listAccounts`。
+ *
+ * @param authDir 凭证目录（默认 `settings.authDir`，测试时传临时目录）
+ */
+export declare function readExistingAccounts(platform: string, authDir?: string): ExistingAccount[];
+/**
+ * `login` 的动作菜单（纯函数，可单测）。
+ *
+ * ⚠️ 最后一项是**导航项**（`Symbol`），不是账号 ID —— 抽成纯函数就是为了让
+ * 「`canGoBack` 时给返回、否则给取消」这条规则能被测试钉住：它是唯一
+ * 决定「用户能不能退回去」的地方，改了没有任何别的东西会报错。
+ *
+ * @param canGoBack 平台是**从菜单选的**才为 true（命令行给的平台没有上一步）
+ */
+export declare function buildLoginActionChoices(existing: ReadonlyArray<ExistingAccount>, options: {
+    canGoBack: boolean;
+}): Choice<string | NavChoice>[];
+export interface LoginOptions {
+    /** `webapi login <platform>`；缺省时交互选择。 */
+    platform?: string;
+    /** `--account <id>`：跳过「存成哪个账号」的询问。 */
+    account?: string;
+    /** `--yes`：所有确认直接通过（脚本用）。 */
+    yes?: boolean;
+    /** `--no-input`：即使有 TTY 也走非交互路径。 */
+    noInput?: boolean;
+}
+/**
+ * 菜单里的「返回上一步」哨兵。
+ *
+ * ⚠️ 用 `Symbol` 而不是 `'__back__'` 这类字符串：菜单选项的值里混着
+ * **真实账号 ID**，总有一天会和某个账号名撞上 —— 而且不会报错，
+ * 只表现为「选那个账号时莫名回到了上一步」。
+ */
+declare const BACK: unique symbol;
+/** 菜单里的「退出 / 取消」哨兵（与 {@link BACK} 区分：一个是回上一步，一个是结束）。 */
+declare const ABORT: unique symbol;
+/** 导航选项的类型。 */
+type NavChoice = typeof BACK | typeof ABORT;
+/**
+ * `webapi login` 的完整流程。
+ *
+ * ## 导航模型
+ * 交互式登录是**两级**的（选平台 → 选动作），所以用一个小循环 + 显式哨兵
+ * 而不是一串顺序执行的 `if`：
+ *
+ * ```
+ *   平台菜单 ──选平台──▶ 动作菜单 ──选动作──▶ 开始捕获
+ *      ▲                    │
+ *      └──── 「← 返回上一步」─┘
+ * ```
+ *
+ * ⚠️ **只从平台菜单进来的才有「上一步」**：`webapi login chatglm` 是用户在命令行
+ * 明确指定的平台，没有可返回的地方，那里给的是「✗ 取消」。
+ *
+ * ⚠️ 动作菜单**即使 0 个账号也照样显示**（此时只有「添加新账号」+ 返回/取消）。
+ * 看起来多按一次回车，换来的是「开了浏览器才发现平台选错」时还能退出来
+ * —— 浏览器一旦启动就得等它登录完或 Ctrl+C。
+ *
+ * @returns 退出码：0 成功 / 1 失败 / 130 用户取消
+ */
+export declare function runLogin(options?: LoginOptions): Promise<number>;
+export interface LogoutOptions {
+    /** `webapi logout <platform>`；缺省时交互选择。 */
+    platform?: string;
+    /** `--account <id>`：跳过账号询问。 */
+    account?: string;
+    /** `--yes`：跳过删除确认（脚本用，**非交互环境必需**）。 */
+    yes?: boolean;
+    /** `--no-input`：即使有 TTY 也走非交互路径。 */
+    noInput?: boolean;
+}
+/**
+ * `webapi logout` 的完整流程。
+ *
+ * ## ⚠️ 这里修掉了一个**会静默删错文件**的老问题
+ * 旧实现是 `webapi logout <platform> [--account x]`，`account` 缺省值写死为
+ * `'default'`。于是 `webapi logout chatglm`（本意可能只是「看看怎么用」）
+ * **直接把 default 账号的凭证删掉了**，而且只在 stdout 说一句「已删除」。
+ *
+ * 现在：账号必须**显式给出**（`--account`）或**从菜单里选**；
+ * 非交互且没给 `--account` 时**直接报错退出**，绝不替用户猜。
+ *
+ * @returns 退出码：0 成功 / 1 失败或未确认 / 130 用户取消
+ */
+export declare function runLogout(options?: LogoutOptions): Promise<number>;
+export {};
+//# sourceMappingURL=login-flow.d.ts.map

package/dist/browser/login-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-flow.d.ts","sourceRoot":"","sources":["../../src/browser/login-flow.ts"],"names":[],"mappings":"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"}