llm-content-creator 0.1.0

package/dist/services/llm/LLMService.d.ts

@@ -0,0 +1,103 @@
+/**
+ * LLM 服务
+ *
+ * 封装 DeepSeek API 调用，支持缓存
+ */
+/**
+ * Chat 消息
+ */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Chat 请求参数
+ */
+export interface ChatRequest {
+    messages: ChatMessage[];
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    stream?: boolean;
+}
+/**
+ * Chat 响应
+ */
+export interface ChatResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: string;
+            content: string;
+        };
+        finishReason: string | null;
+    }>;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Token 使用统计
+ */
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/**
+ * LLM 服务类
+ */
+export declare class LLMService {
+    private baseURL;
+    private apiKey;
+    private modelName;
+    private maxTokens;
+    private temperature;
+    private enableCache;
+    constructor();
+    /**
+     * 生成缓存键
+     */
+    private generateCacheKey;
+    /**
+     * 聊天对话（支持缓存）
+     */
+    chat(request: ChatRequest): Promise<{
+        content: string;
+        usage: TokenUsage;
+    }>;
+    /**
+     * 生成文本（简化接口）
+     */
+    generateText(prompt: string, systemPrompt?: string): Promise<string>;
+    /**
+     * 生成文本并返回使用情况
+     */
+    generateTextWithUsage(prompt: string, systemPrompt?: string): Promise<{
+        text: string;
+        usage: TokenUsage;
+    }>;
+    /**
+     * 批量生成（并行）
+     */
+    batchGenerateText(prompts: string[]): Promise<string[]>;
+    /**
+     * 检查 API 连接
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * 计算文本的 Token 数量（估算）
+     */
+    estimateTokens(text: string): number;
+}
+/**
+ * LLM 服务单例
+ */
+export declare const llmService: LLMService;
+//# sourceMappingURL=LLMService.d.ts.map

package/dist/services/llm/LLMService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMService.d.ts","sourceRoot":"","sources":["../../../src/services/llm/LLMService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC,CAAC;IACH,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAU;;IAW7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;IAiHjF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc1E;;OAEG;IACG,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;IAiB/C;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY7D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAOrC;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/services/llm/LLMService.js

