autosnippet 3.2.16 → 3.2.18

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

@@ -100,7 +100,7 @@ const LANG_ID_MAP = {
 };
 /**
  * 初始化 AST 解析器 (幂等, 延迟加载)
- * @returns {Promise<boolean>} 是否成功初始化
+ * @returns 是否成功初始化
  */
 async function ensureParser() {
     if (_astReady) {
@@ -122,8 +122,7 @@ async function ensureParser() {
 }
 /**
  * 检查 ASTChunker 是否支持指定语言
- * @param {string} language - LanguageService.inferLang() 返回的语言 ID
- * @returns {boolean}
+ * @param language LanguageService.inferLang() 返回的语言 ID
  */
 export function isASTChunkerAvailable(language) {
     if (!_astReady || !_supportedLanguages) {
@@ -143,12 +142,10 @@ export function isASTChunkerAvailable(language) {
  * 4. 超大节点递归拆分 (按子节点边界)
  * 5. 非声明代码 (import, 注释等) 合并为一个 chunk
  *
- * @param {string} content 源代码
- * @param {string} language 语言标识 (来自 LanguageService.inferLang)
- * @param {object} metadata 基础 metadata
- * @param {object} [options]
- * @param {number} [options.maxChunkTokens=512]
- * @returns {Array<{ content: string, metadata: object }>}
+ * @param content 源代码
+ * @param language 语言标识 (来自 LanguageService.inferLang)
+ * @param metadata 基础 metadata
+ * @returns >}
  */
 export function chunkByAST(content, language, metadata = {}, options = {}) {
     const { maxChunkTokens = 512 } = options;
@@ -241,11 +238,9 @@ export function chunkByAST(content, language, metadata = {}, options = {}) {
  *
  * 策略: 按子节点边界分组, 直到每组 ≤ maxChunkTokens
  *
- * @param {object} node tree-sitter AST node
- * @param {string} source 完整源代码
- * @param {object} metadata
- * @param {number} maxChunkTokens
- * @returns {Array<{ content: string, metadata: object }>}
+ * @param node tree-sitter AST node
+ * @param source 完整源代码
+ * @returns >}
  */
 function splitLargeNode(node, source, metadata, maxChunkTokens) {
     const chunks = [];
@@ -324,9 +319,7 @@ function splitLargeNode(node, source, metadata, maxChunkTokens) {
     }
     return chunks;
 }
-/**
- * 按行切割 (最后手段, 当 AST 无法进一步拆分时)
- */
+/** 按行切割 (最后手段, 当 AST 无法进一步拆分时) */
 function splitByLines(text, metadata, node, parentName, maxChunkTokens) {
     const lines = text.split('\n');
     const chunks = [];
@@ -366,8 +359,7 @@ function splitByLines(text, metadata, node, parentName, maxChunkTokens) {
 }
 /**
  * 从 AST 节点提取名称
- * @param {object} node tree-sitter node
- * @returns {string|undefined}
+ * @param node tree-sitter node
  */
 function extractNodeName(node) {
     // 常见模式: 节点有 name 子节点
@@ -386,4 +378,3 @@ function extractNodeName(node) {
     return undefined;
 }
 export { ensureParser, TOP_LEVEL_TYPES, LANG_ID_MAP };
-//# sourceMappingURL=ASTChunker.js.map

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

@@ -21,20 +21,16 @@ export declare const WAL_OP: Readonly<{
 }>;
 /**
  * 计算字符串的 CRC32 校验值
- * @param {string} str
- * @returns {string} 8 位十六进制字符串
+ * @returns 8 位十六进制字符串
  */
 declare function crc32(str: string): string;
 export declare class AsyncPersistence {
     #private;
     /**
-     * @param {object} options
-     * @param {string} options.indexPath - 主索引文件路径 (.asvec)
-     * @param {function} options.onPersist - persist 回调: async () => void (写完整 .asvec)
-     * @param {function} options.onReplay - replay 回调: (op) => void (重放单条操作)
-     * @param {boolean}  [options.enabled=true] - 是否启用 WAL
-     * @param {number}   [options.flushIntervalMs=2000]
-     * @param {number}   [options.flushBatchSize=100]
+     * @param options.indexPath 主索引文件路径 (.asvec)
+     * @param options.onPersist persist 回调: async () => void (写完整 .asvec)
+     * @param options.onReplay replay 回调: (op) => void (重放单条操作)
+     * @param [options.enabled=true] 是否启用 WAL
      */
     constructor(options: {
         indexPath: string;
@@ -54,31 +50,27 @@ export declare class AsyncPersistence {
      * 追加操作到 WAL
      * 操作同时写入磁盘 WAL 文件 (append) 和内存队列
      *
-     * @param {object} op - WAL 操作
-     * @param {number} op.t - 操作类型: 1=upsert, 2=remove, 3=clear
-     * @param {string} [op.id] - 文档 ID
-     * @param {string} [op.c] - 内容 (upsert)
-     * @param {number[]} [op.v] - 向量 (upsert)
-     * @param {object} [op.m] - metadata (upsert)
+     * @param op WAL 操作
+     * @param op.t 操作类型: 1=upsert, 2=remove, 3=clear
+     * @param [op.id] 文档 ID
+     * @param [op.c] 内容 (upsert)
+     * @param [op.v] 向量 (upsert)
+     * @param [op.m] metadata (upsert)
      */
     appendWal(op: Record<string, unknown>): void;
-    /**
-     * 手动触发 flush (用于关闭/测试)
-     */
+    /** 手动触发 flush (用于关闭/测试) */
     flush(): Promise<void>;
     /**
      * 启动时恢复: 读取 WAL 文件, replay 有效条目
      * WAL 条目带 CRC32 校验, 损坏条目跳过
      *
-     * @returns {{ replayed: number, skipped: number }}
+     * @returns }
      */
     recover(): {
         replayed: number;
         skipped: number;
     };
-    /**
-     * 销毁: 清理定时器
-     */
+    /** 销毁: 清理定时器 */
     destroy(): void;
     /**
      * 同步 flush (用于进程退出时)
@@ -87,4 +79,3 @@ export declare class AsyncPersistence {
     destroySync(): void;
 }
 export { crc32 };
-//# sourceMappingURL=AsyncPersistence.d.ts.map

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

@@ -39,8 +39,7 @@ const CRC32_TABLE = (() => {
 })();
 /**
  * 计算字符串的 CRC32 校验值
- * @param {string} str
- * @returns {string} 8 位十六进制字符串
+ * @returns 8 位十六进制字符串
  */
 function crc32(str) {
     const bytes = Buffer.from(str, 'utf-8');
@@ -57,9 +56,7 @@ export class AsyncPersistence {
     #walPath;
     /** @type {Array<object>} 待刷盘操作队列 */
     #pendingOps = [];
-    /** @type {ReturnType<typeof setTimeout>|null} */
     #flushTimer = null;
-    /** @type {boolean} */
     #flushing = false;
     /** @type {number} flush 间隔 (ms) */
     #flushIntervalMs;
@@ -72,13 +69,10 @@ export class AsyncPersistence {
     /** @type {boolean} WAL 是否启用 */
     #enabled;
     /**
-     * @param {object} options
-     * @param {string} options.indexPath - 主索引文件路径 (.asvec)
-     * @param {function} options.onPersist - persist 回调: async () => void (写完整 .asvec)
-     * @param {function} options.onReplay - replay 回调: (op) => void (重放单条操作)
-     * @param {boolean}  [options.enabled=true] - 是否启用 WAL
-     * @param {number}   [options.flushIntervalMs=2000]
-     * @param {number}   [options.flushBatchSize=100]
+     * @param options.indexPath 主索引文件路径 (.asvec)
+     * @param options.onPersist persist 回调: async () => void (写完整 .asvec)
+     * @param options.onReplay replay 回调: (op) => void (重放单条操作)
+     * @param [options.enabled=true] 是否启用 WAL
      */
     constructor(options) {
         this.#indexPath = options.indexPath;
@@ -110,12 +104,12 @@ export class AsyncPersistence {
      * 追加操作到 WAL
      * 操作同时写入磁盘 WAL 文件 (append) 和内存队列
      *
-     * @param {object} op - WAL 操作
-     * @param {number} op.t - 操作类型: 1=upsert, 2=remove, 3=clear
-     * @param {string} [op.id] - 文档 ID
-     * @param {string} [op.c] - 内容 (upsert)
-     * @param {number[]} [op.v] - 向量 (upsert)
-     * @param {object} [op.m] - metadata (upsert)
+     * @param op WAL 操作
+     * @param op.t 操作类型: 1=upsert, 2=remove, 3=clear
+     * @param [op.id] 文档 ID
+     * @param [op.c] 内容 (upsert)
+     * @param [op.v] 向量 (upsert)
+     * @param [op.m] metadata (upsert)
      */
     appendWal(op) {
         if (!this.#enabled) {
@@ -140,9 +134,7 @@ export class AsyncPersistence {
             // 写入失败非致命: 操作已在内存队列, flush 时会写入完整文件
         }
     }
-    /**
-     * 调度 flush (debounced)
-     */
+    /** 调度 flush (debounced) */
     #scheduleFlush() {
         if (this.#flushing) {
             return;
@@ -164,9 +156,7 @@ export class AsyncPersistence {
             this.#flushTimer.unref();
         }
     }
-    /**
-     * 执行 flush: 写入完整 .asvec + 清理 WAL
-     */
+    /** 执行 flush: 写入完整 .asvec + 清理 WAL */
     async #doFlush() {
         if (this.#flushing) {
             return;
@@ -191,9 +181,7 @@ export class AsyncPersistence {
             this.#flushing = false;
         }
     }
-    /**
-     * 手动触发 flush (用于关闭/测试)
-     */
+    /** 手动触发 flush (用于关闭/测试) */
     async flush() {
         // 取消待执行的定时器
         if (this.#flushTimer) {
@@ -206,7 +194,7 @@ export class AsyncPersistence {
      * 启动时恢复: 读取 WAL 文件, replay 有效条目
      * WAL 条目带 CRC32 校验, 损坏条目跳过
      *
-     * @returns {{ replayed: number, skipped: number }}
+     * @returns }
      */
     recover() {
         if (!this.#enabled) {
@@ -254,9 +242,7 @@ export class AsyncPersistence {
         }
         return { replayed, skipped };
     }
-    /**
-     * 清理 WAL 文件
-     */
+    /** 清理 WAL 文件 */
     #clearWal() {
         try {
             if (existsSync(this.#walPath)) {
@@ -267,9 +253,7 @@ export class AsyncPersistence {
             // 删除失败非致命
         }
     }
-    /**
-     * 销毁: 清理定时器
-     */
+    /** 销毁: 清理定时器 */
     destroy() {
         if (this.#flushTimer) {
             clearTimeout(this.#flushTimer);
@@ -289,4 +273,3 @@ export class AsyncPersistence {
 }
 // 导出 CRC32 工具函数 (用于测试)
 export { crc32 };
-//# sourceMappingURL=AsyncPersistence.js.map

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

@@ -15,12 +15,7 @@
  */
 export declare class BatchEmbedder {
     #private;
-    /**
-     * @param {object} aiProvider - AI Provider (需实现 embed(text|string[]) 方法)
-     * @param {object} [options]
-     * @param {number} [options.batchSize=32]
-     * @param {number} [options.maxConcurrency=2]
-     */
+    /** @param aiProvider AI Provider (需实现 embed(text|string[]) 方法) */
     constructor(aiProvider: {
         embed: (text: string | string[]) => Promise<number[] | number[][]>;
     }, options?: {
@@ -31,12 +26,11 @@ export declare class BatchEmbedder {
      * 批量 embed 文本
      *
      * @param {Array<{ id: string, content: string }>} items
-     * @param {function} [onProgress] - (embedded, total) => void
-     * @returns {Promise<Map<string, number[]>>} id → vector
+     * @param [onProgress] (embedded, total) => void
+     * @returns id → vector
      */
     embedAll(items: Array<{
         id: string;
         content: string;
     }>, onProgress?: (embedded: number, total: number) => void): Promise<Map<any, any>>;
 }
-//# sourceMappingURL=BatchEmbedder.d.ts.map

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

@@ -18,12 +18,7 @@ export class BatchEmbedder {
     #aiProvider;
     #batchSize;
     #maxConcurrency;
-    /**
-     * @param {object} aiProvider - AI Provider (需实现 embed(text|string[]) 方法)
-     * @param {object} [options]
-     * @param {number} [options.batchSize=32]
-     * @param {number} [options.maxConcurrency=2]
-     */
+    /** @param aiProvider AI Provider (需实现 embed(text|string[]) 方法) */
     constructor(aiProvider, options = {}) {
         this.#aiProvider = aiProvider;
         this.#batchSize = options.batchSize || 32;
@@ -33,8 +28,8 @@ export class BatchEmbedder {
      * 批量 embed 文本
      *
      * @param {Array<{ id: string, content: string }>} items
-     * @param {function} [onProgress] - (embedded, total) => void
-     * @returns {Promise<Map<string, number[]>>} id → vector
+     * @param [onProgress] (embedded, total) => void
+     * @returns id → vector
      */
     async embedAll(items, onProgress) {
         if (!this.#aiProvider || typeof this.#aiProvider.embed !== 'function') {
@@ -57,7 +52,6 @@ export class BatchEmbedder {
     /**
      * embed 单个批次
      * @param {Array<{ id: string, content: string }>} items
-     * @returns {Promise<Map<string, number[]>>}
      */
     async #embedBatch(items) {
         const result = new Map();
@@ -113,12 +107,7 @@ export class BatchEmbedder {
         }
         return result;
     }
-    /**
-     * 将数组分成固定大小的批次
-     * @param {Array} arr
-     * @param {number} size
-     * @returns {Array<Array>}
-     */
+    /** 将数组分成固定大小的批次 */
     #chunkArray(arr, size) {
         const chunks = [];
         for (let i = 0; i < arr.length; i += size) {
@@ -127,4 +116,3 @@ export class BatchEmbedder {
         return chunks;
     }
 }
-//# sourceMappingURL=BatchEmbedder.js.map

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

@@ -59,12 +59,11 @@ export declare class BinaryPersistence {
     /**
      * 保存 HNSW 索引到二进制文件 (同步)
      *
-     * @param {string} filePath - 文件路径 (.asvec)
-     * @param {object} data
-     * @param {import('./HnswIndex.js').HnswIndex} data.index - HNSW 索引
-     * @param {import('./ScalarQuantizer.js').ScalarQuantizer|null} data.quantizer - 量化器
-     * @param {Map<string, object>} data.metadata - 文档 metadata
-     * @param {Map<string, string>} data.contents - 文档 content
+     * @param filePath 文件路径 (.asvec)
+     * @param data.index HNSW 索引
+     * @param data.quantizer 量化器
+     * @param data.metadata 文档 metadata
+     * @param data.contents 文档 content
      */
     static save(filePath: string, data: {
         index: {
@@ -74,11 +73,7 @@ export declare class BinaryPersistence {
         metadata: Map<string, unknown>;
         contents: Map<string, string>;
     }): void;
-    /**
-     * 异步保存
-     * @param {string} filePath
-     * @param {object} data
-     */
+    /** 异步保存 */
     static saveAsync(filePath: string, data: {
         index: {
             serialize: () => HnswSerializedData;
@@ -89,8 +84,7 @@ export declare class BinaryPersistence {
     }): Promise<void>;
     /**
      * 加载二进制索引 (同步)
-     * @param {string} filePath
-     * @returns {{ index: object, quantizer: ScalarQuantizer|null, metadata: Map, contents: Map }}
+     * @returns }
      */
     static load(filePath: string): {
         indexData: {
@@ -116,11 +110,7 @@ export declare class BinaryPersistence {
         contents: Map<any, any>;
         dimension: number;
     };
-    /**
-     * 编码为 Buffer
-     * @param {object} data
-     * @returns {Buffer}
-     */
+    /** 编码为 Buffer */
     static encode(data: {
         index: {
             serialize: () => HnswSerializedData;
@@ -131,8 +121,7 @@ export declare class BinaryPersistence {
     }): Buffer<ArrayBuffer>;
     /**
      * 从 Buffer 解码
-     * @param {Buffer} buf
-     * @returns {{ indexData: object, quantizerData: object|null, metadata: Map, contents: Map, dimension: number }}
+     * @returns }
      */
     static decode(buf: Buffer): {
         indexData: {
@@ -158,12 +147,7 @@ export declare class BinaryPersistence {
         contents: Map<any, any>;
         dimension: number;
     };
-    /**
-     * 检查文件是否为有效的 ASVEC 文件
-     * @param {string} filePath
-     * @returns {boolean}
-     */
+    /** 检查文件是否为有效的 ASVEC 文件 */
     static isValid(filePath: string): boolean;
 }
 export { MAGIC, VERSION, HEADER_SIZE, FLAG_HAS_QUANTIZER, FLAG_HAS_HNSW_GRAPH, FLAG_SQ8_VECTORS };
-//# sourceMappingURL=BinaryPersistence.d.ts.map

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

@@ -48,12 +48,11 @@ export class BinaryPersistence {
     /**
      * 保存 HNSW 索引到二进制文件 (同步)
      *
-     * @param {string} filePath - 文件路径 (.asvec)
-     * @param {object} data
-     * @param {import('./HnswIndex.js').HnswIndex} data.index - HNSW 索引
-     * @param {import('./ScalarQuantizer.js').ScalarQuantizer|null} data.quantizer - 量化器
-     * @param {Map<string, object>} data.metadata - 文档 metadata
-     * @param {Map<string, string>} data.contents - 文档 content
+     * @param filePath 文件路径 (.asvec)
+     * @param data.index HNSW 索引
+     * @param data.quantizer 量化器
+     * @param data.metadata 文档 metadata
+     * @param data.contents 文档 content
      */
     static save(filePath, data) {
         const buffer = BinaryPersistence.encode(data);
@@ -63,11 +62,7 @@ export class BinaryPersistence {
         }
         writeFileSync(filePath, buffer);
     }
-    /**
-     * 异步保存
-     * @param {string} filePath
-     * @param {object} data
-     */
+    /** 异步保存 */
     static async saveAsync(filePath, data) {
         const buffer = BinaryPersistence.encode(data);
         const dir = dirname(filePath);
@@ -78,18 +73,13 @@ export class BinaryPersistence {
     }
     /**
      * 加载二进制索引 (同步)
-     * @param {string} filePath
-     * @returns {{ index: object, quantizer: ScalarQuantizer|null, metadata: Map, contents: Map }}
+     * @returns }
      */
     static load(filePath) {
         const fileBuffer = readFileSync(filePath);
         return BinaryPersistence.decode(fileBuffer);
     }
-    /**
-     * 编码为 Buffer
-     * @param {object} data
-     * @returns {Buffer}
-     */
+    /** 编码为 Buffer */
     static encode(data) {
         const { index, quantizer, metadata, contents } = data;
         const indexData = index.serialize();
@@ -237,8 +227,7 @@ export class BinaryPersistence {
     }
     /**
      * 从 Buffer 解码
-     * @param {Buffer} buf
-     * @returns {{ indexData: object, quantizerData: object|null, metadata: Map, contents: Map, dimension: number }}
+     * @returns }
      */
     static decode(buf) {
         let offset = 0;
@@ -368,11 +357,7 @@ export class BinaryPersistence {
             dimension,
         };
     }
-    /**
-     * 检查文件是否为有效的 ASVEC 文件
-     * @param {string} filePath
-     * @returns {boolean}
-     */
+    /** 检查文件是否为有效的 ASVEC 文件 */
     static isValid(filePath) {
         try {
             if (!existsSync(filePath)) {
@@ -391,4 +376,3 @@ export class BinaryPersistence {
     }
 }
 export { MAGIC, VERSION, HEADER_SIZE, FLAG_HAS_QUANTIZER, FLAG_HAS_HNSW_GRAPH, FLAG_SQ8_VECTORS };
-//# sourceMappingURL=BinaryPersistence.js.map

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

@@ -16,10 +16,9 @@ declare const DEFAULT_MAX_CHUNK_TOKENS = 512;
 declare const DEFAULT_OVERLAP_TOKENS = 50;
 /**
  * 将内容分块
- * @param {string} content
- * @param {object} metadata - { type, sourcePath, language, ... }
- * @param {object} options - { strategy, maxChunkTokens, overlapTokens, useAST }
- * @returns {Array<{ content: string, metadata: object }>}
+ * @param metadata { type, sourcePath, language, ... }
+ * @param options { strategy, maxChunkTokens, overlapTokens, useAST }
+ * @returns >}
  */
 export declare function chunk(content: string, metadata?: Record<string, unknown>, options?: {
     strategy?: string;
@@ -31,4 +30,3 @@ export declare function chunk(content: string, metadata?: Record<string, unknown
     metadata: Record<string, unknown>;
 }[];
 export { DEFAULT_MAX_CHUNK_TOKENS, DEFAULT_OVERLAP_TOKENS };
-//# sourceMappingURL=Chunker.d.ts.map

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

@@ -33,10 +33,9 @@ const CODE_LANGUAGES = new Set([
 ]);
 /**
  * 将内容分块
- * @param {string} content
- * @param {object} metadata - { type, sourcePath, language, ... }
- * @param {object} options - { strategy, maxChunkTokens, overlapTokens, useAST }
- * @returns {Array<{ content: string, metadata: object }>}
+ * @param metadata { type, sourcePath, language, ... }
+ * @param options { strategy, maxChunkTokens, overlapTokens, useAST }
+ * @returns >}
  */
 export function chunk(content, metadata = {}, options = {}) {
     const { strategy = 'auto', maxChunkTokens = DEFAULT_MAX_CHUNK_TOKENS, overlapTokens = DEFAULT_OVERLAP_TOKENS, useAST = true, } = options;
@@ -86,9 +85,7 @@ export function chunk(content, metadata = {}, options = {}) {
             return [{ content, metadata: { ...metadata, chunkIndex: 0, totalChunks: 1 } }];
     }
 }
-/**
- * 按 Markdown 标题分段
- */
+/** 按 Markdown 标题分段 */
 function chunkBySection(content, metadata, maxChunkTokens) {
     const sections = [];
     const lines = content.split('\n');
@@ -162,9 +159,7 @@ function chunkBySection(content, metadata, maxChunkTokens) {
     }
     return results;
 }
-/**
- * 固定大小分块（带重叠）
- */
+/** 固定大小分块（带重叠） */
 function chunkFixed(content, metadata, maxChunkTokens, overlapTokens) {
     const maxChars = maxChunkTokens * 4;
     const overlapChars = overlapTokens * 4;
@@ -200,4 +195,3 @@ function chunkFixed(content, metadata, maxChunkTokens, overlapTokens) {
     return results;
 }
 export { DEFAULT_MAX_CHUNK_TOKENS, DEFAULT_OVERLAP_TOKENS };
-//# sourceMappingURL=Chunker.js.map