axon-code 2.4.0 → 2.5.1

package/dist/media/office-visual.js

@@ -0,0 +1,409 @@
+/**
+ * Office 文档视觉提取模块
+ * 从 docx/pptx/xlsx ZIP 包中提取嵌入图片 + 文本，
+ * 让多模态模型能"看到"文档中的图片内容。
+ *
+ * 策略：纯 JS 从 ZIP 提取 media/ 目录下的嵌入图片 + 解析文本
+ * 不依赖 LibreOffice 等外部工具
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// 支持的嵌入图片格式
+const SUPPORTED_IMAGE_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.tiff', '.tif', '.emf', '.wmf',
+]);
+/** 每次提取的最大图片数 */
+export const MAX_IMAGES_PER_DOCUMENT = 20;
+/** 单张图片最大尺寸（字节），超过的跳过 */
+const MAX_SINGLE_IMAGE_SIZE = 10 * 1024 * 1024; // 10MB
+/**
+ * 从 Office 文档中提取嵌入图片和文本
+ */
+export async function extractDocumentVisuals(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const buffer = fs.readFileSync(filePath);
+    const JSZip = (await import('jszip')).default;
+    const zip = await JSZip.loadAsync(buffer);
+    switch (ext) {
+        case '.pptx':
+            return extractPptxVisuals(zip);
+        case '.docx':
+            return extractDocxVisuals(zip);
+        case '.xlsx':
+            return extractXlsxVisuals(zip, filePath);
+        default:
+            throw new Error(`Unsupported document format: ${ext}`);
+    }
+}
+/**
+ * 从图片文件扩展名获取 MIME 类型
+ */
+function getImageMimeType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const map = {
+        '.png': 'image/png',
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.gif': 'image/gif',
+        '.webp': 'image/webp',
+        '.bmp': 'image/bmp',
+        '.tiff': 'image/tiff',
+        '.tif': 'image/tiff',
+        '.emf': 'image/emf',
+        '.wmf': 'image/wmf',
+    };
+    return map[ext] || 'image/png';
+}
+/**
+ * 判断文件名是否为支持的图片格式
+ */
+function isSupportedImage(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    return SUPPORTED_IMAGE_EXTENSIONS.has(ext);
+}
+/**
+ * 从 ZIP 中读取所有 media 目录下的图片
+ */
+async function extractMediaImages(zip, mediaPrefix) {
+    const images = new Map();
+    const entries = [];
+    zip.forEach((relativePath) => {
+        if (relativePath.startsWith(mediaPrefix) && isSupportedImage(relativePath)) {
+            entries.push(relativePath);
+        }
+    });
+    // 按文件名排序
+    entries.sort();
+    for (const entry of entries) {
+        const file = zip.file(entry);
+        if (!file)
+            continue;
+        const data = await file.async('nodebuffer');
+        if (data.length > MAX_SINGLE_IMAGE_SIZE)
+            continue; // 跳过过大的图片
+        images.set(entry, {
+            zipPath: entry,
+            data,
+            mimeType: getImageMimeType(entry),
+        });
+    }
+    return images;
+}
+/**
+ * 解析 .rels 文件，获取 relationship ID → target 的映射
+ */
+async function parseRels(zip, relsPath) {
+    const rels = new Map();
+    const file = zip.file(relsPath);
+    if (!file)
+        return rels;
+    const xml = await file.async('text');
+    const regex = /<Relationship\s+[^>]*Id="([^"]+)"[^>]*Target="([^"]+)"[^>]*/g;
+    let match;
+    while ((match = regex.exec(xml)) !== null) {
+        rels.set(match[1], match[2]);
+    }
+    return rels;
+}
+/**
+ * 从 XML 文本中提取 <a:t> 标签的内容（PPTX）
+ */
+function extractPptxText(xml) {
+    const texts = [];
+    const regex = /<a:t[^>]*>([\s\S]*?)<\/a:t>/g;
+    let match;
+    while ((match = regex.exec(xml)) !== null) {
+        const text = unescapeXml(match[1]).trim();
+        if (text)
+            texts.push(text);
+    }
+    return texts.join(' ');
+}
+/**
+ * 从 slide XML 中提取引用的图片 relationship IDs
+ */
+function extractImageRelIds(xml) {
+    const relIds = [];
+    // <a:blip r:embed="rId2" /> 或 <a:blip r:link="rId3" />
+    const regex = /<a:blip[^>]*r:(?:embed|link)="([^"]+)"/g;
+    let match;
+    while ((match = regex.exec(xml)) !== null) {
+        relIds.push(match[1]);
+    }
+    return relIds;
+}
+/**
+ * XML 反转义
+ */
+function unescapeXml(text) {
+    return text
+        .replace(/&apos;/g, "'")
+        .replace(/&quot;/g, '"')
+        .replace(/&gt;/g, '>')
+        .replace(/&lt;/g, '<')
+        .replace(/&amp;/g, '&');
+}
+// ============================================================================
+// PPTX 提取
+// ============================================================================
+async function extractPptxVisuals(zip) {
+    // 1. 提取所有 media 图片
+    const allImages = await extractMediaImages(zip, 'ppt/media/');
+    // 2. 收集 slide 文件
+    const slideFiles = [];
+    zip.forEach((relativePath) => {
+        if (/^ppt\/slides\/slide\d+\.xml$/i.test(relativePath)) {
+            slideFiles.push(relativePath);
+        }
+    });
+    slideFiles.sort((a, b) => {
+        const numA = parseInt(a.match(/slide(\d+)/i)?.[1] || '0');
+        const numB = parseInt(b.match(/slide(\d+)/i)?.[1] || '0');
+        return numA - numB;
+    });
+    // 3. 逐 slide 解析：文本 + 图片关联
+    const slides = [];
+    const usedImages = new Set();
+    let imageCount = 0;
+    for (const slideFile of slideFiles) {
+        const slideNum = parseInt(slideFile.match(/slide(\d+)/i)?.[1] || '0');
+        const content = await zip.file(slideFile)?.async('text');
+        if (!content)
+            continue;
+        // 提取文本
+        const text = extractPptxText(content);
+        // 提取图片关联：slide XML 中的 r:embed → rels 文件 → media 路径
+        const slideImages = [];
+        const relsPath = `ppt/slides/_rels/slide${slideNum}.xml.rels`;
+        const rels = await parseRels(zip, relsPath);
+        const imageRelIds = extractImageRelIds(content);
+        for (const relId of imageRelIds) {
+            if (imageCount >= MAX_IMAGES_PER_DOCUMENT)
+                break;
+            const target = rels.get(relId);
+            if (!target)
+                continue;
+            // target 是相对于 ppt/slides/ 的路径，如 ../media/image1.png
+            const resolvedPath = resolveRelativePath('ppt/slides/', target);
+            const image = allImages.get(resolvedPath);
+            if (image) {
+                slideImages.push({ ...image, slideIndex: slideNum });
+                usedImages.add(resolvedPath);
+                imageCount++;
+            }
+        }
+        slides.push({
+            index: slideNum,
+            text,
+            images: slideImages,
+        });
+    }
+    // 4. 收集未关联到 slide 的图片（兜底）
+    const unassociatedImages = [];
+    for (const [zipPath, image] of allImages) {
+        if (imageCount >= MAX_IMAGES_PER_DOCUMENT)
+            break;
+        if (!usedImages.has(zipPath)) {
+            unassociatedImages.push(image);
+            imageCount++;
+        }
+    }
+    const fullText = slides.map(s => `[Slide ${s.index}] ${s.text}`).join('\n');
+    return {
+        type: 'pptx',
+        slides,
+        unassociatedImages,
+        fullText,
+        totalImages: imageCount,
+    };
+}
+/**
+ * 解析相对路径：将 base + relative 合并为绝对 ZIP 路径
+ * e.g. resolveRelativePath('ppt/slides/', '../media/image1.png') → 'ppt/media/image1.png'
+ */
+function resolveRelativePath(base, relative) {
+    // 去掉 base 末尾的文件名（如果有的话），保留目录
+    const baseParts = base.replace(/\\/g, '/').split('/').filter(Boolean);
+    const relParts = relative.replace(/\\/g, '/').split('/').filter(Boolean);
+    const result = [...baseParts];
+    for (const part of relParts) {
+        if (part === '..') {
+            result.pop();
+        }
+        else if (part !== '.') {
+            result.push(part);
+        }
+    }
+    return result.join('/');
+}
+// ============================================================================
+// DOCX 提取
+// ============================================================================
+async function extractDocxVisuals(zip) {
+    // 1. 提取所有 media 图片
+    const allImages = await extractMediaImages(zip, 'word/media/');
+    // 2. 提取文本 + 图片引用关系
+    const docXml = await zip.file('word/document.xml')?.async('text');
+    if (!docXml) {
+        return {
+            type: 'docx',
+            slides: [],
+            unassociatedImages: [...allImages.values()].slice(0, MAX_IMAGES_PER_DOCUMENT),
+            fullText: '',
+            totalImages: Math.min(allImages.size, MAX_IMAGES_PER_DOCUMENT),
+        };
+    }
+    // 提取文本：所有 <w:t> 标签
+    const textParts = [];
+    const textRegex = /<w:t[^>]*>([\s\S]*?)<\/w:t>/g;
+    let match;
+    while ((match = textRegex.exec(docXml)) !== null) {
+        textParts.push(unescapeXml(match[1]));
+    }
+    const fullText = textParts.join('');
+    // 提取图片引用
+    const rels = await parseRels(zip, 'word/_rels/document.xml.rels');
+    const imageRelIds = extractDocxImageRelIds(docXml);
+    const slideImages = [];
+    const usedImages = new Set();
+    let imageCount = 0;
+    for (const relId of imageRelIds) {
+        if (imageCount >= MAX_IMAGES_PER_DOCUMENT)
+            break;
+        const target = rels.get(relId);
+        if (!target)
+            continue;
+        const resolvedPath = resolveRelativePath('word/', target);
+        const image = allImages.get(resolvedPath);
+        if (image) {
+            slideImages.push({ ...image, slideIndex: 1 });
+            usedImages.add(resolvedPath);
+            imageCount++;
+        }
+    }
+    // 未关联图片
+    const unassociatedImages = [];
+    for (const [zipPath, image] of allImages) {
+        if (imageCount >= MAX_IMAGES_PER_DOCUMENT)
+            break;
+        if (!usedImages.has(zipPath)) {
+            unassociatedImages.push(image);
+            imageCount++;
+        }
+    }
+    return {
+        type: 'docx',
+        slides: [{
+                index: 1,
+                text: fullText,
+                images: slideImages,
+            }],
+        unassociatedImages,
+        fullText,
+        totalImages: imageCount,
+    };
+}
+/**
+ * 从 DOCX document.xml 中提取图片引用的 relationship IDs
+ */
+function extractDocxImageRelIds(xml) {
+    const relIds = [];
+    // <a:blip r:embed="rId7" /> — DrawingML inline images
+    const blipRegex = /<a:blip[^>]*r:(?:embed|link)="([^"]+)"/g;
+    let match;
+    while ((match = blipRegex.exec(xml)) !== null) {
+        relIds.push(match[1]);
+    }
+    // <v:imagedata r:id="rId8" /> — VML images (legacy)
+    const vmlRegex = /<v:imagedata[^>]*r:id="([^"]+)"/g;
+    while ((match = vmlRegex.exec(xml)) !== null) {
+        relIds.push(match[1]);
+    }
+    return relIds;
+}
+// ============================================================================
+// XLSX 提取（简化：只提取嵌入图片，文本走现有逻辑）
+// ============================================================================
+async function extractXlsxVisuals(zip, filePath) {
+    // 提取嵌入图片
+    const allImages = await extractMediaImages(zip, 'xl/media/');
+    // 文本用现有逻辑（动态导入避免循环依赖）
+    let fullText = '';
+    try {
+        const { documentToText } = await import('./office.js');
+        fullText = await documentToText(filePath);
+    }
+    catch {
+        // 降级：无文本
+    }
+    const images = [...allImages.values()].slice(0, MAX_IMAGES_PER_DOCUMENT);
+    return {
+        type: 'xlsx',
+        slides: [{
+                index: 1,
+                text: fullText,
+                images: [],
+            }],
+        unassociatedImages: images,
+        fullText,
+        totalImages: images.length,
+    };
+}
+/**
+ * 批量压缩图片
+ * 使用 sharp 缩放到 2000x2000 以内，转 JPEG
+ */
+export async function compressExtractedImages(images, maxDimension = 2000, quality = 80) {
+    let sharp = null;
+    try {
+        const mod = await import('sharp');
+        sharp = mod.default;
+    }
+    catch {
+        // sharp 不可用，返回原始 base64
+        return images.map(img => ({
+            base64: img.data.toString('base64'),
+            mimeType: 'image/png',
+            size: img.data.length,
+            zipPath: img.zipPath,
+            slideIndex: img.slideIndex,
+        }));
+    }
+    const results = [];
+    for (const img of images) {
+        try {
+            // 跳过 EMF/WMF 等 sharp 不支持的格式
+            if (img.mimeType === 'image/emf' || img.mimeType === 'image/wmf') {
+                continue;
+            }
+            const sharpInstance = sharp(img.data);
+            const metadata = await sharpInstance.metadata();
+            // 只在超过最大尺寸时缩放
+            let pipeline = sharp(img.data);
+            if (metadata.width && metadata.height) {
+                if (metadata.width > maxDimension || metadata.height > maxDimension) {
+                    pipeline = pipeline.resize(maxDimension, maxDimension, {
+                        fit: 'inside',
+                        withoutEnlargement: true,
+                    });
+                }
+            }
+            const outputBuffer = await pipeline
+                .jpeg({ quality, mozjpeg: true })
+                .toBuffer();
+            results.push({
+                base64: outputBuffer.toString('base64'),
+                mimeType: 'image/jpeg',
+                size: outputBuffer.length,
+                zipPath: img.zipPath,
+                slideIndex: img.slideIndex,
+            });
+        }
+        catch {
+            // 单张图片处理失败，跳过
+            continue;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=office-visual.js.map

package/dist/media/office-visual.js.map

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

package/dist/memory/long-term-store.d.ts

@@ -57,8 +57,14 @@ export declare class LongTermStore {
      * 搜索（FTS5 + 时间衰减）
      */
     search(query: string, opts?: SearchOptions): MemorySearchResult[];
+    /**
+     * Fallback: 简单的 LIKE 搜索（FTS5 不可用或查询为空时使用）
+     */
+    private fallbackSearch;
     /**
      * FTS5 搜索（BM25 评分 + 时间衰减）
+     * @param ftsQuery 经过分词/转义的 FTS5 查询
+     * @param originalQuery 原始用户查询（用于 snippet 定位，未经分词处理）
      */
     private fts5Search;
     /**

package/dist/memory/long-term-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"long-term-store.d.ts","sourceRoot":"","sources":["../../src/memory/long-term-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"long-term-store.d.ts","sourceRoot":"","sources":["../../src/memory/long-term-store.ts"],"names":[],"mappings":"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"}

package/dist/memory/long-term-store.js

@@ -123,11 +123,11 @@ export class LongTermStore {
             console.warn('[LongTermStore] FTS5 not available, fallback to basic search');
             this.hasFTS5 = false;
         }
-        // 版本迁移
-        const CURRENT_VERSION = '3';
+        // 版本迁移（使用数字比较，避免字符串比较在两位数版本号时失效）
+        const CURRENT_VERSION = 3;
         const versionRow = this.db.prepare('SELECT value FROM meta WHERE key = ?').get('version');
-        const existingVersion = versionRow?.value;
-        if (!existingVersion || existingVersion < '2') {
+        const existingVersionNum = versionRow ? parseInt(versionRow.value, 10) : 0;
+        if (existingVersionNum < 2) {
             // v1→v2：引入中文字级分词，需要重建 FTS 索引
             this.db.exec('DELETE FROM chunks');
             this.db.exec('DELETE FROM files');
@@ -135,7 +135,7 @@ export class LongTermStore {
                 this.db.exec('DELETE FROM chunks_fts');
             }
         }
-        if (!existingVersion || existingVersion < '3') {
+        if (existingVersionNum < 3) {
             // v2→v3：新增 embedding 列（不清空数据，旧 chunk 无 embedding 值为 NULL）
             try {
                 this.db.exec('ALTER TABLE chunks ADD COLUMN embedding TEXT');
@@ -160,7 +160,7 @@ export class LongTermStore {
             }
         }
         const versionStmt = this.db.prepare('INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)');
-        versionStmt.run('version', CURRENT_VERSION);
+        versionStmt.run('version', String(CURRENT_VERSION));
     }
     /**
      * 索引文件
@@ -305,8 +305,12 @@ export class LongTermStore {
             // 转义 FTS5 特殊字符，防止搜索语法错误
             const escaped = query.replace(/["\-*(){}:^~\[\]\\+.]/g, ' ');
             const ftsQuery = tokenizeChinese(escaped);
+            // 空查询（全是特殊字符）→ 跳过 FTS5，降级到 fallback
+            if (!ftsQuery.trim()) {
+                return this.fallbackSearch(query, source, maxResults);
+            }
             // 第一轮：原始 query 搜索
-            results = this.fts5Search(ftsQuery, source, maxResults * 2);
+            results = this.fts5Search(ftsQuery, source, maxResults * 2, query);
             // 第二轮：关键词扩展搜索（结果不足时补充）
             if (results.length < Math.ceil(maxResults / 2)) {
                 const keywords = extractKeywords(query);
@@ -317,7 +321,7 @@ export class LongTermStore {
                         .filter(kw => kw.trim().length > 0)
                         .join(' OR ');
                     if (keywordQuery.trim()) {
-                        const supplementary = this.fts5Search(keywordQuery, source, maxResults * 2);
+                        const supplementary = this.fts5Search(keywordQuery, source, maxResults * 2, query);
                         // 合并去重（按 id）
                         const seenIds = new Set(results.map(r => r.id));
                         for (const r of supplementary) {
@@ -333,48 +337,57 @@ export class LongTermStore {
             }
         }
         else {
-            // Fallback: 简单的 LIKE 搜索
-            let sql = `
-        SELECT id, path, source, start_line, end_line, text, created_at
-        FROM chunks
-        WHERE text LIKE ?
-      `;
-            const fallbackParams = [`%${query}%`];
-            if (source) {
-                sql += ` AND source = ?`;
-                fallbackParams.push(source);
-            }
-            sql += ` LIMIT ?`;
-            fallbackParams.push(maxResults * 2);
-            const stmt = this.db.prepare(sql);
-            const rows = stmt.all(...fallbackParams);
-            const now = Date.now();
-            for (const row of rows) {
-                const age = now - row.created_at;
-                const decay = 1 / (1 + age / HALF_LIFE);
-                const rawScore = 0.5; // 简单搜索给固定分数
-                const finalScore = rawScore * decay;
-                results.push({
-                    id: row.id,
-                    path: row.path,
-                    startLine: row.start_line,
-                    endLine: row.end_line,
-                    score: finalScore,
-                    snippet: this.extractSnippet(row.text, query),
-                    source: row.source,
-                    timestamp: new Date(row.created_at).toISOString(),
-                    age,
-                });
-            }
+            results = this.fallbackSearch(query, source, maxResults);
         }
         // 排序并限制结果
         results.sort((a, b) => b.score - a.score);
         return results.slice(0, maxResults);
     }
+    /**
+     * Fallback: 简单的 LIKE 搜索（FTS5 不可用或查询为空时使用）
+     */
+    fallbackSearch(query, source, maxResults) {
+        let sql = `
+      SELECT id, path, source, start_line, end_line, text, created_at
+      FROM chunks
+      WHERE text LIKE ?
+    `;
+        const fallbackParams = [`%${query}%`];
+        if (source) {
+            sql += ` AND source = ?`;
+            fallbackParams.push(source);
+        }
+        sql += ` LIMIT ?`;
+        fallbackParams.push(maxResults * 2);
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...fallbackParams);
+        const now = Date.now();
+        const results = [];
+        for (const row of rows) {
+            const age = now - row.created_at;
+            const decay = 1 / (1 + age / HALF_LIFE);
+            const rawScore = 0.5;
+            const finalScore = rawScore * decay;
+            results.push({
+                id: row.id,
+                path: row.path,
+                startLine: row.start_line,
+                endLine: row.end_line,
+                score: finalScore,
+                snippet: this.extractSnippet(row.text, query),
+                source: row.source,
+                timestamp: new Date(row.created_at).toISOString(),
+                age,
+            });
+        }
+        return results;
+    }
     /**
      * FTS5 搜索（BM25 评分 + 时间衰减）
+     * @param ftsQuery 经过分词/转义的 FTS5 查询
+     * @param originalQuery 原始用户查询（用于 snippet 定位，未经分词处理）
      */
-    fts5Search(ftsQuery, source, limit) {
+    fts5Search(ftsQuery, source, limit, originalQuery) {
         let sql = `
       SELECT
         c.id,
@@ -415,7 +428,7 @@ export class LongTermStore {
                 startLine: row.start_line,
                 endLine: row.end_line,
                 score: finalScore,
-                snippet: this.extractSnippet(row.text, ftsQuery),
+                snippet: this.extractSnippet(row.text, originalQuery || ftsQuery),
                 source: row.source,
                 timestamp: new Date(row.created_at).toISOString(),
                 age,
@@ -507,6 +520,7 @@ export class LongTermStore {
         const source = opts?.source;
         if (this.hasVecSearch) {
             // 使用 sqlite-vec 原生向量搜索
+            // sqlite-vec knn 查询需要 k = ? 约束
             let sql = `
         SELECT
           cv.chunk_id,
@@ -520,14 +534,14 @@ export class LongTermStore {
         FROM chunks_vec cv
         JOIN chunks c ON cv.chunk_id = c.id
         WHERE cv.embedding MATCH ?
+          AND k = ?
       `;
-            const params = [new Float32Array(queryVec)];
+            const params = [new Float32Array(queryVec), maxResults];
             if (source) {
                 sql += ` AND c.source = ?`;
                 params.push(source);
             }
-            sql += ` ORDER BY cv.distance LIMIT ?`;
-            params.push(maxResults);
+            sql += ` ORDER BY cv.distance`;
             const rows = this.db.prepare(sql).all(...params);
             return rows.map(row => ({
                 id: row.chunk_id,
@@ -545,7 +559,7 @@ export class LongTermStore {
         let sql = `
       SELECT id, path, source, start_line, end_line, text, embedding, created_at
       FROM chunks
-      WHERE embedding IS NOT NULL
+      WHERE embedding IS NOT NULL AND embedding != ''
     `;
         const params = [];
         if (source) {
@@ -599,6 +613,10 @@ export class LongTermStore {
         // FTS5 BM25 搜索（不带时间衰减，由混合搜索层统一处理）
         const escaped = query.replace(/["\-*(){}:^~\[\]\\+.]/g, ' ');
         const ftsQuery = tokenizeChinese(escaped);
+        // 空查询（全是特殊字符）→ 返回空结果，避免 FTS5 语法错误
+        if (!ftsQuery.trim()) {
+            return [];
+        }
         let sql = `
       SELECT
         c.id,
@@ -654,7 +672,7 @@ export class LongTermStore {
      * 是否有存储 embedding 的 chunk（判断是否需要重建索引）
      */
     hasEmbeddings() {
-        const row = this.db.prepare('SELECT 1 FROM chunks WHERE embedding IS NOT NULL LIMIT 1').get();
+        const row = this.db.prepare("SELECT 1 FROM chunks WHERE embedding IS NOT NULL AND embedding != '' LIMIT 1").get();
         return row !== undefined;
     }
     /**