@jingyi0605/codingns 0.8.5 → 0.9.0

package/dist/server/modules/affairs-indexer/core/src/services/search/search-index-builder.js

@@ -0,0 +1,305 @@
+import fs from "node:fs";
+import path from "node:path";
+import { performance } from "node:perf_hooks";
+import { CatalogRepository, } from "../../repositories/catalog-repository.js";
+import { iterateNdjsonFileSync, } from "../../utils/file-streaming.js";
+import { logAffairsIndexerRss } from "../../utils/rss-log.js";
+import { throwIfAborted, yieldToEventLoop } from "../../utils/abort.js";
+import { writeAffairsLibraryDebugLog } from "../../../../../workspace/affairs-library-debug-log.js";
+function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+function writeJson(filePath, value) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
+}
+function appendNdjson(filePath, value) {
+    ensureDir(path.dirname(filePath));
+    fs.appendFileSync(filePath, `${JSON.stringify(value)}\n`, "utf-8");
+}
+function safeUnlink(filePath) {
+    if (fs.existsSync(filePath)) {
+        fs.unlinkSync(filePath);
+    }
+}
+function normalizeText(value) {
+    return value.toLowerCase();
+}
+function tokenize(value) {
+    const terms = new Set();
+    const normalized = normalizeText(value);
+    const wordMatches = normalized.match(/[a-z0-9][a-z0-9._-]*/g) ?? [];
+    for (const word of wordMatches) {
+        if (word.length >= 2) {
+            terms.add(word);
+        }
+    }
+    const compact = normalized.replace(/\s+/g, "");
+    const hanMatches = compact.match(/[\u4e00-\u9fff]{2,}/g) ?? [];
+    for (const block of hanMatches) {
+        if (block.length <= 4) {
+            terms.add(block);
+            continue;
+        }
+        for (let size = 2; size <= 4; size += 1) {
+            for (let index = 0; index <= block.length - size; index += 1) {
+                terms.add(block.slice(index, index + size));
+            }
+        }
+    }
+    return [...terms];
+}
+function buildBucketName(term) {
+    const first = term[0] ?? "_";
+    if (/[a-z0-9]/.test(first)) {
+        return first;
+    }
+    return "han";
+}
+function buildDocumentEntry(document) {
+    return {
+        document_id: document.documentId,
+        path: document.path,
+        title: document.title,
+        summary: document.summary,
+        mtime: document.mtime,
+        tags: [...document.tags, ...document.derivedTags],
+    };
+}
+function mergePosting(termMap, term, documentId) {
+    const postings = termMap.get(term) ?? [];
+    if (postings[postings.length - 1] !== documentId) {
+        postings.push(documentId);
+    }
+    termMap.set(term, postings);
+}
+function writeSearchBucketFile(filePath, exportedAt, bucket, documents, terms) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, `{\n  "version": 1,\n  "format": "search-bucket-v1",\n  "generated_at": ${JSON.stringify(exportedAt)},\n  "bucket": ${JSON.stringify(bucket)},\n  "documents": [`, "utf-8");
+    let isFirst = true;
+    for (const document of documents) {
+        fs.appendFileSync(filePath, `${isFirst ? "" : ","}\n${JSON.stringify(document, null, 2)}`, "utf-8");
+        isFirst = false;
+    }
+    fs.appendFileSync(filePath, `${isFirst ? "" : "\n"}  ],\n  "terms": [`, "utf-8");
+    isFirst = true;
+    for (const term of terms) {
+        fs.appendFileSync(filePath, `${isFirst ? "" : ","}\n${JSON.stringify(term, null, 2)}`, "utf-8");
+        isFirst = false;
+    }
+    fs.appendFileSync(filePath, `${isFirst ? "" : "\n"}  ]\n}\n`, "utf-8");
+}
+/**
+ * 离线关键词倒排构建器。
+ * 改成两阶段流式：第一阶段按 bucket 写临时 NDJSON，第二阶段逐 bucket 汇总为静态 JSON，
+ * 避免把全部 documents / terms 一次性挂在内存里。
+ */
+export class SearchIndexBuilder {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async build(options = {}) {
+        const exportedAt = new Date().toISOString();
+        const startedAt = performance.now();
+        const repository = new CatalogRepository(this.config.dbPath);
+        const outputDir = path.join(this.config.exportDir, "search");
+        const tempDir = path.join(outputDir, ".tmp");
+        ensureDir(outputDir);
+        ensureDir(tempDir);
+        const filesWritten = [];
+        const manifestBuckets = [];
+        const documentTempPaths = new Map();
+        const termTempPaths = new Map();
+        writeAffairsLibraryDebugLog({
+            event: "search_build_started",
+            processRole: "helper",
+            rootDir: this.config.rootDir,
+            command: options.commandName ?? "export",
+            reason: options.reason,
+            targetPath: options.targetPath,
+            status: "running",
+            details: {
+                outputDir,
+                tempDir
+            }
+        });
+        for (const batch of repository.iterateExportDocumentRecords(2000)) {
+            throwIfAborted(options.signal, "事务文档库搜索索引构建已取消");
+            for (const document of batch) {
+                throwIfAborted(options.signal, "事务文档库搜索索引构建已取消");
+                const entry = buildDocumentEntry(document);
+                const sourceText = [
+                    document.path,
+                    document.title,
+                    document.summary,
+                    ...document.tags,
+                    ...document.derivedTags,
+                ].join("\n");
+                const bucketTerms = new Map();
+                for (const term of tokenize(sourceText)) {
+                    const bucket = buildBucketName(term);
+                    const current = bucketTerms.get(bucket) ?? [];
+                    current.push(term);
+                    bucketTerms.set(bucket, current);
+                }
+                for (const [bucket, terms] of bucketTerms.entries()) {
+                    const documentTempPath = documentTempPaths.get(bucket) ?? path.join(tempDir, `${bucket}.documents.ndjson`);
+                    const termTempPath = termTempPaths.get(bucket) ?? path.join(tempDir, `${bucket}.terms.ndjson`);
+                    if (!documentTempPaths.has(bucket)) {
+                        writeAffairsLibraryDebugLog({
+                            event: "search_bucket_temp_prepared",
+                            processRole: "helper",
+                            rootDir: this.config.rootDir,
+                            command: options.commandName ?? "export",
+                            reason: options.reason,
+                            targetPath: options.targetPath,
+                            status: "running",
+                            details: {
+                                bucket,
+                                documentTempPath,
+                                termTempPath
+                            }
+                        });
+                    }
+                    documentTempPaths.set(bucket, documentTempPath);
+                    termTempPaths.set(bucket, termTempPath);
+                    appendNdjson(documentTempPath, entry);
+                    for (const term of new Set(terms)) {
+                        appendNdjson(termTempPath, {
+                            term,
+                            document_id: entry.document_id,
+                        });
+                    }
+                }
+            }
+            await yieldToEventLoop(options.signal, "事务文档库搜索索引构建已取消");
+        }
+        for (const bucket of [...documentTempPaths.keys()].sort((a, b) => a.localeCompare(b, "zh-Hans-CN"))) {
+            throwIfAborted(options.signal, "事务文档库搜索索引构建已取消");
+            const documentTempPath = documentTempPaths.get(bucket);
+            const termTempPath = termTempPaths.get(bucket);
+            const bucketStartedAt = performance.now();
+            writeAffairsLibraryDebugLog({
+                event: "search_bucket_build_started",
+                processRole: "helper",
+                rootDir: this.config.rootDir,
+                command: options.commandName ?? "export",
+                reason: options.reason,
+                targetPath: options.targetPath,
+                status: "running",
+                details: {
+                    bucket,
+                    documentTempPath,
+                    termTempPath
+                }
+            });
+            const documentMap = new Map();
+            const termMap = new Map();
+            iterateNdjsonFileSync(documentTempPath, (document) => {
+                documentMap.set(document.document_id, document);
+            });
+            iterateNdjsonFileSync(termTempPath, (record) => {
+                mergePosting(termMap, record.term, record.document_id);
+            });
+            const filePath = path.join(outputDir, `${bucket}.json`);
+            writeSearchBucketFile(filePath, exportedAt, bucket, [...documentMap.values()].sort((a, b) => a.path.localeCompare(b.path, "zh-Hans-CN")), [...termMap.entries()]
+                .sort((a, b) => a[0].localeCompare(b[0], "zh-Hans-CN"))
+                .map(([term, documentIds]) => ({
+                term,
+                document_count: documentIds.length,
+                document_ids: documentIds,
+            })));
+            filesWritten.push(filePath);
+            manifestBuckets.push({
+                bucket,
+                path: `search/${bucket}.json`,
+                term_count: termMap.size,
+            });
+            writeAffairsLibraryDebugLog({
+                event: "search_bucket_build_finished",
+                processRole: "helper",
+                rootDir: this.config.rootDir,
+                command: options.commandName ?? "export",
+                reason: options.reason,
+                targetPath: options.targetPath,
+                status: "finished",
+                durationMs: Number((performance.now() - bucketStartedAt).toFixed(2)),
+                details: {
+                    bucket,
+                    filePath,
+                    documentCount: documentMap.size,
+                    termCount: termMap.size
+                }
+            });
+            safeUnlink(documentTempPath);
+            safeUnlink(termTempPath);
+            writeAffairsLibraryDebugLog({
+                event: "search_bucket_temp_cleaned",
+                processRole: "helper",
+                rootDir: this.config.rootDir,
+                command: options.commandName ?? "export",
+                reason: options.reason,
+                targetPath: options.targetPath,
+                status: "finished",
+                details: {
+                    bucket,
+                    documentTempPath,
+                    termTempPath
+                }
+            });
+            await yieldToEventLoop(options.signal, "事务文档库搜索索引构建已取消");
+        }
+        if (fs.existsSync(tempDir) && fs.readdirSync(tempDir).length === 0) {
+            fs.rmdirSync(tempDir);
+            writeAffairsLibraryDebugLog({
+                event: "search_temp_dir_removed",
+                processRole: "helper",
+                rootDir: this.config.rootDir,
+                command: options.commandName ?? "export",
+                reason: options.reason,
+                targetPath: options.targetPath,
+                status: "finished",
+                details: {
+                    tempDir
+                }
+            });
+        }
+        const manifestPath = path.join(outputDir, "manifest.json");
+        writeJson(manifestPath, {
+            version: 1,
+            format: "search-v1",
+            generated_at: exportedAt,
+            buckets: manifestBuckets,
+        });
+        filesWritten.push(manifestPath);
+        logAffairsIndexerRss(this.config, "search.complete", {
+            rootDir: this.config.rootDir,
+            bucketCount: manifestBuckets.length,
+            fileCount: filesWritten.length
+        });
+        writeAffairsLibraryDebugLog({
+            event: "search_build_finished",
+            processRole: "helper",
+            rootDir: this.config.rootDir,
+            command: options.commandName ?? "export",
+            reason: options.reason,
+            targetPath: options.targetPath,
+            status: "finished",
+            durationMs: Number((performance.now() - startedAt).toFixed(2)),
+            details: {
+                bucketCount: manifestBuckets.length,
+                fileCount: filesWritten.length,
+                manifestPath
+            }
+        });
+        return {
+            outputDir,
+            bucketCount: manifestBuckets.length,
+            manifestPath,
+            filesWritten,
+            exportedAt,
+        };
+    }
+}
+//# sourceMappingURL=search-index-builder.js.map

