v2er-insight 1.0.0

package/dist/cli/workflow/recovery.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecoveryActions = getRecoveryActions;
+/**
+ * 统一维护原因码到恢复动作的映射，避免恢复命令散落在各命令实现中。
+ */
+const RECOVERY_MAP = {
+    FETCH_PROFILE_FAILED: [
+        {
+            type: 'command',
+            content: 'v2er fetch <username> --force',
+            description: '重新抓取 <username> 的用户资料并覆盖损坏缓存',
+        },
+    ],
+    FETCH_PARTIAL_FAILED: [
+        {
+            type: 'instruction',
+            content: '当前版本暂不支持仅重试失败页',
+            description: '建议先执行全量重抓，后续阶段会接入 --retry 能力',
+        },
+        {
+            type: 'command',
+            content: 'v2er fetch <username> --force',
+            description: '强制重新抓取，替换现有 raw 数据',
+        },
+    ],
+    ANALYZE_INPUT_MISSING: [
+        {
+            type: 'command',
+            content: 'v2er fetch <username>',
+            description: '先生成 raw.json，再执行 analyze',
+        },
+    ],
+    ANALYZE_FAILED: [
+        {
+            type: 'command',
+            content: 'v2er analyze <username>',
+            description: '修复数据问题后重试 analyze 步骤',
+        },
+        {
+            type: 'command',
+            content: 'v2er fetch <username> --force',
+            description: '若 raw 数据可能损坏，先强制重新抓取再分析',
+        },
+    ],
+    AI_INPUT_MISSING: [
+        {
+            type: 'command',
+            content: 'v2er analyze <username>',
+            description: '先生成 analyzed.json，再执行 AI 分析',
+        },
+    ],
+    AI_API_KEY_MISSING: [
+        {
+            type: 'instruction',
+            content: '先在环境变量或配置文件中设置 API Key',
+            description: '当前缺少 AI API Key，无法发起 AI 请求',
+        },
+        {
+            type: 'command',
+            content: 'v2er ai <username>',
+            description: '完成 API Key 配置后重试 AI 步骤',
+        },
+    ],
+    AI_INVALID_THINKING_LEVEL: [
+        {
+            type: 'instruction',
+            content: '将 thinking-level 调整为 minimal | low | medium | high 之一',
+            description: '当前传入的思考等级不合法，需使用受支持的枚举值',
+        },
+        {
+            type: 'command',
+            content: 'v2er ai <username> --thinking-level medium',
+            description: '使用合法思考等级重试 AI 步骤',
+        },
+        {
+            type: 'command',
+            content: 'v2er config set ai.thinkingLevel medium',
+            description: '修正全局默认 thinkingLevel，避免后续重复报错',
+        },
+    ],
+    AI_PROVIDER_FAILED: [
+        {
+            type: 'instruction',
+            content: '常见原因：网络或代理异常、请求限流(429)、模型不可用、响应格式异常',
+            description: '请先结合错误信息定位原因，再执行对应恢复动作',
+        },
+        {
+            type: 'command',
+            content: 'v2er config proxy <url>',
+            description: '网络受限时先配置代理后再重试',
+        },
+        {
+            type: 'command',
+            content: 'v2er ai <username>',
+            description: '在已存在 analyzed.json 时直接重试 AI 步骤',
+        },
+        {
+            type: 'command',
+            content: 'v2er ai <username> --model gemini-2.0-flash',
+            description: '若当前模型不稳定，可切换模型后重试',
+        },
+    ],
+    SHOW_RESULT_MISSING: [
+        {
+            type: 'command',
+            content: 'v2er ai <username>',
+            description: '先生成 result.json，再执行展示',
+        },
+    ],
+    UNKNOWN_ERROR: [],
+};
+/**
+ * 渲染恢复动作中的模板变量（如 <username>）。
+ */
+function renderTemplate(content, context) {
+    if (!context.username)
+        return content;
+    return content.replace(/<username>/g, context.username);
+}
+/**
+ * 获取指定原因码对应的恢复动作列表，并按上下文渲染模板变量。
+ */
+function getRecoveryActions(reasonCode, context = {}) {
+    if (!reasonCode)
+        return [];
+    const actions = RECOVERY_MAP[reasonCode] ?? [];
+    return actions.map((action) => ({
+        ...action,
+        content: renderTemplate(action.content, context),
+        description: renderTemplate(action.description, context),
+    }));
+}
+//# sourceMappingURL=recovery.js.map

