@sanqianx/project-knowledge 5.0.18 → 5.0.20-rc.1

package/_site/lib/index-builder.js

@@ -1,157 +1,157 @@
-const fs = require('fs');
-const path = require('path');
-
-const MAX_INDEX_ITEMS = 40;
-const MAX_MODULE_ITEMS = 80;
-const MAX_TAGS = 4;
-const MAX_SOURCE_PATHS = 3;
-const MAX_LOOKUPS = 4;
-const MAX_CELL_CHARS = 120;
-const GENERATED_NOTICE = '<!-- Generated by project-knowledge. Do not edit manually. -->';
-
-function parseFrontmatter(text) {
-  const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/.exec(String(text || ''));
-  if (!match) return {};
-  const meta = {};
-  for (const line of match[1].split(/\r?\n/)) {
-    const m = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line.trim());
-    if (!m) continue;
-    let value = m[2].trim();
-    if (/^\[.*\]$/.test(value)) {
-      value = value.slice(1, -1).split(',').map(s => s.trim()).filter(Boolean);
-    }
-    meta[m[1]] = value;
-  }
-  return meta;
-}
-
-function listMarkdown(dir) {
-  if (!fs.existsSync(dir)) return [];
-  return fs.readdirSync(dir, { withFileTypes: true })
-    .filter(entry => entry.isFile() && entry.name.endsWith('.md') && entry.name !== '00-index.md')
-    .map(entry => {
-      const rel = entry.name;
-      const full = path.join(dir, entry.name);
-      const text = fs.readFileSync(full, 'utf-8');
-      const meta = parseFrontmatter(text);
-      const title = meta.title || text.match(/^#\s+(.+)$/m)?.[1] || entry.name.replace(/\.md$/, '');
-      return { rel, full, meta, title, updatedAt: meta.updatedAt || meta.period || '' };
-    });
-}
-
-function metaList(value) {
-  if (Array.isArray(value)) return value.filter(Boolean);
-  if (!value) return [];
-  return String(value).split(',').map(s => s.trim()).filter(Boolean);
-}
-
-function compactList(value, limit) {
-  const items = metaList(value);
-  if (items.length <= limit) return items.join(', ');
-  return `${items.slice(0, limit).join(', ')} (+${items.length - limit})`;
-}
-
-function cell(value, maxChars = MAX_CELL_CHARS) {
-  const text = Array.isArray(value) ? value.join(', ') : String(value || '');
-  const clean = text.replace(/\r?\n/g, ' ').replace(/\|/g, '\\|').trim();
-  if (!clean) return '-';
-  return clean.length > maxChars ? `${clean.slice(0, Math.max(1, maxChars - 1)).trimEnd()}…` : clean;
-}
-
-function indexSummary(total, shown) {
-  return shown < total
-    ? `Items: ${total} (showing ${shown}; use knowledge search or file search for older entries)`
-    : `Items: ${total}`;
-}
-
-function markdownLink(title, rel) {
-  const label = cell(title, 80).replace(/\[/g, '\\[').replace(/\]/g, '\\]');
-  const target = encodeURI(String(rel || '')).replace(/\(/g, '%28').replace(/\)/g, '%29');
-  return `[${label}](./${target})`;
-}
-
-function renderModuleIndex(kbPath) {
-  const dir = path.join(kbPath, 'modules');
-  const items = listMarkdown(dir).sort((a, b) => a.title.localeCompare(b.title));
-  const visible = items.slice(0, MAX_MODULE_ITEMS);
-  const lines = [
-    GENERATED_NOTICE,
-    '',
-    '# Modules Index',
-    '',
-    indexSummary(items.length, visible.length),
-    '',
-    '| Module | Tags | Source Paths | Routes / Symbols | Updated |',
-    '|---|---|---|---|---|',
-  ];
-  for (const item of visible) {
-    const tagsText = compactList(item.meta.tags, MAX_TAGS);
-    const sourcePaths = compactList(item.meta.sourcePaths, MAX_SOURCE_PATHS);
-    const routes = metaList(item.meta.routes);
-    const symbols = metaList(item.meta.symbols);
-    const lookup = compactList([...routes, ...symbols], MAX_LOOKUPS);
-    lines.push(`| ${markdownLink(item.title, item.rel)} | ${cell(tagsText)} | ${cell(sourcePaths)} | ${cell(lookup)} | ${cell(item.updatedAt)} |`);
-  }
-  if (!items.length) lines.push('| No modules yet | - | - | - | - |');
-  return { path: 'modules/00-index.md', count: items.length, content: lines.join('\n') + '\n' };
-}
-
-function writeModuleIndex(kbPath) {
-  const rendered = renderModuleIndex(kbPath);
-  const dest = path.join(kbPath, rendered.path);
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.writeFileSync(dest, rendered.content, 'utf-8');
-  return { path: rendered.path, count: rendered.count };
-}
-
-function renderChangesIndex(kbPath) {
-  const dir = path.join(kbPath, 'changes');
-  const items = listMarkdown(dir).sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)) || a.title.localeCompare(b.title));
-  const visible = items.slice(0, MAX_INDEX_ITEMS);
-  const lines = [
-    GENERATED_NOTICE,
-    '',
-    '# Changes Index',
-    '',
-    indexSummary(items.length, visible.length),
-    '',
-    '| Change | Tags | Affected Modules | Period / Updated | Intent |',
-    '|---|---|---|---|---|',
-  ];
-  for (const item of visible) {
-    const tagsText = compactList(item.meta.tags, MAX_TAGS);
-    const affected = compactList(item.meta.affectedModules, MAX_SOURCE_PATHS);
-    const intent = item.meta.developmentIntent || item.meta.intent || '';
-    lines.push(`| ${markdownLink(item.title, item.rel)} | ${cell(tagsText)} | ${cell(affected)} | ${cell(item.updatedAt)} | ${cell(intent)} |`);
-  }
-  if (!items.length) lines.push('| No changes yet | - | - | - | - |');
-  return { path: 'changes/00-index.md', count: items.length, content: lines.join('\n') + '\n' };
-}
-
-function writeChangesIndex(kbPath) {
-  const rendered = renderChangesIndex(kbPath);
-  const dest = path.join(kbPath, rendered.path);
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.writeFileSync(dest, rendered.content, 'utf-8');
-  return { path: rendered.path, count: rendered.count };
-}
-
-function regenerateIndexes(kbPath) {
-  return {
-    modules: writeModuleIndex(kbPath),
-    changes: writeChangesIndex(kbPath),
-  };
-}
-
-module.exports = {
-  parseFrontmatter,
-  compactList,
-  cell,
-  markdownLink,
-  GENERATED_NOTICE,
-  renderModuleIndex,
-  renderChangesIndex,
-  regenerateIndexes,
-  writeModuleIndex,
-  writeChangesIndex,
-};
+const fs = require('fs');
+const path = require('path');
+
+const MAX_INDEX_ITEMS = 40;
+const MAX_MODULE_ITEMS = 80;
+const MAX_TAGS = 4;
+const MAX_SOURCE_PATHS = 3;
+const MAX_LOOKUPS = 4;
+const MAX_CELL_CHARS = 120;
+const GENERATED_NOTICE = '<!-- Generated by project-knowledge. Do not edit manually. -->';
+
+function parseFrontmatter(text) {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/.exec(String(text || ''));
+  if (!match) return {};
+  const meta = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const m = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line.trim());
+    if (!m) continue;
+    let value = m[2].trim();
+    if (/^\[.*\]$/.test(value)) {
+      value = value.slice(1, -1).split(',').map(s => s.trim()).filter(Boolean);
+    }
+    meta[m[1]] = value;
+  }
+  return meta;
+}
+
+function listMarkdown(dir) {
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir, { withFileTypes: true })
+    .filter(entry => entry.isFile() && entry.name.endsWith('.md') && entry.name !== '00-index.md')
+    .map(entry => {
+      const rel = entry.name;
+      const full = path.join(dir, entry.name);
+      const text = fs.readFileSync(full, 'utf-8');
+      const meta = parseFrontmatter(text);
+      const title = meta.title || text.match(/^#\s+(.+)$/m)?.[1] || entry.name.replace(/\.md$/, '');
+      return { rel, full, meta, title, updatedAt: meta.updatedAt || meta.period || '' };
+    });
+}
+
+function metaList(value) {
+  if (Array.isArray(value)) return value.filter(Boolean);
+  if (!value) return [];
+  return String(value).split(',').map(s => s.trim()).filter(Boolean);
+}
+
+function compactList(value, limit) {
+  const items = metaList(value);
+  if (items.length <= limit) return items.join(', ');
+  return `${items.slice(0, limit).join(', ')} (+${items.length - limit})`;
+}
+
+function cell(value, maxChars = MAX_CELL_CHARS) {
+  const text = Array.isArray(value) ? value.join(', ') : String(value || '');
+  const clean = text.replace(/\r?\n/g, ' ').replace(/\|/g, '\\|').trim();
+  if (!clean) return '-';
+  return clean.length > maxChars ? `${clean.slice(0, Math.max(1, maxChars - 1)).trimEnd()}…` : clean;
+}
+
+function indexSummary(total, shown) {
+  return shown < total
+    ? `Items: ${total} (showing ${shown}; use knowledge search or file search for older entries)`
+    : `Items: ${total}`;
+}
+
+function markdownLink(title, rel) {
+  const label = cell(title, 80).replace(/\[/g, '\\[').replace(/\]/g, '\\]');
+  const target = encodeURI(String(rel || '')).replace(/\(/g, '%28').replace(/\)/g, '%29');
+  return `[${label}](./${target})`;
+}
+
+function renderModuleIndex(kbPath) {
+  const dir = path.join(kbPath, 'modules');
+  const items = listMarkdown(dir).sort((a, b) => a.title.localeCompare(b.title));
+  const visible = items.slice(0, MAX_MODULE_ITEMS);
+  const lines = [
+    GENERATED_NOTICE,
+    '',
+    '# Modules Index',
+    '',
+    indexSummary(items.length, visible.length),
+    '',
+    '| Module | Tags | Source Paths | Routes / Symbols | Updated |',
+    '|---|---|---|---|---|',
+  ];
+  for (const item of visible) {
+    const tagsText = compactList(item.meta.tags, MAX_TAGS);
+    const sourcePaths = compactList(item.meta.sourcePaths, MAX_SOURCE_PATHS);
+    const routes = metaList(item.meta.routes);
+    const symbols = metaList(item.meta.symbols);
+    const lookup = compactList([...routes, ...symbols], MAX_LOOKUPS);
+    lines.push(`| ${markdownLink(item.title, item.rel)} | ${cell(tagsText)} | ${cell(sourcePaths)} | ${cell(lookup)} | ${cell(item.updatedAt)} |`);
+  }
+  if (!items.length) lines.push('| No modules yet | - | - | - | - |');
+  return { path: 'modules/00-index.md', count: items.length, content: lines.join('\n') + '\n' };
+}
+
+function writeModuleIndex(kbPath) {
+  const rendered = renderModuleIndex(kbPath);
+  const dest = path.join(kbPath, rendered.path);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.writeFileSync(dest, rendered.content, 'utf-8');
+  return { path: rendered.path, count: rendered.count };
+}
+
+function renderChangesIndex(kbPath) {
+  const dir = path.join(kbPath, 'changes');
+  const items = listMarkdown(dir).sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)) || a.title.localeCompare(b.title));
+  const visible = items.slice(0, MAX_INDEX_ITEMS);
+  const lines = [
+    GENERATED_NOTICE,
+    '',
+    '# Changes Index',
+    '',
+    indexSummary(items.length, visible.length),
+    '',
+    '| Change | Tags | Affected Modules | Period / Updated | Intent |',
+    '|---|---|---|---|---|',
+  ];
+  for (const item of visible) {
+    const tagsText = compactList(item.meta.tags, MAX_TAGS);
+    const affected = compactList(item.meta.affectedModules, MAX_SOURCE_PATHS);
+    const intent = item.meta.developmentIntent || item.meta.intent || '';
+    lines.push(`| ${markdownLink(item.title, item.rel)} | ${cell(tagsText)} | ${cell(affected)} | ${cell(item.updatedAt)} | ${cell(intent)} |`);
+  }
+  if (!items.length) lines.push('| No changes yet | - | - | - | - |');
+  return { path: 'changes/00-index.md', count: items.length, content: lines.join('\n') + '\n' };
+}
+
+function writeChangesIndex(kbPath) {
+  const rendered = renderChangesIndex(kbPath);
+  const dest = path.join(kbPath, rendered.path);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.writeFileSync(dest, rendered.content, 'utf-8');
+  return { path: rendered.path, count: rendered.count };
+}
+
+function regenerateIndexes(kbPath) {
+  return {
+    modules: writeModuleIndex(kbPath),
+    changes: writeChangesIndex(kbPath),
+  };
+}
+
+module.exports = {
+  parseFrontmatter,
+  compactList,
+  cell,
+  markdownLink,
+  GENERATED_NOTICE,
+  renderModuleIndex,
+  renderChangesIndex,
+  regenerateIndexes,
+  writeModuleIndex,
+  writeChangesIndex,
+};