@@ -0,0 +1,212 @@
+/**
+ * LLM 服务
+ *
+ * 封装 DeepSeek API 调用，支持缓存
+ */
+import axios, { AxiosError } from 'axios';
+import crypto from 'crypto';
+import { config } from '../../config/index.js';
+import { createLogger } from '../../infrastructure/logging/logger.js';
+import { cacheService } from '../../infrastructure/cache/CacheService.js';
+import { metricsService } from '../../infrastructure/monitoring/MetricsService.js';
+const logger = createLogger('LLM');
+/**
+ * LLM 服务类
+ */
+export class LLMService {
+    baseURL;
+    apiKey;
+    modelName;
+    maxTokens;
+    temperature;
+    enableCache;
+    constructor() {
+        this.baseURL = config.llm.baseURL;
+        this.apiKey = config.llm.apiKey;
+        this.modelName = config.llm.modelName;
+        this.maxTokens = config.llm.maxTokens;
+        this.temperature = config.llm.temperature;
+        this.enableCache = config.llm.enableCache ?? true;
+    }
+    /**
+     * 生成缓存键
+     */
+    generateCacheKey(request) {
+        const cacheData = {
+            model: request.model || this.modelName,
+            messages: request.messages,
+            maxTokens: request.maxTokens || this.maxTokens,
+            temperature: request.temperature ?? this.temperature,
+        };
+        const hash = crypto
+            .createHash('sha256')
+            .update(JSON.stringify(cacheData))
+            .digest('hex');
+        return hash;
+    }
+    /**
+     * 聊天对话（支持缓存）
+     */
+    async chat(request) {
+        const cacheKey = this.generateCacheKey(request);
+        // 尝试从缓存获取
+        if (this.enableCache) {
+            try {
+                const cached = await cacheService.getCachedLLMResponse(cacheKey);
+                if (cached) {
+                    logger.debug('LLM response retrieved from cache', { cacheKey });
+                    metricsService.recordCacheHit('llm');
+                    // 返回缓存的结果，usage 设为 0（因为这是缓存）
+                    return {
+                        content: cached,
+                        usage: {
+                            promptTokens: 0,
+                            completionTokens: 0,
+                            totalTokens: 0,
+                        },
+                    };
+                }
+                metricsService.recordCacheMiss('llm');
+            }
+            catch (error) {
+                logger.warn('Failed to retrieve from cache', error);
+                // 继续执行，不阻断请求
+            }
+        }
+        try {
+            logger.debug('Sending chat request', {
+                model: request.model || this.modelName,
+                messagesCount: request.messages.length,
+            });
+            const maxTokens = typeof (request.maxTokens || this.maxTokens) === 'number'
+                ? request.maxTokens || this.maxTokens
+                : parseInt(String(request.maxTokens || this.maxTokens));
+            const temperature = typeof (request.temperature ?? this.temperature) === 'number'
+                ? request.temperature ?? this.temperature
+                : parseFloat(String(request.temperature ?? this.temperature));
+            const response = await axios.post(`${this.baseURL}/v1/chat/completions`, {
+                model: request.model || this.modelName,
+                messages: request.messages,
+                max_tokens: maxTokens,
+                temperature: temperature,
+                stream: request.stream || false,
+            }, {
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                timeout: 60000, // 60 秒超时
+            });
+            const choice = response.data.choices[0];
+            if (!choice) {
+                throw new Error('No choice in response');
+            }
+            const content = choice.message.content;
+            const usage = response.data.usage;
+            logger.info('Chat request completed', {
+                promptTokens: usage.promptTokens,
+                completionTokens: usage.completionTokens,
+                totalTokens: usage.totalTokens,
+                finishReason: choice.finishReason,
+            });
+            // 缓存响应（异步，不等待）
+            if (this.enableCache) {
+                cacheService.setCachedLLMResponse(cacheKey, content).catch((error) => {
+                    logger.warn('Failed to cache LLM response', error);
+                });
+            }
+            // 记录 LLM 调用指标
+            metricsService.recordLLMRequest(this.modelName, 'chat');
+            metricsService.recordLLMTokenUsage(this.modelName, 'prompt', usage.promptTokens);
+            metricsService.recordLLMTokenUsage(this.modelName, 'completion', usage.completionTokens);
+            return {
+                content,
+                usage: {
+                    promptTokens: usage.promptTokens,
+                    completionTokens: usage.completionTokens,
+                    totalTokens: usage.totalTokens,
+                },
+            };
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const axiosError = error;
+                logger.error('LLM API request failed', {
+                    status: axiosError.response?.status,
+                    data: axiosError.response?.data,
+                    message: axiosError.message,
+                });
+                throw new Error(`LLM API error: ${axiosError.response?.status} - ${JSON.stringify(axiosError.response?.data)}`);
+            }
+            logger.error('LLM service error', error);
+            throw error;
+        }
+    }
+    /**
+     * 生成文本（简化接口）
+     */
+    async generateText(prompt, systemPrompt) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const result = await this.chat({ messages });
+        return result.content;
+    }
+    /**
+     * 生成文本并返回使用情况
+     */
+    async generateTextWithUsage(prompt, systemPrompt) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const result = await this.chat({ messages });
+        return {
+            text: result.content,
+            usage: result.usage,
+        };
+    }
+    /**
+     * 批量生成（并行）
+     */
+    async batchGenerateText(prompts) {
+        logger.info('Batch generating text', { count: prompts.length });
+        const results = await Promise.all(prompts.map((prompt) => this.generateText(prompt)));
+        logger.info('Batch generation completed', { count: results.length });
+        return results;
+    }
+    /**
+     * 检查 API 连接
+     */
+    async healthCheck() {
+        try {
+            await this.chat({
+                messages: [{ role: 'user', content: 'test' }],
+                maxTokens: 1,
+            });
+            logger.info('LLM service health check passed');
+            return true;
+        }
+        catch (error) {
+            logger.error('LLM service health check failed', error);
+            return false;
+        }
+    }
+    /**
+     * 计算文本的 Token 数量（估算）
+     */
+    estimateTokens(text) {
+        // 粗略估算：英文约 4 字符/token，中文约 1.5 字符/token
+        const chineseChars = (text.match(/[\u4e00-\u9fa5]/g) || []).length;
+        const englishChars = text.length - chineseChars;
+        return Math.ceil(chineseChars / 1.5 + englishChars / 4);
+    }
+}
+/**
+ * LLM 服务单例
+ */
+export const llmService = new LLMService();
+//# sourceMappingURL=LLMService.js.map

package/dist/services/llm/LLMService.js.map

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

