v2er-insight 1.0.0

package/dist/infra/fetcher/agent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HTTP Agent 配置
+ */
+import type { Agent } from 'https';
+/**
+ * 获取 HTTPS Agent
+ * 优先从配置文件读取，其次从环境变量读取
+ */
+export declare function getHttpsAgent(): Agent | undefined;
+//# sourceMappingURL=agent.d.ts.map

package/dist/infra/fetcher/agent.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * HTTP Agent 配置
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHttpsAgent = getHttpsAgent;
+const https_proxy_agent_1 = require("https-proxy-agent");
+const config_1 = require("../../config");
+/**
+ * 获取 HTTPS Agent
+ * 优先从配置文件读取，其次从环境变量读取
+ */
+function getHttpsAgent() {
+    const proxyUrl = (0, config_1.getProxyUrl)();
+    return proxyUrl ? new https_proxy_agent_1.HttpsProxyAgent(proxyUrl) : undefined;
+}
+//# sourceMappingURL=agent.js.map

package/dist/infra/fetcher/fetcher.d.ts

@@ -0,0 +1,10 @@
+import type { IFetchStrategy, FetchResult, FetchOptions, FetchEvents } from './types';
+export declare class SequentialStrategy implements IFetchStrategy {
+    fetch(urls: string[], options?: FetchOptions, events?: FetchEvents): AsyncGenerator<FetchResult>;
+}
+export declare class Fetcher {
+    private strategy;
+    constructor(strategy: IFetchStrategy);
+    fetch(urls: string[], options?: FetchOptions, events?: FetchEvents): AsyncGenerator<FetchResult>;
+}
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/infra/fetcher/fetcher.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fetcher = exports.SequentialStrategy = void 0;
+const axios_1 = __importDefault(require("axios"));
+const agent_1 = require("./agent");
+const config_1 = require("../../config");
+/**
+ * 将响应数据转换为字符串
+ */
+function responseToString(data) {
+    if (typeof data === 'string') {
+        return data;
+    }
+    try {
+        return JSON.stringify(data);
+    }
+    catch {
+        return String(data);
+    }
+}
+class SequentialStrategy {
+    async *fetch(urls, options, events) {
+        const total = urls.length;
+        const httpsAgent = (0, agent_1.getHttpsAgent)();
+        for (let i = 0; i < total; i++) {
+            const url = urls[i];
+            // 触发开始事件
+            events?.onStart?.(url, i, total);
+            try {
+                const response = await axios_1.default.get(url, {
+                    timeout: options?.timeout ?? (0, config_1.getConfig)().fetch?.timeout ?? 30000,
+                    ...(options?.headers && { headers: options.headers }),
+                    ...(httpsAgent && { httpsAgent }),
+                    proxy: false,
+                    validateStatus: () => true,
+                });
+                const isSuccess = response.status >= 200 && response.status < 300;
+                const responseBody = responseToString(response.data);
+                const result = {
+                    url,
+                    content: isSuccess ? responseBody : null,
+                    success: isSuccess,
+                    statusCode: response.status,
+                    ...(isSuccess ? {} : { errorBody: responseBody }),
+                };
+                // 触发成功/失败事件
+                if (result.success) {
+                    events?.onSuccess?.(result, i, total);
+                }
+                else {
+                    events?.onError?.(result, i, total);
+                }
+                yield result;
+            }
+            catch (error) {
+                const result = {
+                    url,
+                    content: null,
+                    success: false,
+                    error: error,
+                };
+                events?.onError?.(result, i, total);
+                yield result;
+            }
+        }
+    }
+}
+exports.SequentialStrategy = SequentialStrategy;
+class Fetcher {
+    constructor(strategy) {
+        this.strategy = strategy;
+    }
+    async *fetch(urls, options, events) {
+        yield* this.strategy.fetch(urls, options, events);
+    }
+}
+exports.Fetcher = Fetcher;
+//# sourceMappingURL=fetcher.js.map

package/dist/infra/fetcher/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './fetcher';
+//# sourceMappingURL=index.d.ts.map

package/dist/infra/fetcher/index.js