package/_site/lib/integration-status-scan.js

@@ -1,99 +1,99 @@
-'use strict';
-const path = require('node:path');
-const { fork, spawn } = require('node:child_process');
-const { IntegrationManager, SUPPORTED_CLIENTS, CLIENT_LABELS } = require('./integration-installer');
-
-class IntegrationStatusScan {
-  constructor({ workerFile, timeoutMs = 20000 } = {}) {
-    this.workerFile = workerFile || path.join(__dirname, 'integration-status-worker.js');
-    this.timeoutMs = timeoutMs; this.entries = new Map(); this.children = new Set(); this.generation = 0;
-    this.queue = []; this.running = 0; this.closed = false;
-  }
-  async read(managerOptions, statusOptions = {}, { force = false, waitMs = 500 } = {}) {
-    if (managerOptions.runner || managerOptions.commandResolver || managerOptions.bridgeModule || managerOptions.codexHookProbe) return new IntegrationManager(managerOptions).statusAll(statusOptions);
-    const key = JSON.stringify([managerOptions.rootDir, managerOptions.homeDir, managerOptions.bridgeHomeDir, statusOptions.cwd, statusOptions.captureOnly, statusOptions.clients]);
-    let entry = this.entries.get(key);
-    if (!entry || !entry.promise && (force || Date.now() - entry.at > 30000)) {
-      entry = { at: Date.now(), generation: ++this.generation, summary: entry?.summary || null, promise: null };
-      entry.promise = this.run(managerOptions, statusOptions).then(summary => { entry.summary = summary; entry.at = Date.now(); return summary; }, error => {
-        if (entry.summary) {
-          entry.summary = { ...entry.summary, stale: true, error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
-          return entry.summary;
-        }
-        entry.summary = { bridge: { ok: false, state: 'check-failed', detail: '接入状态检查失败或超时，未将其判为未安装。' },
-          clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
-            knowledgeIntegration: { ok: false, state: 'check-failed', detail: '检查未完成，请重试。' }, automaticContext: { supported: client !== 'opencode', configured: false, state: 'check-failed', detail: '检查未完成，不代表客户端未接入。' },
-            developmentCapture: { ok: false, state: 'check-failed', detail: '采集状态尚未核实。' } })), error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
-        return entry.summary;
-      }).finally(() => { entry.promise = null; });
-      this.entries.set(key, entry);
-      if (this.entries.size > 100) for (const [oldKey, old] of this.entries) { if (!old.promise && oldKey !== key) { this.entries.delete(oldKey); break; } }
-    }
-    if (entry.promise && waitMs > 0) {
-      let timer;
-      await Promise.race([entry.promise, new Promise(resolve => { timer = setTimeout(resolve, waitMs); })]); clearTimeout(timer);
-    }
-    const pending = entry.promise !== null;
-    if (entry.summary) return { ...entry.summary, scan: { state: pending ? 'refreshing' : 'ready', generation: entry.generation, updatedAt: entry.at } };
-    return { bridge: { ok: true, state: 'checking' }, clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
-      configFound: new IntegrationManager(managerOptions).captureConfigFound(client),
-      knowledgeIntegration: { ok: true, state: 'checking', detail: '正在检查接入状态…' },
-      automaticContext: { supported: client !== 'opencode', configured: false, state: 'checking', detail: '正在检查开发前知识读取…' },
-      developmentCapture: { ok: true, state: 'checking', detail: '正在检查采集…' } })), scan: { state: 'checking', generation: entry.generation } };
-  }
-  run(managerOptions, statusOptions) {
-    return new Promise((resolve, reject) => {
-      if (this.closed || this.queue.length >= 64) { reject(Object.assign(new Error('状态检查暂不可用。'), { code: this.closed ? 'INTEGRATION_STATUS_CLOSED' : 'INTEGRATION_STATUS_BUSY' })); return; }
-      this.queue.push({ managerOptions, statusOptions, resolve, reject }); this.drain();
-    });
-  }
-  drain() {
-    while (!this.closed && this.running < 2 && this.queue.length) {
-      const next = this.queue.shift(); this.running++;
-      this.probe(next.managerOptions, next.statusOptions).then(next.resolve, next.reject).finally(() => { this.running--; this.drain(); });
-    }
-  }
-  probe(managerOptions, statusOptions) {
-    return new Promise((resolve, reject) => {
-      const child = fork(this.workerFile, [], { stdio: ['ignore', 'ignore', 'ignore', 'ipc'], windowsHide: true, env: { ...process.env, KB_INTEGRATION_STATUS_WORKER: '1' } });
-      this.children.add(child);
-      let settled = false;
-      const finish = (error, summary) => { if (settled) return; settled = true; clearTimeout(timer); error ? reject(error) : resolve(summary); };
-      const timer = setTimeout(() => {
-        Promise.resolve(managerOptions.logger?.warn?.('integration.status.timeout', '客户端接入状态检查超时；未将其判为未安装。', {
-          operationId: managerOptions.operationId, component: 'integration', phase: 'status',
-          context: { clients: statusOptions.clients || SUPPORTED_CLIENTS, timeoutMs: this.timeoutMs },
-        })).catch(() => {});
-        this.terminate(child); finish(Object.assign(new Error('状态检查超时。'), { code: 'INTEGRATION_STATUS_TIMEOUT' }));
-      }, this.timeoutMs);
-      child.on('message', message => {
-        if (message?.kind === 'log') {
-          if (['info', 'warn', 'error'].includes(message.level) && Array.isArray(message.args) && /^integration\./.test(message.args[0] || '')) Promise.resolve(managerOptions.logger?.[message.level]?.(...message.args)).catch(() => {});
-          return;
-        }
-        finish(message?.ok ? null : Object.assign(new Error('状态检查失败。'), { code: message?.code }), message?.summary);
-      });
-      child.once('error', error => finish(error));
-      child.once('exit', () => { this.children.delete(child); if (!settled) finish(Object.assign(new Error('状态检查进程提前退出。'), { code: 'INTEGRATION_STATUS_EXITED' })); });
-      const allowed = ['rootDir', 'homeDir', 'version', 'packageSpec', 'operationId', 'bridgeHomeDir', 'bridgeConsumerName', 'claudeSettingsFile', 'codexConfigFile', 'zcodeConfigFile', 'openCodePluginsDir'];
-      child.send({ managerOptions: Object.fromEntries(allowed.filter(k => managerOptions[k] !== undefined).map(k => [k, managerOptions[k]])), statusOptions });
-    });
-  }
-  terminate(child) {
-    if (child.exitCode !== null || child.signalCode !== null) return;
-    if (process.platform === 'win32') {
-      // Only the live worker we created, including its probe children. Never
-      // terminate by executable name or scan unrelated Node processes.
-      const killer = spawn('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
-      killer.on('error', () => child.kill());
-    } else child.kill('SIGTERM');
-  }
-  invalidate() { for (const entry of this.entries.values()) entry.at = 0; }
-  close() {
-    this.closed = true;
-    for (const child of this.children) this.terminate(child);
-    for (const item of this.queue) item.reject(Object.assign(new Error('扫描已关闭。'), { code: 'INTEGRATION_STATUS_CLOSED' }));
-    this.queue = []; this.entries.clear();
-  }
-}
-module.exports = { IntegrationStatusScan };
+'use strict';
+const path = require('node:path');
+const { fork, spawn } = require('node:child_process');
+const { IntegrationManager, SUPPORTED_CLIENTS, CLIENT_LABELS } = require('./integration-installer');
+
+class IntegrationStatusScan {
+  constructor({ workerFile, timeoutMs = 20000 } = {}) {
+    this.workerFile = workerFile || path.join(__dirname, 'integration-status-worker.js');
+    this.timeoutMs = timeoutMs; this.entries = new Map(); this.children = new Set(); this.generation = 0;
+    this.queue = []; this.running = 0; this.closed = false;
+  }
+  async read(managerOptions, statusOptions = {}, { force = false, waitMs = 500 } = {}) {
+    if (managerOptions.runner || managerOptions.commandResolver || managerOptions.bridgeModule || managerOptions.codexHookProbe) return new IntegrationManager(managerOptions).statusAll(statusOptions);
+    const key = JSON.stringify([managerOptions.rootDir, managerOptions.homeDir, managerOptions.bridgeHomeDir, statusOptions.cwd, statusOptions.captureOnly, statusOptions.clients]);
+    let entry = this.entries.get(key);
+    if (!entry || !entry.promise && (force || Date.now() - entry.at > 30000)) {
+      entry = { at: Date.now(), generation: ++this.generation, summary: entry?.summary || null, promise: null };
+      entry.promise = this.run(managerOptions, statusOptions).then(summary => { entry.summary = summary; entry.at = Date.now(); return summary; }, error => {
+        if (entry.summary) {
+          entry.summary = { ...entry.summary, stale: true, error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
+          return entry.summary;
+        }
+        entry.summary = { bridge: { ok: false, state: 'check-failed', detail: '接入状态检查失败或超时，未将其判为未安装。' },
+          clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
+            knowledgeIntegration: { ok: false, state: 'check-failed', detail: '检查未完成，请重试。' }, automaticContext: { supported: client !== 'opencode', configured: false, state: 'check-failed', detail: '检查未完成，不代表客户端未接入。' },
+            developmentCapture: { ok: false, state: 'check-failed', detail: '采集状态尚未核实。' } })), error: { code: error.code || 'INTEGRATION_STATUS_FAILED' } };
+        return entry.summary;
+      }).finally(() => { entry.promise = null; });
+      this.entries.set(key, entry);
+      if (this.entries.size > 100) for (const [oldKey, old] of this.entries) { if (!old.promise && oldKey !== key) { this.entries.delete(oldKey); break; } }
+    }
+    if (entry.promise && waitMs > 0) {
+      let timer;
+      await Promise.race([entry.promise, new Promise(resolve => { timer = setTimeout(resolve, waitMs); })]); clearTimeout(timer);
+    }
+    const pending = entry.promise !== null;
+    if (entry.summary) return { ...entry.summary, scan: { state: pending ? 'refreshing' : 'ready', generation: entry.generation, updatedAt: entry.at } };
+    return { bridge: { ok: true, state: 'checking' }, clients: (statusOptions.clients || SUPPORTED_CLIENTS).map(client => ({ client, label: CLIENT_LABELS[client],
+      configFound: new IntegrationManager(managerOptions).captureConfigFound(client),
+      knowledgeIntegration: { ok: true, state: 'checking', detail: '正在检查接入状态…' },
+      automaticContext: { supported: client !== 'opencode', configured: false, state: 'checking', detail: '正在检查开发前知识读取…' },
+      developmentCapture: { ok: true, state: 'checking', detail: '正在检查采集…' } })), scan: { state: 'checking', generation: entry.generation } };
+  }
+  run(managerOptions, statusOptions) {
+    return new Promise((resolve, reject) => {
+      if (this.closed || this.queue.length >= 64) { reject(Object.assign(new Error('状态检查暂不可用。'), { code: this.closed ? 'INTEGRATION_STATUS_CLOSED' : 'INTEGRATION_STATUS_BUSY' })); return; }
+      this.queue.push({ managerOptions, statusOptions, resolve, reject }); this.drain();
+    });
+  }
+  drain() {
+    while (!this.closed && this.running < 2 && this.queue.length) {
+      const next = this.queue.shift(); this.running++;
+      this.probe(next.managerOptions, next.statusOptions).then(next.resolve, next.reject).finally(() => { this.running--; this.drain(); });
+    }
+  }
+  probe(managerOptions, statusOptions) {
+    return new Promise((resolve, reject) => {
+      const child = fork(this.workerFile, [], { stdio: ['ignore', 'ignore', 'ignore', 'ipc'], windowsHide: true, env: { ...process.env, KB_INTEGRATION_STATUS_WORKER: '1' } });
+      this.children.add(child);
+      let settled = false;
+      const finish = (error, summary) => { if (settled) return; settled = true; clearTimeout(timer); error ? reject(error) : resolve(summary); };
+      const timer = setTimeout(() => {
+        Promise.resolve(managerOptions.logger?.warn?.('integration.status.timeout', '客户端接入状态检查超时；未将其判为未安装。', {
+          operationId: managerOptions.operationId, component: 'integration', phase: 'status',
+          context: { clients: statusOptions.clients || SUPPORTED_CLIENTS, timeoutMs: this.timeoutMs },
+        })).catch(() => {});
+        this.terminate(child); finish(Object.assign(new Error('状态检查超时。'), { code: 'INTEGRATION_STATUS_TIMEOUT' }));
+      }, this.timeoutMs);
+      child.on('message', message => {
+        if (message?.kind === 'log') {
+          if (['info', 'warn', 'error'].includes(message.level) && Array.isArray(message.args) && /^integration\./.test(message.args[0] || '')) Promise.resolve(managerOptions.logger?.[message.level]?.(...message.args)).catch(() => {});
+          return;
+        }
+        finish(message?.ok ? null : Object.assign(new Error('状态检查失败。'), { code: message?.code }), message?.summary);
+      });
+      child.once('error', error => finish(error));
+      child.once('exit', () => { this.children.delete(child); if (!settled) finish(Object.assign(new Error('状态检查进程提前退出。'), { code: 'INTEGRATION_STATUS_EXITED' })); });
+      const allowed = ['rootDir', 'homeDir', 'version', 'packageSpec', 'operationId', 'bridgeHomeDir', 'bridgeConsumerName', 'claudeSettingsFile', 'codexConfigFile', 'zcodeConfigFile', 'openCodePluginsDir'];
+      child.send({ managerOptions: Object.fromEntries(allowed.filter(k => managerOptions[k] !== undefined).map(k => [k, managerOptions[k]])), statusOptions });
+    });
+  }
+  terminate(child) {
+    if (child.exitCode !== null || child.signalCode !== null) return;
+    if (process.platform === 'win32') {
+      // Only the live worker we created, including its probe children. Never
+      // terminate by executable name or scan unrelated Node processes.
+      const killer = spawn('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+      killer.on('error', () => child.kill());
+    } else child.kill('SIGTERM');
+  }
+  invalidate() { for (const entry of this.entries.values()) entry.at = 0; }
+  close() {
+    this.closed = true;
+    for (const child of this.children) this.terminate(child);
+    for (const item of this.queue) item.reject(Object.assign(new Error('扫描已关闭。'), { code: 'INTEGRATION_STATUS_CLOSED' }));
+    this.queue = []; this.entries.clear();
+  }
+}
+module.exports = { IntegrationStatusScan };

