@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/vector/PostgresVectorStore.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * PostgresVectorStore - PostgreSQL 向量存储实现（使用 pgvector 扩展）
+ *
+ * 使用 pgvector 扩展进行高性能向量搜索：
+ * - 向量表命名：quint_vec_{hash(modelId)}
+ * - 利用 <=> 运算符（余弦距离）进行近似最近邻搜索
+ * - 支持 IVFFlat 和 HNSW 索引
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresVectorStore = void 0;
+const pg_1 = require("pg");
+const node_postgres_1 = require("drizzle-orm/node-postgres");
+const drizzle_orm_1 = require("drizzle-orm");
+const VectorStore_1 = require("./VectorStore");
+class PostgresVectorStore extends VectorStore_1.VectorStore {
+    constructor(options) {
+        super();
+        /** @ignored */
+        this.pool = null;
+        /** @ignored */
+        this.db = null;
+        this.connectionString = options.connectionString;
+    }
+    // ============================================
+    // Lifecycle (Initializable / Finalizable)
+    // ============================================
+    async initialize() {
+        await this.open();
+    }
+    async finalize() {
+        await this.close();
+    }
+    async open() {
+        if (this.pool)
+            return;
+        this.pool = new pg_1.Pool({ connectionString: this.connectionString });
+        this.db = (0, node_postgres_1.drizzle)(this.pool);
+        // 确保 pgvector 扩展已安装
+        await this.db.execute((0, drizzle_orm_1.sql) `CREATE EXTENSION IF NOT EXISTS vector`);
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+            this.db = null;
+        }
+    }
+    async ensureOpen() {
+        if (!this.pool) {
+            await this.open();
+        }
+    }
+    getDb() {
+        if (!this.db) {
+            throw new Error('PostgresVectorStore is not open. Call open() or initialize() first.');
+        }
+        return this.db;
+    }
+    getTableName(modelId) {
+        return `quint_vec_${(0, VectorStore_1.hashModelId)(modelId)}`;
+    }
+    // ============================================
+    // 向量表管理
+    // ============================================
+    async ensureVectorTable(modelId) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const db = this.getDb();
+        // 创建表
+        await db.execute((0, drizzle_orm_1.sql) `
+      CREATE TABLE IF NOT EXISTS ${drizzle_orm_1.sql.identifier(tableName)} (
+        id INTEGER PRIMARY KEY,
+        embedding vector(${drizzle_orm_1.sql.raw(this.defaultDimension.toString())}),
+        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      )
+    `);
+        // 创建 HNSW 索引（高维向量推荐）
+        await db.execute((0, drizzle_orm_1.sql) `
+      CREATE INDEX IF NOT EXISTS ${drizzle_orm_1.sql.identifier(`${tableName}_embedding_idx`)}
+      ON ${drizzle_orm_1.sql.identifier(tableName)}
+      USING hnsw (embedding vector_cosine_ops)
+    `);
+    }
+    async dropVectorTable(modelId) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        await this.getDb().execute((0, drizzle_orm_1.sql) `DROP TABLE IF EXISTS ${drizzle_orm_1.sql.identifier(tableName)} CASCADE`);
+    }
+    async hasVectorTable(modelId) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        try {
+            const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+        SELECT EXISTS (
+          SELECT FROM information_schema.tables
+          WHERE table_name = ${tableName}
+        ) as exists
+      `);
+            return result.rows[0]?.exists ?? false;
+        }
+        catch {
+            return false;
+        }
+    }
+    async listVectorTables() {
+        await this.ensureOpen();
+        try {
+            const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+        SELECT table_name FROM information_schema.tables
+        WHERE table_name LIKE 'quint_vec_%'
+      `);
+            return result.rows.map((r) => r.table_name);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ============================================
+    // 向量操作
+    // ============================================
+    async upsertVector(modelId, id, embedding) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const embeddingStr = `[${embedding.join(',')}]`;
+        await this.getDb().execute((0, drizzle_orm_1.sql) `
+      INSERT INTO ${drizzle_orm_1.sql.identifier(tableName)} (id, embedding)
+      VALUES (${id}, ${embeddingStr}::vector)
+      ON CONFLICT (id) DO UPDATE SET embedding = ${embeddingStr}::vector, created_at = NOW()
+    `);
+    }
+    async batchUpsertVectors(modelId, records) {
+        if (records.length === 0)
+            return;
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            for (const rec of records) {
+                const embeddingStr = `[${rec.embedding.join(',')}]`;
+                await this.getDb().execute((0, drizzle_orm_1.sql) `
+          INSERT INTO ${drizzle_orm_1.sql.identifier(tableName)} (id, embedding)
+          VALUES (${rec.id}, ${embeddingStr}::vector)
+          ON CONFLICT (id) DO UPDATE SET embedding = ${embeddingStr}::vector, created_at = NOW()
+        `);
+            }
+            await client.query('COMMIT');
+        }
+        catch (e) {
+            await client.query('ROLLBACK');
+            throw e;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async getVector(modelId, id) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        try {
+            const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+        SELECT id, embedding, created_at FROM ${drizzle_orm_1.sql.identifier(tableName)} WHERE id = ${id}
+      `);
+            return result.rows.length > 0 ? this.rowToVector(result.rows[0]) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async deleteVector(modelId, id) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        await this.getDb().execute((0, drizzle_orm_1.sql) `DELETE FROM ${drizzle_orm_1.sql.identifier(tableName)} WHERE id = ${id}`);
+    }
+    async batchDeleteVectors(modelId, ids) {
+        if (ids.length === 0)
+            return;
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const idList = ids.join(',');
+        await this.getDb().execute((0, drizzle_orm_1.sql) `
+      DELETE FROM ${drizzle_orm_1.sql.identifier(tableName)}
+      WHERE id IN (${drizzle_orm_1.sql.raw(idList)})
+    `);
+    }
+    async search(modelId, queryEmbedding, options = {}) {
+        await this.ensureOpen();
+        const { limit = 10, threshold, excludeIds } = options;
+        const tableName = this.getTableName(modelId);
+        const embeddingStr = `[${queryEmbedding.join(',')}]`;
+        // 构建基础查询
+        let whereClause = 'WHERE embedding IS NOT NULL';
+        // 添加 excludeIds 过滤
+        if (excludeIds && excludeIds.size > 0) {
+            const excludeList = Array.from(excludeIds).join(',');
+            whereClause += ` AND id NOT IN (${excludeList})`;
+        }
+        const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+      SELECT id, embedding <=> ${embeddingStr}::vector as distance
+      FROM ${drizzle_orm_1.sql.identifier(tableName)}
+      ${drizzle_orm_1.sql.raw(whereClause)}
+      ORDER BY distance
+      LIMIT ${limit * 2}
+    `);
+        const rows = result.rows;
+        const results = [];
+        for (const row of rows) {
+            const distance = row.distance;
+            const score = this.distanceToScore(distance);
+            if (threshold !== undefined && score < threshold)
+                continue;
+            results.push({ id: row.id, distance, score });
+        }
+        return results.slice(0, limit);
+    }
+    // ============================================
+    // 统计
+    // ============================================
+    async countVectors(modelId) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        try {
+            const result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+        SELECT COUNT(*) as count FROM ${drizzle_orm_1.sql.identifier(tableName)}
+      `);
+            return parseInt(result.rows[0]?.count ?? '0', 10);
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ============================================
+    // 迁移支持
+    // ============================================
+    async getVectorIds(modelId, options = {}) {
+        await this.ensureOpen();
+        const tableName = this.getTableName(modelId);
+        const { limit = 1000, afterId } = options;
+        try {
+            let result;
+            if (afterId !== undefined) {
+                result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+          SELECT id FROM ${drizzle_orm_1.sql.identifier(tableName)}
+          WHERE id > ${afterId}
+          ORDER BY id
+          LIMIT ${limit}
+        `);
+            }
+            else {
+                result = await this.getDb().execute((0, drizzle_orm_1.sql) `
+          SELECT id FROM ${drizzle_orm_1.sql.identifier(tableName)}
+          ORDER BY id
+          LIMIT ${limit}
+        `);
+            }
+            return result.rows.map((r) => r.id);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ============================================
+    // 私有方法
+    // ============================================
+    rowToVector(row) {
+        return {
+            id: row.id,
+            embedding: this.parseEmbedding(row.embedding),
+            createdAt: this.toTimestamp(row.created_at),
+        };
+    }
+    parseEmbedding(embedding) {
+        // pgvector 返回的可能是数组或字符串
+        if (Array.isArray(embedding)) {
+            return embedding;
+        }
+        if (typeof embedding === 'string') {
+            // 解析 "[1,2,3]" 格式
+            try {
+                return JSON.parse(embedding);
+            }
+            catch {
+                return [];
+            }
+        }
+        return [];
+    }
+}
+exports.PostgresVectorStore = PostgresVectorStore;
+//# sourceMappingURL=PostgresVectorStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresVectorStore.js","sourceRoot":"","sources":["../../../src/storage/vector/PostgresVectorStore.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * PostgresVectorStore - PostgreSQL 向量存储实现（使用 pgvector 扩展）\n *\n * 使用 pgvector 扩展进行高性能向量搜索：\n * - 向量表命名：quint_vec_{hash(modelId)}\n * - 利用 <=> 运算符（余弦距离）进行近似最近邻搜索\n * - 支持 IVFFlat 和 HNSW 索引\n */\n\nimport { Pool } from 'pg';\nimport { drizzle as drizzlePg, NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport { sql } from 'drizzle-orm';\nimport type { Finalizable, Initializable } from '@solid/community-server';\nimport { VectorStore, hashModelId } from './VectorStore';\nimport type { VectorRecord, VectorSearchOptions, VectorSearchResult, VectorStoreOptions } from './types';\n\nexport class PostgresVectorStore extends VectorStore implements Initializable, Finalizable {\n  protected readonly connectionString: string;\n  /** @ignored */\n  private pool: Pool | null = null;\n  /** @ignored */\n  private db: NodePgDatabase | null = null;\n\n  public constructor(options: VectorStoreOptions) {\n    super();\n    this.connectionString = options.connectionString;\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 async open(): Promise<void> {\n    if (this.pool) return;\n\n    this.pool = new Pool({ connectionString: this.connectionString });\n    this.db = drizzlePg(this.pool);\n\n    // 确保 pgvector 扩展已安装\n    await this.db.execute(sql`CREATE EXTENSION IF NOT EXISTS vector`);\n  }\n\n  public async close(): Promise<void> {\n    if (this.pool) {\n      await this.pool.end();\n      this.pool = null;\n      this.db = null;\n    }\n  }\n\n  private async ensureOpen(): Promise<void> {\n    if (!this.pool) {\n      await this.open();\n    }\n  }\n\n  private getDb(): NodePgDatabase {\n    if (!this.db) {\n      throw new Error('PostgresVectorStore is not open. Call open() or initialize() first.');\n    }\n    return this.db;\n  }\n\n  protected getTableName(modelId: string): string {\n    return `quint_vec_${hashModelId(modelId)}`;\n  }\n\n  // ============================================\n  // 向量表管理\n  // ============================================\n\n  public async ensureVectorTable(modelId: string): Promise<void> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n    const db = this.getDb();\n\n    // 创建表\n    await db.execute(sql`\n      CREATE TABLE IF NOT EXISTS ${sql.identifier(tableName)} (\n        id INTEGER PRIMARY KEY,\n        embedding vector(${sql.raw(this.defaultDimension.toString())}),\n        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()\n      )\n    `);\n\n    // 创建 HNSW 索引（高维向量推荐）\n    await db.execute(sql`\n      CREATE INDEX IF NOT EXISTS ${sql.identifier(`${tableName}_embedding_idx`)}\n      ON ${sql.identifier(tableName)}\n      USING hnsw (embedding vector_cosine_ops)\n    `);\n  }\n\n  public async dropVectorTable(modelId: string): Promise<void> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    await this.getDb().execute(sql`DROP TABLE IF EXISTS ${sql.identifier(tableName)} CASCADE`);\n  }\n\n  public async hasVectorTable(modelId: string): Promise<boolean> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    try {\n      const result = await this.getDb().execute(sql`\n        SELECT EXISTS (\n          SELECT FROM information_schema.tables\n          WHERE table_name = ${tableName}\n        ) as exists\n      `);\n      return result.rows[0]?.exists ?? false;\n    } catch {\n      return false;\n    }\n  }\n\n  public async listVectorTables(): Promise<string[]> {\n    await this.ensureOpen();\n\n    try {\n      const result = await this.getDb().execute(sql`\n        SELECT table_name FROM information_schema.tables\n        WHERE table_name LIKE 'quint_vec_%'\n      `);\n      return result.rows.map((r: any) => r.table_name);\n    } catch {\n      return [];\n    }\n  }\n\n  // ============================================\n  // 向量操作\n  // ============================================\n\n  public async upsertVector(modelId: string, id: number, embedding: number[]): Promise<void> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n    const embeddingStr = `[${embedding.join(',')}]`;\n\n    await this.getDb().execute(sql`\n      INSERT INTO ${sql.identifier(tableName)} (id, embedding)\n      VALUES (${id}, ${embeddingStr}::vector)\n      ON CONFLICT (id) DO UPDATE SET embedding = ${embeddingStr}::vector, created_at = NOW()\n    `);\n  }\n\n  public async batchUpsertVectors(modelId: string, records: { id: number; embedding: number[] }[]): Promise<void> {\n    if (records.length === 0) return;\n\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    const client = await this.pool!.connect();\n    try {\n      await client.query('BEGIN');\n      for (const rec of records) {\n        const embeddingStr = `[${rec.embedding.join(',')}]`;\n        await this.getDb().execute(sql`\n          INSERT INTO ${sql.identifier(tableName)} (id, embedding)\n          VALUES (${rec.id}, ${embeddingStr}::vector)\n          ON CONFLICT (id) DO UPDATE SET embedding = ${embeddingStr}::vector, created_at = NOW()\n        `);\n      }\n      await client.query('COMMIT');\n    } catch (e) {\n      await client.query('ROLLBACK');\n      throw e;\n    } finally {\n      client.release();\n    }\n  }\n\n  public async getVector(modelId: string, id: number): Promise<VectorRecord | null> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    try {\n      const result = await this.getDb().execute(sql`\n        SELECT id, embedding, created_at FROM ${sql.identifier(tableName)} WHERE id = ${id}\n      `);\n      return result.rows.length > 0 ? this.rowToVector(result.rows[0]) : null;\n    } catch {\n      return null;\n    }\n  }\n\n  public async deleteVector(modelId: string, id: number): Promise<void> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    await this.getDb().execute(sql`DELETE FROM ${sql.identifier(tableName)} WHERE id = ${id}`);\n  }\n\n  public async batchDeleteVectors(modelId: string, ids: number[]): Promise<void> {\n    if (ids.length === 0) return;\n\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n    const idList = ids.join(',');\n\n    await this.getDb().execute(sql`\n      DELETE FROM ${sql.identifier(tableName)}\n      WHERE id IN (${sql.raw(idList)})\n    `);\n  }\n\n  public async search(modelId: string, queryEmbedding: number[], options: VectorSearchOptions = {}): Promise<VectorSearchResult[]> {\n    await this.ensureOpen();\n    const { limit = 10, threshold, excludeIds } = options;\n    const tableName = this.getTableName(modelId);\n    const embeddingStr = `[${queryEmbedding.join(',')}]`;\n\n    // 构建基础查询\n    let whereClause = 'WHERE embedding IS NOT NULL';\n    \n    // 添加 excludeIds 过滤\n    if (excludeIds && excludeIds.size > 0) {\n      const excludeList = Array.from(excludeIds).join(',');\n      whereClause += ` AND id NOT IN (${excludeList})`;\n    }\n\n    const result = await this.getDb().execute(sql`\n      SELECT id, embedding <=> ${embeddingStr}::vector as distance\n      FROM ${sql.identifier(tableName)}\n      ${sql.raw(whereClause)}\n      ORDER BY distance\n      LIMIT ${limit * 2}\n    `);\n\n    const rows = result.rows as { id: number; distance: number }[];\n    const results: VectorSearchResult[] = [];\n\n    for (const row of rows) {\n      const distance = row.distance;\n      const score = this.distanceToScore(distance);\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  }\n\n  // ============================================\n  // 统计\n  // ============================================\n\n  public async countVectors(modelId: string): Promise<number> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n\n    try {\n      const result = await this.getDb().execute(sql`\n        SELECT COUNT(*) as count FROM ${sql.identifier(tableName)}\n      `);\n      return parseInt(result.rows[0]?.count ?? '0', 10);\n    } catch {\n      return 0;\n    }\n  }\n\n  // ============================================\n  // 迁移支持\n  // ============================================\n\n  public async getVectorIds(modelId: string, options: { limit?: number; afterId?: number } = {}): Promise<number[]> {\n    await this.ensureOpen();\n    const tableName = this.getTableName(modelId);\n    const { limit = 1000, afterId } = options;\n\n    try {\n      let result;\n      if (afterId !== undefined) {\n        result = await this.getDb().execute(sql`\n          SELECT id FROM ${sql.identifier(tableName)}\n          WHERE id > ${afterId}\n          ORDER BY id\n          LIMIT ${limit}\n        `);\n      } else {\n        result = await this.getDb().execute(sql`\n          SELECT id FROM ${sql.identifier(tableName)}\n          ORDER BY id\n          LIMIT ${limit}\n        `);\n      }\n      return result.rows.map((r: any) => r.id);\n    } catch {\n      return [];\n    }\n  }\n\n  // ============================================\n  // 私有方法\n  // ============================================\n\n  private rowToVector(row: any): VectorRecord {\n    return {\n      id: row.id,\n      embedding: this.parseEmbedding(row.embedding),\n      createdAt: this.toTimestamp(row.created_at),\n    };\n  }\n\n  private parseEmbedding(embedding: any): number[] {\n    // pgvector 返回的可能是数组或字符串\n    if (Array.isArray(embedding)) {\n      return embedding;\n    }\n    if (typeof embedding === 'string') {\n      // 解析 \"[1,2,3]\" 格式\n      try {\n        return JSON.parse(embedding);\n      } catch {\n        return [];\n      }\n    }\n    return [];\n  }\n}\n"]}

