opcode-pg-memory 2.2.8 → 2.3.1

package/dist/mcp-server.js.map

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

package/dist/src/cache/semantic-cache.js

@@ -0,0 +1,399 @@
+"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 __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.SemanticCacheManager = void 0;
+exports.queryWithCachePriority = queryWithCachePriority;
+exports.createCacheManager = createCacheManager;
+const crypto = __importStar(require("crypto"));
+const DEFAULT_CONFIG = {
+    initialThreshold: 0.92,
+    adjustmentStep: 0.02,
+    minThreshold: 0.85,
+    maxThreshold: 0.97,
+    queryWindowSize: 100,
+    enabled: true
+};
+/**
+ * 语义缓存管理器
+ *
+ * 功能：
+ * 1. 使用 HNSW 索引实现亚 10ms 级检索
+ * 2. 动态阈值调整（初始 0.92，每 100 次查询根据命中率 ±0.02）
+ * 3. 与 DCP 协同，设置最高检索优先级
+ * 4. 缓存命中后直接返回，零 token 消耗
+ */
+class SemanticCacheManager {
+    pool;
+    config;
+    currentThreshold;
+    queryCount;
+    hitCount;
+    constructor(pool, config = {}) {
+        this.pool = pool;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.currentThreshold = this.config.initialThreshold;
+        this.queryCount = 0;
+        this.hitCount = 0;
+    }
+    /**
+     * 检查缓存
+     *
+     * 流程：
+     * 1. 生成查询哈希
+     * 2. 使用 HNSW 索引快速检索候选
+     * 3. 检查相似度是否达到阈值
+     * 4. 更新命中统计
+     */
+    async checkCache(queryText) {
+        if (!this.config.enabled) {
+            return { hit: false };
+        }
+        const startTime = Date.now();
+        try {
+            // 1. 生成查询哈希
+            const queryHash = this.generateQueryHash(queryText);
+            // 2. 首先尝试精确匹配（哈希匹配）
+            const exactMatch = await this.pool.query(`
+        SELECT id, response_text, hit_count, similarity_threshold
+        FROM semantic_cache
+        WHERE query_hash = $1 AND is_pruned = FALSE
+      `, [queryHash]);
+            if (exactMatch.rows.length > 0) {
+                const cached = exactMatch.rows[0];
+                // 更新命中统计
+                await this.recordHit(cached.id);
+                console.log(`[PG Memory] Cache HIT (exact): ${queryText.substring(0, 50)}...`);
+                return {
+                    hit: true,
+                    response: cached.response_text,
+                    similarity: 1.0,
+                    cached: true,
+                    cacheId: cached.id
+                };
+            }
+            // 3. 语义相似度匹配
+            // 注意：实际应生成 embedding，这里简化处理
+            const queryEmbedding = await this.generateQueryEmbedding(queryText);
+            // 使用 HNSW 索引快速检索候选
+            const candidates = await this.pool.query(`
+        SELECT id, query_text, response_text, query_embedding <=> $1 as distance,
+               similarity_threshold
+        FROM semantic_cache
+        WHERE is_pruned = FALSE
+        ORDER BY query_embedding <=> $1
+        LIMIT 5
+      `, [queryEmbedding]);
+            // 4. 检查是否命中
+            for (const candidate of candidates.rows) {
+                const similarity = 1 - candidate.distance; // 距离转相似度
+                if (similarity >= this.currentThreshold) {
+                    // 命中：更新统计
+                    await this.recordHit(candidate.id);
+                    const retrievalTime = Date.now() - startTime;
+                    console.log(`[PG Memory] Cache HIT (semantic): similarity=${similarity.toFixed(3)}, time=${retrievalTime}ms`);
+                    return {
+                        hit: true,
+                        response: candidate.response_text,
+                        similarity,
+                        cached: true,
+                        cacheId: candidate.id
+                    };
+                }
+            }
+            // 未命中
+            await this.recordMiss();
+            console.log(`[PG Memory] Cache MISS: ${queryText.substring(0, 50)}...`);
+            return {
+                hit: false,
+                cached: false
+            };
+        }
+        catch (error) {
+            console.error('[PG Memory] Cache check error:', error);
+            return { hit: false };
+        }
+    }
+    /**
+     * 存储缓存
+     */
+    async storeCache(queryText, responseText, sessionId) {
+        if (!this.config.enabled) {
+            return null;
+        }
+        try {
+            const queryHash = this.generateQueryHash(queryText);
+            const queryEmbedding = await this.generateQueryEmbedding(queryText);
+            // 检查是否已存在
+            const existing = await this.pool.query('SELECT id FROM semantic_cache WHERE query_hash = $1', [queryHash]);
+            if (existing.rows.length > 0) {
+                // 更新现有记录
+                await this.pool.query(`
+          UPDATE semantic_cache
+          SET response_text = $1,
+              hit_count = hit_count + 1,
+              last_hit_at = NOW(),
+              is_pruned = FALSE
+          WHERE id = $2
+        `, [responseText, existing.rows[0].id]);
+                return existing.rows[0].id;
+            }
+            // 创建新记录
+            const result = await this.pool.query(`
+        INSERT INTO semantic_cache (
+          query_hash, query_text, query_embedding, response_text,
+          similarity_threshold, session_id
+        ) VALUES ($1, $2, $3, $4, $5, $6)
+        RETURNING id
+      `, [
+                queryHash,
+                queryText,
+                queryEmbedding,
+                responseText,
+                this.currentThreshold,
+                sessionId || null
+            ]);
+            console.log(`[PG Memory] Cache stored: ${queryText.substring(0, 50)}...`);
+            return result.rows[0].id;
+        }
+        catch (error) {
+            console.error('[PG Memory] Cache store error:', error);
+            return null;
+        }
+    }
+    /**
+     * 记录缓存命中
+     */
+    async recordHit(cacheId) {
+        this.hitCount++;
+        this.queryCount++;
+        await this.pool.query(`
+      UPDATE semantic_cache
+      SET hit_count = hit_count + 1,
+          last_hit_at = NOW()
+      WHERE id = $1
+    `, [cacheId]);
+        await this.maybeAdjustThreshold();
+    }
+    /**
+     * 记录缓存未命中
+     */
+    async recordMiss() {
+        this.queryCount++;
+        await this.maybeAdjustThreshold();
+    }
+    /**
+     * 动态调整阈值
+     *
+     * 策略：
+     * - 每 100 次查询检查一次
+     * - 命中率 < 30%：降低阈值（提高命中率）
+     * - 命中率 > 80%：提高阈值（提高精确度）
+     */
+    async maybeAdjustThreshold() {
+        if (this.queryCount % this.config.queryWindowSize !== 0) {
+            return;
+        }
+        const hitRate = this.hitCount / this.queryCount;
+        let adjustment = 'none';
+        let newThreshold = this.currentThreshold;
+        if (hitRate < 0.3 && this.currentThreshold > this.config.minThreshold) {
+            // 命中率过低，降低阈值
+            newThreshold = Math.max(this.config.minThreshold, this.currentThreshold - this.config.adjustmentStep);
+            adjustment = 'decrease';
+        }
+        else if (hitRate > 0.8 && this.currentThreshold < this.config.maxThreshold) {
+            // 命中率过高，提高阈值（避免过度匹配）
+            newThreshold = Math.min(this.config.maxThreshold, this.currentThreshold + this.config.adjustmentStep);
+            adjustment = 'increase';
+        }
+        if (adjustment !== 'none' && newThreshold !== this.currentThreshold) {
+            this.currentThreshold = newThreshold;
+            // 记录调整日志
+            await this.pool.query(`
+        INSERT INTO cache_threshold_log (threshold_value, hit_rate, query_count, adjustment_reason)
+        VALUES ($1, $2, $3, $4)
+      `, [
+                this.currentThreshold,
+                hitRate,
+                this.queryCount,
+                `auto_${adjustment}`
+            ]);
+            console.log(`[PG Memory] Cache threshold adjusted: ${adjustment} to ${this.currentThreshold.toFixed(2)} (hit rate: ${(hitRate * 100).toFixed(1)}%)`);
+        }
+        // 重置计数器
+        this.hitCount = 0;
+        this.queryCount = 0;
+    }
+    /**
+     * 生成查询哈希
+     */
+    generateQueryHash(queryText) {
+        // 规范化查询文本
+        const normalized = queryText
+            .toLowerCase()
+            .replace(/\s+/g, ' ')
+            .trim();
+        return crypto
+            .createHash('sha256')
+            .update(normalized)
+            .digest('hex');
+    }
+    /**
+     * 生成查询向量
+     *
+     * 注意：实际应调用 embedding API
+     */
+    async generateQueryEmbedding(queryText) {
+        // 实际应调用 embedding API
+        // 例如：return await openai.embeddings.create({ input: queryText, model: 'text-embedding-3-small' });
+        // 简化版：返回随机向量（仅用于演示）
+        return new Array(1536).fill(0).map(() => (Math.random() - 0.5) * 0.1);
+    }
+    /**
+     * 标记缓存为已压缩（DCP 协同）
+     */
+    async markAsPruned(cacheId) {
+        await this.pool.query(`
+      UPDATE semantic_cache
+      SET is_pruned = TRUE
+      WHERE id = $1
+    `, [cacheId]);
+    }
+    /**
+     * 批量标记缓存为已压缩
+     */
+    async markMultipleAsPruned(cacheIds) {
+        if (cacheIds.length === 0)
+            return;
+        await this.pool.query(`
+      UPDATE semantic_cache
+      SET is_pruned = TRUE
+      WHERE id = ANY($1)
+    `, [cacheIds]);
+    }
+    /**
+     * 获取缓存统计
+     */
+    async getStats() {
+        const result = await this.pool.query(`
+      SELECT 
+        COUNT(*) as total,
+        COUNT(*) FILTER (WHERE is_pruned = TRUE) as pruned,
+        COALESCE(SUM(hit_count), 0) as total_hits,
+        AVG(hit_count) as avg_hits
+      FROM semantic_cache
+    `);
+        return {
+            totalEntries: parseInt(result.rows[0].total, 10),
+            prunedEntries: parseInt(result.rows[0].pruned, 10),
+            totalHits: parseInt(result.rows[0].total_hits, 10),
+            currentThreshold: this.currentThreshold,
+            averageHitCount: parseFloat(result.rows[0].avg_hits || 0)
+        };
+    }
+    /**
+     * 清理过期缓存
+     */
+    async cleanupExpiredCache(maxAgeDays = 30) {
+        const result = await this.pool.query(`
+      DELETE FROM semantic_cache
+      WHERE last_hit_at < NOW() - INTERVAL '${maxAgeDays} days'
+        AND hit_count < 5
+      RETURNING id
+    `);
+        console.log(`[PG Memory] Cleaned up ${result.rowCount} expired cache entries`);
+        return result.rowCount;
+    }
+    /**
+     * 获取当前阈值
+     */
+    getCurrentThreshold() {
+        return this.currentThreshold;
+    }
+    /**
+     * 手动设置阈值
+     */
+    async setThreshold(threshold) {
+        if (threshold < this.config.minThreshold || threshold > this.config.maxThreshold) {
+            throw new Error(`Threshold must be between ${this.config.minThreshold} and ${this.config.maxThreshold}`);
+        }
+        this.currentThreshold = threshold;
+        // 记录手动调整
+        await this.pool.query(`
+      INSERT INTO cache_threshold_log (threshold_value, adjustment_reason)
+      VALUES ($1, $2)
+    `, [threshold, 'manual']);
+        console.log(`[PG Memory] Cache threshold manually set to: ${threshold}`);
+    }
+}
+exports.SemanticCacheManager = SemanticCacheManager;
+/**
+ * 带缓存优先级的查询包装器
+ *
+ * 使用方式：
+ * 1. 首先检查语义缓存
+ * 2. 缓存命中：直接返回，零 token 消耗
+ * 3. 缓存未命中：执行实际查询，并存入缓存
+ */
+async function queryWithCachePriority(queryText, actualQuery, cacheManager, shouldCache) {
+    // 1. 首先检查语义缓存
+    const cacheResult = await cacheManager.checkCache(queryText);
+    if (cacheResult.hit && cacheResult.response) {
+        // 缓存命中：直接返回
+        return {
+            result: JSON.parse(cacheResult.response),
+            fromCache: true,
+            similarity: cacheResult.similarity
+        };
+    }
+    // 2. 缓存未命中：执行实际查询
+    const result = await actualQuery();
+    // 3. 存入缓存（如果符合条件）
+    const shouldStore = shouldCache ? shouldCache(result) : true;
+    if (shouldStore) {
+        await cacheManager.storeCache(queryText, JSON.stringify(result));
+    }
+    return {
+        result,
+        fromCache: false
+    };
+}
+/**
+ * 创建缓存管理器实例
+ */
+function createCacheManager(pool, config) {
+    return new SemanticCacheManager(pool, config);
+}
+//# sourceMappingURL=semantic-cache.js.map

package/dist/src/cache/semantic-cache.js.map

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