package/_site/lib/integration-status-worker.js

@@ -1,14 +1,14 @@
-'use strict';
-const { IntegrationManager } = require('./integration-installer');
-process.once('message', async input => {
-  try {
-    const logger = Object.fromEntries(['info', 'warn', 'error'].map(level => [level, (...args) => {
-      if (process.connected) process.send({ kind: 'log', level, args: args.map(value => value instanceof Error ? { name: value.name, code: value.code, message: 'Integration command failed.' } : value) });
-    }]));
-    const manager = new IntegrationManager({ ...input.managerOptions, logger });
-    const summary = await manager.statusAll(input.statusOptions);
-    process.send({ ok: true, summary }, () => process.disconnect());
-  } catch (error) {
-    process.send({ ok: false, code: error.code || 'INTEGRATION_STATUS_FAILED' }, () => process.disconnect());
-  }
-});
+'use strict';
+const { IntegrationManager } = require('./integration-installer');
+process.once('message', async input => {
+  try {
+    const logger = Object.fromEntries(['info', 'warn', 'error'].map(level => [level, (...args) => {
+      if (process.connected) process.send({ kind: 'log', level, args: args.map(value => value instanceof Error ? { name: value.name, code: value.code, message: 'Integration command failed.' } : value) });
+    }]));
+    const manager = new IntegrationManager({ ...input.managerOptions, logger });
+    const summary = await manager.statusAll(input.statusOptions);
+    process.send({ ok: true, summary }, () => process.disconnect());
+  } catch (error) {
+    process.send({ ok: false, code: error.code || 'INTEGRATION_STATUS_FAILED' }, () => process.disconnect());
+  }
+});