package/dist/cli/workflow/state.d.ts

@@ -0,0 +1,19 @@
+import type { WorkflowState, WorkflowStep } from './types';
+/**
+ * 检测用户本地工作流产物状态。
+ *
+ * 这里只做"文件是否存在"的轻量判断，不读取和解析 JSON 内容。
+ * 具体的数据缺失或结构错误由各步骤命令自行处理并返回 reasonCode。
+ */
+export declare function detectWorkflowState(username: string): WorkflowState;
+/**
+ * 根据当前状态推导入口步骤。
+ *
+ * 当 `force=true` 时，无条件从 `fetch` 开始执行全流程。
+ */
+export declare function resolveEntryStep(state: WorkflowState, force?: boolean): WorkflowStep;
+/**
+ * 根据入口步骤生成线性执行计划。
+ */
+export declare function buildExecutionPlan(entryStep: WorkflowStep): WorkflowStep[];
+//# sourceMappingURL=state.d.ts.map

package/dist/cli/workflow/state.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectWorkflowState = detectWorkflowState;
+exports.resolveEntryStep = resolveEntryStep;
+exports.buildExecutionPlan = buildExecutionPlan;
+const fs_1 = require("fs");
+const paths_1 = require("../../infra/storage/paths");
+/**
+ * 检测用户本地工作流产物状态。
+ *
+ * 这里只做"文件是否存在"的轻量判断，不读取和解析 JSON 内容。
+ * 具体的数据缺失或结构错误由各步骤命令自行处理并返回 reasonCode。
+ */
+function detectWorkflowState(username) {
+    const hasRaw = (0, fs_1.existsSync)((0, paths_1.getDataFilePath)(username, 'raw'));
+    const hasAnalyzed = (0, fs_1.existsSync)((0, paths_1.getDataFilePath)(username, 'analyzed'));
+    const hasResult = (0, fs_1.existsSync)((0, paths_1.getDataFilePath)(username, 'result'));
+    return { hasRaw, hasAnalyzed, hasResult };
+}
+/**
+ * 根据当前状态推导入口步骤。
+ *
+ * 当 `force=true` 时，无条件从 `fetch` 开始执行全流程。
+ */
+function resolveEntryStep(state, force = false) {
+    if (force)
+        return 'fetch';
+    if (state.hasResult)
+        return 'show';
+    if (state.hasAnalyzed)
+        return 'ai';
+    if (state.hasRaw)
+        return 'analyze';
+    return 'fetch';
+}
+/** 固定步骤顺序，作为执行计划的唯一数据源 */
+const STEP_ORDER = ['fetch', 'analyze', 'ai', 'show'];
+/**
+ * 根据入口步骤生成线性执行计划。
+ */
+function buildExecutionPlan(entryStep) {
+    const index = STEP_ORDER.indexOf(entryStep);
+    return index === -1 ? [...STEP_ORDER] : STEP_ORDER.slice(index);
+}
+//# sourceMappingURL=state.js.map

package/dist/cli/workflow/types.d.ts

