@fgbg/mdocs 0.6.0

package/dist/server/routes/visitors.routes.js

@@ -0,0 +1,119 @@
+import { Router } from "express";
+import { generateRecoveryCode, recoverVisitor, registerVisitor, toPublic, VisitorValidationError, } from "../identity/visitor.service.js";
+import { getDb } from "../db/connection.js";
+import { listActiveVisitorsDirectory } from "../db/repositories/visitor.repo.js";
+import { ensurePersonalDomain } from "../domains/personal-domain.service.js";
+import { useLogger } from "../logger/logger.js";
+const log = useLogger("visitors-route");
+/**
+ * 构建访客相关路由。
+ * 包含注册、恢复、查询活跃访客目录、获取当前访客信息等接口。
+ * @returns Express Router 实例
+ */
+export function buildVisitorsRouter() {
+    const router = Router();
+    /**
+     * POST /register
+     * 注册新访客。
+     * 返回 { visitor, visitorToken, recoveryCode }
+     */
+    router.post("/register", (req, res) => {
+        const body = (req.body ?? {});
+        // 校验访客名是否为有效字符串
+        if (typeof body.visitorName !== "string") {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "visitorName is required" } });
+            return;
+        }
+        try {
+            const result = registerVisitor(body.visitorName);
+            res.json({
+                data: {
+                    visitor: result.visitor,
+                    visitorToken: result.visitorToken,
+                    recoveryCode: result.recoveryCode,
+                },
+            });
+        }
+        catch (err) {
+            if (err instanceof VisitorValidationError) {
+                res.status(400).json({ error: { code: "INVALID_VISITOR_NAME", message: err.message } });
+                return;
+            }
+            // 非预期异常记录日志后返回 500
+            log.error("register failed: %s", err instanceof Error ? err.message : String(err));
+            res.status(500).json({ error: { code: "INTERNAL", message: "failed to register visitor" } });
+        }
+    });
+    /**
+     * POST /recover
+     * 使用恢复码找回访客身份。
+     * 请求体: { recoveryCode: string }
+     * 返回: { visitor, visitorToken } 或 404
+     */
+    router.post("/recover", (req, res) => {
+        const body = (req.body ?? {});
+        if (typeof body.recoveryCode !== "string" || !body.recoveryCode.trim()) {
+            res.status(400).json({ error: { code: "BAD_REQUEST", message: "recoveryCode is required" } });
+            return;
+        }
+        const result = recoverVisitor(body.recoveryCode.trim());
+        if (!result) {
+            res.status(404).json({ error: { code: "INVALID_RECOVERY_CODE", message: "recovery code is invalid or expired" } });
+            return;
+        }
+        res.json({
+            data: {
+                visitor: result.visitor,
+                visitorToken: result.visitorToken,
+            },
+        });
+    });
+    /**
+     * POST /recovery-code
+     * 为当前已登录的访客生成新的恢复码（覆盖旧的）。
+     * 需要认证。返回 { recoveryCode: string }
+     */
+    router.post("/recovery-code", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        const code = generateRecoveryCode(req.visitor.visitor_id);
+        res.json({ data: { recoveryCode: code } });
+    });
+    /**
+     * GET /
+     * 获取活跃访客目录（不含已停用/已删除的访客）。
+     */
+    router.get("/", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        /* 取「活跃」访客目录：WHERE disabled_at IS NULL，停用/已删除的不在左栏出现 */
+        const rows = listActiveVisitorsDirectory(getDb());
+        res.json({
+            data: {
+                visitors: rows.map((r) => ({
+                    visitorId: r.visitor_id,
+                    visitorName: r.visitor_name,
+                })),
+            },
+        });
+    });
+    /**
+     * GET /me
+     * 获取当前登录访客的信息，并确保其个人域已创建。
+     */
+    router.get("/me", (req, res) => {
+        if (!req.visitor) {
+            res.status(401).json({ error: { code: "UNAUTHENTICATED", message: "no visitor" } });
+            return;
+        }
+        // 确保该访客拥有对应的个人域
+        ensurePersonalDomain(getDb(), req.visitor.visitor_id, req.visitor.visitor_name);
+        res.json({ data: { visitor: toPublic(req.visitor) } });
+    });
+    return router;
+}
+//# sourceMappingURL=visitors.routes.js.map

