v2er-insight 1.0.0

package/dist/cli/commands/show.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * show 命令 — 展示 AI 分析结果
+ *
+ * 读取 result.json，以结构化格式输出到终端。
+ * 支持 --json 原始输出和 --brief 简略版。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runShow = runShow;
+const storage_1 = require("../../infra/storage");
+const logger_1 = require("../../infra/logger");
+const colors_1 = require("../../infra/logger/colors");
+const recovery_1 = require("../workflow/recovery");
+// -- 格式化工具 --------------------------------------------------------------
+/** OCEAN 五维特质的中文标签 */
+const OCEAN_LABELS = {
+    openness: '开放性',
+    conscientiousness: '尽责性',
+    extraversion: '外向性',
+    agreeableness: '宜人性',
+    neuroticism: '神经质',
+};
+/**
+ * 渲染分数条 (0-100)
+ *
+ * 示例: ████████░░ 80
+ */
+function renderScoreBar(score, width = 10) {
+    if (!Number.isFinite(score))
+        return '░'.repeat(width) + ' N/A';
+    const clamped = Math.max(0, Math.min(100, score));
+    const filled = Math.round((clamped / 100) * width);
+    const empty = width - filled;
+    return `${'█'.repeat(filled)}${'░'.repeat(empty)} ${clamped}`;
+}
+/** 风险等级对应的显示样式 */
+function formatRiskLevel(level) {
+    switch (level) {
+        case 'safe':
+            return `${colors_1.COLORS.green}安全${colors_1.COLORS.reset}`;
+        case 'suspicious':
+            return `${colors_1.COLORS.yellow}可疑${colors_1.COLORS.reset}`;
+        case 'high_risk':
+            return `${colors_1.COLORS.red}高风险${colors_1.COLORS.reset}`;
+        default:
+            return level;
+    }
+}
+// -- 输出模式 ----------------------------------------------------------------
+/** --brief: 简略版输出 */
+function printBrief(result) {
+    console.log(`\n${colors_1.COLORS.bold}${colors_1.COLORS.cyan}=== 用户画像摘要 ===${colors_1.COLORS.reset}\n`);
+    console.log(result.summary);
+    console.log(`\n${colors_1.COLORS.bold}关键指标${colors_1.COLORS.reset}`);
+    console.log(`  职业方向: ${result.professional.career_path}`);
+    console.log(`  技术水平: ${result.professional.level}`);
+    console.log(`  人生阶段: ${result.personal.life_stage}`);
+    console.log(`  风险评估: ${formatRiskLevel(result.risk.level)}`);
+}
+/** 默认: 完整格式化输出 */
+function printFull(result) {
+    // Summary
+    console.log(`\n${colors_1.COLORS.bold}${colors_1.COLORS.cyan}=== 用户画像分析 ===${colors_1.COLORS.reset}\n`);
+    console.log(result.summary);
+    // Professional
+    console.log(`\n${colors_1.COLORS.bold}[职业画像]${colors_1.COLORS.reset}`);
+    console.log(`  方向: ${result.professional.career_path}`);
+    console.log(`  水平: ${result.professional.level}`);
+    console.log(`  技术栈: ${(result.professional.tech_stack ?? []).join(', ')}`);
+    console.log(`  专注一致性: ${result.professional.focus_coherence}`);
+    const timeline = result.professional.evolution?.timeline ?? [];
+    if (timeline.length > 0) {
+        console.log(`  ${colors_1.COLORS.gray}演变轨迹:${colors_1.COLORS.reset}`);
+        for (const entry of timeline) {
+            console.log(`    ${entry.period} → ${entry.focus}`);
+        }
+    }
+    // Personal
+    console.log(`\n${colors_1.COLORS.bold}[个人生活]${colors_1.COLORS.reset}`);
+    console.log(`  人生阶段: ${result.personal.life_stage}`);
+    console.log(`  兴趣爱好: ${(result.personal.hobbies ?? []).join(', ')}`);
+    console.log(`  价值取向: ${(result.personal.values ?? []).join(', ')}`);
+    // Psychological (OCEAN)
+    console.log(`\n${colors_1.COLORS.bold}[心理画像 — OCEAN]${colors_1.COLORS.reset}`);
+    const { scores } = result.psychological;
+    for (const [key, label] of Object.entries(OCEAN_LABELS)) {
+        const score = scores[key];
+        console.log(`  ${label.padEnd(4)} ${renderScoreBar(score)}`);
+    }
+    console.log(`  关键词: ${(result.psychological.keywords ?? []).join(', ')}`);
+    // Behavioral
+    console.log(`\n${colors_1.COLORS.bold}[行为画像]${colors_1.COLORS.reset}`);
+    console.log(`  社区角色: ${result.behavioral.role}`);
+    console.log(`  互动风格: ${result.behavioral.interaction_style}`);
+    console.log(`  活跃模式: ${result.behavioral.active_pattern}`);
+    console.log(`  热度敏感: ${result.behavioral.heat_sensitivity}`);
+    // Social
+    console.log(`\n${colors_1.COLORS.bold}[社交画像]${colors_1.COLORS.reset}`);
+    console.log(`  内容吸引力: ${result.social.content_appeal}`);
+    console.log(`  讨论深度: ${result.social.discussion_depth}`);
+    // Risk
+    console.log(`\n${colors_1.COLORS.bold}[风险评估]${colors_1.COLORS.reset}`);
+    console.log(`  等级: ${formatRiskLevel(result.risk.level)}`);
+    console.log(`  理由: ${result.risk.reason}`);
+    console.log('');
+}
+// -- 命令入口 ----------------------------------------------------------------
+/**
+ * 执行 show 命令
+ */
+async function runShow(username, options) {
+    const result = (0, storage_1.readDataFile)(username, 'result');
+    if (!result) {
+        logger_1.logger.error(`未找到 ${username} 的分析结果`);
+        logger_1.logger.info('请先运行: v2er ai <username>');
+        return {
+            step: 'show',
+            status: 'failed',
+            reasonCode: 'SHOW_RESULT_MISSING',
+            message: '缺少 result.json，无法展示报告',
+            recoverable: true,
+            recoverActions: (0, recovery_1.getRecoveryActions)('SHOW_RESULT_MISSING', { username }),
+        };
+    }
+    // --json: 原始 JSON 输出
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return {
+            step: 'show',
+            status: 'success',
+            message: '已输出 JSON 结果',
+            meta: { mode: 'json' },
+        };
+    }
+    // --brief: 简略版
+    if (options.brief) {
+        printBrief(result);
+        return {
+            step: 'show',
+            status: 'success',
+            message: '已输出简略报告',
+            meta: { mode: 'brief' },
+        };
+    }
+    // 默认: 完整格式化
+    printFull(result);
+    return {
+        step: 'show',
+        status: 'success',
+        message: '已输出完整报告',
+        meta: { mode: 'full' },
+    };
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI 入口
+ */
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI 入口
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const config_1 = require("../config");
+const commander_1 = require("commander");
+const commands_1 = require("./commands");
+const logger_1 = require("../infra/logger");
+const package_json_1 = __importDefault(require("../../package.json"));
+// 从配置文件初始化日志级别（必须在其他初始化之前）
+const configLogLevel = (0, config_1.getConfig)().log?.level;
+if (configLogLevel) {
+    logger_1.logger.setLevel(configLogLevel);
+}
+// 为原生 fetch() 设置代理（AI 模块使用）
+(0, config_1.initFetchProxy)();
+commander_1.program
+    .name('v2er')
+    .description('V2EX user insight - Analysis and profiling tool')
+    .version(package_json_1.default.version);
+// 主命令 - 一键分析
+commander_1.program
+    .argument('[username]', 'V2EX username')
+    .option('--force', 'Force re-fetch from scratch')
+    .option('--model [name]', 'Specify AI model (or select interactively)')
+    .option('--thinking-level [level]', 'Specify thinking level (or select interactively)')
+    .option('-v, --verbose', 'Show debug output')
+    .action(async (username, options, command) => {
+    if (!username) {
+        command.help();
+        return;
+    }
+    await (0, commands_1.runPipeline)(username, options);
+});
+// fetch - 抓取数据
+// NOTE: 子命令仅对 failed 设置 exitCode=1，partial 视为可接受的降级成功（exitCode=0）。
+// 这与 pipeline 模式不同（partial 会导致 exitCode=1），因为 pipeline 中 partial 影响后续步骤质量。
+commander_1.program
+    .command('fetch')
+    .description('Fetch user profile, topics and replies')
+    .argument('<username>', 'V2EX username')
+    .option('--topics', 'Fetch topics only')
+    .option('--replies', 'Fetch replies only')
+    .option('--force', 'Force refetch even if cache exists')
+    .action(async (username, options) => {
+    const result = await (0, commands_1.runFetch)(username, options);
+    if (result.status === 'failed')
+        process.exitCode = 1;
+});
+// analyze - 数据分析
+commander_1.program
+    .command('analyze')
+    .description('Process raw data and generate statistics')
+    .argument('<username>', 'V2EX username')
+    .action(async (username) => {
+    const result = await (0, commands_1.runAnalyze)(username);
+    if (result.status === 'failed')
+        process.exitCode = 1;
+});
+// ai - AI 画像
+commander_1.program
+    .command('ai')
+    .description('Generate AI user profile and analysis')
+    .argument('<username>', 'V2EX username')
+    .option('--model [name]', 'Specify Gemini model (or select interactively)')
+    .option('--thinking-level [level]', 'Specify thinking level: minimal | low | medium | high')
+    .action(async (username, options) => {
+    const result = await (0, commands_1.runAi)(username, options);
+    if (result.status === 'failed')
+        process.exitCode = 1;
+});
+// show - 展示结果
+commander_1.program
+    .command('show')
+    .description('Show analysis report')
+    .argument('<username>', 'V2EX username')
+    .option('--json', 'Output raw JSON')
+    .option('--brief', 'Show brief summary only')
+    .action(async (username, options) => {
+    const result = await (0, commands_1.runShow)(username, options);
+    if (result.status === 'failed')
+        process.exitCode = 1;
+});
+// config - 配置管理
+const config = commander_1.program.command('config').description('Manage configuration');
+config
+    .command('proxy [url]')
+    .description('Set, view, or clear proxy')
+    .option('--clear', 'Clear proxy setting')
+    .action(commands_1.configProxy);
+config.command('show [group]').description('Show current configuration').action(commands_1.configShow);
+config
+    .command('set <path> <value>')
+    .description('Set a configuration value (e.g. ai.model gemini-2.5-flash)')
+    .action(commands_1.configSet);
+config
+    .command('reset [group]')
+    .description('Reset configuration to defaults (all or specific group)')
+    .action(commands_1.configReset);
+commander_1.program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CLI 命令选项类型定义
+ */
+import type { ThinkingLevel } from '../config';
+/**
+ * fetch 命令选项
+ */
+export interface FetchCommandOptions {
+    /** 仅抓取话题 */
+    topics?: boolean;
+    /** 仅抓取回复 */
+    replies?: boolean;
+    /** 强制重新抓取，忽略缓存 */
+    force?: boolean;
+    /** 由一键流程触发时开启，供命令控制日志粒度 */
+    pipeline?: boolean;
+}
+/**
+ * ai 命令选项
+ */
+export interface AiCommandOptions {
+    /** 临时指定模型，或 true 表示触发交互选择 */
+    model?: string | true;
+    /** 临时覆盖思考等级，或 true 表示触发交互选择 */
+    thinkingLevel?: ThinkingLevel | true;
+    /** 由一键流程触发时开启，供命令控制日志粒度 */
+    pipeline?: boolean;
+}
+/**
+ * show 命令选项
+ */
+export interface ShowCommandOptions {
+    /** 输出原始 JSON */
+    json?: boolean;
+    /** 简略版输出（仅 summary + 关键指标） */
+    brief?: boolean;
+    /** 由一键流程触发时开启，供命令控制日志粒度 */
+    pipeline?: boolean;
+}
+/**
+ * 主命令 `v2er <username>` 选项
+ *
+ * Commander 将 --model [name] 解析为 string | true：
+ * - `--model gemini-2.5-pro` → model = 'gemini-2.5-pro'
+ * - `--model`（无值）→ model = true（触发交互选择）
+ * --thinking-level 同理。
+ */
+export interface RunCommandOptions {
+    /** 强制重新抓取，忽略缓存 */
+    force?: boolean;
+    /** 临时指定模型，或 true 表示触发交互选择 */
+    model?: string | true;
+    /** 临时覆盖思考等级，或 true 表示触发交互选择 */
+    thinkingLevel?: ThinkingLevel | true;
+    /** 显示 debug 级别日志 */
+    verbose?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * CLI 命令选项类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cli/utils/error.d.ts

@@ -0,0 +1,6 @@
+export interface ErrorDetails {
+    message: string;
+    raw: string;
+}
+export declare function extractErrorDetails(error: unknown): ErrorDetails;
+//# sourceMappingURL=error.d.ts.map

package/dist/cli/utils/error.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractErrorDetails = extractErrorDetails;
+function extractErrorDetails(error) {
+    if (error instanceof Error) {
+        const raw = error.stack ?? `${error.name}: ${error.message}`;
+        return {
+            message: error.message,
+            raw,
+        };
+    }
+    const raw = String(error);
+    return {
+        message: raw,
+        raw,
+    };
+}
+//# sourceMappingURL=error.js.map

package/dist/cli/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CLI 共享工具函数
+ */
+import type { FetchResult, FetchEvents } from '../infra/fetcher';
+/**
+ * 打印抓取错误详情
+ *
+ * 优化输出格式：第一行使用 logger.error 显示错误标题，
+ * 后续细节使用 logger.detail 保持缩进对齐。
+ */
+export declare function logFetchError(result: FetchResult): void;
+/**
+ * 创建通用的抓取事件回调
+ *
+ * 用于命令行抓取过程中的进度展示和错误记录。
+ *
+ * @param label - 进度条前的标签（如 "获取资料"、"抓取帖子"）
+ */
+export declare function createFetchEvents(label: string): FetchEvents;
+//# sourceMappingURL=utils.d.ts.map

package/dist/cli/utils.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * CLI 共享工具函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logFetchError = logFetchError;
+exports.createFetchEvents = createFetchEvents;
+const logger_1 = require("../infra/logger");
+/** 响应体预览最大长度 */
+const ERROR_BODY_PREVIEW_LENGTH = 200;
+/**
+ * 打印抓取错误详情
+ *
+ * 优化输出格式：第一行使用 logger.error 显示错误标题，
+ * 后续细节使用 logger.detail 保持缩进对齐。
+ */
+function logFetchError(result) {
+    logger_1.logger.error(`抓取失败: ${result.url}`);
+    if (result.statusCode !== undefined) {
+        logger_1.logger.detail(`状态码: ${result.statusCode}`);
+    }
+    if (result.error) {
+        logger_1.logger.detail(`错误信息: ${result.error.message}`);
+    }
+    if (result.errorBody) {
+        const preview = result.errorBody.substring(0, ERROR_BODY_PREVIEW_LENGTH).replace(/\s+/g, ' ');
+        const suffix = result.errorBody.length > ERROR_BODY_PREVIEW_LENGTH ? '...' : '';
+        logger_1.logger.detail(`响应预览: ${preview}${suffix}`);
+    }
+}
+/**
+ * 创建通用的抓取事件回调
+ *
+ * 用于命令行抓取过程中的进度展示和错误记录。
+ *
+ * @param label - 进度条前的标签（如 "获取资料"、"抓取帖子"）
+ */
+function createFetchEvents(label) {
+    return {
+        onStart: (_url, index, total) => {
+            logger_1.logger.progress(index, total, label);
+        },
+        onError: (result) => {
+            logFetchError(result);
+        },
+    };
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1,15 @@
+import type { RunOutcome, RunWorkflowOptions, StepRunResult, WorkflowStep } from './types';
+type StepExecutor = () => Promise<StepRunResult>;
+type WorkflowExecutorSet = Record<WorkflowStep, StepExecutor>;
+/**
+ * 构建工作流步骤执行器集合，供编排层按步骤名调度。
+ */
+export declare function buildStepExecutors(options: RunWorkflowOptions): WorkflowExecutorSet;
+/**
+ * 执行一键工作流并聚合步骤结果。
+ * @param options 一键工作流入口参数
+ * @returns 聚合后的流程执行结果
+ */
+export declare function runWorkflow(options: RunWorkflowOptions): Promise<RunOutcome>;
+export {};
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/cli/workflow/orchestrator.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStepExecutors = buildStepExecutors;
+exports.runWorkflow = runWorkflow;
+const logger_1 = require("../../infra/logger");
+const commands_1 = require("../commands");
+const error_1 = require("../utils/error");
+const state_1 = require("./state");
+const STEP_LABEL = {
+    fetch: '抓取',
+    analyze: '分析',
+    ai: 'AI',
+    show: '展示',
+};
+/**
+ * 构建工作流步骤执行器集合，供编排层按步骤名调度。
+ */
+function buildStepExecutors(options) {
+    const fetchOptions = {
+        force: options.force,
+        pipeline: true,
+    };
+    const aiOptions = {
+        model: options.model,
+        thinkingLevel: options.thinkingLevel,
+        pipeline: true,
+    };
+    const showOptions = {
+        pipeline: true,
+    };
+    return {
+        fetch: () => (0, commands_1.runFetch)(options.username, fetchOptions),
+        analyze: () => (0, commands_1.runAnalyze)(options.username, { pipeline: true }),
+        ai: () => (0, commands_1.runAi)(options.username, aiOptions),
+        show: () => (0, commands_1.runShow)(options.username, showOptions),
+    };
+}
+/**
+ * 执行一键工作流并聚合步骤结果。
+ * @param options 一键工作流入口参数
+ * @returns 聚合后的流程执行结果
+ */
+async function runWorkflow(options) {
+    const state = (0, state_1.detectWorkflowState)(options.username);
+    const entryStep = (0, state_1.resolveEntryStep)(state, options.force);
+    const plan = (0, state_1.buildExecutionPlan)(entryStep);
+    const executors = buildStepExecutors(options);
+    const results = [];
+    logger_1.logger.debug(`workflow state: raw=${state.hasRaw}, analyzed=${state.hasAnalyzed}, result=${state.hasResult}`);
+    logger_1.logger.debug(`workflow entry: ${entryStep}`);
+    logger_1.logger.debug(`workflow plan: ${plan.join(' -> ')}`);
+    let hasPartial = false;
+    for (const [index, step] of plan.entries()) {
+        try {
+            const result = await executors[step]();
+            results.push(result);
+            printStepLine(result, index, plan.length);
+            if (result.status === 'partial') {
+                hasPartial = true;
+                printResultSummary(result);
+                continue;
+            }
+            if (result.status === 'failed') {
+                printResultSummary(result);
+                return {
+                    overallStatus: 'failed',
+                    exitCode: 1,
+                    failedStep: step,
+                    results,
+                };
+            }
+        }
+        catch (error) {
+            const { message, raw } = (0, error_1.extractErrorDetails)(error);
+            const result = {
+                step,
+                status: 'failed',
+                reasonCode: 'UNKNOWN_ERROR',
+                message: `步骤执行异常: ${message}`,
+                meta: {
+                    rawError: raw,
+                },
+            };
+            results.push(result);
+            printStepLine(result, index, plan.length);
+            printResultSummary(result);
+            return {
+                overallStatus: 'failed',
+                exitCode: 1,
+                failedStep: step,
+                results,
+            };
+        }
+    }
+    return {
+        overallStatus: hasPartial ? 'partial' : 'success',
+        exitCode: hasPartial ? 1 : 0,
+        results,
+    };
+}
+function printStepLine(result, index, total) {
+    const progress = `[${index + 1}/${total}]`;
+    const stepLabel = STEP_LABEL[result.step];
+    const message = result.message ? ` ${result.message}` : '';
+    if (result.status === 'failed') {
+        logger_1.logger.error(`${progress} ${stepLabel}失败${message}`);
+        return;
+    }
+    if (result.status === 'partial') {
+        logger_1.logger.warn(`${progress} ${stepLabel}部分完成${message}`);
+        return;
+    }
+    if (result.status === 'skipped') {
+        logger_1.logger.info(`${progress} ${stepLabel}已跳过${message}`);
+        return;
+    }
+    logger_1.logger.info(`${progress} ${stepLabel}完成${message}`);
+}
+function printResultSummary(result) {
+    if (result.reasonCode) {
+        logger_1.logger.info(`原因码: ${result.reasonCode}`);
+    }
+    const rawError = result.meta?.rawError;
+    if (typeof rawError === 'string') {
+        logger_1.logger.detail(rawError);
+    }
+    if (!result.recoverActions || result.recoverActions.length === 0) {
+        return;
+    }
+    logger_1.logger.info('恢复建议:');
+    for (const action of result.recoverActions) {
+        printRecoveryAction(action);
+    }
+}
+function printRecoveryAction(action) {
+    if (action.type === 'command') {
+        logger_1.logger.detail(`命令: ${action.content}`);
+    }
+    else {
+        logger_1.logger.detail(`操作: ${action.content}`);
+    }
+    logger_1.logger.detail(`说明: ${action.description}`);
+}
+//# sourceMappingURL=orchestrator.js.map

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

@@ -0,0 +1,10 @@
+import type { ReasonCode, RecoveryAction } from './types';
+interface RecoveryRenderContext {
+    username?: string;
+}
+/**
+ * 获取指定原因码对应的恢复动作列表，并按上下文渲染模板变量。
+ */
+export declare function getRecoveryActions(reasonCode?: ReasonCode, context?: RecoveryRenderContext): RecoveryAction[];
+export {};
+//# sourceMappingURL=recovery.d.ts.map