@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/vector/SqliteVectorStore.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * SqliteVectorStore - SQLite 向量存储实现（使用 sqlite-vec 扩展）
+ *
+ * 设计思路：
+ * - sqlite-vec 的 vec0 表使用 rowid 作为主键
+ * - rowid 直接与 quints 表的 rowid 对应，无需额外映射
+ * - 通过 rowid JOIN quints 表即可关联业务数据
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteVectorStore = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const VectorStore_1 = require("./VectorStore");
+class SqliteVectorStore extends VectorStore_1.VectorStore {
+    constructor(options) {
+        super();
+        /** @ignored */
+        this.db = null;
+        let connStr = options.connectionString;
+        if (connStr.startsWith('sqlite:')) {
+            connStr = connStr.slice(7);
+        }
+        this.filename = connStr;
+    }
+    // ============================================
+    // Lifecycle (Initializable / Finalizable)
+    // ============================================
+    async initialize() {
+        await this.open();
+    }
+    async finalize() {
+        await this.close();
+    }
+    async open() {
+        if (this.db)
+            return;
+        // 确保目录存在
+        if (this.filename !== ':memory:') {
+            const dir = path_1.default.dirname(this.filename);
+            if (dir && dir !== '.' && !fs_1.default.existsSync(dir)) {
+                fs_1.default.mkdirSync(dir, { recursive: true });
+            }
+        }
+        this.db = new better_sqlite3_1.default(this.filename);
+        // 加载 sqlite-vec 扩展
+        const { load } = require('sqlite-vec');
+        const vecPath = require('sqlite-vec').getLoadablePath();
+        load(this.db, vecPath);
+        if (this.filename !== ':memory:') {
+            this.db.pragma('journal_mode = WAL');
+            this.db.pragma('busy_timeout = 5000');
+        }
+    }
+    async close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    ensureOpen() {
+        if (!this.db) {
+            // 懒初始化：如果尚未打开，则自动打开
+            // 确保目录存在
+            if (this.filename !== ':memory:') {
+                const dir = path_1.default.dirname(this.filename);
+                if (dir && dir !== '.' && !fs_1.default.existsSync(dir)) {
+                    fs_1.default.mkdirSync(dir, { recursive: true });
+                }
+            }
+            this.db = new better_sqlite3_1.default(this.filename);
+            // 加载 sqlite-vec 扩展
+            const { load } = require('sqlite-vec');
+            const vecPath = require('sqlite-vec').getLoadablePath();
+            load(this.db, vecPath);
+            if (this.filename !== ':memory:') {
+                this.db.pragma('journal_mode = WAL');
+                this.db.pragma('busy_timeout = 5000');
+            }
+        }
+        return this.db;
+    }
+    getTableName(modelId) {
+        return `vec_${(0, VectorStore_1.hashModelId)(modelId)}`;
+    }
+    getDimension() {
+        return this.defaultDimension;
+    }
+    // ============================================
+    // 向量表管理
+    // ============================================
+    async ensureVectorTable(modelId) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        // 使用 sqlite-vec 的 vec0 虚拟表
+        // rowid 作为主键，与 quints 表的 rowid 对应
+        db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS ${tableName} USING vec0(
+        embedding float[${this.getDimension()}]
+      )
+    `);
+    }
+    async dropVectorTable(modelId) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        db.exec(`DROP TABLE IF EXISTS ${tableName}`);
+    }
+    async hasVectorTable(modelId) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        try {
+            const row = db
+                .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name=?`)
+                .get(tableName);
+            return !!row;
+        }
+        catch {
+            return false;
+        }
+    }
+    async listVectorTables() {
+        const db = this.ensureOpen();
+        try {
+            const rows = db
+                .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'vec_%'`)
+                .all();
+            return rows.map((r) => r.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ============================================
+    // 向量操作
+    // ============================================
+    async upsertVector(modelId, id, embedding) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        // 转换为 BigInt 以确保 sqlite-vec 识别为整数
+        const bigId = BigInt(Math.floor(id));
+        // sqlite-vec 不支持 UPDATE，需要先删除再插入
+        db.prepare(`DELETE FROM ${tableName} WHERE rowid = ?`).run(bigId);
+        // 使用 rowid 作为主键插入向量
+        db.prepare(`INSERT INTO ${tableName} (rowid, embedding) VALUES (?, ?)`).run(bigId, JSON.stringify(embedding));
+    }
+    async batchUpsertVectors(modelId, records) {
+        if (records.length === 0)
+            return;
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const transaction = db.transaction((recs) => {
+            for (const rec of recs) {
+                // 转换为 BigInt 以确保 sqlite-vec 识别为整数
+                const bigId = BigInt(Math.floor(rec.id));
+                // sqlite-vec 不支持 UPDATE，需要先删除再插入
+                db.prepare(`DELETE FROM ${tableName} WHERE rowid = ?`).run(bigId);
+                db.prepare(`INSERT INTO ${tableName} (rowid, embedding) VALUES (?, ?)`).run(bigId, JSON.stringify(rec.embedding));
+            }
+        });
+        transaction(records);
+    }
+    async getVector(modelId, id) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        try {
+            const row = db.prepare(`SELECT rowid, embedding FROM ${tableName} WHERE rowid = ?`).get(id);
+            return row ? this.rowToVector(row) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async deleteVector(modelId, id) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        db.prepare(`DELETE FROM ${tableName} WHERE rowid = ?`).run(id);
+    }
+    async batchDeleteVectors(modelId, ids) {
+        if (ids.length === 0)
+            return;
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const placeholders = ids.map(() => '?').join(',');
+        db.prepare(`DELETE FROM ${tableName} WHERE rowid IN (${placeholders})`).run(...ids);
+    }
+    async search(modelId, queryEmbedding, options = {}) {
+        const db = this.ensureOpen();
+        const { limit = 10, threshold, excludeIds } = options;
+        const tableName = this.getTableName(modelId);
+        try {
+            // 使用 sqlite-vec 的近似最近邻搜索
+            // 注意：sqlite-vec 要求在 MATCH 中使用 k=? 参数
+            const sql = `
+        SELECT
+          rowid as id,
+          distance
+        FROM ${tableName}
+        WHERE embedding MATCH ?
+          AND k = ?
+        ORDER BY distance
+      `;
+            const rows = db.prepare(sql).all(JSON.stringify(queryEmbedding), limit * 2);
+            const results = [];
+            for (const row of rows) {
+                if (excludeIds?.has(row.id))
+                    continue;
+                const distance = row.distance;
+                // sqlite-vec 使用 L2 距离，对于归一化向量，转换为余弦相似度：
+                // L2² = 2 * (1 - cosine_similarity)
+                // cosine_similarity = 1 - L2² / 2
+                // score 限制在 [0, 1] 范围内
+                const score = Math.max(0, Math.min(1, 1 - (distance * distance) / 2));
+                if (threshold !== undefined && score < threshold)
+                    continue;
+                results.push({ id: row.id, distance, score });
+            }
+            return results.slice(0, limit);
+        }
+        catch (e) {
+            // sqlite-vec 扩展不可用时抛出错误
+            throw new Error(`sqlite-vec search failed: ${e}`);
+        }
+    }
+    // ============================================
+    // 统计
+    // ============================================
+    async countVectors(modelId) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        try {
+            const row = db.prepare(`SELECT COUNT(*) as count FROM ${tableName}`).get();
+            return row?.count ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ============================================
+    // 迁移支持
+    // ============================================
+    async getVectorIds(modelId, options = {}) {
+        const db = this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const { limit = 1000, afterId } = options;
+        try {
+            const sql = afterId !== undefined
+                ? `SELECT rowid FROM ${tableName} WHERE rowid > ? ORDER BY rowid LIMIT ?`
+                : `SELECT rowid FROM ${tableName} ORDER BY rowid LIMIT ?`;
+            const params = afterId !== undefined ? [afterId, limit] : [limit];
+            const rows = db.prepare(sql).all(...params);
+            return rows.map((r) => r.rowid);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ============================================
+    // 行转换
+    // ============================================
+    rowToVector(row) {
+        return {
+            id: row.rowid,
+            embedding: this.deserializeEmbedding(row.embedding),
+            createdAt: Math.floor(Date.now() / 1000),
+        };
+    }
+    deserializeEmbedding(blob) {
+        // sqlite-vec 返回的是 float32 buffer
+        const buffer = Buffer.isBuffer(blob) ? blob : Buffer.from(blob);
+        const embedding = [];
+        for (let i = 0; i < buffer.length; i += 4) {
+            embedding.push(buffer.readFloatLE(i));
+        }
+        return embedding;
+    }
+}
+exports.SqliteVectorStore = SqliteVectorStore;
+//# sourceMappingURL=SqliteVectorStore.js.map

package/dist/storage/vector/SqliteVectorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteVectorStore.js","sourceRoot":"","sources":["../../../src/storage/vector/SqliteVectorStore.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SqliteVectorStore - SQLite 向量存储实现（使用 sqlite-vec 扩展）\n *\n * 设计思路：\n * - sqlite-vec 的 vec0 表使用 rowid 作为主键\n * - rowid 直接与 quints 表的 rowid 对应，无需额外映射\n * - 通过 rowid JOIN quints 表即可关联业务数据\n */\n\nimport Database from 'better-sqlite3';\nimport fs from 'fs';\nimport path from 'path';\nimport type { Finalizable, Initializable } from '@solid/community-server';\nimport { VectorStore, hashModelId } from './VectorStore';\nimport type { VectorRecord, VectorSearchOptions, VectorSearchResult, VectorStoreOptions } from './types';\n\nexport class SqliteVectorStore extends VectorStore implements Initializable, Finalizable {\n  /** @ignored */\n  private db: Database.Database | null = null;\n  private readonly filename: string;\n\n  public constructor(options: VectorStoreOptions) {\n    super();\n    let connStr = options.connectionString;\n    if (connStr.startsWith('sqlite:')) {\n      connStr = connStr.slice(7);\n    }\n    this.filename = connStr;\n  }\n\n  // ============================================\n  // Lifecycle (Initializable / Finalizable)\n  // ============================================\n\n  public async initialize(): Promise<void> {\n    await this.open();\n  }\n\n  public async finalize(): Promise<void> {\n    await this.close();\n  }\n\n  public override async open(): Promise<void> {\n    if (this.db) return;\n\n    // 确保目录存在\n    if (this.filename !== ':memory:') {\n      const dir = path.dirname(this.filename);\n      if (dir && dir !== '.' && !fs.existsSync(dir)) {\n        fs.mkdirSync(dir, { recursive: true });\n      }\n    }\n\n    this.db = new Database(this.filename);\n\n    // 加载 sqlite-vec 扩展\n    const { load } = require('sqlite-vec');\n    const vecPath = require('sqlite-vec').getLoadablePath();\n    load(this.db, vecPath);\n\n    if (this.filename !== ':memory:') {\n      this.db.pragma('journal_mode = WAL');\n      this.db.pragma('busy_timeout = 5000');\n    }\n  }\n\n  public override async close(): Promise<void> {\n    if (this.db) {\n      this.db.close();\n      this.db = null;\n    }\n  }\n\n  private ensureOpen(): Database.Database {\n    if (!this.db) {\n      // 懒初始化：如果尚未打开，则自动打开\n      // 确保目录存在\n      if (this.filename !== ':memory:') {\n        const dir = path.dirname(this.filename);\n        if (dir && dir !== '.' && !fs.existsSync(dir)) {\n          fs.mkdirSync(dir, { recursive: true });\n        }\n      }\n\n      this.db = new Database(this.filename);\n\n      // 加载 sqlite-vec 扩展\n      const { load } = require('sqlite-vec');\n      const vecPath = require('sqlite-vec').getLoadablePath();\n      load(this.db, vecPath);\n\n      if (this.filename !== ':memory:') {\n        this.db.pragma('journal_mode = WAL');\n        this.db.pragma('busy_timeout = 5000');\n      }\n    }\n    return this.db;\n  }\n\n  private getTableName(modelId: string): string {\n    return `vec_${hashModelId(modelId)}`;\n  }\n\n  private getDimension(): number {\n    return this.defaultDimension;\n  }\n\n  // ============================================\n  // 向量表管理\n  // ============================================\n\n  public override async ensureVectorTable(modelId: string): Promise<void> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    // 使用 sqlite-vec 的 vec0 虚拟表\n    // rowid 作为主键，与 quints 表的 rowid 对应\n    db.exec(`\n      CREATE VIRTUAL TABLE IF NOT EXISTS ${tableName} USING vec0(\n        embedding float[${this.getDimension()}]\n      )\n    `);\n  }\n\n  public override async dropVectorTable(modelId: string): Promise<void> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    db.exec(`DROP TABLE IF EXISTS ${tableName}`);\n  }\n\n  public override async hasVectorTable(modelId: string): Promise<boolean> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    try {\n      const row = db\n        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name=?`)\n        .get(tableName) as { name: string } | undefined;\n      return !!row;\n    } catch {\n      return false;\n    }\n  }\n\n  public override async listVectorTables(): Promise<string[]> {\n    const db = this.ensureOpen();\n\n    try {\n      const rows = db\n        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'vec_%'`)\n        .all() as { name: string }[];\n      return rows.map((r) => r.name);\n    } catch {\n      return [];\n    }\n  }\n\n  // ============================================\n  // 向量操作\n  // ============================================\n\n  public override async upsertVector(modelId: string, id: number, embedding: number[]): Promise<void> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    // 转换为 BigInt 以确保 sqlite-vec 识别为整数\n    const bigId = BigInt(Math.floor(id));\n\n    // sqlite-vec 不支持 UPDATE，需要先删除再插入\n    db.prepare(`DELETE FROM ${tableName} WHERE rowid = ?`).run(bigId);\n\n    // 使用 rowid 作为主键插入向量\n    db.prepare(\n      `INSERT INTO ${tableName} (rowid, embedding) VALUES (?, ?)`\n    ).run(bigId, JSON.stringify(embedding));\n  }\n\n  public override async batchUpsertVectors(modelId: string, records: { id: number; embedding: number[] }[]): Promise<void> {\n    if (records.length === 0) return;\n\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    const transaction = db.transaction((recs: typeof records) => {\n      for (const rec of recs) {\n        // 转换为 BigInt 以确保 sqlite-vec 识别为整数\n        const bigId = BigInt(Math.floor(rec.id));\n\n        // sqlite-vec 不支持 UPDATE，需要先删除再插入\n        db.prepare(`DELETE FROM ${tableName} WHERE rowid = ?`).run(bigId);\n        db.prepare(\n          `INSERT INTO ${tableName} (rowid, embedding) VALUES (?, ?)`\n        ).run(bigId, JSON.stringify(rec.embedding));\n      }\n    });\n\n    transaction(records);\n  }\n\n  public override async getVector(modelId: string, id: number): Promise<VectorRecord | null> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    try {\n      const row = db.prepare(`SELECT rowid, embedding FROM ${tableName} WHERE rowid = ?`).get(id) as any;\n      return row ? this.rowToVector(row) : null;\n    } catch {\n      return null;\n    }\n  }\n\n  public override async deleteVector(modelId: string, id: number): Promise<void> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    db.prepare(`DELETE FROM ${tableName} WHERE rowid = ?`).run(id);\n  }\n\n  public override async batchDeleteVectors(modelId: string, ids: number[]): Promise<void> {\n    if (ids.length === 0) return;\n\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    const placeholders = ids.map(() => '?').join(',');\n    db.prepare(`DELETE FROM ${tableName} WHERE rowid IN (${placeholders})`).run(...ids);\n  }\n\n  public override async search(modelId: string, queryEmbedding: number[], options: VectorSearchOptions = {}): Promise<VectorSearchResult[]> {\n    const db = this.ensureOpen();\n\n    const { limit = 10, threshold, excludeIds } = options;\n    const tableName = this.getTableName(modelId);\n\n    try {\n      // 使用 sqlite-vec 的近似最近邻搜索\n      // 注意：sqlite-vec 要求在 MATCH 中使用 k=? 参数\n      const sql = `\n        SELECT\n          rowid as id,\n          distance\n        FROM ${tableName}\n        WHERE embedding MATCH ?\n          AND k = ?\n        ORDER BY distance\n      `;\n\n      const rows = db.prepare(sql).all(JSON.stringify(queryEmbedding), limit * 2) as { id: number; distance: number }[];\n\n      const results: VectorSearchResult[] = [];\n\n      for (const row of rows) {\n        if (excludeIds?.has(row.id)) continue;\n\n        const distance = row.distance;\n        // sqlite-vec 使用 L2 距离，对于归一化向量，转换为余弦相似度：\n        // L2² = 2 * (1 - cosine_similarity)\n        // cosine_similarity = 1 - L2² / 2\n        // score 限制在 [0, 1] 范围内\n        const score = Math.max(0, Math.min(1, 1 - (distance * distance) / 2));\n\n        if (threshold !== undefined && score < threshold) continue;\n\n        results.push({ id: row.id, distance, score });\n      }\n\n      return results.slice(0, limit);\n    } catch (e) {\n      // sqlite-vec 扩展不可用时抛出错误\n      throw new Error(`sqlite-vec search failed: ${e}`);\n    }\n  }\n\n  // ============================================\n  // 统计\n  // ============================================\n\n  public override async countVectors(modelId: string): Promise<number> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    try {\n      const row = db.prepare(`SELECT COUNT(*) as count FROM ${tableName}`).get() as any;\n      return row?.count ?? 0;\n    } catch {\n      return 0;\n    }\n  }\n\n  // ============================================\n  // 迁移支持\n  // ============================================\n\n  public override async getVectorIds(modelId: string, options: { limit?: number; afterId?: number } = {}): Promise<number[]> {\n    const db = this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n    const { limit = 1000, afterId } = options;\n\n    try {\n      const sql = afterId !== undefined\n        ? `SELECT rowid FROM ${tableName} WHERE rowid > ? ORDER BY rowid LIMIT ?`\n        : `SELECT rowid FROM ${tableName} ORDER BY rowid LIMIT ?`;\n      const params = afterId !== undefined ? [afterId, limit] : [limit];\n      const rows = db.prepare(sql).all(...params) as any[];\n      return rows.map((r) => r.rowid);\n    } catch {\n      return [];\n    }\n  }\n\n  // ============================================\n  // 行转换\n  // ============================================\n\n  private rowToVector(row: any): VectorRecord {\n    return {\n      id: row.rowid,\n      embedding: this.deserializeEmbedding(row.embedding),\n      createdAt: Math.floor(Date.now() / 1000),\n    };\n  }\n\n  private deserializeEmbedding(blob: Buffer | Uint8Array): number[] {\n    // sqlite-vec 返回的是 float32 buffer\n    const buffer = Buffer.isBuffer(blob) ? blob : Buffer.from(blob);\n    const embedding: number[] = [];\n    for (let i = 0; i < buffer.length; i += 4) {\n      embedding.push(buffer.readFloatLE(i));\n    }\n    return embedding;\n  }\n}\n"]}

package/dist/storage/vector/SqliteVectorStore.jsonld

@@ -0,0 +1,137 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore",
+      "@type": "Class",
+      "requireElement": "SqliteVectorStore",
+      "extends": [
+        "undefineds:dist/storage/vector/VectorStore.jsonld#VectorStore",
+        "css:dist/init/Initializable.jsonld#Initializable",
+        "css:dist/init/final/Finalizable.jsonld#Finalizable"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore_options_connectionString",
+          "range": "xsd:string",
+          "comment": "数据库连接字符串，如 sqlite:./data/xpod.db 或 postgresql://..."
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_db",
+          "memberFieldName": "db"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_filename",
+          "memberFieldName": "filename"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_ensureOpen",
+          "memberFieldName": "ensureOpen"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_getTableName",
+          "memberFieldName": "getTableName"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_getDimension",
+          "memberFieldName": "getDimension"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_ensureVectorTable",
+          "memberFieldName": "ensureVectorTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_dropVectorTable",
+          "memberFieldName": "dropVectorTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_hasVectorTable",
+          "memberFieldName": "hasVectorTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_listVectorTables",
+          "memberFieldName": "listVectorTables"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_upsertVector",
+          "memberFieldName": "upsertVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_batchUpsertVectors",
+          "memberFieldName": "batchUpsertVectors"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_getVector",
+          "memberFieldName": "getVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_deleteVector",
+          "memberFieldName": "deleteVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_batchDeleteVectors",
+          "memberFieldName": "batchDeleteVectors"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_search",
+          "memberFieldName": "search"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_countVectors",
+          "memberFieldName": "countVectors"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_getVectorIds",
+          "memberFieldName": "getVectorIds"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_rowToVector",
+          "memberFieldName": "rowToVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore__member_deserializeEmbedding",
+          "memberFieldName": "deserializeEmbedding"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "connectionString",
+              "value": {
+                "@id": "undefineds:dist/storage/vector/SqliteVectorStore.jsonld#SqliteVectorStore_options_connectionString"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/storage/vector/VectorIndexingListener.d.ts

@@ -0,0 +1,114 @@
+/**
+ * VectorIndexingListener - 向量索引监听器
+ *
+ * 监听资源变更事件，自动触发向量索引更新。
+ *
+ * 工作流程：
+ * 1. 收到资源变更事件
+ * 2. 检查资源是否在某个 VectorStore 的 scope 内
+ * 3. 如果是，读取资源内容，生成 embedding，存入向量库
+ */
+import type { ResourceChangeEvent, ResourceChangeListener } from '../ObservableResourceStore';
+import type { VectorStore } from '../vector/VectorStore';
+import type { EmbeddingService } from '../../ai/service/EmbeddingService';
+import type { SparqlEngine } from '../sparql/SubgraphQueryEngine';
+import type { ResourceStore } from '@solid/community-server';
+/**
+ * VectorStore 定义（从 RDF 读取）
+ */
+export interface VectorStoreDefinition {
+    /** VectorStore URI */
+    uri: string;
+    /** 索引范围（Container URI） */
+    scope: string;
+    /** embedding 模型 */
+    model: string;
+    /** 状态 */
+    status: 'active' | 'paused';
+    /** 分块大小 */
+    chunkSize?: number;
+    /** 分块重叠 */
+    chunkOverlap?: number;
+}
+export interface VectorIndexingListenerOptions {
+    /** SPARQL 引擎（用于查询 VectorStore 定义和 AI 凭据） */
+    sparqlEngine: SparqlEngine;
+    /** 向量存储 */
+    vectorStore: VectorStore;
+    /** Embedding 服务 */
+    embeddingService: EmbeddingService;
+    /** 资源存储（用于读取资源内容） */
+    resourceStore: ResourceStore;
+    /** 默认 embedding 模型 */
+    defaultModel?: string;
+    /** 支持的文件扩展名 */
+    supportedExtensions?: string[];
+}
+/**
+ * VectorIndexingListener - 自动向量索引
+ */
+export declare class VectorIndexingListener implements ResourceChangeListener {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly sparqlEngine;
+    private readonly vectorStore;
+    private readonly embeddingService;
+    private readonly resourceStore;
+    private readonly defaultModel;
+    private readonly supportedExtensions;
+    private vectorStoreCache;
+    private cacheExpiry;
+    private readonly cacheTtlMs;
+    constructor(options: VectorIndexingListenerOptions);
+    /**
+     * 处理资源变更事件
+     */
+    onResourceChanged(event: ResourceChangeEvent): Promise<void>;
+    /**
+     * 处理删除操作
+     */
+    private handleDelete;
+    /**
+     * 处理创建或更新操作
+     */
+    private handleCreateOrUpdate;
+    /**
+     * 查找覆盖指定路径的 VectorStore
+     */
+    private findVectorStoresForPath;
+    /**
+     * 获取 Pod 的所有 VectorStore 定义
+     */
+    private getVectorStoreDefinitions;
+    /**
+     * 获取 AI 凭据
+     */
+    private getAiCredential;
+    /**
+     * 读取资源内容
+     */
+    private getResourceContent;
+    /**
+     * 检查是否为支持的文件类型
+     */
+    private isSupportedFile;
+    /**
+     * 获取文件扩展名
+     */
+    private getExtension;
+    /**
+     * 从路径提取 Pod base URL
+     */
+    private getPodBaseUrl;
+    /**
+     * 解析相对 URI
+     */
+    private resolveUri;
+    /**
+     * 将路径转换为向量 ID（使用 hash）
+     */
+    private pathToVectorId;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+}