package/dist/server/modules/affairs-indexer/core/src/services/search/search-index-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index-builder.js","sourceRoot":"","sources":["../../../../../../../../src/modules/affairs-indexer/core/src/services/search/search-index-builder.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/affairs-indexer/core/src/services/tagging/tag-recompute-service.d.ts

@@ -0,0 +1,53 @@
+import type { RuntimeConfig } from "../../../../contracts/src/index.js";
+import { type RecomputeScope } from "../../repositories/catalog-repository.js";
+import type { DirtyScope } from "../dirty/dirty-scope-resolver.js";
+export interface TagRecomputeRunInput {
+    scope?: RecomputeScope;
+    signal?: AbortSignal;
+    onProgress?: (progress: TagRecomputeProgressSnapshot) => void;
+}
+export interface TagRecomputeResult {
+    scannedCount: number;
+    updatedCount: number;
+    directAssignedCount: number;
+    derivedAssignedCount: number;
+    dirtyScope: DirtyScope;
+    exportResult: {
+        metaShardCount: number;
+        detailShardCount: number;
+        tagShardCount: number;
+        exportedAt: string;
+    } | null;
+    timingsMs: {
+        infer: number;
+        write: number;
+        export: number;
+        total: number;
+    };
+}
+export interface TagRecomputeProgressSnapshot {
+    phase: "prepare" | "recompute" | "write" | "export" | "finished";
+    label: string;
+    detail: string | null;
+    current: number;
+    total: number;
+    percent: number;
+}
+/**
+ * 只重算标签，不重新解析原始文件。
+ * 当前只合并人工绑定、文件夹绑定和系统派生结果。
+ */
+export declare class TagRecomputeService {
+    private readonly config;
+    constructor(config: RuntimeConfig);
+    run(input?: TagRecomputeRunInput): Promise<TagRecomputeResult>;
+    private resolveManualAssignments;
+    private resolveFolderAssignments;
+    private resolveRetainedResolvedAssignments;
+    private mergeResolvedAssignments;
+    private mergeResolvedAssignmentsWithRetained;
+    private resolveSmartRuleAssignments;
+    private buildDirtyScopeFromResolvedEntries;
+    private emitProgress;
+    private hasTagDefinitionDriftSinceLastExport;
+}