@customize-agent/server 4.2.4 → 4.2.6

package/messages/zh-CN.json

@@ -17,7 +17,8 @@
     "models": "模型配置",
     "settings": "设置",
     "promptManagement": "提示词管理",
-    "systemLogs": "系统日志"
+    "systemLogs": "系统日志",
+    "templateReferences": "模板参考"
   },
   "overview": {
     "title": "系统总览",
@@ -693,5 +694,60 @@
     "gb": "GB",
     "unknown": "未知",
     "never": "从未"
+  },
+  "refs": {
+    "title": "模板参考库",
+    "description": "上传优秀入围施组文件作为质量对标基准。系统自动解析质量画像（参数密度、工序链、结构等），生成文档后按工程类型对标。参考文件仅用于质量对标与结构参考，绝不作为项目事实材料参与生成。",
+    "uploadTitle": "点击或拖拽上传参考文件",
+    "uploadHint": "支持 PDF / Word 文档，可上传多份不同类型的入围文件累积沉淀",
+    "uploading": "正在上传并解析…",
+    "uploaded": "参考文件已入库并完成画像解析",
+    "uploadFailed": "上传失败",
+    "operationFailed": "操作失败",
+    "projectType": "工程类型",
+    "autoClassify": "不选则自动分类",
+    "statusParsing": "解析中…",
+    "statusFailed": "解析失败",
+    "setPrimary": "设为主参考",
+    "unsetPrimary": "取消主参考",
+    "changeType": "改为",
+    "typeChanged": "类型已更新",
+    "delete": "删除",
+    "deleteConfirm": "删除该参考文件？原文将一并移除",
+    "paramDensity": "参数密度",
+    "arrowChain": "工序链覆盖率",
+    "duplication": "段落重复率",
+    "tables": "表格数",
+    "sections": "章节数",
+    "sectionSubsection": "章节/小节",
+    "subsections": "小节数",
+    "subitems": "子目数",
+    "words": "字数",
+    "more": "展开",
+    "noReferences": "暂无该类型的参考文件",
+    "redLineTitle": "红线说明",
+    "redLine": "参考文件独立存储，永不进入知识库检索、永不作为生成事实材料。",
+    "profileTitle": "类型画像",
+    "profileSamples": "份样本",
+    "profileUpdated": "更新于",
+    "profileDetail": "查看画像详情",
+    "profileDetailTitle": "类型画像详情",
+    "profileMetrics": "指标区间（最小 - 均值 - 最大）",
+    "profileTypicalHeadings": "典型章节结构（样本覆盖率）",
+    "profileCommonTables": "常见表格",
+    "profileFrequentParams": "高频工艺参数",
+    "profileSources": "画像来源文件",
+    "profileNoSamples": "该类型暂无样本，上传参考文件后自动沉淀画像",
+    "profilePrimaryBadge": "主参考",
+    "totalSamples": "有效样本",
+    "coveredTypes": "覆盖类型",
+    "primaryCount": "主参考",
+    "uploadSection": "上传参考文件",
+    "autoClassified": "自动分类",
+    "fileLibrary": "文件库",
+    "allFiles": "全部",
+    "profileSubtitle": "类型级累积画像，随参考文件持续沉淀",
+    "headingPreview": "章节结构",
+    "avgSectionWords": "平均每章字数"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@customize-agent/server",
-  "version": "4.2.4",
+  "version": "4.2.6",
   "description": "Customize Agent Web 管理控制台",
   "exports": {
     "./package.json": "./package.json"
@@ -9,14 +9,6 @@
     "customize-web": "scripts/start-server.cjs",
     "customize-dashboard": "scripts/start-server.cjs"
   },
-  "scripts": {
-    "dev": "node -e \"require('fs').rmSync('.next', { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && next dev -p 17321",
-    "build": "node -e \"require('fs').rmSync('.next', { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && next build && node -e \"const fs=require('fs'); for (const p of ['.next/cache','.next/static/development','.next/static/webpack']) fs.rmSync(p, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && node scripts/verify-next-static.js",
-    "prepack": "node -e \"const fs=require('fs'); for (const p of ['.next/cache','.next/static/development','.next/static/webpack']) fs.rmSync(p, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && node scripts/verify-next-static.js --silent",
-    "prestart": "node scripts/verify-next-static.js",
-    "start": "next start -p 17321",
-    "lint": "eslint src/"
-  },
   "files": [
     ".next/BUILD_ID",
     ".next/app-build-manifest.json",
@@ -44,7 +36,7 @@
   },
   "dependencies": {
     "@ant-design/icons": "^6.3.2",
-    "@customize-agent/knowledge": "^4.0.42",
+    "@customize-agent/knowledge": "^4.0.43",
     "@customize-agent/llm": "^3.0.13",
     "@customize-agent/runtime": "^3.0.13",
     "@napi-rs/canvas": "^0.1.82",
@@ -78,5 +70,12 @@
     "postcss": "^8.4.49",
     "sass": "^1.101.0",
     "tailwindcss": "^4.3.2"
+  },
+  "scripts": {
+    "dev": "node -e \"require('fs').rmSync('.next', { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && next dev -p 17321",
+    "build": "node -e \"require('fs').rmSync('.next', { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && next build && node -e \"const fs=require('fs'); for (const p of ['.next/cache','.next/static/development','.next/static/webpack']) fs.rmSync(p, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\" && node scripts/verify-next-static.js",
+    "prestart": "node scripts/verify-next-static.js",
+    "start": "next start -p 17321",
+    "lint": "eslint src/"
   }
-}
+}