package/dist/server/routes/visitors.routes.js.map

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

package/dist/server/search/document-index-manager.js

@@ -0,0 +1,234 @@
+/**
+ * 文档全文检索索引管理器
+ *
+ * 职责：
+ * - 标记 dirty：文档创建/更新时将 is_dirty=1
+ * - 定时重建：扫描 is_dirty=1 的文档，读取 .md 文件内容，从 Lexical JSON 提取纯文本后写入 FTS5
+ * - 外部触发：导出 rebuildAllDirty() 供路由或其他模块主动调用
+ * - 乐观锁：通过 updated_at 防止 rebuild 期间并发更新导致的索引覆盖
+ * - 内存锁：Set<documentId> 防止 timer 与外部触发同时重建同一文档
+ */
+import { Jieba } from "@node-rs/jieba";
+import { dict } from "@node-rs/jieba/dict";
+import { getDb } from "../db/connection.js";
+import { readDocument } from "../storage/file-store.js";
+import { useLogger } from "../logger/logger.js";
+/** 递归遍历 Lexical JSON 的最大深度，防止爆栈 */
+const MAX_LEXICAL_DEPTH = 40;
+/** Jieba 分词实例，使用搜索引擎模式提高召回率 */
+const JIEBA = Jieba.withDict(dict);
+const log = useLogger("document-index-manager");
+/** 正在重建索引的文档 ID 集合，防止 concurrent rebuild */
+const BUILDING = new Set();
+/** 定时器间隔毫秒，可通过环境变量 MDOCS_INDEX_INTERVAL_MS 配置，默认 60000ms */
+const INDEX_INTERVAL_MS = Number(process.env.MDOCS_INDEX_INTERVAL_MS) || 60000;
+/** 是否已启动定时器 */
+let started = false;
+/**
+ * 启动定时索引重建。
+ * 重复调用安全，仅启动一次。
+ */
+export function startIndexTimer() {
+    if (started)
+        return;
+    started = true;
+    // 首次启动时立即执行一次全量扫描
+    rebuildAllDirty()
+        .then((n) => {
+        if (n > 0)
+            log.info("initial index rebuild done, %d documents indexed", n);
+    })
+        .catch((err) => log.error("initial index rebuild failed: %s", err instanceof Error ? err.message : String(err)));
+    // 定时扫描
+    setInterval(() => {
+        rebuildAllDirty()
+            .then((n) => {
+            if (n > 0)
+                log.debug("periodic index rebuild done, %d documents indexed", n);
+        })
+            .catch((err) => log.error("periodic index rebuild failed: %s", err instanceof Error ? err.message : String(err)));
+    }, INDEX_INTERVAL_MS);
+    log.info("index timer started, interval=%dms", INDEX_INTERVAL_MS);
+}
+/**
+ * 标记文档需要重建索引。
+ * 文档创建/更新时调用。
+ */
+export function markDirty(documentId) {
+    getDb()
+        .prepare(`UPDATE documents SET is_dirty = 1 WHERE document_id = ?`)
+        .run(documentId);
+}
+/**
+ * 从全文索引中移除文档。
+ * 文档删除时调用。
+ */
+export function removeIndex(documentId) {
+    const db = getDb();
+    // 查 FTS rowid 映射
+    const mapRow = db
+        .prepare(`SELECT fts_rowid FROM documents_fts_rowid WHERE document_id = ?`)
+        .get(documentId);
+    if (mapRow) {
+        // FTS5 删除语法：INSERT INTO table(table, rowid) VALUES('delete', ?)
+        db.prepare(`INSERT INTO documents_fts(documents_fts, rowid) VALUES('delete', ?)`).run(mapRow.fts_rowid);
+        db.prepare(`DELETE FROM documents_fts_rowid WHERE document_id = ?`).run(documentId);
+    }
+}
+/**
+ * 扫描所有 is_dirty=1 的文档并重建索引。
+ *
+ * @returns 本次成功重建的文档数量
+ */
+export async function rebuildAllDirty() {
+    const db = getDb();
+    const dirtyIds = db
+        .prepare(`SELECT document_id FROM documents WHERE is_dirty = 1 AND file_type = 'md'`)
+        .all();
+    let count = 0;
+    for (const { document_id } of dirtyIds) {
+        // 跳过正在被其他流程重建的文档
+        if (BUILDING.has(document_id))
+            continue;
+        try {
+            rebuildDocument(document_id);
+            count += 1;
+        }
+        catch (err) {
+            log.warn("rebuild failed for %s: %s", document_id, err instanceof Error ? err.message : String(err));
+        }
+    }
+    return count;
+}
+/**
+ * 重建单篇文档的全文索引。
+ *
+ * 乐观锁流程：
+ * 1. 记录当前 updated_at（版本号）
+ * 2. 读取磁盘文件内容
+ * 3. 删除旧 FTS 条目 → 插入新 FTS 条目
+ * 4. 用 updated_at 条件清除 is_dirty，若不匹配说明索引期间文档被更新，保留 dirty
+ */
+/**
+ * 重建单篇文档的全文索引。
+ *
+ * 乐观锁流程：
+ * 1. 记录当前 updated_at（版本号）
+ * 2. 读取磁盘文件内容
+ * 3. 删除旧 FTS 条目 → 插入新 FTS 条目
+ * 4. 用 updated_at 条件清除 is_dirty，若不匹配说明索引期间文档被更新，保留 dirty
+ */
+export function rebuildDocument(documentId) {
+    const db = getDb();
+    // ---- 获取文档元数据 ----
+    const doc = db
+        .prepare(`SELECT domain_id, relative_path, display_name, owner_visitor_id, permission, updated_at
+       FROM documents WHERE document_id = ?`)
+        .get(documentId);
+    if (!doc)
+        return;
+    // 记录本次索引的版本
+    const version = doc.updated_at;
+    // ---- 读取磁盘文件内容 ---- 从 Lexical JSON 中提取纯文本用于 FTS5 索引
+    const { content } = readDocument(doc.domain_id, doc.relative_path);
+    const plainText = extractLexicalText(content);
+    // ---- 重建 FTS 条目 ----
+    // 1. 删除旧条目（含映射表记录）
+    const oldMap = db
+        .prepare(`SELECT fts_rowid FROM documents_fts_rowid WHERE document_id = ?`)
+        .get(documentId);
+    if (oldMap) {
+        try {
+            // FTS5 删除语法：INSERT INTO table(table, rowid) VALUES('delete', ?)
+            db.prepare(`INSERT INTO documents_fts(documents_fts, rowid) VALUES('delete', ?)`).run(oldMap.fts_rowid);
+        }
+        catch {
+            // 忽略删除失败
+        }
+        db.prepare(`DELETE FROM documents_fts_rowid WHERE document_id = ?`).run(documentId);
+    }
+    // 2. 插入新条目
+    const result = db
+        .prepare(`INSERT INTO documents_fts(content, document_id, display_name, relative_path, domain_id, owner_visitor_id, permission)
+       VALUES(?, ?, ?, ?, ?, ?, ?)`)
+        .run(plainText, documentId, doc.display_name, doc.relative_path, doc.domain_id, doc.owner_visitor_id, doc.permission);
+    // 记录 rowid 映射，用于后续删除/更新
+    db.prepare(`INSERT INTO documents_fts_rowid(document_id, fts_rowid) VALUES(?, ?)`).run(documentId, result.lastInsertRowid);
+    // ---- 乐观锁：确认文档未在索引期间被更新 ----
+    const changed = db
+        .prepare(`UPDATE documents SET is_dirty = 0 WHERE document_id = ? AND updated_at = ?`)
+        .run(documentId, version);
+    // 如果没有行被修改，说明此文档在索引期间被并发更新了，保留 is_dirty 由下个周期重建
+    if (changed.changes === 0) {
+        log.debug("index rebuild skipped for %s: document was concurrently updated", documentId);
+    }
+}
+// ============================================================
+//  Lexical JSON → 纯文本提取
+// ============================================================
+/**
+ * 从文件原始内容中提取用于 FTS5 索引的纯文本。
+ *
+ * mdocs 文档以 Lexical 编辑器的 JSON 格式存储，如果直接索引原始 JSON，
+ * 会污染索引（如 children、format、direction 等元数据键名）。
+ *
+ * 本函数尝试将内容解析为 Lexical JSON：
+ * - 解析成功 → 递归遍历 children 树，收集 type="text" 节点的 text 字段
+ * - 解析失败 → 返回原文（兼容非 Lexical 格式的老数据、Markdown 文件）
+ *
+ * 提取的文本通过 Jieba 搜索引擎模式分词，使中文关键词可被 FTS5 正确匹配。
+ * 递归深度上限 40 层，防止恶意构造的超深 JSON 导致爆栈。
+ */
+function extractLexicalText(rawContent) {
+    let doc;
+    try {
+        doc = JSON.parse(rawContent);
+    }
+    catch {
+        // 非 JSON 格式（老数据、纯 Markdown 等），分词后用于索引
+        return tokenizeForSearch(rawContent);
+    }
+    // 必须是对象且有 root 节点，才是 Lexical JSON
+    if (!doc || typeof doc !== "object" || !("root" in doc)) {
+        return tokenizeForSearch(rawContent);
+    }
+    const parts = [];
+    collectLexicalText(doc.root, parts, 0);
+    return tokenizeForSearch(parts.join(""));
+}
+/**
+ * 通过 Jieba 搜索引擎模式对文本分词，返回空格分隔的 tokens。
+ *
+ * 搜索引擎模式会在精确分词的基础上进一步拆分复合词（如"数据库"→"数据 据库 数据库"），
+ * 提高搜索召回率，使长尾词也能命中。
+ */
+function tokenizeForSearch(text) {
+    return JIEBA.cutForSearch(text, true).join(" ");
+}
+/**
+ * 递归收集 Lexical 节点树中的所有文本。
+ *
+ * @param node 当前遍历的 Lexical 节点
+ * @param parts 累积文本的数组，type="text" 节点的 text 字段追加到此数组
+ * @param depth 当前递归深度，超过 MAX_LEXICAL_DEPTH 时截断
+ */
+function collectLexicalText(node, parts, depth) {
+    if (depth > MAX_LEXICAL_DEPTH)
+        return;
+    if (!node || typeof node !== "object")
+        return;
+    const n = node;
+    // 文本节点：提取实际内容
+    if (n.type === "text") {
+        if (typeof n.text === "string" && n.text.length > 0) {
+            parts.push(n.text);
+        }
+    }
+    // 递归处理子节点
+    if (Array.isArray(n.children)) {
+        for (const child of n.children) {
+            collectLexicalText(child, parts, depth + 1);
+        }
+    }
+}
+//# sourceMappingURL=document-index-manager.js.map

