v2er-insight 1.0.0

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

@@ -0,0 +1,20 @@
+/**
+ * 数据管理配置类型
+ */
+/** 数据管理配置 */
+export interface DataConfig {
+    /**
+     * AI 成功后是否永久保留原始数据（raw.json / analyzed.json）
+     * - true：永久保留，不自动清理
+     * - false：按 rawRetention 天数自动清理（默认）
+     */
+    keepRaw?: boolean;
+    /**
+     * 原始数据保留天数（仅 keepRaw=false 时生效）
+     * 超过此天数的 raw.json / analyzed.json 会被自动清理
+     * result.json 永远不会被清理
+     * 有效范围：>= 0（0 表示不保留，负数会被修正为 0）
+     */
+    rawRetention?: number;
+}
+//# sourceMappingURL=data.d.ts.map

package/dist/config/types/data.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 数据管理配置类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data.js.map

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

@@ -0,0 +1,9 @@
+/**
+ * Fetcher 模块配置类型
+ */
+/** Fetcher 模块配置 */
+export interface FetchConfig {
+    /** HTTP 请求超时（毫秒） */
+    timeout?: number;
+}
+//# sourceMappingURL=fetch.d.ts.map

package/dist/config/types/fetch.js

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

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

@@ -0,0 +1,32 @@
+/**
+ * 配置类型 — 统一导出
+ *
+ * 每个模块的配置拆分为独立文件，方便阅读和按需引用。
+ */
+export type { AIConfig, ThinkingLevel } from './ai';
+export { THINKING_LEVELS } from './ai';
+export type { FetchConfig } from './fetch';
+export type { AnalyzerConfig } from './analyzer';
+export type { DataConfig } from './data';
+export type { LogConfig, LogLevel } from './log';
+import type { AIConfig } from './ai';
+import type { FetchConfig } from './fetch';
+import type { AnalyzerConfig } from './analyzer';
+import type { DataConfig } from './data';
+import type { LogConfig } from './log';
+/** 全局配置接口 */
+export interface V2erConfig {
+    /** 代理服务器地址（如 http://127.0.0.1:10808） */
+    proxy?: string;
+    /** AI 模块配置 */
+    ai?: AIConfig;
+    /** Fetcher 模块配置 */
+    fetch?: FetchConfig;
+    /** Analyzer 模块配置 */
+    analyzer?: AnalyzerConfig;
+    /** 数据管理配置 */
+    data?: DataConfig;
+    /** 日志配置 */
+    log?: LogConfig;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/config/types/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * 配置类型 — 统一导出
+ *
+ * 每个模块的配置拆分为独立文件，方便阅读和按需引用。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THINKING_LEVELS = void 0;
+var ai_1 = require("./ai");
+Object.defineProperty(exports, "THINKING_LEVELS", { enumerable: true, get: function () { return ai_1.THINKING_LEVELS; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,11 @@
+/**
+ * 日志配置类型
+ */
+import type { LogLevel } from '../../infra/logger';
+export type { LogLevel };
+/** 日志配置 */
+export interface LogConfig {
+    /** 日志等级 */
+    level?: LogLevel;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/config/types/log.js

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

package/dist/core/ai/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AI 模块入口
+ *
+ * 提供用户分析功能的统一接口
+ */
+export type { AIAnalysisInput, AIAnalysisResult, AnalysisOptions, IAIProvider, SessionOptions, ProfessionalProfile, PersonalProfile, PsychologicalProfile, BehavioralProfile, SocialProfile, RiskAssessment, } from './types';
+export { GeminiProvider } from './providers';
+export { parseResponse, type ValidationResult } from './parser';
+export { resolveApiKey, withRetry, type RetryOptions } from './utils';
+export { buildMessageSequence, type MessageSequence } from './prompt';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ai/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * AI 模块入口
+ *
+ * 提供用户分析功能的统一接口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMessageSequence = exports.withRetry = exports.resolveApiKey = exports.parseResponse = exports.GeminiProvider = void 0;
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "GeminiProvider", { enumerable: true, get: function () { return providers_1.GeminiProvider; } });
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseResponse", { enumerable: true, get: function () { return parser_1.parseResponse; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "resolveApiKey", { enumerable: true, get: function () { return utils_1.resolveApiKey; } });
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return utils_1.withRetry; } });
+var prompt_1 = require("./prompt");
+Object.defineProperty(exports, "buildMessageSequence", { enumerable: true, get: function () { return prompt_1.buildMessageSequence; } });
+//# sourceMappingURL=index.js.map

package/dist/core/ai/parser/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AI 响应解析器
+ */
+import { type ValidationResult } from './validator';
+export type { ValidationResult };
+/**
+ * 将 AI 响应文本解析为 AIAnalysisResult
+ *
+ * 返回 ValidationResult，包含 data 和 warnings
+ */
+export declare function parseResponse(rawText: string): ValidationResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ai/parser/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * AI 响应解析器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseResponse = parseResponse;
+const validator_1 = require("./validator");
+/**
+ * 如果存在 Markdown 代码块，从中提取 JSON
+ *
+ * 优先匹配 ```json 标记的代码块，其次匹配无标记代码块
+ */
+function extractJson(text) {
+    const jsonBlockMatch = text.match(/```json\s*([\s\S]*?)```/);
+    if (jsonBlockMatch && jsonBlockMatch[1]) {
+        return jsonBlockMatch[1].trim();
+    }
+    const codeBlockMatch = text.match(/```\s*([\s\S]*?)```/);
+    if (codeBlockMatch && codeBlockMatch[1]) {
+        return codeBlockMatch[1].trim();
+    }
+    return text.trim();
+}
+/**
+ * 将 AI 响应文本解析为 AIAnalysisResult
+ *
+ * 返回 ValidationResult，包含 data 和 warnings
+ */
+function parseResponse(rawText) {
+    const jsonStr = extractJson(rawText);
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch (e) {
+        // JSON 解析失败，返回默认值和警告
+        return {
+            data: (0, validator_1.validateResponse)(null).data,
+            warnings: [`JSON 解析失败: ${e instanceof Error ? e.message : '未知错误'}`],
+        };
+    }
+    return (0, validator_1.validateResponse)(parsed);
+}
+//# sourceMappingURL=index.js.map

package/dist/core/ai/parser/validator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AI 响应 Schema 验证器 - 宽松模式
+ *
+ * 不抛出错误，缺失字段用默认值填充，返回警告列表
+ */
+import type { AIAnalysisResult } from '../types';
+/** 验证结果 */
+export interface ValidationResult {
+    data: AIAnalysisResult;
+    warnings: string[];
+}
+/**
+ * 宽松验证 AI 响应
+ *
+ * 缺失字段用默认值填充，不抛出错误
+ */
+export declare function validateResponse(data: unknown): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/ai/parser/validator.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * AI 响应 Schema 验证器 - 宽松模式
+ *
+ * 不抛出错误，缺失字段用默认值填充，返回警告列表
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateResponse = validateResponse;
+const DEFAULT_SCORES = {
+    openness: 50,
+    conscientiousness: 50,
+    extraversion: 50,
+    agreeableness: 50,
+    neuroticism: 50,
+};
+const DEFAULT_RESULT = {
+    summary: '数据缺失，无法生成摘要',
+    professional: {
+        tech_stack: [],
+        career_path: '未知',
+        level: '未知',
+        focus_coherence: '未知',
+        evolution: {
+            summary: '未知',
+            timeline: [],
+        },
+    },
+    personal: {
+        hobbies: [],
+        life_stage: '未知',
+        values: [],
+    },
+    psychological: {
+        scores: DEFAULT_SCORES,
+        keywords: [],
+    },
+    behavioral: {
+        role: '未知',
+        interaction_style: '未知',
+        active_pattern: '未知',
+        heat_sensitivity: '未知',
+    },
+    social: {
+        content_appeal: '未知',
+        discussion_depth: '未知',
+    },
+    risk: {
+        level: 'safe',
+        reason: '数据不足，默认安全',
+    },
+};
+const RISK_LEVELS = ['safe', 'suspicious', 'high_risk'];
+/**
+ * 宽松验证 AI 响应
+ *
+ * 缺失字段用默认值填充，不抛出错误
+ */
+function validateResponse(data) {
+    const warnings = [];
+    if (!data || typeof data !== 'object') {
+        warnings.push('响应不是有效对象，使用默认值');
+        return { data: structuredClone(DEFAULT_RESULT), warnings };
+    }
+    const obj = data;
+    const result = structuredClone(DEFAULT_RESULT);
+    // summary
+    if (typeof obj.summary === 'string') {
+        result.summary = obj.summary;
+    }
+    else {
+        warnings.push('缺少 summary 字段');
+    }
+    // professional
+    if (obj.professional && typeof obj.professional === 'object') {
+        result.professional = mergeWithDefault(obj.professional, DEFAULT_RESULT.professional);
+    }
+    else {
+        warnings.push('缺少 professional 字段');
+    }
+    // personal
+    if (obj.personal && typeof obj.personal === 'object') {
+        result.personal = mergeWithDefault(obj.personal, DEFAULT_RESULT.personal);
+    }
+    else {
+        warnings.push('缺少 personal 字段');
+    }
+    // psychological
+    if (obj.psychological && typeof obj.psychological === 'object') {
+        const psych = obj.psychological;
+        result.psychological = {
+            scores: validateScores(psych.scores, warnings),
+            keywords: Array.isArray(psych.keywords) ? psych.keywords : [],
+        };
+    }
+    else {
+        warnings.push('缺少 psychological 字段');
+    }
+    // behavioral
+    if (obj.behavioral && typeof obj.behavioral === 'object') {
+        result.behavioral = mergeWithDefault(obj.behavioral, DEFAULT_RESULT.behavioral);
+    }
+    else {
+        warnings.push('缺少 behavioral 字段');
+    }
+    // social
+    if (obj.social && typeof obj.social === 'object') {
+        result.social = mergeWithDefault(obj.social, DEFAULT_RESULT.social);
+    }
+    else {
+        warnings.push('缺少 social 字段');
+    }
+    // risk
+    if (obj.risk && typeof obj.risk === 'object') {
+        const risk = obj.risk;
+        const isValidLevel = RISK_LEVELS.includes(risk.level);
+        result.risk = {
+            level: isValidLevel ? risk.level : 'safe',
+            reason: typeof risk.reason === 'string' ? risk.reason : '未知',
+        };
+        if (!isValidLevel) {
+            warnings.push(`无效的 risk.level: ${risk.level}，使用默认值 safe`);
+        }
+    }
+    else {
+        warnings.push('缺少 risk 字段');
+    }
+    return { data: result, warnings };
+}
+/** 验证心理评分，值限制在 0-100 范围 */
+function validateScores(scores, warnings) {
+    if (!scores || typeof scores !== 'object') {
+        warnings.push('缺少 psychological.scores');
+        return { ...DEFAULT_SCORES };
+    }
+    const s = scores;
+    const result = { ...DEFAULT_SCORES };
+    for (const key of Object.keys(DEFAULT_SCORES)) {
+        if (typeof s[key] === 'number') {
+            const raw = s[key];
+            const clamped = Math.max(0, Math.min(100, raw));
+            if (raw !== clamped) {
+                warnings.push(`psychological.scores.${key} 值 ${raw} 超出范围，已限制为 ${clamped}`);
+            }
+            result[key] = clamped;
+        }
+        else {
+            warnings.push(`缺少 psychological.scores.${key}，使用默认值 50`);
+        }
+    }
+    return result;
+}
+/** 深度合并对象，缺失字段用默认值 */
+function mergeWithDefault(source, defaults) {
+    if (!source || typeof source !== 'object') {
+        return defaults;
+    }
+    const src = source;
+    const result = { ...defaults };
+    for (const key of Object.keys(defaults)) {
+        const defaultValue = defaults[key];
+        const sourceValue = src[key];
+        if (sourceValue === undefined) {
+            continue;
+        }
+        if (defaultValue !== null &&
+            typeof defaultValue === 'object' &&
+            !Array.isArray(defaultValue) &&
+            sourceValue !== null &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue)) {
+            result[key] = mergeWithDefault(sourceValue, defaultValue);
+        }
+        else {
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/ai/prompt/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prompt Builder - Multi-turn Message Sequence
+ */
+import type { AIAnalysisInput } from '../types';
+export interface MessageSequence {
+    systemPrompt: string;
+    messages: string[];
+    finalPrompt: string;
+}
+/**
+ * Build message sequence for multi-turn chat
+ *
+ * Sequence:
+ * 1. UserOverview
+ * 2. PeriodsSummary
+ * 3. Each PeriodContent/Chunk
+ * 4. Final prompt requesting analysis
+ */
+export declare function buildMessageSequence(input: AIAnalysisInput): MessageSequence;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ai/prompt/index.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Prompt Builder - Multi-turn Message Sequence
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMessageSequence = buildMessageSequence;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+// Load system prompt from md file
+const SYSTEM_PROMPT_PATH = path.join(__dirname, 'system-prompt.md');
+function loadSystemPrompt() {
+    return fs.readFileSync(SYSTEM_PROMPT_PATH, 'utf-8');
+}
+/**
+ * Build message sequence for multi-turn chat
+ *
+ * Sequence:
+ * 1. UserOverview
+ * 2. PeriodsSummary
+ * 3. Each PeriodContent/Chunk
+ * 4. Final prompt requesting analysis
+ */
+function buildMessageSequence(input) {
+    const messages = [];
+    // 1. UserOverview
+    messages.push(JSON.stringify({ userOverview: input.userOverview }, null, 2));
+    // 2. PeriodsSummary
+    messages.push(JSON.stringify({ summary: input.summary }, null, 2));
+    // 3. Each content chunk
+    if (input.contents.length === 0) {
+        console.warn('Warning: contents is empty');
+    }
+    for (const content of input.contents) {
+        messages.push(JSON.stringify(content, null, 2));
+    }
+    return {
+        systemPrompt: loadSystemPrompt(),
+        messages,
+        finalPrompt: '根据以上数据生成用户分析报告，严格按照 Output Schema 输出 JSON。',
+    };
+}
+//# sourceMappingURL=index.js.map