package/_site/lib/kb-framework.js

@@ -42,21 +42,21 @@ function ensureFile(file, content, created, base) {
   if (created) created.push(path.relative(base, file).replace(/\\/g, '/'));
 }
 
-function initProjectDirs(slug, kbPath) {
-  const base = path.resolve(kbPath);
-  // Import only declares the external project directory. Real Markdown and
-  // collection directories are created lazily by validated promotion; an
-  // empty/TODO skeleton would turn guesses into durable project knowledge.
-  fs.mkdirSync(base, { recursive: true });
-  return {
-    created: [],
-    basePath: base,
-    kbSchemaVersion: PROJECT_SCHEMA_VERSION,
-    frameworkSchema: KB_FRAMEWORK_SCHEMA,
-    topLevel: TOP_LEVEL.slice(),
-    lazy: true,
-  };
-}
+function initProjectDirs(slug, kbPath) {
+  const base = path.resolve(kbPath);
+  // Import only declares the external project directory. Real Markdown and
+  // collection directories are created lazily by validated promotion; an
+  // empty/TODO skeleton would turn guesses into durable project knowledge.
+  fs.mkdirSync(base, { recursive: true });
+  return {
+    created: [],
+    basePath: base,
+    kbSchemaVersion: PROJECT_SCHEMA_VERSION,
+    frameworkSchema: KB_FRAMEWORK_SCHEMA,
+    topLevel: TOP_LEVEL.slice(),
+    lazy: true,
+  };
+}
 
 function readIfExists(file) {
   return fs.existsSync(file) ? fs.readFileSync(file, 'utf-8') : '';