@@ -0,0 +1,60 @@
+import type { ThinkingLevel } from '../../config';
+/**
+ * Workflow 层共享类型定义
+ */
+/** 全流程固定步骤名称 */
+export type WorkflowStep = 'fetch' | 'analyze' | 'ai' | 'show';
+/** 单步骤执行状态 */
+export type StepStatus = 'success' | 'partial' | 'failed' | 'skipped';
+/** 统一错误/诊断原因码 */
+export type ReasonCode = 'FETCH_PROFILE_FAILED' | 'FETCH_PARTIAL_FAILED' | 'ANALYZE_INPUT_MISSING' | 'ANALYZE_FAILED' | 'AI_INPUT_MISSING' | 'AI_API_KEY_MISSING' | 'AI_INVALID_THINKING_LEVEL' | 'AI_PROVIDER_FAILED' | 'SHOW_RESULT_MISSING' | 'UNKNOWN_ERROR';
+/** 步骤失败或部分成功时可提供给用户的恢复动作 */
+export interface RecoveryAction {
+    /** 动作类型：可执行命令或人工操作指引 */
+    type: 'command' | 'instruction';
+    /** 动作内容：命令文本或操作说明 */
+    content: string;
+    /** 动作用途说明 */
+    description: string;
+}
+/** 单个步骤的结构化执行结果 */
+export interface StepRunResult {
+    /** 当前结果对应的步骤 */
+    step: WorkflowStep;
+    /** 步骤最终状态 */
+    status: StepStatus;
+    /** 非 success 状态下的原因码 */
+    reasonCode?: ReasonCode;
+    /** 面向用户的简短提示 */
+    message?: string;
+    /** 是否可通过恢复动作继续处理 */
+    recoverable?: boolean;
+    /** 恢复动作列表（按建议顺序） */
+    recoverActions?: RecoveryAction[];
+    /** 额外元数据，用于编排判断或后续重试 */
+    meta?: Record<string, unknown>;
+}
+/** 本地中间产物状态 */
+export interface WorkflowState {
+    hasRaw: boolean;
+    hasAnalyzed: boolean;
+    hasResult: boolean;
+}
+/** 工作流最终聚合状态 */
+export type WorkflowOverallStatus = 'success' | 'partial' | 'failed';
+/** 一键工作流入口参数 */
+export interface RunWorkflowOptions {
+    username: string;
+    force?: boolean;
+    model?: string;
+    thinkingLevel?: ThinkingLevel;
+    verbose?: boolean;
+}
+/** 一键工作流执行结果 */
+export interface RunOutcome {
+    overallStatus: WorkflowOverallStatus;
+    exitCode: 0 | 1;
+    failedStep?: WorkflowStep;
+    results: StepRunResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/workflow/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/config/defaults.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 配置默认值
+ *
+ * 定义所有配置项的默认值。
+ * getConfig() 会将用户设置覆盖到这些默认值上。
+ *
+ * 注意：
+ * - proxy、ai.apiKey 无默认值，必须由用户设置
+ * - 各模块内部的 config.ts 硬编码值应与此保持一致
+ */
+import type { V2erConfig } from './types';
+/**
+ * 合并默认值后的配置类型
+ * - 对象类型的字段（如 ai、fetch）：所有子字段变为必填
+ * - 原始类型的字段（如 proxy）：key 必须存在，但值仍可能为 undefined
+ */
+export type ResolvedConfig = Required<{
+    [K in keyof V2erConfig]: V2erConfig[K] extends object | undefined ? Required<NonNullable<V2erConfig[K]>> : V2erConfig[K];
+}>;
+/** 全局默认配置 */
+export declare const DEFAULT_CONFIG: {
+    readonly ai: {
+        readonly provider: "gemini";
+        readonly model: "gemini-3-pro-preview";
+        readonly thinkingLevel: "high";
+        readonly timeout: 60000;
+        readonly maxRetries: 3;
+        readonly baseDelay: 1000;
+        readonly maxDelay: 10000;
+    };
+    readonly fetch: {
+        readonly timeout: 30000;
+    };
+    readonly analyzer: {
+        readonly inactivityThreshold: 60;
+        readonly chunkMaxTopics: 20;
+        readonly chunkMaxReplies: 100;
+        readonly nodeDistributionTopN: 3;
+    };
+    readonly data: {
+        readonly keepRaw: false;
+        readonly rawRetention: 1;
+    };
+    readonly log: {
+        readonly level: "info";
+    };
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * 配置默认值
+ *
+ * 定义所有配置项的默认值。
+ * getConfig() 会将用户设置覆盖到这些默认值上。
+ *
+ * 注意：
+ * - proxy、ai.apiKey 无默认值，必须由用户设置
+ * - 各模块内部的 config.ts 硬编码值应与此保持一致
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+/** 全局默认配置 */
+exports.DEFAULT_CONFIG = {
+    ai: {
+        provider: 'gemini',
+        model: 'gemini-3-pro-preview',
+        thinkingLevel: 'high',
+        timeout: 60000,
+        maxRetries: 3,
+        baseDelay: 1000,
+        maxDelay: 10000,
+    },
+    fetch: {
+        timeout: 30000,
+    },
+    analyzer: {
+        inactivityThreshold: 60,
+        chunkMaxTopics: 20,
+        chunkMaxReplies: 100,
+        nodeDistributionTopN: 3,
+    },
+    data: {
+        keepRaw: false,
+        rawRetention: 1,
+    },
+    log: {
+        level: 'info',
+    },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 配置模块公共导出
+ */
+export type { V2erConfig } from './types';
+export type { AIConfig, ThinkingLevel } from './types/ai';
+export { THINKING_LEVELS } from './types/ai';
+export type { FetchConfig } from './types/fetch';
+export type { AnalyzerConfig } from './types/analyzer';
+export type { DataConfig } from './types/data';
+export type { LogConfig } from './types/log';
+export type { LogLevel } from '../infra/logger';
+export { getConfigDir, getConfigPath } from './path';
+export { readConfig, writeConfig, getConfig } from './storage';
+export { DEFAULT_CONFIG } from './defaults';
+export { getProxyUrl, initFetchProxy } from './proxy';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * 配置模块公共导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initFetchProxy = exports.getProxyUrl = exports.DEFAULT_CONFIG = exports.getConfig = exports.writeConfig = exports.readConfig = exports.getConfigPath = exports.getConfigDir = exports.THINKING_LEVELS = void 0;
+var ai_1 = require("./types/ai");
+Object.defineProperty(exports, "THINKING_LEVELS", { enumerable: true, get: function () { return ai_1.THINKING_LEVELS; } });
+var path_1 = require("./path");
+Object.defineProperty(exports, "getConfigDir", { enumerable: true, get: function () { return path_1.getConfigDir; } });
+Object.defineProperty(exports, "getConfigPath", { enumerable: true, get: function () { return path_1.getConfigPath; } });
+var storage_1 = require("./storage");
+Object.defineProperty(exports, "readConfig", { enumerable: true, get: function () { return storage_1.readConfig; } });
+Object.defineProperty(exports, "writeConfig", { enumerable: true, get: function () { return storage_1.writeConfig; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return storage_1.getConfig; } });
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return defaults_1.DEFAULT_CONFIG; } });
+var proxy_1 = require("./proxy");
+Object.defineProperty(exports, "getProxyUrl", { enumerable: true, get: function () { return proxy_1.getProxyUrl; } });
+Object.defineProperty(exports, "initFetchProxy", { enumerable: true, get: function () { return proxy_1.initFetchProxy; } });
+//# sourceMappingURL=index.js.map