package/dist/server/search/document-index-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-index-manager.js","sourceRoot":"","sources":["../../../src/server/search/document-index-manager.ts"],"names":[],"mappings":"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"}

package/dist/server/search/document-index-manager.test.js

@@ -0,0 +1,114 @@
+import { describe, it, expect, beforeAll, afterEach, vi } from "vitest";
+import Database from "better-sqlite3";
+import { applySchema } from "../db/schema.js";
+import { createDocument } from "../documents/document.service.js";
+import { rebuildAllDirty } from "./document-index-manager.js";
+import { searchDocuments } from "./search.service.js";
+const testDbRef = vi.hoisted(() => ({ db: null }));
+vi.mock("../db/connection.js", () => ({
+    getDb: () => testDbRef.db,
+}));
+vi.mock("../storage/file-store.js", () => ({
+    writeDocument: () => ({ contentHash: "mock-hash", bytes: 0 }),
+    readDocument: () => ({ content: JSON.stringify({
+            root: {
+                children: [{
+                        children: [{ type: "text", text: "测试文档内容" }]
+                    }]
+            }
+        }) }),
+    deleteDocumentFile: () => { },
+}));
+vi.mock("../config/index.js", () => ({
+    getConfig: () => ({
+        host: "127.0.0.1",
+        port: 4000,
+        dataDir: "/tmp/mdocs-test",
+        dbFile: "/tmp/mdocs-test/sqlite/data.sqlite",
+        filesDir: "/tmp/mdocs-test/files",
+        docsDir: "/tmp/mdocs-test/files/docs",
+        assetsDir: "/tmp/mdocs-test/files/assets",
+        logsDir: "/tmp/mdocs-test/logs",
+        webDistDir: "/tmp/mdocs-test/web",
+        logging: {
+            level: "silent",
+            consoleLevel: "silent",
+            consoleStyle: "json",
+            retentionDays: 1,
+            maxFileBytes: 1024,
+        },
+        defaultDomainId: "default",
+    }),
+}));
+vi.mock("../logger/logger.js", () => ({
+    useLogger: () => ({
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+    }),
+}));
+describe("Search functionality", () => {
+    beforeAll(() => {
+        const db = new Database(":memory:");
+        applySchema(db);
+        testDbRef.db = db;
+    });
+    afterEach(() => {
+        const db = testDbRef.db;
+        db.exec("DELETE FROM documents");
+        db.exec("DELETE FROM documents_fts");
+        db.exec("DELETE FROM documents_fts_rowid");
+        db.exec("DELETE FROM audit_logs");
+        db.exec("DELETE FROM document_invites");
+    });
+    it("should index documents and search works", async () => {
+        // 创建测试文档
+        createDocument({
+            actorVisitorId: "test-actor",
+            fileName: "test-document.md",
+            displayName: "测试文档",
+            content: "这是一个测试文档，包含了一些测试内容",
+            domainId: "default",
+            parentId: null,
+        });
+        // 强制索引构建
+        await rebuildAllDirty();
+        // 搜索文档
+        const results = searchDocuments({
+            query: "测试",
+            visitorId: "test-actor",
+            domainId: "default",
+            topN: 10,
+        });
+        expect(results).toEqual([
+            expect.objectContaining({
+                documentId: expect.any(String),
+                displayName: "测试文档",
+                snippet: expect.any(String),
+            }),
+        ]);
+    });
+    it("should not find documents with no matching terms", async () => {
+        // 创建测试文档
+        createDocument({
+            actorVisitorId: "test-actor",
+            fileName: "another-test.md",
+            displayName: "另一个测试文档",
+            content: "这个文档包含了不同的内容",
+            domainId: "default",
+            parentId: null,
+        });
+        // 强制索引构建
+        await rebuildAllDirty();
+        // 搜索不存在的术语
+        const results = searchDocuments({
+            query: "不存在的术语",
+            visitorId: "test-actor",
+            domainId: "default",
+            topN: 10,
+        });
+        expect(results).toEqual([]);
+    });
+});
+//# sourceMappingURL=document-index-manager.test.js.map

