repowiki-core 0.1.0

package/dist/llm/auth-manager.js

@@ -0,0 +1,172 @@
+/**
+ * @module auth-manager
+ * @description 管理 LLM API 凭证，支持多来源优先级链解析配置。
+ *
+ * 优先级链（按优先级从高到低）：
+ * 1. 环境变量: REPOWIKI_API_KEY, REPOWIKI_BASE_URL, REPOWIKI_MODEL
+ * 2. 环境变量 (OpenAI 兼容): OPENAI_API_KEY, OPENAI_BASE_URL
+ * 3. 全局配置文件: ~/.repowiki/config.json
+ * 4. 工作区 .env 文件（使用 dotenv 解析）
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import dotenv from 'dotenv';
+// ============================================================================
+// 常量
+// ============================================================================
+/** 默认 API 端点 */
+const DEFAULT_API_ENDPOINT = 'https://api.openai.com/v1';
+/** 默认模型名称 */
+const DEFAULT_MODEL_NAME = 'gpt-4o';
+/** 全局配置目录名 */
+const GLOBAL_CONFIG_DIR = '.repowiki';
+/** 全局配置文件名 */
+const GLOBAL_CONFIG_FILE = 'config.json';
+// ============================================================================
+// 内部工具函数
+// ============================================================================
+/**
+ * 获取全局配置文件的绝对路径
+ */
+function getGlobalConfigPath() {
+    return path.join(os.homedir(), GLOBAL_CONFIG_DIR, GLOBAL_CONFIG_FILE);
+}
+/**
+ * 尝试读取并解析 JSON 配置文件，若文件不存在或解析失败则返回空对象
+ */
+async function readJsonConfig(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        // 文件不存在或内容无效，均视为空配置
+        return {};
+    }
+}
+/**
+ * 尝试解析工作区 .env 文件，返回解析后的键值对
+ */
+async function readWorkspaceEnv(workspacePath) {
+    const envFilePath = path.join(workspacePath, '.env');
+    try {
+        const content = await fs.readFile(envFilePath, 'utf-8');
+        const parsed = dotenv.parse(content);
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 返回第一个非空字符串值，若全部为空则返回 undefined
+ */
+function firstNonEmpty(...values) {
+    for (const v of values) {
+        if (v && v.trim().length > 0) {
+            return v.trim();
+        }
+    }
+    return undefined;
+}
+// ============================================================================
+// 公开 API
+// ============================================================================
+/**
+ * 按优先级链加载 LLM 配置。
+ *
+ * 解析顺序：
+ * 1. 进程环境变量（REPOWIKI_* 优先，其次 OPENAI_*）
+ * 2. 全局配置文件 ~/.repowiki/config.json
+ * 3. 工作区 .env 文件
+ *
+ * 对于每个字段，取优先级最高的非空值；若全部为空则使用默认值或空字符串。
+ *
+ * @param workspacePath - 可选的工作区路径，用于读取 .env 文件
+ * @returns 解析后的 LLM 配置
+ */
+export async function loadLLMConfig(workspacePath) {
+    // --- 来源 1 & 2: 环境变量（已在 process.env 中） ---
+    const envApiKey = firstNonEmpty(process.env['REPOWIKI_API_KEY'], process.env['OPENAI_API_KEY']);
+    const envEndpoint = firstNonEmpty(process.env['REPOWIKI_BASE_URL'], process.env['OPENAI_BASE_URL']);
+    const envModel = firstNonEmpty(process.env['REPOWIKI_MODEL']);
+    // --- 来源 3: 全局配置文件 ---
+    const globalConfig = await readJsonConfig(getGlobalConfigPath());
+    const globalApiKey = typeof globalConfig['apiKey'] === 'string' ? globalConfig['apiKey'] : undefined;
+    const globalEndpoint = typeof globalConfig['apiEndpoint'] === 'string' ? globalConfig['apiEndpoint'] : undefined;
+    const globalModel = typeof globalConfig['modelName'] === 'string' ? globalConfig['modelName'] : undefined;
+    // --- 来源 4: 工作区 .env ---
+    let wsApiKey;
+    let wsEndpoint;
+    let wsModel;
+    if (workspacePath) {
+        const wsEnv = await readWorkspaceEnv(workspacePath);
+        wsApiKey = firstNonEmpty(wsEnv['REPOWIKI_API_KEY'], wsEnv['OPENAI_API_KEY']);
+        wsEndpoint = firstNonEmpty(wsEnv['REPOWIKI_BASE_URL'], wsEnv['OPENAI_BASE_URL']);
+        wsModel = firstNonEmpty(wsEnv['REPOWIKI_MODEL']);
+    }
+    // --- 合并：对每个字段，按优先级取第一个非空值 ---
+    const apiKey = firstNonEmpty(envApiKey, globalApiKey, wsApiKey) ?? '';
+    const apiEndpoint = firstNonEmpty(envEndpoint, globalEndpoint, wsEndpoint) ?? DEFAULT_API_ENDPOINT;
+    const modelName = firstNonEmpty(envModel, globalModel, wsModel) ?? DEFAULT_MODEL_NAME;
+    return { apiEndpoint, modelName, apiKey };
+}
+/**
+ * 将配置保存到全局配置文件 ~/.repowiki/config.json。
+ *
+ * 如果文件已存在，则与现有配置合并（新值覆盖旧值）。
+ * 如果目录不存在，则自动创建。
+ *
+ * @param config - 要保存的部分配置
+ */
+export async function saveGlobalConfig(config) {
+    const configPath = getGlobalConfigPath();
+    const configDir = path.dirname(configPath);
+    // 确保配置目录存在
+    await fs.mkdir(configDir, { recursive: true });
+    // 读取现有配置并合并
+    const existing = await readJsonConfig(configPath);
+    // 仅合并非 undefined 的字段
+    const merged = { ...existing };
+    if (config.apiEndpoint !== undefined)
+        merged['apiEndpoint'] = config.apiEndpoint;
+    if (config.modelName !== undefined)
+        merged['modelName'] = config.modelName;
+    if (config.apiKey !== undefined)
+        merged['apiKey'] = config.apiKey;
+    await fs.writeFile(configPath, JSON.stringify(merged, null, 2), 'utf-8');
+}
+/**
+ * 验证 LLM 配置的完整性。
+ *
+ * @param config - 待验证的配置
+ * @returns 错误消息数组。若为空数组，则配置有效。
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (!config.apiKey || config.apiKey.trim().length === 0) {
+        errors.push('缺少 API 密钥 (apiKey)。请通过环境变量 REPOWIKI_API_KEY 或全局配置文件设置。');
+    }
+    if (!config.apiEndpoint || config.apiEndpoint.trim().length === 0) {
+        errors.push('缺少 API 端点 (apiEndpoint)。');
+    }
+    if (!config.modelName || config.modelName.trim().length === 0) {
+        errors.push('缺少模型名称 (modelName)。');
+    }
+    // 验证 apiEndpoint 是合法 URL
+    if (config.apiEndpoint && config.apiEndpoint.trim().length > 0) {
+        try {
+            new URL(config.apiEndpoint);
+        }
+        catch {
+            errors.push(`API 端点格式无效: "${config.apiEndpoint}"。请提供合法的 URL。`);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=auth-manager.js.map

package/dist/llm/auth-manager.js.map

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

package/dist/llm/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module llm
+ * @description LLM 层入口 - 统一导出认证管理、客户端和提示词管理功能。
+ */
+export type { LLMConfig } from './auth-manager.js';
+export { loadLLMConfig, saveGlobalConfig, validateConfig } from './auth-manager.js';
+export type { ChatMessage, LLMClientOptions, LLMResponse, ChatOptions } from './llm-client.js';
+export { LLMClient, LLMError, LLMAuthError, LLMRateLimitError, LLMJsonParseError } from './llm-client.js';
+export { buildModuleAnalysisPrompt, buildMermaidPrompt, buildWikiPagePrompt, buildWikiPlanPrompt, buildSourceSummaryPrompt, } from './prompt-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGpF,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAG1G,OAAO,EACH,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,9 @@
+/**
+ * @module llm
+ * @description LLM 层入口 - 统一导出认证管理、客户端和提示词管理功能。
+ */
+export { loadLLMConfig, saveGlobalConfig, validateConfig } from './auth-manager.js';
+export { LLMClient, LLMError, LLMAuthError, LLMRateLimitError, LLMJsonParseError } from './llm-client.js';
+// 提示词管理
+export { buildModuleAnalysisPrompt, buildMermaidPrompt, buildWikiPagePrompt, buildWikiPlanPrompt, buildSourceSummaryPrompt, } from './prompt-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIpF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1G,QAAQ;AACR,OAAO,EACH,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/llm/llm-client.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @module llm-client
+ * @description OpenAI 兼容的 LLM API 客户端。
+ *
+ * 特性:
+ * - 使用原生 fetch (Node 18+)
+ * - 指数退避重试 (429 / 5xx)
+ * - AbortController 超时控制
+ * - chatJSON: 自动解析 JSON 响应并可选 Zod 校验
+ */
+import { z } from 'zod';
+import type { LLMConfig } from './auth-manager.js';
+/** 聊天消息 */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** LLM 客户端选项 */
+export interface LLMClientOptions {
+    /** LLM 服务配置 */
+    config: LLMConfig;
+    /** 最大重试次数 (默认 3) */
+    maxRetries?: number;
+    /** 基础重试延迟，毫秒 (默认 1000) */
+    retryDelayMs?: number;
+    /** 请求超时，毫秒 (默认 120000，即 2 分钟) */
+    timeoutMs?: number;
+}
+/** LLM 响应 */
+export interface LLMResponse {
+    /** 模型回复的文本内容 */
+    content: string;
+    /** Token 使用统计 */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** chat 方法可选参数 */
+export interface ChatOptions {
+    /** 温度，控制随机性 (默认 0.3) */
+    temperature?: number;
+    /** 最大生成 token 数 */
+    maxTokens?: number;
+}
+/** LLM 请求错误基类 */
+export declare class LLMError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, responseBody?: string | undefined);
+}
+/** 认证错误 (401 / 403) */
+export declare class LLMAuthError extends LLMError {
+    constructor(message: string, statusCode: number, responseBody?: string);
+}
+/** 速率限制错误 (429) */
+export declare class LLMRateLimitError extends LLMError {
+    constructor(message: string, responseBody?: string);
+}
+/** JSON 解析错误 */
+export declare class LLMJsonParseError extends LLMError {
+    readonly rawContent: string;
+    constructor(message: string, rawContent: string);
+}
+/**
+ * OpenAI 兼容的 LLM 客户端。
+ *
+ * @example
+ * ```ts
+ * const client = new LLMClient({ config });
+ * const response = await client.chat([
+ *     { role: 'system', content: '你是一个助手。' },
+ *     { role: 'user', content: '你好' },
+ * ]);
+ * console.log(response.content);
+ * ```
+ */
+export declare class LLMClient {
+    private readonly config;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private readonly timeoutMs;
+    constructor(options: LLMClientOptions);
+    /**
+     * 发送聊天补全请求。
+     *
+     * @param messages - 聊天消息列表
+     * @param options  - 可选参数（温度、最大 token 数）
+     * @returns LLM 响应
+     * @throws {LLMAuthError} 认证失败
+     * @throws {LLMRateLimitError} 速率限制（重试耗尽后）
+     * @throws {LLMError} 其他请求错误
+     */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<LLMResponse>;
+    /**
+     * 发送聊天请求并将响应解析为 JSON。
+     *
+     * 工作流程:
+     * 1. 调用 chat() 获取文本响应
+     * 2. 尝试解析 JSON（支持从 Markdown 代码块中提取）
+     * 3. 若提供了 Zod schema，进行运行时校验
+     * 4. 若 JSON 解析失败，追加修正提示后重试一次
+     *
+     * @param messages - 聊天消息列表
+     * @param schema   - 可选的 Zod 校验 schema
+     * @returns 解析后的 JSON 对象
+     * @throws {LLMJsonParseError} JSON 解析或校验失败
+     */
+    chatJSON<T = unknown>(messages: ChatMessage[], schema?: z.ZodType<T>): Promise<T>;
+    /**
+     * 构建 OpenAI 兼容的请求体
+     */
+    private buildRequestBody;
+    /**
+     * 带超时控制的 fetch 请求
+     */
+    private fetchWithTimeout;
+    /**
+     * 根据 HTTP 状态码抛出对应错误
+     */
+    private handleErrorStatus;
+    /**
+     * 从 OpenAI 兼容响应中解析内容和 usage
+     */
+    private parseResponse;
+    /**
+     * 验证 JSON 响应：解析 + 可选 Zod 校验
+     */
+    private validateJsonResponse;
+}
+//# sourceMappingURL=llm-client.d.ts.map

package/dist/llm/llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/llm/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,WAAW;AACX,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC7B,eAAe;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,oBAAoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,WAAW;IACxB,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,CAAC,EAAE;QACJ,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAED,kBAAkB;AAClB,MAAM,WAAW,WAAW;IACxB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,iBAAiB;AACjB,qBAAa,QAAS,SAAQ,KAAK;aAGX,UAAU,CAAC,EAAE,MAAM;aACnB,YAAY,CAAC,EAAE,MAAM;gBAFrC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,YAAY,CAAC,EAAE,MAAM,YAAA;CAK5C;AAED,uBAAuB;AACvB,qBAAa,YAAa,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAIzE;AAED,mBAAmB;AACnB,qBAAa,iBAAkB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAIrD;AAED,gBAAgB;AAChB,qBAAa,iBAAkB,SAAQ,QAAQ;aAGvB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKzC;AAmDD;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,gBAAgB;IAOrC;;;;;;;;;OASG;IACG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAwChF;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqCvF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;YACW,gBAAgB;IAuC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;YACW,aAAa;IAyB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAgB/B"}

package/dist/llm/llm-client.js

@@ -0,0 +1,308 @@
+/**
+ * @module llm-client
+ * @description OpenAI 兼容的 LLM API 客户端。
+ *
+ * 特性:
+ * - 使用原生 fetch (Node 18+)
+ * - 指数退避重试 (429 / 5xx)
+ * - AbortController 超时控制
+ * - chatJSON: 自动解析 JSON 响应并可选 Zod 校验
+ */
+// ============================================================================
+// 错误类
+// ============================================================================
+/** LLM 请求错误基类 */
+export class LLMError extends Error {
+    statusCode;
+    responseBody;
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.name = 'LLMError';
+    }
+}
+/** 认证错误 (401 / 403) */
+export class LLMAuthError extends LLMError {
+    constructor(message, statusCode, responseBody) {
+        super(message, statusCode, responseBody);
+        this.name = 'LLMAuthError';
+    }
+}
+/** 速率限制错误 (429) */
+export class LLMRateLimitError extends LLMError {
+    constructor(message, responseBody) {
+        super(message, 429, responseBody);
+        this.name = 'LLMRateLimitError';
+    }
+}
+/** JSON 解析错误 */
+export class LLMJsonParseError extends LLMError {
+    rawContent;
+    constructor(message, rawContent) {
+        super(message);
+        this.rawContent = rawContent;
+        this.name = 'LLMJsonParseError';
+    }
+}
+// ============================================================================
+// 内部工具函数
+// ============================================================================
+/** 可重试的 HTTP 状态码 */
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503]);
+/**
+ * 延迟指定毫秒
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 尝试从 Markdown 代码块中提取 JSON 字符串。
+ * 匹配 ```json ... ``` 或 ``` ... ``` 格式。
+ */
+function extractJsonFromMarkdown(text) {
+    // 匹配 ```json\n...\n``` 或 ```\n...\n```
+    const fencePattern = /```(?:json)?\s*\n([\s\S]*?)\n\s*```/;
+    const match = text.match(fencePattern);
+    if (match?.[1]) {
+        return match[1].trim();
+    }
+    return null;
+}
+/**
+ * 尝试解析 JSON 字符串，失败时尝试从 Markdown 代码块中提取再解析。
+ */
+function parseJsonSafe(text) {
+    // 首先直接尝试解析
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // 尝试从代码块提取
+        const extracted = extractJsonFromMarkdown(text);
+        if (extracted) {
+            return JSON.parse(extracted);
+        }
+        throw new Error(`无法解析 JSON 内容`);
+    }
+}
+// ============================================================================
+// LLMClient 类
+// ============================================================================
+/**
+ * OpenAI 兼容的 LLM 客户端。
+ *
+ * @example
+ * ```ts
+ * const client = new LLMClient({ config });
+ * const response = await client.chat([
+ *     { role: 'system', content: '你是一个助手。' },
+ *     { role: 'user', content: '你好' },
+ * ]);
+ * console.log(response.content);
+ * ```
+ */
+export class LLMClient {
+    config;
+    maxRetries;
+    retryDelayMs;
+    timeoutMs;
+    constructor(options) {
+        this.config = options.config;
+        this.maxRetries = options.maxRetries ?? 3;
+        this.retryDelayMs = options.retryDelayMs ?? 1000;
+        this.timeoutMs = options.timeoutMs ?? 120_000;
+    }
+    /**
+     * 发送聊天补全请求。
+     *
+     * @param messages - 聊天消息列表
+     * @param options  - 可选参数（温度、最大 token 数）
+     * @returns LLM 响应
+     * @throws {LLMAuthError} 认证失败
+     * @throws {LLMRateLimitError} 速率限制（重试耗尽后）
+     * @throws {LLMError} 其他请求错误
+     */
+    async chat(messages, options) {
+        const url = `${this.config.apiEndpoint.replace(/\/+$/, '')}/chat/completions`;
+        const body = this.buildRequestBody(messages, options);
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            // 非首次请求时等待（指数退避）
+            if (attempt > 0) {
+                const delay = this.retryDelayMs * Math.pow(2, attempt - 1);
+                await sleep(delay);
+            }
+            try {
+                const response = await this.fetchWithTimeout(url, body);
+                return this.parseResponse(response);
+            }
+            catch (error) {
+                lastError = error;
+                // 认证错误不重试
+                if (error instanceof LLMAuthError) {
+                    throw error;
+                }
+                // 非可重试错误不重试
+                if (error instanceof LLMError && error.statusCode && !RETRYABLE_STATUS_CODES.has(error.statusCode)) {
+                    throw error;
+                }
+                // 最后一次重试仍然失败
+                if (attempt === this.maxRetries) {
+                    break;
+                }
+            }
+        }
+        // 重试耗尽
+        throw lastError ?? new LLMError('LLM 请求失败: 未知错误');
+    }
+    /**
+     * 发送聊天请求并将响应解析为 JSON。
+     *
+     * 工作流程:
+     * 1. 调用 chat() 获取文本响应
+     * 2. 尝试解析 JSON（支持从 Markdown 代码块中提取）
+     * 3. 若提供了 Zod schema，进行运行时校验
+     * 4. 若 JSON 解析失败，追加修正提示后重试一次
+     *
+     * @param messages - 聊天消息列表
+     * @param schema   - 可选的 Zod 校验 schema
+     * @returns 解析后的 JSON 对象
+     * @throws {LLMJsonParseError} JSON 解析或校验失败
+     */
+    async chatJSON(messages, schema) {
+        // 第一次尝试
+        const response = await this.chat(messages);
+        try {
+            return this.validateJsonResponse(response.content, schema);
+        }
+        catch (firstError) {
+            // JSON 解析或校验失败，追加修正提示后重试
+            const fixMessages = [
+                ...messages,
+                { role: 'assistant', content: response.content },
+                {
+                    role: 'user',
+                    content: '你上次的回复不是合法的 JSON 格式。请严格按照要求只输出合法的 JSON，' +
+                        '不要在 JSON 前后添加任何额外文字或 Markdown 格式标记。' +
+                        (firstError instanceof Error ? `\n错误信息: ${firstError.message}` : ''),
+                },
+            ];
+            const retryResponse = await this.chat(fixMessages);
+            try {
+                return this.validateJsonResponse(retryResponse.content, schema);
+            }
+            catch (secondError) {
+                throw new LLMJsonParseError(`JSON 解析失败（已重试）: ${secondError instanceof Error ? secondError.message : '未知错误'}`, retryResponse.content);
+            }
+        }
+    }
+    // ========================================================================
+    // 私有方法
+    // ========================================================================
+    /**
+     * 构建 OpenAI 兼容的请求体
+     */
+    buildRequestBody(messages, options) {
+        const payload = {
+            model: this.config.modelName,
+            messages: messages.map((m) => ({ role: m.role, content: m.content })),
+            temperature: options?.temperature ?? 0.3,
+        };
+        if (options?.maxTokens !== undefined) {
+            payload['max_tokens'] = options.maxTokens;
+        }
+        return JSON.stringify(payload);
+    }
+    /**
+     * 带超时控制的 fetch 请求
+     */
+    async fetchWithTimeout(url, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body,
+                signal: controller.signal,
+            });
+            // 处理错误状态码
+            if (!response.ok) {
+                const responseBody = await response.text().catch(() => '');
+                this.handleErrorStatus(response.status, responseBody);
+            }
+            return response;
+        }
+        catch (error) {
+            if (error instanceof LLMError) {
+                throw error;
+            }
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new LLMError(`请求超时 (${this.timeoutMs}ms)`);
+            }
+            throw new LLMError(`网络请求失败: ${error instanceof Error ? error.message : '未知错误'}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * 根据 HTTP 状态码抛出对应错误
+     */
+    handleErrorStatus(status, responseBody) {
+        // 尝试从响应体中提取错误消息
+        let detail = '';
+        try {
+            const parsed = JSON.parse(responseBody);
+            detail = parsed?.error?.message ?? '';
+        }
+        catch {
+            detail = responseBody.slice(0, 200);
+        }
+        if (status === 401 || status === 403) {
+            throw new LLMAuthError(`认证失败 (HTTP ${status}): ${detail || 'API 密钥无效或已过期'}`, status, responseBody);
+        }
+        if (status === 429) {
+            throw new LLMRateLimitError(`请求速率超限 (HTTP 429): ${detail || '请稍后重试'}`, responseBody);
+        }
+        throw new LLMError(`API 请求失败 (HTTP ${status}): ${detail || '未知错误'}`, status, responseBody);
+    }
+    /**
+     * 从 OpenAI 兼容响应中解析内容和 usage
+     */
+    async parseResponse(response) {
+        const json = (await response.json());
+        const content = json.choices?.[0]?.message?.content ?? '';
+        const result = { content };
+        if (json.usage) {
+            result.usage = {
+                promptTokens: json.usage.prompt_tokens ?? 0,
+                completionTokens: json.usage.completion_tokens ?? 0,
+                totalTokens: json.usage.total_tokens ?? 0,
+            };
+        }
+        return result;
+    }
+    /**
+     * 验证 JSON 响应：解析 + 可选 Zod 校验
+     */
+    validateJsonResponse(content, schema) {
+        const parsed = parseJsonSafe(content);
+        if (schema) {
+            const result = schema.safeParse(parsed);
+            if (!result.success) {
+                const issues = result.error.issues
+                    .map((i) => `  - ${i.path.join('.')}: ${i.message}`)
+                    .join('\n');
+                throw new Error(`JSON 数据校验失败:\n${issues}`);
+            }
+            return result.data;
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/llm/llm-client.js.map

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