package/dist/storage/vector/PostgresVectorStore.jsonld

@@ -0,0 +1,142 @@
+{
+  "@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/PostgresVectorStore.jsonld#PostgresVectorStore",
+      "@type": "Class",
+      "requireElement": "PostgresVectorStore",
+      "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/PostgresVectorStore.jsonld#PostgresVectorStore_options_connectionString",
+          "range": "xsd:string",
+          "comment": "数据库连接字符串，如 sqlite:./data/xpod.db 或 postgresql://..."
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_connectionString",
+          "memberFieldName": "connectionString",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_pool",
+          "memberFieldName": "pool"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_db",
+          "memberFieldName": "db"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_open",
+          "memberFieldName": "open"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_ensureOpen",
+          "memberFieldName": "ensureOpen"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_getDb",
+          "memberFieldName": "getDb"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_getTableName",
+          "memberFieldName": "getTableName"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_ensureVectorTable",
+          "memberFieldName": "ensureVectorTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_dropVectorTable",
+          "memberFieldName": "dropVectorTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_hasVectorTable",
+          "memberFieldName": "hasVectorTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_listVectorTables",
+          "memberFieldName": "listVectorTables"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_upsertVector",
+          "memberFieldName": "upsertVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_batchUpsertVectors",
+          "memberFieldName": "batchUpsertVectors"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_getVector",
+          "memberFieldName": "getVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_deleteVector",
+          "memberFieldName": "deleteVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_batchDeleteVectors",
+          "memberFieldName": "batchDeleteVectors"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_search",
+          "memberFieldName": "search"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_countVectors",
+          "memberFieldName": "countVectors"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_getVectorIds",
+          "memberFieldName": "getVectorIds"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_rowToVector",
+          "memberFieldName": "rowToVector"
+        },
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore__member_parseEmbedding",
+          "memberFieldName": "parseEmbedding"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "connectionString",
+              "value": {
+                "@id": "undefineds:dist/storage/vector/PostgresVectorStore.jsonld#PostgresVectorStore_options_connectionString"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+/**
+ * SqliteVectorStore - SQLite 向量存储实现（使用 sqlite-vec 扩展）
+ *
+ * 设计思路：
+ * - sqlite-vec 的 vec0 表使用 rowid 作为主键
+ * - rowid 直接与 quints 表的 rowid 对应，无需额外映射
+ * - 通过 rowid JOIN quints 表即可关联业务数据
+ */
+import type { Finalizable, Initializable } from '@solid/community-server';
+import { VectorStore } from './VectorStore';
+import type { VectorRecord, VectorSearchOptions, VectorSearchResult, VectorStoreOptions } from './types';
+export declare class SqliteVectorStore extends VectorStore implements Initializable, Finalizable {
+    /** @ignored */
+    private db;
+    private readonly filename;
+    constructor(options: VectorStoreOptions);
+    initialize(): Promise<void>;
+    finalize(): Promise<void>;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    private ensureOpen;
+    private getTableName;
+    private getDimension;
+    ensureVectorTable(modelId: string): Promise<void>;
+    dropVectorTable(modelId: string): Promise<void>;
+    hasVectorTable(modelId: string): Promise<boolean>;
+    listVectorTables(): Promise<string[]>;
+    upsertVector(modelId: string, id: number, embedding: number[]): Promise<void>;
+    batchUpsertVectors(modelId: string, records: {
+        id: number;
+        embedding: number[];
+    }[]): Promise<void>;
+    getVector(modelId: string, id: number): Promise<VectorRecord | null>;
+    deleteVector(modelId: string, id: number): Promise<void>;
+    batchDeleteVectors(modelId: string, ids: number[]): Promise<void>;
+    search(modelId: string, queryEmbedding: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    countVectors(modelId: string): Promise<number>;
+    getVectorIds(modelId: string, options?: {
+        limit?: number;
+        afterId?: number;
+    }): Promise<number[]>;
+    private rowToVector;
+    private deserializeEmbedding;
+}