package/dist/server/search/document-index-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-index-manager.test.js","sourceRoot":"","sources":["../../../src/server/search/document-index-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/server/search/search.service.js

@@ -0,0 +1,138 @@
+import { getDb } from "../db/connection.js";
+import { findDomainById, isDomainMember } from "../db/repositories/domain.repo.js";
+import { canReadDocument } from "../access/access-control.js";
+/**
+ * 在全文索引中搜索文档。
+ *
+ * 流程：
+ * 1. 在 documents_fts 中执行 MATCH 查询，按 BM25 排名
+ * 2. 按 domainId 过滤（若传入）
+ * 3. 对每个匹配文档执行 canReadDocument 权限检查
+ * 4. 截取 topN 条结果
+ *
+ * @param visitorId 当前访客 ID（未登录为 null）
+ */
+export function searchDocuments(params) {
+    const db = getDb();
+    const topN = params.topN ?? 10;
+    // ---- 查询 FTS5 ----
+    // 取足够多的候选结果（topN * 4），供权限过滤后仍有足够条目
+    const ftsRows = queryFts(db, params.query, topN * 4, params.domainId);
+    if (ftsRows.length === 0)
+        return [];
+    // ---- 权限过滤 ----
+    // 收集涉及的各域信息，批量查询以复用
+    const domainIds = Array.from(new Set(ftsRows.map((r) => r.domain_id)));
+    const domainCache = new Map();
+    for (const did of domainIds) {
+        domainCache.set(did, findDomainById(db, did) ?? null);
+    }
+    const results = [];
+    for (const row of ftsRows) {
+        // 构造 DocumentRow 用于权限判定
+        const docRow = {
+            document_id: row.document_id,
+            domain_id: row.domain_id,
+            relative_path: row.relative_path,
+            display_name: row.display_name,
+            owner_visitor_id: row.owner_visitor_id,
+            created_by: row.owner_visitor_id,
+            updated_by: row.owner_visitor_id,
+            content_hash: "",
+            created_at: "",
+            updated_at: "",
+            permission: row.permission,
+            file_type: "md",
+            parent_id: null,
+        };
+        const domain = domainCache.get(row.domain_id);
+        const domainPermission = domain?.permission ?? "public";
+        const isMember = !!(params.visitorId && domain && isDomainMember(db, row.domain_id, params.visitorId));
+        const domainInfo = { domainPermission, isDomainMember: isMember };
+        if (!canReadDocument(docRow, params.visitorId ?? null, domainInfo))
+            continue;
+        // 截取内容片段（最多 200 字符，从第一个匹配词附近开始）
+        const snippet = extractSnippet(row.content, params.query, 200);
+        results.push({
+            documentId: row.document_id,
+            displayName: row.display_name,
+            relativePath: row.relative_path,
+            domainId: row.domain_id,
+            snippet,
+            bm25Score: row.bm25_score != null ? row.bm25_score : 0,
+        });
+        if (results.length >= topN)
+            break;
+    }
+    return results;
+}
+/**
+ * 执行 FTS5 查询，返回按 BM25 排名升序排列的结果。
+ *
+ * @param db 数据库实例
+ * @param query 用户输入的查询字符串
+ * @param limit 返回数量上限
+ * @param domainIdPattern 可选域过滤（通过 FTS5 UNINDEXED 列）
+ */
+function queryFts(db, query, limit, domainIdPattern) {
+    // 转义 FTS5 特殊字符，防止用户输入破坏查询语法
+    const safeQuery = escapeFts5Query(query);
+    if (!safeQuery)
+        return [];
+    // 构造 SQL：MATCH 必须用字符串字面量，domain_id 用参数绑定防止注入
+    const domainClause = domainIdPattern ? "AND domain_id = ?" : "";
+    const params = domainIdPattern ? [safeQuery, domainIdPattern, limit] : [safeQuery, limit];
+    try {
+        return db.prepare(`SELECT document_id, display_name, relative_path, domain_id, owner_visitor_id, permission, content, bm25(documents_fts) AS bm25_score
+       FROM documents_fts
+       WHERE documents_fts MATCH ? ${domainClause}
+       ORDER BY bm25_score ASC
+       LIMIT ?`).all(...params);
+    }
+    catch {
+        // FTS5 语法异常时返回空（如用户输入了无法解析的字符序列）
+        return [];
+    }
+}
+/**
+ * 转义用户输入中可能破坏 FTS5 语法的特殊字符。
+ *
+ * FTS5 特殊字符：* " + - ^ ( ) { } [ ] ~ . : 、空格
+ * 将每个词用双引号包裹以避免特殊字符被解释为操作符。
+ */
+function escapeFts5Query(query) {
+    const trimmed = query.trim();
+    if (!trimmed)
+        return "";
+    // 移除引号避免破坏 FTS5 语法，按空白分词后每词用双引号包裹，词间 AND
+    const sanitized = trimmed.replace(/"/g, "");
+    const words = sanitized.split(/\s+/).filter((w) => w.length > 0);
+    if (words.length === 0)
+        return "";
+    return words.map((w) => `"${w}"`).join(" ");
+}
+/**
+ * 从文档内容中提取包含查询词的片段。
+ *
+ * @param text 文档全文
+ * @param query 用户查询
+ * @param maxLen 片段最大长度，默认 200 字符
+ */
+function extractSnippet(text, query, maxLen = 200) {
+    if (text.length <= maxLen)
+        return text;
+    const lowerText = text.toLowerCase();
+    const lowerQuery = query.toLowerCase();
+    const idx = lowerText.indexOf(lowerQuery);
+    if (idx === -1) {
+        // 未找到精确匹配（FTS 可能匹配了词干变体），返回开头
+        return text.slice(0, maxLen) + "…";
+    }
+    // 从匹配位置开始前移一些字符，保证片段完整
+    const start = Math.max(0, idx - 30);
+    const end = Math.min(text.length, start + maxLen);
+    const prefix = start > 0 ? "…" : "";
+    const suffix = end < text.length ? "…" : "";
+    return prefix + text.slice(start, end).replace(/\n/g, " ") + suffix;
+}
+//# sourceMappingURL=search.service.js.map

package/dist/server/search/search.service.js.map

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