package/dist/services/quality/HardRuleChecker.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 硬规则检查器
+ *
+ * 对内容进行确定性的硬规则验证
+ * 包括：字数检查、关键词检查、结构检查、禁用词过滤
+ */
+/**
+ * 硬约束规则
+ */
+export interface HardConstraints {
+    minWords?: number;
+    maxWords?: number;
+    keywords?: string[];
+    requireAllKeywords?: boolean;
+    requireTitle?: boolean;
+    requireIntro?: boolean;
+    requireConclusion?: boolean;
+    requireSections?: boolean;
+    minSections?: number;
+    forbiddenWords?: string[];
+    hasBulletPoints?: boolean;
+    hasNumberedList?: boolean;
+}
+/**
+ * 硬规则检查结果
+ */
+export interface HardRuleCheckResult {
+    passed: boolean;
+    score: number;
+    details: {
+        wordCount?: {
+            count: number;
+            min?: number;
+            max?: number;
+            passed: boolean;
+        };
+        keywords?: {
+            required: string[];
+            found: string[];
+            missing: string[];
+            passed: boolean;
+        };
+        structure?: {
+            hasTitle: boolean;
+            hasIntro: boolean;
+            hasConclusion: boolean;
+            sectionCount: number;
+            hasBulletPoints: boolean;
+            hasNumberedList: boolean;
+            passed: boolean;
+        };
+        forbiddenWords?: {
+            found: string[];
+            passed: boolean;
+        };
+    };
+    issues: Array<{
+        severity: 'error' | 'warning';
+        category: string;
+        message: string;
+        suggestion?: string;
+    }>;
+    checkedAt: number;
+}
+/**
+ * 检查选项
+ */
+export interface CheckOptions {
+    locale?: 'zh-CN' | 'en-US';
+    wordBoundary?: RegExp;
+}
+/**
+ * 硬规则检查器类
+ */
+export declare class HardRuleChecker {
+    private options;
+    constructor(options?: Partial<CheckOptions>);
+    /**
+     * 检查内容
+     */
+    check(content: string, constraints: HardConstraints): HardRuleCheckResult;
+    /**
+     * 检查字数
+     */
+    private checkWordCount;
+    /**
+     * 检查关键词
+     */
+    private checkKeywords;
+    /**
+     * 检查结构
+     */
+    private checkStructure;
+    /**
+     * 检查禁用词
+     */
+    private checkForbiddenWords;
+    /**
+     * 计算字数
+     */
+    private countWords;
+    /**
+     * 生成字数错误消息
+     */
+    private getWordCountErrorMessage;
+    /**
+     * 生成字数建议
+     */
+    private getWordCountSuggestion;
+    /**
+     * 生成关键词错误消息
+     */
+    private getKeywordsErrorMessage;
+    /**
+     * 生成关键词建议
+     */
+    private getKeywordsSuggestion;
+    /**
+     * 生成结构错误消息
+     */
+    private getStructureErrorMessage;
+    /**
+     * 生成结构建议
+     */
+    private getStructureSuggestion;
+    /**
+     * 生成禁用词错误消息
+     */
+    private getForbiddenWordsErrorMessage;
+    /**
+     * 生成禁用词建议
+     */
+    private getForbiddenWordsSuggestion;
+    /**
+     * 验证约束规则
+     */
+    static validateConstraints(constraints: any): HardConstraints;
+}
+/**
+ * 硬规则检查器单例
+ */
+export declare const hardRuleChecker: HardRuleChecker;
+//# sourceMappingURL=HardRuleChecker.d.ts.map

package/dist/services/quality/HardRuleChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HardRuleChecker.d.ts","sourceRoot":"","sources":["../../../src/services/quality/HardRuleChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAG1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,SAAS,CAAC,EAAE;YACV,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;QACF,SAAS,CAAC,EAAE;YACV,QAAQ,EAAE,OAAO,CAAC;YAClB,QAAQ,EAAE,OAAO,CAAC;YAClB,aAAa,EAAE,OAAO,CAAC;YACvB,YAAY,EAAE,MAAM,CAAC;YACrB,eAAe,EAAE,OAAO,CAAC;YACzB,eAAe,EAAE,OAAO,CAAC;YACzB,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;QACF,cAAc,CAAC,EAAE;YACf,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;KACH,CAAC;IACF,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;QAC9B,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAI3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,mBAAmB;IAmFzE;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAMrC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAMnC;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,GAAG,GAAG,eAAe;CAkB9D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}