autosnippet 3.2.9 → 3.2.11

package/dist/lib/infrastructure/vector/JsonVectorAdapter.js

@@ -0,0 +1,253 @@
+/**
+ * JsonVectorAdapter — 基于 JSON 文件的向量存储实现
+ * 适用于中小规模（<10K 文档），无外部依赖
+ * 支持余弦相似度搜索、混合搜索（向量 70% + 关键词 30%）
+ */
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import pathGuard from '../../shared/PathGuard.js';
+import { cosineSimilarity } from '../../shared/similarity.js';
+import { VectorStore } from './VectorStore.js';
+export class JsonVectorAdapter extends VectorStore {
+    #indexPath;
+    #data; // Map<id, { id, content, vector, metadata }>
+    #dirty;
+    constructor(projectRoot, options = {}) {
+        super();
+        const contextDir = options.contextDir || '.autosnippet/context/index';
+        this.#indexPath = options.indexPath || join(projectRoot, contextDir, 'vector_index.json');
+        this.#data = new Map();
+        this.#dirty = false;
+    }
+    async init() {
+        this.#load();
+    }
+    /**
+     * 同步初始化 — 供 ServiceContainer 懒加载工厂使用
+     * （#load 本身就是同步的 readFileSync，无需 await）
+     */
+    initSync() {
+        this.#load();
+    }
+    async upsert(item) {
+        if (!item?.id) {
+            throw new Error('Item must have an id');
+        }
+        this.#data.set(item.id, {
+            id: item.id,
+            content: item.content || '',
+            vector: item.vector || [],
+            metadata: item.metadata || {},
+            updatedAt: Date.now(),
+        });
+        this.#dirty = true;
+        this.#autoSave();
+    }
+    async batchUpsert(items) {
+        for (const item of items) {
+            if (!item?.id) {
+                continue;
+            }
+            this.#data.set(item.id, {
+                id: item.id,
+                content: item.content || '',
+                vector: item.vector || [],
+                metadata: item.metadata || {},
+                updatedAt: Date.now(),
+            });
+        }
+        this.#dirty = true;
+        this.#autoSave();
+    }
+    async remove(id) {
+        this.#data.delete(id);
+        this.#dirty = true;
+        this.#autoSave();
+    }
+    async getById(id) {
+        return this.#data.get(id) || null;
+    }
+    /**
+     * 向量相似度搜索（余弦相似度）
+     */
+    async searchVector(queryVector, options = {}) {
+        const { topK = 10, filter = null, minScore = 0 } = options;
+        if (!queryVector || queryVector.length === 0) {
+            return [];
+        }
+        let candidates = [...this.#data.values()];
+        // 应用过滤
+        if (filter) {
+            candidates = this.#applyFilter(candidates, filter);
+        }
+        // 计算余弦相似度
+        const scored = candidates
+            .filter((item) => item.vector && item.vector.length > 0)
+            .map((item) => ({
+            item,
+            score: this.#cosineSimilarity(queryVector, item.vector),
+        }))
+            .filter((result) => result.score >= minScore)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK);
+        return scored;
+    }
+    /**
+     * 混合搜索：向量 70% + 关键词 30%
+     */
+    async hybridSearch(queryVector, queryText, options = {}) {
+        const { topK = 10, filter = null } = options;
+        let candidates = [...this.#data.values()];
+        if (filter) {
+            candidates = this.#applyFilter(candidates, filter);
+        }
+        const scored = candidates
+            .map((item) => {
+            // 向量分数
+            let vectorScore = 0;
+            if (queryVector && queryVector.length > 0 && item.vector && item.vector.length > 0) {
+                vectorScore = this.#cosineSimilarity(queryVector, item.vector);
+            }
+            // 关键词分数
+            let keywordScore = 0;
+            if (queryText) {
+                const text = (item.content || '').toLowerCase();
+                const query = queryText.toLowerCase();
+                const words = query.split(/\s+/);
+                const hits = words.filter((w) => text.includes(w)).length;
+                keywordScore = words.length > 0 ? hits / words.length : 0;
+            }
+            return {
+                item,
+                score: vectorScore * 0.7 + keywordScore * 0.3,
+                vectorScore,
+                keywordScore,
+            };
+        })
+            .filter((r) => r.score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK);
+        return scored;
+    }
+    /**
+     * query() — SearchEngine / RetrievalFunnel 使用的向量搜索别名
+     * 接口: query(vector, topK) → Array<{ id, similarity, metadata }>
+     */
+    async query(queryVector, topK = 10) {
+        const results = await this.searchVector(queryVector, { topK });
+        return results.map((r) => ({
+            id: r.item.id,
+            similarity: r.score,
+            score: r.score,
+            content: r.item.content,
+            metadata: r.item.metadata || {},
+        }));
+    }
+    async searchByFilter(filter) {
+        return this.#applyFilter([...this.#data.values()], filter);
+    }
+    async listIds() {
+        return [...this.#data.keys()];
+    }
+    async clear() {
+        this.#data.clear();
+        this.#dirty = true;
+        this.#autoSave();
+    }
+    async getStats() {
+        let indexSize = 0;
+        try {
+            if (existsSync(this.#indexPath)) {
+                indexSize = statSync(this.#indexPath).size;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return {
+            count: this.#data.size,
+            indexSize,
+            indexPath: this.#indexPath,
+            hasVectors: [...this.#data.values()].filter((d) => d.vector?.length > 0).length,
+        };
+    }
+    // --- 私有方法 ---
+    #applyFilter(items, filter) {
+        return items.filter((item) => {
+            const meta = item.metadata || {};
+            if (filter.type && meta.type !== filter.type) {
+                return false;
+            }
+            if (filter.category && meta.category !== filter.category) {
+                return false;
+            }
+            if (filter.language && meta.language !== filter.language) {
+                return false;
+            }
+            if (filter.sourcePath &&
+                !meta.sourcePath?.includes(filter.sourcePath)) {
+                return false;
+            }
+            if (filter.module && meta.module !== filter.module) {
+                return false;
+            }
+            if (filter.tags && Array.isArray(filter.tags)) {
+                const itemTags = meta.tags || [];
+                if (!filter.tags.some((t) => itemTags.includes(t))) {
+                    return false;
+                }
+            }
+            if (filter.deprecated === false && meta.deprecated) {
+                return false;
+            }
+            return true;
+        });
+    }
+    #cosineSimilarity(a, b) {
+        return cosineSimilarity(a, b);
+    }
+    #load() {
+        try {
+            if (!existsSync(this.#indexPath)) {
+                return;
+            }
+            const raw = readFileSync(this.#indexPath, 'utf-8');
+            const items = JSON.parse(raw);
+            if (Array.isArray(items)) {
+                for (const item of items) {
+                    if (item?.id) {
+                        this.#data.set(item.id, item);
+                    }
+                }
+            }
+            else if (typeof items === 'object') {
+                // 兼容旧格式 { id: item }
+                for (const [id, item] of Object.entries(items)) {
+                    this.#data.set(id, { ...item, id });
+                }
+            }
+        }
+        catch {
+            /* silent: start empty */
+        }
+    }
+    #autoSave() {
+        if (!this.#dirty) {
+            return;
+        }
+        try {
+            const dir = dirname(this.#indexPath);
+            pathGuard.assertProjectWriteSafe(dir);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const items = [...this.#data.values()];
+            writeFileSync(this.#indexPath, JSON.stringify(items, null, 2));
+            this.#dirty = false;
+        }
+        catch {
+            /* silent */
+        }
+    }
+}
+//# sourceMappingURL=JsonVectorAdapter.js.map

package/dist/lib/infrastructure/vector/JsonVectorAdapter.js.map

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

package/dist/lib/infrastructure/vector/ScalarQuantizer.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ScalarQuantizer — SQ8 标量量化器
+ *
+ * 将 Float32 向量映射到 Uint8 (0-255)，使用 per-dimension min/max 线性缩放:
+ *   q_i = round((v_i - min_i) / (max_i - min_i) * 255)
+ *   v̂_i = q_i / 255 * (max_i - min_i) + min_i
+ *
+ * 优势:
+ * - 内存: 768 维 × 4 bytes → 768 维 × 1 byte = 75% 节省
+ * - Recall: > 95% (误差极小)
+ *
+ * @module infrastructure/vector/ScalarQuantizer
+ */
+export declare class ScalarQuantizer {
+    #private;
+    /**
+     * @param {number} dimension 向量维度
+     */
+    constructor(dimension: number);
+    get dimension(): number;
+    get trained(): boolean;
+    /**
+     * 训练量化器 — 从一批向量中统计 per-dimension min/max
+     * @param {Array<Float32Array|number[]>} vectors 训练集 (建议 ≥ 100 条)
+     */
+    train(vectors: Array<Float32Array | number[]>): void;
+    /**
+     * 量化单个向量
+     * @param {Float32Array|number[]} vector
+     * @returns {Uint8Array}
+     */
+    encode(vector: Float32Array | number[]): Uint8Array<ArrayBuffer>;
+    /**
+     * 批量量化
+     * @param {Array<Float32Array|number[]>} vectors
+     * @returns {Uint8Array[]}
+     */
+    encodeBatch(vectors: Array<Float32Array | number[]>): Uint8Array<ArrayBuffer>[];
+    /**
+     * 反量化 (用于精排 re-rank)
+     * @param {Uint8Array} quantized
+     * @returns {Float32Array}
+     */
+    decode(quantized: Uint8Array): Float32Array<ArrayBuffer>;
+    /**
+     * 量化空间内的距离计算 (避免反量化, 整数运算)
+     * 使用 L2 on quantized space 近似余弦距离
+     *
+     * @param {Uint8Array} a
+     * @param {Uint8Array} b
+     * @returns {number} 距离值 (越小越相似)
+     */
+    distance(a: Uint8Array, b: Uint8Array): number;
+    /**
+     * 混合距离: 量化粗排 + 原始精排
+     * 用于搜索时: 先用 SQ8 快速过滤, 再用 Float32 精确计算
+     *
+     * @param {Uint8Array} quantizedA
+     * @param {Float32Array|number[]} originalA
+     * @param {Uint8Array} quantizedB
+     * @param {Float32Array|number[]} originalB
+     * @returns {{ coarse: number, fine: number }}
+     */
+    hybridDistance(quantizedA: Uint8Array, originalA: Float32Array | number[], quantizedB: Uint8Array, originalB: Float32Array | number[]): {
+        coarse: number;
+        fine: number;
+    };
+    /**
+     * 序列化量化器参数
+     * @returns {{ dimension: number, mins: number[], maxs: number[] }}
+     */
+    serialize(): {
+        dimension: number;
+        mins: number[];
+        maxs: number[];
+    };
+    /**
+     * 从序列化数据恢复量化器
+     * @param {{ dimension: number, mins: number[], maxs: number[] }} data
+     * @returns {ScalarQuantizer}
+     */
+    static deserialize(data: {
+        dimension: number;
+        mins: number[];
+        maxs: number[];
+    }): ScalarQuantizer;
+}
+//# sourceMappingURL=ScalarQuantizer.d.ts.map

package/dist/lib/infrastructure/vector/ScalarQuantizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScalarQuantizer.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/vector/ScalarQuantizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qBAAa,eAAe;;IAU1B;;OAEG;gBACS,SAAS,EAAE,MAAM;IAO7B,IAAI,SAAS,WAEZ;IAED,IAAI,OAAO,YAEV;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC;IAkC7C;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE;IAoBtC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC;IAInD;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,UAAU;IAiB5B;;;;;;;OAOG;IACH,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU;IAWrC;;;;;;;;;OASG;IACH,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE;;;;IA+BpC;;;OAGG;IACH,SAAS;;;;;IAQT;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;CAa/E"}

package/dist/lib/infrastructure/vector/ScalarQuantizer.js

@@ -0,0 +1,202 @@
+/**
+ * ScalarQuantizer — SQ8 标量量化器
+ *
+ * 将 Float32 向量映射到 Uint8 (0-255)，使用 per-dimension min/max 线性缩放:
+ *   q_i = round((v_i - min_i) / (max_i - min_i) * 255)
+ *   v̂_i = q_i / 255 * (max_i - min_i) + min_i
+ *
+ * 优势:
+ * - 内存: 768 维 × 4 bytes → 768 维 × 1 byte = 75% 节省
+ * - Recall: > 95% (误差极小)
+ *
+ * @module infrastructure/vector/ScalarQuantizer
+ */
+export class ScalarQuantizer {
+    #dimension;
+    /** @type {Float32Array} 每维最小值 */
+    #mins;
+    /** @type {Float32Array} 每维最大值 */
+    #maxs;
+    /** @type {Float32Array} 每维范围 (max - min), 预计算避免重复减法 */
+    #ranges;
+    #trained = false;
+    /**
+     * @param {number} dimension 向量维度
+     */
+    constructor(dimension) {
+        this.#dimension = dimension;
+        this.#mins = new Float32Array(dimension);
+        this.#maxs = new Float32Array(dimension);
+        this.#ranges = new Float32Array(dimension);
+    }
+    get dimension() {
+        return this.#dimension;
+    }
+    get trained() {
+        return this.#trained;
+    }
+    /**
+     * 训练量化器 — 从一批向量中统计 per-dimension min/max
+     * @param {Array<Float32Array|number[]>} vectors 训练集 (建议 ≥ 100 条)
+     */
+    train(vectors) {
+        if (!vectors || vectors.length === 0) {
+            throw new Error('ScalarQuantizer.train() requires at least 1 vector');
+        }
+        const dim = this.#dimension;
+        const mins = new Float32Array(dim).fill(Infinity);
+        const maxs = new Float32Array(dim).fill(-Infinity);
+        for (const vec of vectors) {
+            for (let i = 0; i < dim; i++) {
+                const v = vec[i] || 0;
+                if (v < mins[i]) {
+                    mins[i] = v;
+                }
+                if (v > maxs[i]) {
+                    maxs[i] = v;
+                }
+            }
+        }
+        // 防止 range = 0 (所有值相同的维度), 设置最小范围
+        const ranges = new Float32Array(dim);
+        for (let i = 0; i < dim; i++) {
+            const range = maxs[i] - mins[i];
+            ranges[i] = range > 1e-10 ? range : 1e-10;
+        }
+        this.#mins = mins;
+        this.#maxs = maxs;
+        this.#ranges = ranges;
+        this.#trained = true;
+    }
+    /**
+     * 量化单个向量
+     * @param {Float32Array|number[]} vector
+     * @returns {Uint8Array}
+     */
+    encode(vector) {
+        if (!this.#trained) {
+            throw new Error('ScalarQuantizer not trained. Call train() first.');
+        }
+        const dim = this.#dimension;
+        const result = new Uint8Array(dim);
+        const mins = this.#mins;
+        const ranges = this.#ranges;
+        for (let i = 0; i < dim; i++) {
+            const v = vector[i] || 0;
+            // 钳位到 [min, max] 范围, 然后映射到 [0, 255]
+            const normalized = (v - mins[i]) / ranges[i];
+            result[i] = Math.max(0, Math.min(255, Math.round(normalized * 255)));
+        }
+        return result;
+    }
+    /**
+     * 批量量化
+     * @param {Array<Float32Array|number[]>} vectors
+     * @returns {Uint8Array[]}
+     */
+    encodeBatch(vectors) {
+        return vectors.map((v) => this.encode(v));
+    }
+    /**
+     * 反量化 (用于精排 re-rank)
+     * @param {Uint8Array} quantized
+     * @returns {Float32Array}
+     */
+    decode(quantized) {
+        if (!this.#trained) {
+            throw new Error('ScalarQuantizer not trained.');
+        }
+        const dim = this.#dimension;
+        const result = new Float32Array(dim);
+        const mins = this.#mins;
+        const ranges = this.#ranges;
+        for (let i = 0; i < dim; i++) {
+            result[i] = (quantized[i] / 255) * ranges[i] + mins[i];
+        }
+        return result;
+    }
+    /**
+     * 量化空间内的距离计算 (避免反量化, 整数运算)
+     * 使用 L2 on quantized space 近似余弦距离
+     *
+     * @param {Uint8Array} a
+     * @param {Uint8Array} b
+     * @returns {number} 距离值 (越小越相似)
+     */
+    distance(a, b) {
+        const dim = this.#dimension;
+        let sum = 0;
+        for (let i = 0; i < dim; i++) {
+            const diff = a[i] - b[i];
+            sum += diff * diff;
+        }
+        // 归一化到 ~[0, 1] 范围:  max possible = 255² × dim
+        return sum / (255 * 255 * dim);
+    }
+    /**
+     * 混合距离: 量化粗排 + 原始精排
+     * 用于搜索时: 先用 SQ8 快速过滤, 再用 Float32 精确计算
+     *
+     * @param {Uint8Array} quantizedA
+     * @param {Float32Array|number[]} originalA
+     * @param {Uint8Array} quantizedB
+     * @param {Float32Array|number[]} originalB
+     * @returns {{ coarse: number, fine: number }}
+     */
+    hybridDistance(quantizedA, originalA, quantizedB, originalB) {
+        return {
+            coarse: this.distance(quantizedA, quantizedB),
+            fine: ScalarQuantizer.#cosineDistanceFloat(originalA, originalB),
+        };
+    }
+    /**
+     * 余弦距离 (Float32 精确计算)
+     * @param {Float32Array|number[]} a
+     * @param {Float32Array|number[]} b
+     * @returns {number}
+     */
+    static #cosineDistanceFloat(a, b) {
+        if (!a || !b || a.length === 0) {
+            return 1;
+        }
+        const len = Math.min(a.length, b.length);
+        let dot = 0, normA = 0, normB = 0;
+        for (let i = 0; i < len; i++) {
+            dot += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denom = Math.sqrt(normA) * Math.sqrt(normB);
+        return denom === 0 ? 1 : 1 - dot / denom;
+    }
+    /**
+     * 序列化量化器参数
+     * @returns {{ dimension: number, mins: number[], maxs: number[] }}
+     */
+    serialize() {
+        return {
+            dimension: this.#dimension,
+            mins: Array.from(this.#mins),
+            maxs: Array.from(this.#maxs),
+        };
+    }
+    /**
+     * 从序列化数据恢复量化器
+     * @param {{ dimension: number, mins: number[], maxs: number[] }} data
+     * @returns {ScalarQuantizer}
+     */
+    static deserialize(data) {
+        const q = new ScalarQuantizer(data.dimension);
+        q.#mins = new Float32Array(data.mins);
+        q.#maxs = new Float32Array(data.maxs);
+        const ranges = new Float32Array(data.dimension);
+        for (let i = 0; i < data.dimension; i++) {
+            const range = q.#maxs[i] - q.#mins[i];
+            ranges[i] = range > 1e-10 ? range : 1e-10;
+        }
+        q.#ranges = ranges;
+        q.#trained = true;
+        return q;
+    }
+}
+//# sourceMappingURL=ScalarQuantizer.js.map

package/dist/lib/infrastructure/vector/ScalarQuantizer.js.map

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

package/dist/lib/infrastructure/vector/VectorMigration.d.ts

@@ -0,0 +1,34 @@
+/**
+ * VectorMigration — JSON → HNSW 二进制索引自动迁移
+ *
+ * 场景:
+ * 1. 首次启动, 无任何索引 → 返回 'new'
+ * 2. 存在 vector_index.json → 读取 JSON, 批量插入 HNSW, 重命名旧文件
+ * 3. 存在 .asvec 二进制索引 → 返回 'binary' (已迁移)
+ *
+ * @module infrastructure/vector/VectorMigration
+ */
+export declare class VectorMigration {
+    /**
+     * 检测并执行自动迁移
+     *
+     * @param {string} indexDir - 索引目录路径
+     * @param {import('./HnswVectorAdapter.js').HnswVectorAdapter} adapter - HNSW 适配器实例
+     * @returns {Promise<'new'|'migrated'|'binary'>}
+     */
+    static migrate(indexDir: string, adapter: {
+        batchUpsert: (items: Array<{
+            id: string;
+            content: string;
+            vector: number[];
+            metadata: Record<string, unknown>;
+        }>) => Promise<void>;
+    }): Promise<"binary" | "new" | "migrated">;
+    /**
+     * 检查是否需要迁移
+     * @param {string} indexDir
+     * @returns {boolean}
+     */
+    static needsMigration(indexDir: string): boolean;
+}
+//# sourceMappingURL=VectorMigration.d.ts.map

package/dist/lib/infrastructure/vector/VectorMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorMigration.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/vector/VectorMigration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,qBAAa,eAAe;IAC1B;;;;;;OAMG;WACU,OAAO,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QACP,WAAW,EAAE,CACX,KAAK,EAAE,KAAK,CAAC;YACX,EAAE,EAAE,MAAM,CAAC;YACX,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC,KACC,OAAO,CAAC,IAAI,CAAC,CAAC;KACpB;IA+DH;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM;CAKvC"}