package/scripts/kb-index-worker.cjs

@@ -1,58 +1,13 @@
 #!/usr/bin/env node
-const crypto = require('node:crypto');
-const fs = require('node:fs');
-const os = require('node:os');
+// 知识库后台索引子进程壳：索引主循环复用 @customize-agent/knowledge 的 runIndexLoop
+// （与主进程 runInProcess 共用同一实现），本文件只负责参数解析、进程壳与日志 IPC 转发。
+// 操作日志单写者为主进程：worker 不再直接读写 kb-operations.jsonl，
+// 而是通过 process.send({ type: 'log', patch }) 把补丁交给主进程统一落盘，
+// 避免父子进程同时读改写日志文件造成记录丢失。
 const path = require('node:path');
 
-function computeProjectId(projectRoot) {
-  return crypto.createHash('sha256').update(path.resolve(projectRoot)).digest('hex').slice(0, 12);
-}
-
-function logPath(projectRoot) {
-  return path.join(os.homedir(), '.customize-agent', 'projects', computeProjectId(path.resolve(projectRoot)), 'kb-operations.jsonl');
-}
-
-function readAll(projectRoot) {
-  const file = logPath(projectRoot);
-  if (!fs.existsSync(file)) return [];
-  return fs.readFileSync(file, 'utf8').split('\n').filter(Boolean).flatMap(line => {
-    try { return [JSON.parse(line)]; } catch { return []; }
-  });
-}
-
-function writeAll(projectRoot, records) {
-  const file = logPath(projectRoot);
-  fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, `${records.slice(-200).map(record => JSON.stringify(record)).join('\n')}\n`, 'utf8');
-}
-
-function upsert(projectRoot, patch) {
-  const now = Date.now();
-  const records = readAll(projectRoot);
-  const index = records.findIndex(record => record.id === patch.id);
-  const current = index >= 0 ? records[index] : undefined;
-  const next = {
-    id: patch.id,
-    type: patch.type,
-    title: patch.title,
-    stage: patch.stage ?? current?.stage ?? 'uploading',
-    status: patch.status ?? current?.status ?? 'processing',
-    message: patch.message ?? current?.message ?? '',
-    percent: patch.percent ?? current?.percent ?? 0,
-    fileName: patch.fileName ?? current?.fileName,
-    filePath: patch.filePath ?? current?.filePath,
-    chunkCount: patch.chunkCount ?? current?.chunkCount,
-    textLength: patch.textLength ?? current?.textLength,
-    extractionMode: patch.extractionMode ?? current?.extractionMode,
-    error: patch.error ?? current?.error,
-    createdAt: current?.createdAt ?? now,
-    updatedAt: now,
-  };
-  if (index >= 0) records[index] = next;
-  else records.push(next);
-  writeAll(projectRoot, records);
-  if (process.send) process.send({ type: 'progress', record: next });
-  return next;
+function upsert(_projectRoot, patch) {
+  if (process.send) process.send({ type: 'log', patch });
 }
 
 function toStage(stage) {
@@ -86,44 +41,7 @@ async function main() {
     error: progress.vectorStatus?.error,
   });
 
-  let diff = job.relativePaths?.length
-    ? await project.incrementalIndex({ vectorMode: job.vectorMode, onProgress, onlyRelativePaths: job.relativePaths })
-    : job.relativePath
-      ? await project.reindexFile(job.relativePath, { vectorMode: job.vectorMode, onProgress })
-      : job.forceReindexAll
-        ? await project.forceReindexAll({ vectorMode: job.vectorMode, onProgress })
-        : await project.consumePendingIndexJobs({ vectorMode: job.vectorMode, onProgress, waitForUploadId: job.uploadOperationId });
-
-  let idleChecks = 0;
-  // 上传 session 空闲上限：批次间无新文件到达超过该时长即退出等待，避免前端中断后 worker 永久挂起
-  const sessionIdleLimitMs = Math.max(60_000, Number(process.env.CUSTOMIZE_KB_UPLOAD_SESSION_IDLE_MS || 600_000));
-  const maxIdleChecks = Math.max(10, Math.ceil(sessionIdleLimitMs / 1000));
-  // 等待任何未关闭的上传 session（不限于本 operationId），避免重叠上传的后续批次文件无人消费
-  while (!job.relativePath && !job.relativePaths?.length && (project.countPendingIndexJobs() > 0 || (project.hasOpenUploadSessions() && idleChecks < maxIdleChecks))) {
-    if (project.countPendingIndexJobs() === 0) {
-      idleChecks += 1;
-      await new Promise(resolve => setTimeout(resolve, 1000));
-      continue;
-    }
-    idleChecks = 0;
-    const nextDiff = await project.consumePendingIndexJobs({ vectorMode: job.vectorMode, onProgress, waitForUploadId: job.uploadOperationId });
-    diff = {
-      newFiles: [...diff.newFiles, ...nextDiff.newFiles],
-      modifiedFiles: [...diff.modifiedFiles, ...nextDiff.modifiedFiles],
-      deletedFiles: [...diff.deletedFiles, ...nextDiff.deletedFiles],
-      unchangedCount: diff.unchangedCount + nextDiff.unchangedCount,
-      mtimeOnlyCount: diff.mtimeOnlyCount + nextDiff.mtimeOnlyCount,
-      skippedFiles: [...diff.skippedFiles, ...nextDiff.skippedFiles],
-      hasChanges: diff.hasChanges || nextDiff.hasChanges,
-      diffTimeMs: diff.diffTimeMs + nextDiff.diffTimeMs,
-    };
-  }
-
-  let vectorStatus = project.getVectorStatus();
-  if (job.vectorMode === 'defer' && vectorStatus.status === 'pending') {
-    await project.indexVectors();
-    vectorStatus = project.getVectorStatus();
-  }
+  const { vectorStatus } = await knowledge.runIndexLoop(project, job, onProgress);
   if (vectorStatus.status === 'error') {
     const error = vectorStatus.error || 'HNSWLib 向量入库失败';
     upsert(projectRoot, { id: operationId, type: operationType, title: operationTitle, stage: 'error', status: 'error', percent: 100, message: error, error });

package/.next/package.json

@@ -1 +0,0 @@
-{"type": "commonjs"}