@@ -0,0 +1,19 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./fetcher"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infra/fetcher/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Fetcher 模块类型定义
+ */
+/** 请求配置选项 */
+export interface FetchOptions {
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/** 抓取结果 */
+export interface FetchResult {
+    url: string;
+    content: string | null;
+    success: boolean;
+    error?: Error;
+    statusCode?: number;
+    /** 非 2xx 响应时的响应体 */
+    errorBody?: string;
+}
+/** 抓取事件回调 */
+export interface FetchEvents {
+    onStart?: (url: string, index: number, total: number) => void;
+    onSuccess?: (result: FetchResult, index: number, total: number) => void;
+    onError?: (result: FetchResult, index: number, total: number) => void;
+}
+/** 抓取策略接口 */
+export interface IFetchStrategy {
+    fetch(urls: string[], options?: FetchOptions, events?: FetchEvents): AsyncGenerator<FetchResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/infra/fetcher/types.js

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

package/dist/infra/logger/colors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ANSI 终端颜色常量
+ *
+ * 供 logger 和 CLI 输出模块共享，避免重复定义。
+ */
+export declare const COLORS: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly cyan: "\u001B[36m";
+    readonly gray: "\u001B[90m";
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/infra/logger/colors.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * ANSI 终端颜色常量
+ *
+ * 供 logger 和 CLI 输出模块共享，避免重复定义。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLORS = void 0;
+exports.COLORS = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+//# sourceMappingURL=colors.js.map

package/dist/infra/logger/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 全局日志模块
+ *
+ * 提供四级日志（error > warn > info > debug），全局单例。
+ * 无外部依赖，所有层均可使用。
+ *
+ * 用法:
+ *   import { logger } from '../../infra/logger';
+ *   logger.info('消息');
+ *
+ * 入口处设置级别:
+ *   logger.setLevel('debug');
+ */
+export { logger } from './logger';
+export type { LogLevel } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/infra/logger/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * 全局日志模块
+ *
+ * 提供四级日志（error > warn > info > debug），全局单例。
+ * 无外部依赖，所有层均可使用。
+ *
+ * 用法:
+ *   import { logger } from '../../infra/logger';
+ *   logger.info('消息');
+ *
+ * 入口处设置级别:
+ *   logger.setLevel('debug');
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+//# sourceMappingURL=index.js.map

package/dist/infra/logger/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 全局日志模块 — 基于级别过滤
+ *
+ * 级别优先级：error > warn > info > debug
+ * 设置为 'info' 时，'debug' 消息会被过滤。
+ *
+ * 使用 ANSI 转义码实现终端彩色输出，无外部依赖。
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+/** 未知总数的哨兵值 */
+export declare const UNKNOWN_TOTAL = -1;
+export declare const logger: {
+    /** 设置最低日志级别，低于此级别的消息将被过滤 */
+    setLevel(level: LogLevel): void;
+    /** 获取当前日志级别 */
+    getLevel(): LogLevel;
+    /** 调试信息 — 仅 verbose 模式可见 */
+    debug(msg: string): void;
+    /** 普通信息 — 正常输出 */
+    info(msg: string): void;
+    /** 警告信息 — 非致命异常 */
+    warn(msg: string): void;
+    /** 错误信息 — 操作失败 */
+    error(msg: string): void;
+    /** 章节标题 — 分隔不同操作阶段 */
+    section(title: string): void;
+    /** 成功信息 — 带绿色对勾前缀 */
+    success(msg: string): void;
+    /** 缩进详情 — 补充上一行输出 */
+    detail(msg: string): void;
+    /** 进度显示 — 页码或步骤进度 */
+    progress(current: number, total: number, label: string): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/infra/logger/logger.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * 全局日志模块 — 基于级别过滤
+ *
+ * 级别优先级：error > warn > info > debug
+ * 设置为 'info' 时，'debug' 消息会被过滤。
+ *
+ * 使用 ANSI 转义码实现终端彩色输出，无外部依赖。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.UNKNOWN_TOTAL = void 0;
+const colors_1 = require("./colors");
+/** 未知总数的哨兵值 */
+exports.UNKNOWN_TOTAL = -1;
+// -- 常量 --------------------------------------------------------------------
+/** 级别优先级（数值越大越严重） */
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/** 级别显示标签 */
+const LEVEL_LABELS = {
+    debug: `${colors_1.COLORS.gray}[DEBUG]${colors_1.COLORS.reset}`,
+    info: '',
+    warn: `${colors_1.COLORS.yellow}[WARN]${colors_1.COLORS.reset}`,
+    error: `${colors_1.COLORS.red}[ERROR]${colors_1.COLORS.reset}`,
+};
+// -- 状态 --------------------------------------------------------------------
+let currentLevel = 'info';
+// -- 内部函数 ----------------------------------------------------------------
+function shouldLog(level) {
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[currentLevel];
+}
+function formatMessage(level, msg) {
+    const label = LEVEL_LABELS[level];
+    return label ? `${label} ${msg}` : msg;
+}
+// -- 公共 API ----------------------------------------------------------------
+exports.logger = {
+    /** 设置最低日志级别，低于此级别的消息将被过滤 */
+    setLevel(level) {
+        currentLevel = level;
+    },
+    /** 获取当前日志级别 */
+    getLevel() {
+        return currentLevel;
+    },
+    /** 调试信息 — 仅 verbose 模式可见 */
+    debug(msg) {
+        if (shouldLog('debug')) {
+            console.log(formatMessage('debug', msg));
+        }
+    },
+    /** 普通信息 — 正常输出 */
+    info(msg) {
+        if (shouldLog('info')) {
+            console.log(formatMessage('info', msg));
+        }
+    },
+    /** 警告信息 — 非致命异常 */
+    warn(msg) {
+        if (shouldLog('warn')) {
+            console.warn(formatMessage('warn', msg));
+        }
+    },
+    /** 错误信息 — 操作失败 */
+    error(msg) {
+        if (shouldLog('error')) {
+            console.error(formatMessage('error', msg));
+        }
+    },
+    // -- CLI 格式化输出 --------------------------------------------------------
+    /** 章节标题 — 分隔不同操作阶段 */
+    section(title) {
+        if (shouldLog('info')) {
+            console.log(`\n${title}`);
+        }
+    },
+    /** 成功信息 — 带绿色对勾前缀 */
+    success(msg) {
+        if (shouldLog('info')) {
+            console.log(`  ${colors_1.COLORS.green}Done:${colors_1.COLORS.reset} ${msg}`);
+        }
+    },
+    /** 缩进详情 — 补充上一行输出 */
+    detail(msg) {
+        if (shouldLog('info')) {
+            console.log(`  ${msg}`);
+        }
+    },
+    /** 进度显示 — 页码或步骤进度 */
+    progress(current, total, label) {
+        if (shouldLog('info')) {
+            const display = total === exports.UNKNOWN_TOTAL ? `${current + 1}` : `${current + 1}/${total}`;
+            console.log(`  ${label} (${display})...`);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/infra/storage/cleaner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Storage 过期数据清理
+ *
+ * 根据配置清理过期的原始数据文件（raw.json / analyzed.json）。
+ * result.json 永远不会被清理。
+ *
+ * 清理策略：
+ * - keepRaw=true → 永不清理
+ * - keepRaw=false → 检查文件 mtime，超过 rawRetention 天则删除
+ */
+import type { DataFileType } from './types';
+/**
+ * 清理指定用户的过期数据文件
+ *
+ * 根据 config.data.keepRaw 和 config.data.rawRetention 决定清理行为：
+ * - keepRaw=true：不做任何操作
+ * - keepRaw=false：删除超过 rawRetention 天的 raw.json 和 analyzed.json
+ * - result.json 永远不受影响
+ *
+ * @param username - V2EX 用户名
+ * @returns 被删除的文件类型列表
+ */
+export declare function cleanExpiredData(username: string): DataFileType[];
+//# sourceMappingURL=cleaner.d.ts.map

package/dist/infra/storage/cleaner.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Storage 过期数据清理
+ *
+ * 根据配置清理过期的原始数据文件（raw.json / analyzed.json）。
+ * result.json 永远不会被清理。
+ *
+ * 清理策略：
+ * - keepRaw=true → 永不清理
+ * - keepRaw=false → 检查文件 mtime，超过 rawRetention 天则删除
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanExpiredData = cleanExpiredData;
+const fs_1 = __importDefault(require("fs"));
+const config_1 = require("../../config");
+const paths_1 = require("./paths");
+/** 需要清理的文件类型（result 永不清理） */
+const CLEANABLE_TYPES = ['raw', 'analyzed'];
+/**
+ * 判断文件是否已过期
+ * @param filePath - 文件路径
+ * @param retentionDays - 保留天数
+ * @returns true 表示文件已过期，应被清理
+ */
+function isExpired(filePath, retentionDays) {
+    try {
+        const stat = fs_1.default.statSync(filePath);
+        const ageMs = Date.now() - stat.mtimeMs;
+        const retentionMs = retentionDays * 24 * 60 * 60 * 1000;
+        return ageMs > retentionMs;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 清理指定用户的过期数据文件
+ *
+ * 根据 config.data.keepRaw 和 config.data.rawRetention 决定清理行为：
+ * - keepRaw=true：不做任何操作
+ * - keepRaw=false：删除超过 rawRetention 天的 raw.json 和 analyzed.json
+ * - result.json 永远不受影响
+ *
+ * @param username - V2EX 用户名
+ * @returns 被删除的文件类型列表
+ */
+function cleanExpiredData(username) {
+    const config = (0, config_1.getConfig)();
+    const keepRaw = config.data?.keepRaw ?? false;
+    const retentionDays = Math.max(0, config.data?.rawRetention ?? 1);
+    // 永久保留模式，不清理
+    if (keepRaw) {
+        return [];
+    }
+    const deleted = [];
+    for (const type of CLEANABLE_TYPES) {
+        const filePath = (0, paths_1.getDataFilePath)(username, type);
+        if (fs_1.default.existsSync(filePath) && isExpired(filePath, retentionDays)) {
+            try {
+                fs_1.default.unlinkSync(filePath);
+                deleted.push(type);
+            }
+            catch {
+                // 文件可能在检查后被外部删除，忽略 ENOENT
+            }
+        }
+    }
+    return deleted;
+}
+//# sourceMappingURL=cleaner.js.map

package/dist/infra/storage/index.d.ts

@@ -0,0 +1,7 @@
+export type { DataFileType, WriteOptions } from './types';
+export { DATA_FILE_NAMES } from './types';
+export { getUserDataDir, getDataFilePath } from './paths';
+export { readDataFile } from './reader';
+export { writeDataFile } from './writer';
+export { cleanExpiredData } from './cleaner';
+//# sourceMappingURL=index.d.ts.map

package/dist/infra/storage/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanExpiredData = exports.writeDataFile = exports.readDataFile = exports.getDataFilePath = exports.getUserDataDir = exports.DATA_FILE_NAMES = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "DATA_FILE_NAMES", { enumerable: true, get: function () { return types_1.DATA_FILE_NAMES; } });
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "getUserDataDir", { enumerable: true, get: function () { return paths_1.getUserDataDir; } });
+Object.defineProperty(exports, "getDataFilePath", { enumerable: true, get: function () { return paths_1.getDataFilePath; } });
+var reader_1 = require("./reader");
+Object.defineProperty(exports, "readDataFile", { enumerable: true, get: function () { return reader_1.readDataFile; } });
+var writer_1 = require("./writer");
+Object.defineProperty(exports, "writeDataFile", { enumerable: true, get: function () { return writer_1.writeDataFile; } });
+var cleaner_1 = require("./cleaner");
+Object.defineProperty(exports, "cleanExpiredData", { enumerable: true, get: function () { return cleaner_1.cleanExpiredData; } });
+//# sourceMappingURL=index.js.map

package/dist/infra/storage/paths.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Storage 路径解析
+ *
+ * 数据目录结构：
+ *   ~/.v2er-insight/data/{username}/
+ *     ├── raw.json       # 抓取的原始数据
+ *     ├── analyzed.json   # Analyzer 输出
+ *     └── result.json     # AI 分析结果
+ */
+import type { DataFileType } from './types';
+/**
+ * 获取用户数据目录路径
+ * @param username - V2EX 用户名
+ * @returns 如 ~/.v2er-insight/data/livid/
+ * @throws Error 用户名包含非法字符时抛出
+ */
+export declare function getUserDataDir(username: string): string;
+/**
+ * 获取指定用户的数据文件路径
+ * @param username - V2EX 用户名
+ * @param type - 数据文件类型
+ * @returns 如 ~/.v2er-insight/data/livid/raw.json
+ * @throws Error 用户名包含非法字符时抛出
+ */
+export declare function getDataFilePath(username: string, type: DataFileType): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/infra/storage/paths.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Storage 路径解析
+ *
+ * 数据目录结构：
+ *   ~/.v2er-insight/data/{username}/
+ *     ├── raw.json       # 抓取的原始数据
+ *     ├── analyzed.json   # Analyzer 输出
+ *     └── result.json     # AI 分析结果
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserDataDir = getUserDataDir;
+exports.getDataFilePath = getDataFilePath;
+const path_1 = __importDefault(require("path"));
+const path_2 = require("../../config/path");
+const types_1 = require("./types");
+/** 数据根目录名 */
+const DATA_DIR = 'data';
+/** 合法用户名格式：仅允许字母、数字、下划线、连字符 */
+const USERNAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+/**
+ * 校验用户名是否合法
+ * @throws Error 用户名包含非法字符时抛出
+ */
+function validateUsername(username) {
+    if (!USERNAME_PATTERN.test(username)) {
+        throw new Error(`用户名 "${username}" 包含非法字符，仅允许字母、数字、下划线和连字符`);
+    }
+}
+/**
+ * 获取用户数据目录路径
+ * @param username - V2EX 用户名
+ * @returns 如 ~/.v2er-insight/data/livid/
+ * @throws Error 用户名包含非法字符时抛出
+ */
+function getUserDataDir(username) {
+    validateUsername(username);
+    return path_1.default.join((0, path_2.getConfigDir)(), DATA_DIR, username);
+}
+/**
+ * 获取指定用户的数据文件路径
+ * @param username - V2EX 用户名
+ * @param type - 数据文件类型
+ * @returns 如 ~/.v2er-insight/data/livid/raw.json
+ * @throws Error 用户名包含非法字符时抛出
+ */
+function getDataFilePath(username, type) {
+    return path_1.default.join(getUserDataDir(username), types_1.DATA_FILE_NAMES[type]);
+}
+//# sourceMappingURL=paths.js.map

package/dist/infra/storage/reader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Storage 文件读取
+ *
+ * 从用户数据目录读取 JSON 文件并解析为对象。
+ * 文件不存在或解析失败时返回 null，不抛出异常。
+ */
+import type { DataFileType } from './types';
+/**
+ * 读取指定用户的数据文件
+ * @param username - V2EX 用户名
+ * @param type - 数据文件类型（raw / analyzed / result）
+ * @returns 解析后的对象，文件不存在或解析失败返回 null
+ */
+export declare function readDataFile<T>(username: string, type: DataFileType): T | null;
+//# sourceMappingURL=reader.d.ts.map

package/dist/infra/storage/reader.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Storage 文件读取
+ *
+ * 从用户数据目录读取 JSON 文件并解析为对象。
+ * 文件不存在或解析失败时返回 null，不抛出异常。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDataFile = readDataFile;
+const fs_1 = __importDefault(require("fs"));
+const paths_1 = require("./paths");
+/**
+ * 读取指定用户的数据文件
+ * @param username - V2EX 用户名
+ * @param type - 数据文件类型（raw / analyzed / result）
+ * @returns 解析后的对象，文件不存在或解析失败返回 null
+ */
+function readDataFile(username, type) {
+    const filePath = (0, paths_1.getDataFilePath)(username, type);
+    if (!fs_1.default.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs_1.default.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/infra/storage/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Storage 模块类型定义
+ *
+ * 定义数据文件类型和读写选项。
+ */
+/** 数据文件类型 */
+export type DataFileType = 'raw' | 'analyzed' | 'result';
+/**
+ * 数据文件类型到文件名的映射
+ * 供 paths 模块使用
+ */
+export declare const DATA_FILE_NAMES: Record<DataFileType, string>;
+/** 写入选项 */
+export interface WriteOptions {
+    /**
+     * 是否格式化 JSON 输出（美化缩进）
+     * 默认 true
+     */
+    pretty?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map