package/dist/config/path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 配置文件路径解析
+ *
+ * 配置目录：~/.v2er-insight/
+ * 配置文件：~/.v2er-insight/config.json
+ */
+/** 返回配置目录路径 */
+export declare function getConfigDir(): string;
+/** 返回配置文件完整路径 */
+export declare function getConfigPath(): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/config/path.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * 配置文件路径解析
+ *
+ * 配置目录：~/.v2er-insight/
+ * 配置文件：~/.v2er-insight/config.json
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigDir = getConfigDir;
+exports.getConfigPath = getConfigPath;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/** 配置目录名 */
+const CONFIG_DIR = '.v2er-insight';
+/** 配置文件名 */
+const CONFIG_FILE = 'config.json';
+/** 返回配置目录路径 */
+function getConfigDir() {
+    return path_1.default.join(os_1.default.homedir(), CONFIG_DIR);
+}
+/** 返回配置文件完整路径 */
+function getConfigPath() {
+    return path_1.default.join(getConfigDir(), CONFIG_FILE);
+}
+//# sourceMappingURL=path.js.map

package/dist/config/proxy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 获取代理 URL
+ * 优先级：配置文件 > HTTPS_PROXY > HTTP_PROXY
+ */
+export declare function getProxyUrl(): string | undefined;
+/**
+ * 为原生 fetch() 初始化代理
+ *
+ * 通过 undici 的 setGlobalDispatcher 设置全局代理，
+ * 使 @google/genai 等使用原生 fetch() 的库走配置的代理。
+ * 不影响 Axios 请求（Fetcher 模块仍使用自己的 httpsAgent）。
+ *
+ * 应在 CLI 入口处调用一次。
+ */
+export declare function initFetchProxy(): void;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/config/proxy.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProxyUrl = getProxyUrl;
+exports.initFetchProxy = initFetchProxy;
+const undici_1 = require("undici");
+const storage_1 = require("./storage");
+const logger_1 = require("../infra/logger");
+/**
+ * 获取代理 URL
+ * 优先级：配置文件 > HTTPS_PROXY > HTTP_PROXY
+ */
+function getProxyUrl() {
+    const config = (0, storage_1.readConfig)();
+    return config.proxy || process.env.HTTPS_PROXY || process.env.HTTP_PROXY;
+}
+/**
+ * 为原生 fetch() 初始化代理
+ *
+ * 通过 undici 的 setGlobalDispatcher 设置全局代理，
+ * 使 @google/genai 等使用原生 fetch() 的库走配置的代理。
+ * 不影响 Axios 请求（Fetcher 模块仍使用自己的 httpsAgent）。
+ *
+ * 应在 CLI 入口处调用一次。
+ */
+function initFetchProxy() {
+    const proxyUrl = getProxyUrl();
+    if (!proxyUrl)
+        return;
+    try {
+        (0, undici_1.setGlobalDispatcher)(new undici_1.ProxyAgent(proxyUrl));
+        logger_1.logger.debug(`已为原生 fetch 设置代理: ${proxyUrl}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.warn(`代理初始化失败 (${proxyUrl}): ${message}`);
+        logger_1.logger.warn('AI 请求将不使用代理，直接连接');
+    }
+}
+//# sourceMappingURL=proxy.js.map

package/dist/config/storage.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 配置存储
+ *
+ * 提供读写配置文件和合并默认值的逻辑。
+ * getConfig() 是对外的主要入口，返回默认值与用户设置合并后的完整配置。
+ */
+import type { V2erConfig } from './types';
+/**
+ * 读取并解析用户配置文件
+ * 若文件不存在或解析失败，返回空对象
+ */
+export declare function readConfig(): V2erConfig;
+/**
+ * 将配置写入文件
+ * 自动创建配置目录，使用 0600 权限（Linux/Mac）
+ */
+export declare function writeConfig(config: V2erConfig): void;
+/**
+ * 获取合并后的完整配置（默认值 + 用户设置）
+ * 用户设置会覆盖默认值中的同名字段
+ */
+export declare function getConfig(): V2erConfig;
+//# sourceMappingURL=storage.d.ts.map

package/dist/config/storage.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * 配置存储
+ *
+ * 提供读写配置文件和合并默认值的逻辑。
+ * getConfig() 是对外的主要入口，返回默认值与用户设置合并后的完整配置。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readConfig = readConfig;
+exports.writeConfig = writeConfig;
+exports.getConfig = getConfig;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = require("./path");
+const defaults_1 = require("./defaults");
+// -- 内部工具 ----------------------------------------------------------------
+/**
+ * 深合并两个对象（仅处理普通对象，不处理数组）
+ * target 的值会被 source 中的非 undefined 值覆盖
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceVal = source[key];
+        const targetVal = target[key];
+        if (sourceVal === undefined)
+            continue;
+        if (typeof sourceVal === 'object' &&
+            sourceVal !== null &&
+            !Array.isArray(sourceVal) &&
+            typeof targetVal === 'object' &&
+            targetVal !== null &&
+            !Array.isArray(targetVal)) {
+            result[key] = deepMerge(targetVal, sourceVal);
+        }
+        else {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+// -- 公共 API ----------------------------------------------------------------
+/**
+ * 读取并解析用户配置文件
+ * 若文件不存在或解析失败，返回空对象
+ */
+function readConfig() {
+    const configPath = (0, path_1.getConfigPath)();
+    if (!fs_1.default.existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const content = fs_1.default.readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 将配置写入文件
+ * 自动创建配置目录，使用 0600 权限（Linux/Mac）
+ */
+function writeConfig(config) {
+    const configDir = (0, path_1.getConfigDir)();
+    const configPath = (0, path_1.getConfigPath)();
+    if (!fs_1.default.existsSync(configDir)) {
+        fs_1.default.mkdirSync(configDir, { recursive: true });
+    }
+    fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2), {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+}
+/**
+ * 获取合并后的完整配置（默认值 + 用户设置）
+ * 用户设置会覆盖默认值中的同名字段
+ */
+function getConfig() {
+    const userConfig = readConfig();
+    return deepMerge({ ...defaults_1.DEFAULT_CONFIG }, userConfig);
+}
+//# sourceMappingURL=storage.js.map

package/dist/config/types/ai.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AI 模块配置类型
+ *
+ * ThinkingLevel 使用小写值，与 @google/genai SDK 内部类型一致。
+ * SDK 导出的枚举值（如 ThinkingLevel.HIGH = "HIGH"）用于 API 调用，
+ * 但配置文件面向用户，使用小写更友好。
+ */
+/** 合法的思考水平值（运行时校验用） */
+export declare const THINKING_LEVELS: readonly ["minimal", "low", "medium", "high"];
+/** 思考水平类型（从 THINKING_LEVELS 派生，保证类型与运行时一致） */
+export type ThinkingLevel = (typeof THINKING_LEVELS)[number];
+/** AI 模块配置 */
+export interface AIConfig {
+    /** AI 提供商（目前仅支持 gemini） */
+    provider?: string;
+    /** API 密钥 */
+    apiKey?: string;
+    /** 模型名称 */
+    model?: string;
+    /** 思考水平 */
+    thinkingLevel?: ThinkingLevel;
+    /** AI 请求超时（毫秒） */
+    timeout?: number;
+    /** 最大重试次数 */
+    maxRetries?: number;
+    /** 重试基础延迟（毫秒） */
+    baseDelay?: number;
+    /** 重试最大延迟（毫秒） */
+    maxDelay?: number;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/config/types/ai.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * AI 模块配置类型
+ *
+ * ThinkingLevel 使用小写值，与 @google/genai SDK 内部类型一致。
+ * SDK 导出的枚举值（如 ThinkingLevel.HIGH = "HIGH"）用于 API 调用，
+ * 但配置文件面向用户，使用小写更友好。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THINKING_LEVELS = void 0;
+/** 合法的思考水平值（运行时校验用） */
+exports.THINKING_LEVELS = ['minimal', 'low', 'medium', 'high'];
+//# sourceMappingURL=ai.js.map

package/dist/config/types/analyzer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Analyzer 模块配置类型
+ */
+/** Analyzer 模块配置 */
+export interface AnalyzerConfig {
+    /** 暂停期检测阈值（天） */
+    inactivityThreshold?: number;
+    /** 单片最大帖子数 */
+    chunkMaxTopics?: number;
+    /** 单片最大回复数 */
+    chunkMaxReplies?: number;
+    /** 节点分布 Top N */
+    nodeDistributionTopN?: number;
+}
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/config/types/analyzer.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Analyzer 模块配置类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=analyzer.js.map