@lyhue1991/tvsearch 0.1.0

package/dist/commands/search.js

@@ -0,0 +1,66 @@
+import ora from 'ora';
+import { searchWeb, validateApiKey } from '../api/tavily.js';
+import { getApiKey, getDefaultFormat, getDefaultCount, getDefaultFreshness } from '../utils/config.js';
+import { formatOutput } from '../utils/output.js';
+import { AuthError, handleError, validateCount, validateFormat, validateFreshness, validateDepth, validateTopic, } from '../utils/errors.js';
+import { ExitCode } from '../types/index.js';
+/**
+ * 执行搜索命令
+ */
+export async function executeSearch(query, options) {
+    try {
+        // 验证参数
+        if (options.count) {
+            validateCount(options.count);
+        }
+        if (options.format) {
+            validateFormat(options.format);
+        }
+        if (options.freshness) {
+            validateFreshness(options.freshness);
+        }
+        if (options.depth) {
+            validateDepth(options.depth);
+        }
+        if (options.topic) {
+            validateTopic(options.topic);
+        }
+        // 获取 API Key
+        const apiKey = getApiKey(options.apiKey);
+        if (!apiKey) {
+            throw new AuthError('API Key 无效或未配置。请使用 tvsearch config --api-key 设置');
+        }
+        // 验证 API Key 格式
+        if (!validateApiKey(apiKey)) {
+            console.warn('警告: API Key 格式可能不正确，应以 tvly- 开头');
+        }
+        // 构建搜索选项
+        const searchOptions = {
+            query,
+            count: options.count ?? getDefaultCount(),
+            format: options.format ?? getDefaultFormat(),
+            freshness: options.freshness ?? getDefaultFreshness(),
+            depth: options.depth,
+            topic: options.topic,
+        };
+        // 执行搜索
+        const spinner = ora('搜索中...').start();
+        let results;
+        try {
+            results = await searchWeb(searchOptions, apiKey);
+            spinner.succeed(`找到 ${results.length} 条结果`);
+        }
+        catch (error) {
+            spinner.fail('搜索失败');
+            throw error;
+        }
+        // 输出结果
+        const output = formatOutput(results, searchOptions.format ?? 'json');
+        console.log(output);
+        return ExitCode.SUCCESS;
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACvG,OAAO,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAEL,SAAS,EAET,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAW7C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,OAA6B;IAE7B,IAAI,CAAC;QACH,OAAO;QACP,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,aAAa;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;QACzE,CAAC;QAED,gBAAgB;QAChB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAClD,CAAC;QAED,SAAS;QACT,MAAM,aAAa,GAAkB;YACnC,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,eAAe,EAAE;YACzC,MAAM,EAAG,OAAO,CAAC,MAAc,IAAI,gBAAgB,EAAE;YACrD,SAAS,EAAG,OAAO,CAAC,SAAiB,IAAI,mBAAmB,EAAE;YAC9D,KAAK,EAAE,OAAO,CAAC,KAAY;YAC3B,KAAK,EAAE,OAAO,CAAC,KAAY;SAC5B,CAAC;QAEF,OAAO;QACP,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QACtC,IAAI,OAAuB,CAAC;QAE5B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACjD,OAAO,CAAC,OAAO,CAAC,MAAM,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO;QACP,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { program } from './cli.js';
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 输出格式类型
+ */
+export type OutputFormat = 'json' | 'markdown' | 'table';
+/**
+ * 时间范围类型
+ */
+export type Freshness = 'pd' | 'pw' | 'pm' | 'py' | string;
+/**
+ * 搜索深度类型
+ */
+export type SearchDepth = 'basic' | 'advanced';
+/**
+ * 搜索主题类型
+ */
+export type Topic = 'general' | 'news';
+/**
+ * 搜索结果项
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    content: string;
+    score: number;
+}
+/**
+ * 搜索选项
+ */
+export interface SearchOptions {
+    query: string;
+    count?: number;
+    freshness?: Freshness;
+    format?: OutputFormat;
+    depth?: SearchDepth;
+    topic?: Topic;
+    apiKey?: string;
+}
+/**
+ * 存储的配置
+ */
+export interface StoredConfig {
+    apiKey?: string;
+    defaultFormat?: OutputFormat;
+    defaultCount?: number;
+    defaultFreshness?: Freshness;
+}
+/**
+ * Tavily API 请求参数
+ */
+export interface TavilySearchRequest {
+    api_key: string;
+    query: string;
+    search_depth?: 'basic' | 'advanced';
+    topic?: 'general' | 'news';
+    max_results?: number;
+    time_range?: 'day' | 'week' | 'month' | 'year';
+    include_answer?: boolean;
+    include_raw_content?: boolean;
+    include_images?: boolean;
+}
+/**
+ * Tavily API 响应结果项
+ */
+export interface TavilyResultItem {
+    title: string;
+    url: string;
+    content: string;
+    score: number;
+    raw_content?: string;
+}
+/**
+ * Tavily API 响应
+ */
+export interface TavilySearchResponse {
+    answer?: string;
+    results: TavilyResultItem[];
+    images?: string[];
+    response_time?: number;
+}
+/**
+ * CLI 退出码
+ */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly INVALID_ARGS: 1;
+    readonly AUTH_ERROR: 2;
+    readonly API_ERROR: 3;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,10 @@
+/**
+ * CLI 退出码
+ */
+export const ExitCode = {
+    SUCCESS: 0,
+    INVALID_ARGS: 1,
+    AUTH_ERROR: 2,
+    API_ERROR: 3,
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAyFA;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;CACJ,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,55 @@
+import { StoredConfig, OutputFormat, Freshness } from '../types/index.js';
+/**
+ * 获取 API Key（优先级：环境变量 > 配置文件）
+ */
+export declare function getApiKey(cliApiKey?: string): string | undefined;
+/**
+ * 设置 API Key
+ */
+export declare function setApiKey(apiKey: string): void;
+/**
+ * 脱敏显示 API Key
+ * 显示格式: tvly-****xxxx（前缀 + **** + 后4位）
+ */
+export declare function maskApiKey(apiKey: string): string;
+/**
+ * 获取默认输出格式
+ */
+export declare function getDefaultFormat(): OutputFormat;
+/**
+ * 设置默认输出格式
+ */
+export declare function setDefaultFormat(format: OutputFormat): void;
+/**
+ * 获取默认结果数量
+ */
+export declare function getDefaultCount(): number;
+/**
+ * 设置默认结果数量
+ */
+export declare function setDefaultCount(count: number): void;
+/**
+ * 获取默认时间范围
+ */
+export declare function getDefaultFreshness(): Freshness | undefined;
+/**
+ * 设置默认时间范围
+ */
+export declare function setDefaultFreshness(freshness: Freshness): void;
+/**
+ * 获取完整配置
+ */
+export declare function getConfig(): StoredConfig;
+/**
+ * 显示当前配置（API Key 脱敏）
+ */
+export declare function displayConfig(): string;
+/**
+ * 重置配置
+ */
+export declare function resetConfig(): void;
+/**
+ * 获取配置文件路径
+ */
+export declare function getConfigPath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAW1E;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAchE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,SAAS,CAE3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAOxC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAStC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/utils/config.js

@@ -0,0 +1,122 @@
+import Conf from 'conf';
+import path from 'path';
+import os from 'os';
+/**
+ * 配置存储实例
+ * 配置文件路径: ~/.config/tvsearch/tvsearch.json
+ */
+const config = new Conf({
+    cwd: path.join(os.homedir(), '.config', 'tvsearch'),
+    configName: 'tvsearch',
+});
+/**
+ * 获取 API Key（优先级：环境变量 > 配置文件）
+ */
+export function getApiKey(cliApiKey) {
+    // 命令行参数优先级最高
+    if (cliApiKey) {
+        return cliApiKey;
+    }
+    // 环境变量次之
+    const envKey = process.env.TAVILY_API_KEY;
+    if (envKey) {
+        return envKey;
+    }
+    // 最后读取配置文件
+    return config.get('apiKey');
+}
+/**
+ * 设置 API Key
+ */
+export function setApiKey(apiKey) {
+    config.set('apiKey', apiKey);
+}
+/**
+ * 脱敏显示 API Key
+ * 显示格式: tvly-****xxxx（前缀 + **** + 后4位）
+ */
+export function maskApiKey(apiKey) {
+    if (!apiKey) {
+        return '(未配置)';
+    }
+    if (apiKey.startsWith('tvly-')) {
+        const suffix = apiKey.slice(-4);
+        return `tvly-****${suffix}`;
+    }
+    // 非 tvly- 前缀，显示前4位 + ****
+    const prefix = apiKey.slice(0, 4);
+    return `${prefix}****`;
+}
+/**
+ * 获取默认输出格式
+ */
+export function getDefaultFormat() {
+    return config.get('defaultFormat') ?? 'json';
+}
+/**
+ * 设置默认输出格式
+ */
+export function setDefaultFormat(format) {
+    config.set('defaultFormat', format);
+}
+/**
+ * 获取默认结果数量
+ */
+export function getDefaultCount() {
+    return config.get('defaultCount') ?? 10;
+}
+/**
+ * 设置默认结果数量
+ */
+export function setDefaultCount(count) {
+    config.set('defaultCount', count);
+}
+/**
+ * 获取默认时间范围
+ */
+export function getDefaultFreshness() {
+    return config.get('defaultFreshness');
+}
+/**
+ * 设置默认时间范围
+ */
+export function setDefaultFreshness(freshness) {
+    config.set('defaultFreshness', freshness);
+}
+/**
+ * 获取完整配置
+ */
+export function getConfig() {
+    return {
+        apiKey: config.get('apiKey'),
+        defaultFormat: config.get('defaultFormat'),
+        defaultCount: config.get('defaultCount'),
+        defaultFreshness: config.get('defaultFreshness'),
+    };
+}
+/**
+ * 显示当前配置（API Key 脱敏）
+ */
+export function displayConfig() {
+    const cfg = getConfig();
+    const lines = [
+        `API Key: ${maskApiKey(cfg.apiKey ?? '')}`,
+        `默认格式: ${cfg.defaultFormat ?? 'json'}`,
+        `默认数量: ${cfg.defaultCount ?? 10}`,
+        `默认时间范围: ${cfg.defaultFreshness ?? '(未设置)'}`,
+    ];
+    return lines.join('\n');
+}
+/**
+ * 重置配置
+ */
+export function resetConfig() {
+    config.clear();
+}
+/**
+ * 获取配置文件路径
+ */
+export function getConfigPath() {
+    return config.path;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * CLI 错误类
+ */
+export declare class CliError extends Error {
+    readonly code: number;
+    constructor(message: string, code?: number);
+}
+/**
+ * 参数验证错误
+ */
+export declare class ValidationError extends CliError {
+    constructor(message: string);
+}
+/**
+ * 认证错误
+ */
+export declare class AuthError extends CliError {
+    constructor(message?: string);
+}
+/**
+ * API 错误
+ */
+export declare class ApiError extends CliError {
+    constructor(message: string);
+}
+/**
+ * 格式化错误消息
+ */
+export declare function formatError(error: unknown): string;
+/**
+ * 输出错误到 stderr 并返回退出码
+ */
+export declare function handleError(error: unknown): number;
+/**
+ * 验证 count 参数
+ */
+export declare function validateCount(count: number): void;
+/**
+ * 验证 format 参数
+ */
+export declare function validateFormat(format: string): void;
+/**
+ * 验证 freshness 参数
+ */
+export declare function validateFreshness(freshness: string): void;
+/**
+ * 验证 depth 参数
+ */
+export declare function validateDepth(depth: string): void;
+/**
+ * 验证 topic 参数
+ */
+export declare function validateTopic(topic: string): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA2B;CAK/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,GAAE,MAAyB;CAI/C;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKjD"}

package/dist/utils/errors.js

@@ -0,0 +1,109 @@
+import { ExitCode } from '../types/index.js';
+/**
+ * CLI 错误类
+ */
+export class CliError extends Error {
+    code;
+    constructor(message, code = ExitCode.API_ERROR) {
+        super(message);
+        this.name = 'CliError';
+        this.code = code;
+    }
+}
+/**
+ * 参数验证错误
+ */
+export class ValidationError extends CliError {
+    constructor(message) {
+        super(message, ExitCode.INVALID_ARGS);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * 认证错误
+ */
+export class AuthError extends CliError {
+    constructor(message = 'API Key 无效或未配置') {
+        super(message, ExitCode.AUTH_ERROR);
+        this.name = 'AuthError';
+    }
+}
+/**
+ * API 错误
+ */
+export class ApiError extends CliError {
+    constructor(message) {
+        super(message, ExitCode.API_ERROR);
+        this.name = 'ApiError';
+    }
+}
+/**
+ * 格式化错误消息
+ */
+export function formatError(error) {
+    if (error instanceof CliError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return '未知错误';
+}
+/**
+ * 输出错误到 stderr 并返回退出码
+ */
+export function handleError(error) {
+    const message = formatError(error);
+    console.error(`错误: ${message}`);
+    if (error instanceof CliError) {
+        return error.code;
+    }
+    return ExitCode.API_ERROR;
+}
+/**
+ * 验证 count 参数
+ */
+export function validateCount(count) {
+    if (count < 1 || count > 50) {
+        throw new ValidationError('count 参数必须在 1-50 之间');
+    }
+}
+/**
+ * 验证 format 参数
+ */
+export function validateFormat(format) {
+    const validFormats = ['json', 'markdown', 'table'];
+    if (!validFormats.includes(format)) {
+        throw new ValidationError(`不支持的输出格式: ${format}`);
+    }
+}
+/**
+ * 验证 freshness 参数
+ */
+export function validateFreshness(freshness) {
+    const validFreshness = ['pd', 'pw', 'pm', 'py'];
+    // 支持自定义日期范围 YYYY-MM-DDtoYYYY-MM-DD
+    const dateRangePattern = /^\d{4}-\d{2}-\d{2}to\d{4}-\d{2}-\d{2}$/;
+    if (!validFreshness.includes(freshness) && !dateRangePattern.test(freshness)) {
+        throw new ValidationError(`不支持的 freshness 参数: ${freshness}。支持: pd, pw, pm, py 或 YYYY-MM-DDtoYYYY-MM-DD`);
+    }
+}
+/**
+ * 验证 depth 参数
+ */
+export function validateDepth(depth) {
+    const validDepths = ['basic', 'advanced'];
+    if (!validDepths.includes(depth)) {
+        throw new ValidationError(`不支持的搜索深度: ${depth}。支持: basic, advanced`);
+    }
+}
+/**
+ * 验证 topic 参数
+ */
+export function validateTopic(topic) {
+    const validTopics = ['general', 'news'];
+    if (!validTopics.includes(topic)) {
+        throw new ValidationError(`不支持的搜索主题: ${topic}。支持: general, news`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/output.d.ts

@@ -0,0 +1,26 @@
+import { SearchResult, OutputFormat } from '../types/index.js';
+/**
+ * 输出 JSON 格式
+ */
+export declare function outputJson(results: SearchResult[]): string;
+/**
+ * 输出 Markdown 格式
+ */
+export declare function outputMarkdown(results: SearchResult[]): string;
+/**
+ * 输出 Table 格式
+ */
+export declare function outputTable(results: SearchResult[]): string;
+/**
+ * 根据格式输出结果
+ */
+export declare function formatOutput(results: SearchResult[], format: OutputFormat): string;
+/**
+ * 输出错误消息到 stderr
+ */
+export declare function outputError(message: string): void;
+/**
+ * 输出成功消息
+ */
+export declare function outputSuccess(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAoB9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAwB3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,YAAY,GACnB,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD"}

package/dist/utils/output.js

@@ -0,0 +1,80 @@
+import Table from 'cli-table3';
+/**
+ * 输出 JSON 格式
+ */
+export function outputJson(results) {
+    return JSON.stringify(results, null, 2);
+}
+/**
+ * 输出 Markdown 格式
+ */
+export function outputMarkdown(results) {
+    if (results.length === 0) {
+        return '无搜索结果';
+    }
+    const lines = [];
+    results.forEach((result, index) => {
+        lines.push(`## ${index + 1}. ${result.title}`);
+        lines.push(`[${result.url}](${result.url})`);
+        lines.push('');
+        lines.push(result.content);
+        lines.push('');
+        lines.push(`**相关度**: ${result.score.toFixed(2)}`);
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    });
+    return lines.join('\n');
+}
+/**
+ * 输出 Table 格式
+ */
+export function outputTable(results) {
+    if (results.length === 0) {
+        return '无搜索结果';
+    }
+    const table = new Table({
+        head: ['#', '标题', '来源', '相关度'],
+        colWidths: [4, 40, 50, 10],
+        wordWrap: true,
+        wrapOnWordBoundary: false,
+    });
+    results.forEach((result, index) => {
+        const title = result.title.length > 38
+            ? result.title.slice(0, 35) + '...'
+            : result.title;
+        const url = result.url.length > 48
+            ? result.url.slice(0, 45) + '...'
+            : result.url;
+        table.push([index + 1, title, url, result.score.toFixed(2)]);
+    });
+    return table.toString();
+}
+/**
+ * 根据格式输出结果
+ */
+export function formatOutput(results, format) {
+    switch (format) {
+        case 'json':
+            return outputJson(results);
+        case 'markdown':
+            return outputMarkdown(results);
+        case 'table':
+            return outputTable(results);
+        default:
+            return outputJson(results);
+    }
+}
+/**
+ * 输出错误消息到 stderr
+ */
+export function outputError(message) {
+    console.error(`错误: ${message}`);
+}
+/**
+ * 输出成功消息
+ */
+export function outputSuccess(message) {
+    console.log(`✓ ${message}`);
+}
+//# sourceMappingURL=output.js.map