@sanqianx/project-knowledge 5.0.8 → 5.0.9-rc.2

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "project-knowledge",
-      "version": "5.0.8",
+      "version": "5.0.9-rc.2",
       "source": "./plugins/project-knowledge",
       "description": "Search durable project decisions and implementation history through MCP."
     }

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [5.0.9-rc.2] - 2026-10-11
+
+- Pin the verified Workbench 0.13.2-rc.1 and vector-hub 1.0.8-rc.1 candidates.
+  Normalize known official MiniMax embedding route aliases at runtime without
+  changing existing v5 configuration bytes or private gateway paths.
+- Queue same-project index writes across embedding-model rebuilds. Failed writes
+  do not poison retries, and unrelated projects remain independent.
+- Restore safe relative Markdown document navigation and verify the standalone
+  retrieval UI at 1920x1080. Tests never kill unrelated port owners.
+- Isolate regression-suite ports and tolerate Windows fixture file release.
+  Candidate publication is not full product acceptance; latest remains unchanged.
+
+## [5.0.9-rc.1] - 2026-10-11
+
+- Retain classified, bounded and redacted index errors in run details, activity
+  and local log/v2 exports. Index-only retries preserve promoted files and do not
+  invoke the analysis model again.
+- Accept ZCode conversation evidence, isolate per-project journal failures and
+  report the exact blocked sequence without dropping evidence or flooding logs.
+- Synchronize production asset hashes, including the shared favicon. Permit
+  exact rc module pins but reject tags, ranges, links and source overrides.
+- Prepare a web-only candidate; latest is not promoted by this release. Existing
+  v5 data and third-party integrations are preserved; system acceptance remains
+  a separate gate from publication.
+
 ## [5.0.8] - 2026-10-10
 
 - Repair managed Codex notify chains after scoped npm package or Bridge-home

package/_modules/knowledge-engine/README.md

@@ -67,6 +67,7 @@ node src/bin.js serve [--port 5790] [--host 127.0.0.1] [--data DIR]
 ## 真实运行与恢复边界
 
 - journal 游标按来源隔离；证据投影及可恢复任务先落盘，再 ACK。不等待模型才能消费下一条事件。
+- 会话来源接受 bridge 的四客户端契约（Claude Code、Codex、OpenCode、ZCode）。单个 journal 的非法证据不被跳过或 ACK，但不阻塞其他项目；失败位置和错误码写入日志，健康接口提供 `journal.failures`，重复轮询不刷屏，恢复后续接原游标。
 - 不同项目最多并发 2 个分析，同项目按提交顺序执行。未晋升的失败提交会阻挡本项目后续提交，不阻挡其他项目。
 - 无头分析在隔离进程中运行，只读冻结证据，只写本次 staging。产物必须通过路径、内容 hash 和依据校验，只有晋升路径写最终项目知识。
 - 归档对话和检索内容只作证据，不能覆盖后台维护指令。SDK 返回成功文字但未生成 manifest 时，记录 `ANALYSIS_OUTPUT_MISSING` 并保留证据供重试，不误报晋升完成。
@@ -74,6 +75,7 @@ node src/bin.js serve [--port 5790] [--host 127.0.0.1] [--data DIR]
 - 具体失败原因、失败步骤和提交依据进入运行详情及 `log/v2` 诊断。受外壳守护时通过 IPC 交给外壳现有日志系统；独立运行保存在 `<data>/logs/`，不写模型凭据和原始证据。升级不会重新运行已失败提交，用户可显式重试失败阶段。
 - 数据目录有单实例租约，目标知识目录有写入锁。关闭或超时等待子进程实际退出，再释放写入锁。
 - 晋升与索引分别记录。索引失败保留已晋升知识并显示待修复，不重新调用模型。
+- 索引错误保留兼容的 `INDEX_FAILED` 及可选 `error.details`（类别、HTTP 状态、上游代码/脱敏原因、请求标识、耗时和尝试次数）；项目和共享索引均写入 `log/v2`。响应仅解析有界 JSON，不记录原始 body 或认证头。只重试索引保留原分析运行、晋升时间和知识字节。
 - 项目、领域、智脑检索使用包含范围。向量只提供排序，显示内容必须来自当前真实文件；索引不可用时降级为文件检索。
 - 候选必须有已晋升文件中的引用依据，未确认候选不能进入任务。确认记录原子持久化后写共享记忆文件，派生索引异步更新，索引失败不会撤销有效记忆。
 - 旧格式不读取、不自动迁移。损坏的正式状态不覆盖、不清空。

package/_modules/knowledge-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/ai-coding-knowledge-engine",
-  "version": "0.2.2",
+  "version": "0.2.3-rc.1",
   "description": "Knowledge engine module for project-knowledge: commit-boundary triggered knowledge analysis/generation (trigger plane) and retrieval for development assistants (retrieval plane).",
   "license": "Apache-2.0",
   "main": "src/server.js",

package/_modules/knowledge-engine/src/coordinator.js

@@ -15,6 +15,7 @@ const { MemoryService } = require('./memories');
 const { execGit } = require('./runtime/git-runner');
 const { createDiagnostics } = require('./diagnostics');
 const { finalizeAnalysisOutput } = require('./analysis-output');
+const { requestIndex } = require('./index-request');
 
 class EngineCoordinator extends EventEmitter {
   constructor(store, options = {}) {
@@ -28,6 +29,7 @@ class EngineCoordinator extends EventEmitter {
     this.concurrency = Math.max(1, Math.min(2, Number(options.concurrency) || 2));
     this.active = new Map();
     this.jobs = new Set();
+    this.journalFailures = new Map();
     this.initializeHook = options.initializeHook;
     this.profiles = new Map();
     const diagnostics = createDiagnostics({ dataDir: store.dataDir, secrets: () => [...this.profiles.values()].flatMap(profile => [profile.apiKey, profile.authToken]) });
@@ -123,34 +125,58 @@ class EngineCoordinator extends EventEmitter {
     this.draining = true;
     try {
       await this.bridge.registerConsumer('knowledge-engine', { journals: ['*'] });
-      for (const journal of await this.bridge.listJournals()) {
+      const journals = await this.bridge.listJournals();
+      this.journalFailures.delete('connection');
+      for (const journal of journals) {
         if (this.closed) break;
-        const cursor = this.store.state.journalCursors[journal.journalId] || 0;
-        const events = await this.bridge.readEvents({ journalId: journal.journalId, fromSequence: cursor + 1, limit: 100 });
-        let through = cursor;
-        for (const event of events) {
-          if (this.closed) break;
-          const p = this.store.listProjects().find(p => p.enabled !== false && ((journal.journalId !== 'global' && p.journalId === journal.journalId)
-            || ((journal.journalId === 'global' || !p.journalId) && event.repoIdentity?.workspaceRoot && this.layout.pathsEqual(p.repoPath, event.repoIdentity.workspaceRoot))));
-          if (p) {
-            if (event.schema === 'ai-coding-event/v1' && ['user_prompt', 'assistant_response'].includes(event.eventType)) await this.conversations.appendBridgeEvent(p.projectId, { ...event, journalId: journal.journalId });
-            if (event.schema === 'git-commit-boundary/v1' && /^[a-f0-9]{7,64}$/i.test(event.commitSha || '')) {
-              if (!fs.existsSync(this.layout.getProjectCommitBoundaryPath(p.projectId, event.commitSha))) this.conversations.writeBoundary(p.projectId, { ...event, journalId: journal.journalId, parentShas: event.parents || [], bridgeCursorAtCommit: event.sequence, journalSequence: event.sequence, operationId: event.operationId || `bridge-${journal.journalId}-${event.sequence}`, committedAt: event.committedAt || event.capturedAt });
-              const baseline = p.runtime.lastAnalyzedCommit || p.trackingStartCommit;
-              const completed = this.reconciler.processingLedger.read(p.projectId, event.commitSha);
-              const historical = baseline && (baseline === event.commitSha || (await execGit(p.repoPath, ['merge-base', '--is-ancestor', event.commitSha, baseline])).ok);
-              if (!completed && !historical && this.store.getProject(p.projectId)?.enabled) this.enqueue({ projectId: p.projectId, commitSha: event.commitSha, trigger: 'git-hook', journalId: journal.journalId, journalSequence: event.sequence });
-            }
-          }
-          through = event.sequence;
+        try {
+          await this.consumeJournal(journal);
+          if (this.journalFailures.delete(journal.journalId)) await this.diagnostics.info('knowledge.journal.recovered', '项目事件消费已恢复。', { phase: 'consuming', context: { journalId: journal.journalId } });
+        } catch (error) {
+          // Never ACK invalid evidence; a project fault must not starve other journals.
+          await this.recordJournalFailure(journal.journalId, error);
         }
-        // All evidence projections and queued jobs are durable before ACK.
-        if (through > cursor) this.store.setJournalCursor(journal.journalId, through);
-        await this.bridge.ackConsumerCursor('knowledge-engine', through, { journalId: journal.journalId });
       }
-      this.journalError = null;
-    } catch { this.journalError = '事件日志连接异常，已保留游标并等待恢复。'; }
-    finally { this.draining = false; }
+      for (const id of this.journalFailures.keys()) if (!journals.some(j => j.journalId === id)) this.journalFailures.delete(id);
+    } catch (error) { await this.recordJournalFailure('connection', error); }
+    finally {
+      this.journalError = this.journalFailures.size ? '事件消费异常，未消费证据与游标已保留，请查看诊断日志。' : null;
+      this.draining = false;
+    }
+  }
+  async recordJournalFailure(journalId, error) {
+    const context = error.journalContext || {};
+    const failure = { journalId, sequence: context.sequence ?? null, projectId: context.projectId || null, code: error.code || 'JOURNAL_FAILED', message: this.safeMessage(error.message) };
+    if (JSON.stringify(this.journalFailures.get(journalId)) !== JSON.stringify(failure)) {
+      this.journalFailures.set(journalId, failure);
+      await this.diagnostics.error('knowledge.journal.failed', '事件消费失败，已保留未确认的证据与游标。', { projectId: failure.projectId, phase: 'consuming', error, context: { ...failure, source: context.source || null } });
+    }
+  }
+  async consumeJournal(journal) {
+    const cursor = this.store.state.journalCursors[journal.journalId] || 0;
+    const events = await this.bridge.readEvents({ journalId: journal.journalId, fromSequence: cursor + 1, limit: 100 });
+    let through = cursor;
+    for (const event of events) {
+      if (this.closed) break;
+      const p = this.store.listProjects().find(p => p.enabled !== false && ((journal.journalId !== 'global' && p.journalId === journal.journalId)
+        || ((journal.journalId === 'global' || !p.journalId) && event.repoIdentity?.workspaceRoot && this.layout.pathsEqual(p.repoPath, event.repoIdentity.workspaceRoot))));
+      try {
+        if (p) {
+          if (event.schema === 'ai-coding-event/v1' && ['user_prompt', 'assistant_response'].includes(event.eventType)) await this.conversations.appendBridgeEvent(p.projectId, { ...event, journalId: journal.journalId });
+          if (event.schema === 'git-commit-boundary/v1' && /^[a-f0-9]{7,64}$/i.test(event.commitSha || '')) {
+            if (!fs.existsSync(this.layout.getProjectCommitBoundaryPath(p.projectId, event.commitSha))) this.conversations.writeBoundary(p.projectId, { ...event, journalId: journal.journalId, parentShas: event.parents || [], bridgeCursorAtCommit: event.sequence, journalSequence: event.sequence, operationId: event.operationId || `bridge-${journal.journalId}-${event.sequence}`, committedAt: event.committedAt || event.capturedAt });
+            const baseline = p.runtime.lastAnalyzedCommit || p.trackingStartCommit;
+            const completed = this.reconciler.processingLedger.read(p.projectId, event.commitSha);
+            const historical = baseline && (baseline === event.commitSha || (await execGit(p.repoPath, ['merge-base', '--is-ancestor', event.commitSha, baseline])).ok);
+            if (!completed && !historical && this.store.getProject(p.projectId)?.enabled) this.enqueue({ projectId: p.projectId, commitSha: event.commitSha, trigger: 'git-hook', journalId: journal.journalId, journalSequence: event.sequence });
+          }
+        }
+      } catch (error) { error.journalContext = { projectId: p?.projectId, sequence: event.sequence, source: event.source }; throw error; }
+      through = event.sequence;
+    }
+    // All evidence projections and queued jobs are durable before ACK.
+    if (through > cursor) this.store.setJournalCursor(journal.journalId, through);
+    await this.bridge.ackConsumerCursor('knowledge-engine', through, { journalId: journal.journalId });
   }
   pump() {
     if (this.closed || !this.executionEnabled) return;
@@ -198,16 +224,19 @@ class EngineCoordinator extends EventEmitter {
   }
   async index(run) {
     const project = this.store.getProject(run.projectId);
+    const attempt = (run.indexAttempts || 0) + 1;
+    const context = { projectId: run.projectId, runId: run.runId, operationId: run.runId, commitSha: run.commitSha, phase: 'indexing' };
     try {
-      this.store.updateRun(run.runId, { phase: 'indexing', indexState: 'running' });
-      const response = await fetch(new URL('/api/sync', this.vectorUrl), { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ project: project.vectorProjectId || project.projectId, sourceDir: project.knowledgePath }), signal: AbortSignal.timeout(120000) });
-      const payload = await response.json();
-      if (!response.ok || payload.ok !== true) throw new Error('INDEX_FAILED');
+      this.store.updateRun(run.runId, { phase: 'indexing', indexState: 'running', indexAttempts: attempt });
+      await requestIndex({ baseUrl: this.vectorUrl, route: '/api/sync', body: { project: project.vectorProjectId || project.projectId, sourceDir: project.knowledgePath }, attempt, sanitize: this.safeMessage });
       await this.store.updateRuntime(run.projectId, state => { state.index.dirty = false; state.index.status = 'ready'; });
       this.store.updateRun(run.runId, { state: 'succeeded', phase: 'ready', indexState: 'succeeded', error: null, finishedAt: new Date().toISOString() });
+      await this.diagnostics.info('knowledge.index.completed', '知识向量索引已更新。', { ...context, context: { attempt } });
       this.notify(run, '知识已更新并可检索');
-    } catch {
-      this.store.updateRun(run.runId, { state: 'index-pending', phase: 'index-pending', indexState: 'failed', finishedAt: new Date().toISOString(), error: { code: 'INDEX_FAILED', message: '知识已更新，索引待修复。', retryable: true } });
+    } catch (error) {
+      const details = error.details || { failureKind: 'LOCAL_ERROR', upstreamCode: error.code || 'UNKNOWN', upstreamMessage: this.safeMessage(error.message), attempt };
+      await this.diagnostics.error('knowledge.index.failed', '知识已更新，向量索引失败。', { ...context, error, context: details });
+      this.store.updateRun(run.runId, { state: 'index-pending', phase: 'index-pending', indexState: 'failed', finishedAt: new Date().toISOString(), error: { code: 'INDEX_FAILED', message: '知识已更新，索引待修复。', retryable: true, details } });
       this.notify(run, '知识已更新，索引待修复');
     }
   }
@@ -220,6 +249,7 @@ class EngineCoordinator extends EventEmitter {
     const job = this.sharedIndexQueue.catch(() => {}).then(async () => {
       if (this.closed || !this.store.state.sharedScopes.some(s => s.id === scope.id)) return;
       let index;
+      const attempt = (this.store.state.sharedScopes.find(s => s.id === scope.id)?.index?.attempts || 0) + 1;
       try {
         const files = require('./runtime/markdown-knowledge-indexer').listMarkdownFiles(scope.knowledgePath);
         const digest = crypto.createHash('sha256');
@@ -235,11 +265,13 @@ class EngineCoordinator extends EventEmitter {
           const payload = await health.json();
           if (health.ok && payload.projects?.some(p => p.name === `scope-${scope.kind}-${scope.id}` && p.hasIndex && this.layout.pathsEqual(p.sourceDir || '', scope.knowledgePath))) return;
         }
-        const response = await fetch(new URL('/api/import', this.vectorUrl), { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ projectName: `scope-${scope.kind}-${scope.id}`, sourceDir: scope.knowledgePath, watch: false }), signal: AbortSignal.timeout(120000) });
-        const payload = await response.json();
-        if (!response.ok || payload.ok !== true) throw new Error('INDEX_FAILED');
-        index = { status: 'ready', fingerprint, updatedAt: new Date().toISOString() };
-      } catch { index = { status: 'pending', message: '共享知识已保存，索引待恢复。' }; }
+        await requestIndex({ baseUrl: this.vectorUrl, route: '/api/import', body: { projectName: `scope-${scope.kind}-${scope.id}`, sourceDir: scope.knowledgePath, watch: false }, attempt, sanitize: this.safeMessage });
+        index = { status: 'ready', fingerprint, attempts: attempt, updatedAt: new Date().toISOString() };
+      } catch (error) {
+        const details = error.details || { failureKind: 'LOCAL_ERROR', upstreamCode: error.code || 'UNKNOWN', upstreamMessage: this.safeMessage(error.message), attempt };
+        index = { status: 'pending', message: '共享知识已保存，索引待恢复。', attempts: attempt, error: { code: 'INDEX_FAILED', details } };
+        await this.diagnostics.error('knowledge.shared_index.failed', index.message, { phase: 'indexing', operationId: `scope-index-${scope.id}-${attempt}`, error, context: { scopeId: scope.id, ...details } });
+      }
       // Configuration can replace projection objects while the import awaits.
       const current = this.store.state.sharedScopes.find(s => s.id === scope.id);
       if (!current) return;

package/_modules/knowledge-engine/src/diagnostics.js

@@ -10,7 +10,7 @@ function createDiagnostics({ dataDir, component = 'knowledge-engine', secrets =
     let text = String(value || '');
     let values = []; try { values = secrets() || []; } catch {}
     for (const secret of values) if (typeof secret === 'string' && secret.length >= 4) text = text.split(secret).join('[REDACTED]');
-    return text.replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/gi, '$1[REDACTED]@').replace(/\b(Bearer|Basic)\s+[^\s]+/gi, '$1 [REDACTED]').replace(/((?:api[_-]?key|token|password|secret)\s*[=:]\s*)[^\s,;]+/gi, '$1[REDACTED]').slice(0, 8000);
+    return text.replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/gi, '$1[REDACTED]@').replace(/\b(Bearer|Basic)\s+[^\s]+/gi, '$1 [REDACTED]').replace(/(["']?(?:api[_-]?key|auth[_-]?token|token|password|secret)["']?\s*[=:]\s*)(?:"[^"]*"|'[^']*'|[^\s,;&]+)/gi, '$1[REDACTED]').replace(/\bsk[-_][A-Za-z0-9_-]{8,}/g, '[REDACTED]').slice(0, 8000);
   };
   const logger = { sanitize, close: async () => {} };
   for (const level of ['debug', 'info', 'warn', 'error']) logger[level] = async (event, message, input = {}) => {

package/_modules/knowledge-engine/src/index-request.js

@@ -0,0 +1,49 @@
+'use strict';
+
+async function requestIndex({ baseUrl, route, body, attempt = 1, timeoutMs = 120000, sanitize, fetchImpl = fetch }) {
+  const started = Date.now();
+  const clean = value => sanitize(String(value || '')).slice(0, 2048);
+  let httpStatus = null, requestId = null;
+  function failure(failureKind, upstreamCode, upstreamMessage) {
+    const details = { failureKind, httpStatus, upstreamCode: clean(upstreamCode).slice(0, 120), upstreamMessage: clean(upstreamMessage), requestId, durationMs: Math.max(0, Date.now() - started), attempt };
+    return Object.assign(new Error(`向量索引请求失败：${details.upstreamMessage}`), { code: 'INDEX_FAILED', phase: 'indexing', retryable: true, details });
+  }
+  try {
+    const response = await fetchImpl(new URL(route, baseUrl), { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body), signal: AbortSignal.timeout(timeoutMs) });
+    httpStatus = response.status;
+    requestId = clean(response.headers.get('x-request-id') || response.headers.get('request-id')).slice(0, 120) || null;
+    // Error responses can contain credentials or arbitrarily large HTML. Read
+    // a bounded JSON envelope, never persist a raw body or response headers.
+    const reader = response.body?.getReader();
+    let text = '', size = 0;
+    if (reader) {
+      const decoder = new TextDecoder();
+      try {
+        for (;;) {
+          const chunk = await reader.read();
+          if (chunk.done) break;
+          size += chunk.value.byteLength;
+          if (size > 16384) throw failure('INVALID_RESPONSE', 'RESPONSE_TOO_LARGE', '索引服务响应超过安全大小限制。');
+          text += decoder.decode(chunk.value, { stream: true });
+        }
+        text += decoder.decode();
+      } finally { await reader.cancel().catch(() => {}); }
+    }
+    let payload;
+    try { payload = JSON.parse(text); }
+    catch { throw failure('INVALID_RESPONSE', 'INVALID_JSON', `索引服务返回非 JSON 响应（HTTP ${httpStatus}）。`); }
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) throw failure('INVALID_RESPONSE', 'INVALID_ENVELOPE', '索引服务响应不符合协议。');
+    if (!response.ok || payload.ok === false || payload.error) {
+      const upstream = payload.error;
+      const message = typeof upstream === 'string' ? upstream : upstream?.message || payload.message || `索引服务返回 HTTP ${httpStatus}。`;
+      throw failure(response.ok ? 'UPSTREAM_ERROR' : 'HTTP_ERROR', upstream?.code || payload.code || `HTTP_${httpStatus}`, message);
+    }
+    if (payload.ok !== true) throw failure('INVALID_RESPONSE', 'INVALID_ENVELOPE', '索引服务响应缺少成功标识。');
+    return payload;
+  } catch (error) {
+    if (error.details && error.code === 'INDEX_FAILED') throw error;
+    const timeout = ['TimeoutError', 'AbortError'].includes(error.name);
+    throw failure(timeout ? 'TIMEOUT' : 'NETWORK_ERROR', error.cause?.code || error.code || (timeout ? 'INDEX_TIMEOUT' : 'INDEX_CONNECTION_FAILED'), error.message || (timeout ? '索引服务请求超时。' : '无法连接索引服务。'));
+  }
+}
+module.exports = { requestIndex };

package/_modules/knowledge-engine/src/runtime/conversation-store.js

@@ -3,7 +3,7 @@ const crypto = require('crypto');
 const { SCHEMAS, DomainError, validateProjectId } = require('./contracts');
 const AtomicFile = require('./atomic-file');
 
-const SOURCES = new Set(['claude-code', 'codex', 'opencode']);
+const SOURCES = new Set(['claude-code', 'codex', 'opencode', 'zcode']);
 const ROLES = new Set(['user', 'assistant', null]);
 const SNAPSHOT_STATUSES = new Set(['available', 'no-new-user-prompt', 'unavailable', 'ambiguous']);
 const BINDING_KINDS = new Set(['direct', 'shared-spanning', 'explicit']);

package/_modules/knowledge-engine/src/server.js

@@ -100,7 +100,7 @@ function createEngineServer(options = {}) {
 }
 
 async function api(method, pathname, search, body, store, coordinator, ctx) {
-  if (method === 'GET' && pathname === '/api/health') return { name: 'knowledge-engine', version: VERSION, dataSchemaVersion: store.state.schemaVersion, debug: ctx.debug, executionEnabled: coordinator.executionEnabled, uptimeSec: Math.floor((Date.now() - ctx.startedAt) / 1000), dataDir: ctx.dataDir, counts: { projects: store.state.projects.length, runs: store.state.runs.length, running: coordinator.active.size }, journal: { cursor: store.state.cursor, cursors: store.state.journalCursors, consumer: 'knowledge-engine', enabled: coordinator.consume, error: coordinator.journalError || null }, concurrency: coordinator.concurrency };
+  if (method === 'GET' && pathname === '/api/health') return { name: 'knowledge-engine', version: VERSION, dataSchemaVersion: store.state.schemaVersion, debug: ctx.debug, executionEnabled: coordinator.executionEnabled, uptimeSec: Math.floor((Date.now() - ctx.startedAt) / 1000), dataDir: ctx.dataDir, counts: { projects: store.state.projects.length, runs: store.state.runs.length, running: coordinator.active.size }, journal: { cursor: store.state.cursor, cursors: store.state.journalCursors, consumer: 'knowledge-engine', enabled: coordinator.consume, error: coordinator.journalError || null, failures: [...coordinator.journalFailures.values()] }, concurrency: coordinator.concurrency };
   if (method === 'GET' && pathname === '/api/projects') return { projects: store.listProjects() };
   if (method === 'GET' && pathname === '/api/memories') return { memories: coordinator.memories.list(Object.fromEntries(search)) };
   const memoryMatch = pathname.match(/^\/api\/memories\/([^/]+)$/);

package/_modules/knowledge-engine/ui/app.js

@@ -197,7 +197,7 @@ async function showRunDetail(runId) {
   $('#runDetail').classList.remove('hidden');
   $('#runDetailId').textContent = run.runId;
   $('#runTimeline').innerHTML = runTimeline(run);
-  $('#runMeta').innerHTML = `<div><dt>状态</dt><dd>${stateBadge(run.state)}</dd></div><div><dt>项目 / commit</dt><dd>${escapeHtml(run.projectId)} · <span class="mono">${shortSha(run.commitSha)}</span></dd></div><div><dt>触发入口</dt><dd class="mono">${escapeHtml(run.trigger)}</dd></div><div><dt>错误</dt><dd>${run.error ? escapeHtml(run.error.message) : '–'}</dd></div>${run.error?.retryable ? '<div><dt>恢复</dt><dd><button class="btn" id="retryRun">重试失败阶段</button></dd></div>' : ''}`;
+  $('#runMeta').innerHTML = `<div><dt>状态</dt><dd>${stateBadge(run.state)}</dd></div><div><dt>项目 / commit</dt><dd>${escapeHtml(run.projectId)} · <span class="mono">${shortSha(run.commitSha)}</span></dd></div><div><dt>触发入口</dt><dd class="mono">${escapeHtml(run.trigger)}</dd></div><div><dt>错误</dt><dd>${run.error ? escapeHtml(run.error.message) : '–'}</dd></div>${run.error?.details ? `<div><dt>索引原因</dt><dd>${escapeHtml(run.error.details.upstreamMessage)}<br>${escapeHtml(run.error.details.failureKind)} · HTTP ${escapeHtml(run.error.details.httpStatus ?? '–')} · ${escapeHtml(run.error.details.upstreamCode)}<br>请求 ${escapeHtml(run.error.details.requestId || '–')} · 尝试 ${escapeHtml(run.error.details.attempt)}</dd></div>` : ''}${run.error?.retryable ? '<div><dt>恢复</dt><dd><button class="btn" id="retryRun">重试失败阶段</button></dd></div>' : ''}`;
   $('#retryRun')?.addEventListener('click', async () => { await api(`/api/runs/${encodeURIComponent(runId)}/retry`, { method: 'POST' }); loadRuns(); });
   $('#runStaging').textContent = run.staging ? JSON.stringify(run.staging, null, 2) : '该运行没有 staging 产物。';
 }

package/_site/_test/candidate-release-contract-test.js

@@ -0,0 +1,14 @@
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const { isPinnedModuleVersion } = require('../scripts/verify-module-runtime');
+for (const name of ['claude-ai-workbench', '@sanqianx/vector-hub', '@sanqianx/ai-coding-event-bridge-console']) {
+  for (const version of ['1.2.3', '1.2.3-rc.1', '1.2.3-rc.12']) assert.ok(isPinnedModuleVersion(name, version));
+  for (const version of ['latest', 'next', '^1.2.3', '~1.2.3', '>=1.2.3', 'file:../module', 'link:module', 'workspace:*', '1.2.3-beta.1', '1.2.3-rc', undefined]) assert.equal(isPinnedModuleVersion(name, version), false, String(version));
+}
+assert.ok(isPinnedModuleVersion('claude-ai-workbench', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'));
+assert.equal(isPinnedModuleVersion('@sanqianx/vector-hub', 'npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1'), false);
+const manifest = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../../module-runtime-manifest.json')));
+for (const file of ['ui/index.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg']) assert.match(manifest.productFiles[file], /^[a-f0-9]{64}$/);
+console.log('candidate-release-contract-test PASS');

package/_site/_test/conversation-store-test.js

@@ -45,6 +45,8 @@ const { ConversationStore, sha256 } = require('../lib/conversation-store');
   assert.strictEqual(store.readEvents(projectId).length, 1);
   assert.strictEqual(store.readEvents(projectId)[0].content, privatePrompt, 'full prompt belongs in the private business store');
   assert.strictEqual(store.readEvents(projectId)[0].contentHash, sha256(privatePrompt));
+  await store.appendBridgeEvent(projectId, { ...store.readEvents(projectId)[0], eventId: 'event-zcode-1', sequence: 12, source: 'zcode' });
+  assert.strictEqual(store.readEvents(projectId).find(event => event.eventId === 'event-zcode-1').source, 'zcode');
   assert(!JSON.stringify(logRecords).includes(privatePrompt), 'conversation body must never enter structured logs');
   assert(JSON.stringify(logRecords).includes(sha256(privatePrompt)), 'logs may retain body hash for correlation');
 

package/_site/_test/fixtures/make-git-repos.js

@@ -49,15 +49,7 @@ function makeRepo({ kind = 'one-commit' } = {}) {
   const commits = [];
   const cleanup = () => {
     if (path.dirname(repoPath) !== path.resolve(os.tmpdir()) || !path.basename(repoPath).startsWith(`kb-fixture-${kind}-${process.pid}-`)) throw new Error('Unsafe fixture cleanup');
-    function remove(directory) {
-      for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-        const file = path.join(directory, entry.name);
-        if (entry.isDirectory() && !entry.isSymbolicLink()) remove(file);
-        else { try { fs.unlinkSync(file); } catch (error) { if (error.code !== 'EPERM') throw error; fs.chmodSync(file, 0o600); fs.unlinkSync(file); } }
-      }
-      fs.rmdirSync(directory);
-    }
-    if (fs.existsSync(repoPath)) remove(repoPath);
+    if (fs.existsSync(repoPath)) fs.rmSync(repoPath, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
   };
 
   if (kind === 'not-git') {

package/_site/_test/index-error-display-contract-test.js

@@ -0,0 +1,10 @@
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const source = fs.readFileSync(path.resolve(__dirname, '../../ui/product.js'), 'utf8');
+for (const field of ['upstreamMessage', 'failureKind', 'upstreamCode', 'requestId', 'attempt', 'httpStatus', 'durationMs']) {
+  assert.ok(source.includes(`esc(r.error.details.${field}`), `index detail must be escaped: ${field}`);
+}
+assert.ok(source.includes("['failed', 'index-pending'].includes(r.state)"));
+console.log('index-error-display-contract-test PASS (real rendering/export covered by engine test:web:faults)');

package/_site/_test/product-brand-contract-test.js

@@ -0,0 +1,25 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const ui = path.resolve(__dirname, '../../ui');
+const html = fs.readFileSync(path.join(ui, 'index.html'), 'utf8');
+const css = fs.readFileSync(path.join(ui, 'product.css'), 'utf8');
+const mark = fs.readFileSync(path.join(ui, 'favicon.svg'), 'utf8');
+const favicon = html.match(/<link\b(?=[^>]*\brel="icon")[^>]*\bhref="([^"]+)"/);
+const sidebar = html.match(/<img\b(?=[^>]*\bclass="brand-mark")[^>]*\bsrc="([^"]+)"/);
+
+assert(favicon, 'Product needs an SVG favicon.');
+assert(sidebar, 'Sidebar must use the product mark, not a second drawn icon.');
+assert.equal(sidebar[1], favicon[1], 'Favicon and sidebar must share the exact asset URL.');
+assert.equal(favicon[1].split('?')[0], '/favicon.svg');
+assert.match(favicon[1], /\?v=/, 'Brand changes need a new browser cache identity.');
+assert.match(mark, /viewBox="0 0 64 64"/);
+assert.match(mark, /fill="#516f89"/);
+assert.equal((mark.match(/<path\b/g) || []).length, 1, 'Keep one geometric silhouette.');
+assert.doesNotMatch(mark, /<(?:script|image|text|filter|linearGradient|radialGradient)\b/i);
+assert.doesNotMatch(html, /<span class="brand-mark">知<\/span>/);
+assert.match(css, /\.brand-mark\{[^}]*width:32px;[^}]*height:32px;[^}]*flex:none/);
+console.log('PASS product brand: shared SVG, cache identity, fixed-size layout, no decorative dependencies');

package/_site/_test/release-version-sync-test.js

@@ -90,8 +90,14 @@ try {
   ]);
   const scripts = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).scripts;
   assert.strictEqual(scripts.preversion, 'npm run release:verify');
-  assert.strictEqual(scripts.version, 'node _site/scripts/sync-release-version.js --stage');
+  assert.strictEqual(scripts.version, 'node _site/scripts/sync-release-version.js --stage --web-only');
   assert.strictEqual(scripts.postversion, 'npm run release:verify');
+  const desktopBytes = FILES.filter(file => file.startsWith('desktop/')).map(file => fs.readFileSync(path.join(TEMP, file)));
+  value.version = '9.8.8-rc.1'; fs.writeFileSync(rootPackage, JSON.stringify(value, null, 2) + '\n');
+  assert.strictEqual(run(['--web-only']).status, 0);
+  assert.strictEqual(run(['--check', '--web-only']).status, 0);
+  assert.notStrictEqual(run(['--check']).status, 0, 'desktop still needs explicit synchronization for desktop releases');
+  FILES.filter(file => file.startsWith('desktop/')).forEach((file, i) => assert.deepStrictEqual(fs.readFileSync(path.join(TEMP, file)), desktopBytes[i]));
   console.log('release-version-sync-test PASS');
 } finally {
   fs.rmSync(TEMP, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });

package/_site/_test/sessions-stream-test.js

@@ -5,10 +5,10 @@ const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
 const { spawnServer } = require('./helpers/spawn-server');
+const freePort = require('./helpers/free-port');
 
 const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = 7804;
-const BASE = `http://127.0.0.1:${PORT}`;
+let PORT, BASE;
 const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-sse-v2-'));
 const repoPath = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-sse-repo-'));
 
@@ -60,6 +60,7 @@ async function waitFor(predicate) {
 }
 
 (async () => {
+  PORT = await freePort(); BASE = `http://127.0.0.1:${PORT}`;
   git(['init', '--initial-branch=main']);
   git(['config', 'user.email', 'sse@example.test']);
   git(['config', 'user.name', 'SSE Test']);

package/_site/_test/simple-import-test.js

@@ -4,10 +4,10 @@ const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
 const { spawnServer } = require('./helpers/spawn-server');
+const freePort = require('./helpers/free-port');
 
 const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = 7824;
-const BASE = `http://127.0.0.1:${PORT}`;
+let PORT, BASE;
 const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-import-v2-'));
 const repoPath = fs.mkdtempSync(path.join(os.tmpdir(), 'pkb-import-repo-'));
 const knowledgeRoot = path.join(dataDir, 'knowledge');
@@ -36,6 +36,7 @@ async function waitForServer() {
 }
 
 (async () => {
+  PORT = await freePort(); BASE = `http://127.0.0.1:${PORT}`;
   git(['init', '--initial-branch=main']);
   git(['config', 'user.email', 'import@example.test']);
   git(['config', 'user.name', 'Import Test']);

package/_site/_test/team-knowledge-store-test.js

@@ -4,11 +4,11 @@ const os = require('os');
 const path = require('path');
 const { execFileSync } = require('child_process');
 const { spawnServer } = require('./helpers/spawn-server');
+const freePort = require('./helpers/free-port');
 const githubTeamStore = require('../lib/github-team-store');
 
 const ROOT = path.resolve(__dirname, '..', '..');
-const PORT = Number(process.env.KB_TEAM_KNOWLEDGE_PORT || 7837);
-const BASE_URL = `http://127.0.0.1:${PORT}`;
+let PORT, BASE_URL;
 const TEMP = fs.mkdtempSync(path.join(os.tmpdir(), `kb-team-v2-${process.pid}-`));
 const DATA_DIR = path.join(TEMP, 'data');
 const SOURCE_ONE = path.join(TEMP, 'source-one');
@@ -51,6 +51,7 @@ async function json(method, route, body) {
 }
 
 (async () => {
+  PORT = process.env.KB_TEAM_KNOWLEDGE_PORT ? Number(process.env.KB_TEAM_KNOWLEDGE_PORT) : await freePort(); BASE_URL = `http://127.0.0.1:${PORT}`;
   let spawned;
   try {
     initializeRepo(SOURCE_ONE, 'Source one');

package/_site/lib/conversation-store.js

@@ -4,7 +4,7 @@ const { SCHEMAS, DomainError, validateProjectId } = require('./contracts');
 const AtomicFile = require('./atomic-file');
 const { StorageLayout } = require('./storage-layout');
 
-const SOURCES = new Set(['claude-code', 'codex', 'opencode']);
+const SOURCES = new Set(['claude-code', 'codex', 'opencode', 'zcode']);
 const ROLES = new Set(['user', 'assistant', null]);
 const SNAPSHOT_STATUSES = new Set(['available', 'no-new-user-prompt', 'unavailable', 'ambiguous']);
 const BINDING_KINDS = new Set(['direct', 'shared-spanning', 'explicit']);

package/_site/scripts/pack-module-candidates.js

@@ -53,7 +53,7 @@ function pack(sources) {
     process.stdout.write(`Packed ${key} ${pkg.version}: ${result.files.length} files\n`);
   }
   const manifestPath = path.join(output, 'module-candidates.json'); AtomicFile.writeJsonAtomic(manifestPath, manifest);
-  const productFiles = Object.fromEntries(['ui/index.html', 'ui/product.js', 'ui/product.css'].map(file => [file, hash(fs.readFileSync(path.join(root, file)))]));
+  const productFiles = Object.fromEntries(['ui/index.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg'].map(file => [file, hash(fs.readFileSync(path.join(root, file)))]));
   AtomicFile.writeJsonAtomic(path.join(root, 'module-runtime-manifest.json'), { schema: 'project-knowledge/module-content/v1', productFiles, modules: Object.fromEntries(Object.entries(manifest.modules).map(([key, module]) => [key, { name: module.name, installName: module.installName, version: module.version, files: module.files }])) });
   process.stdout.write(`MODULE_CANDIDATES ${manifestPath}\n`);
   return manifestPath;

package/_site/scripts/sync-release-version.js

@@ -20,7 +20,7 @@ function packageVersion(rootDir) {
   return version;
 }
 
-function releaseVersionTargets(rootDir, version) {
+function releaseVersionTargets(rootDir, version, { webOnly = false } = {}) {
   return [
     {
       file: 'package-lock.json',
@@ -67,13 +67,13 @@ function releaseVersionTargets(rootDir, version) {
         args[index] = `@sanqianx/project-knowledge@${version}`;
       },
     },
-  ].map(target => ({ ...target, path: path.join(rootDir, target.file) }));
+  ].filter(target => !webOnly || !target.file.startsWith('desktop/')).map(target => ({ ...target, path: path.join(rootDir, target.file) }));
 }
 
-function inspectReleaseVersion(rootDir) {
+function inspectReleaseVersion(rootDir, options) {
   const version = packageVersion(rootDir);
   const drift = [];
-  for (const target of releaseVersionTargets(rootDir, version)) {
+  for (const target of releaseVersionTargets(rootDir, version, options)) {
     const before = fs.readFileSync(target.path, 'utf8');
     const value = JSON.parse(before);
     target.update(value);
@@ -83,10 +83,10 @@ function inspectReleaseVersion(rootDir) {
   return { version, drift };
 }
 
-function syncReleaseVersion(rootDir) {
+function syncReleaseVersion(rootDir, options) {
   const version = packageVersion(rootDir);
   const changed = [];
-  for (const target of releaseVersionTargets(rootDir, version)) {
+  for (const target of releaseVersionTargets(rootDir, version, options)) {
     const before = fs.readFileSync(target.path, 'utf8');
     const value = JSON.parse(before);
     target.update(value);
@@ -114,21 +114,23 @@ function parseArgs(argv) {
   let check = false;
   let tag = null;
   let stage = false;
+  let webOnly = false;
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
     if (arg === '--check') check = true;
     else if (arg === '--stage') stage = true;
+    else if (arg === '--web-only') webOnly = true;
     else if (arg === '--root') rootDir = path.resolve(argv[++index] || '');
     else if (arg === '--tag') tag = String(argv[++index] || '').trim();
     else throw new Error(`Unknown argument: ${arg}`);
   }
-  return { rootDir, check, tag, stage };
+  return { rootDir, check, tag, stage, webOnly };
 }
 
 function main(argv = process.argv.slice(2)) {
-  const { rootDir, check, tag, stage } = parseArgs(argv);
+  const { rootDir, check, tag, stage, webOnly } = parseArgs(argv);
   if (check) {
-    const result = inspectReleaseVersion(rootDir);
+    const result = inspectReleaseVersion(rootDir, { webOnly });
     if (result.drift.length) {
       throw new Error(`Release version ${result.version} is out of sync: ${result.drift.join(', ')}`);
     }
@@ -138,7 +140,7 @@ function main(argv = process.argv.slice(2)) {
     console.log(`release version ${result.version} is synchronized`);
     return result;
   }
-  const result = syncReleaseVersion(rootDir);
+  const result = syncReleaseVersion(rootDir, { webOnly });
   if (stage) stageReleaseVersionFiles(rootDir, result.changed);
   console.log(result.changed.length
     ? `${stage ? 'synchronized and staged' : 'synchronized'} release version ${result.version}: ${result.changed.join(', ')}`

package/_site/scripts/verify-module-runtime.js

@@ -5,6 +5,10 @@ const crypto = require('crypto');
 const { spawnSync } = require('child_process');
 const root = path.resolve(__dirname, '../..');
 const workingTree = process.argv.includes('--working-tree');
+function isPinnedModuleVersion(name, value) {
+  const version = name === 'claude-ai-workbench' ? String(value || '').replace(/^npm:@sanqianx\/claude-ai-workbench@/, '') : value;
+  return /^\d+\.\d+\.\d+(?:-rc\.\d+)?$/.test(version || '');
+}
 function verify() {
   const manifest = JSON.parse(fs.readFileSync(path.join(root, 'vendor-manifest.json'), 'utf8'));
   if (manifest.schema !== 'project-knowledge/vendor-runtime/v1') throw new Error('Invalid runtime manifest');
@@ -12,7 +16,7 @@ function verify() {
   if (!engine || engine.root !== '_modules/knowledge-engine') throw new Error('Missing engine runtime');
   const packageInfo = JSON.parse(fs.readFileSync(path.join(root, 'package.json')));
   for (const dependency of ['claude-ai-workbench', '@sanqianx/vector-hub', '@sanqianx/ai-coding-event-bridge-console']) {
-    if (!/^\d+\.\d+\.\d+$/.test(packageInfo.dependencies[dependency] || '') && !/^npm:@sanqianx\/claude-ai-workbench@\d+\.\d+\.\d+$/.test(packageInfo.dependencies[dependency] || '')) throw new Error(`Module dependency must be pinned: ${dependency}`);
+    if (!isPinnedModuleVersion(dependency, packageInfo.dependencies[dependency])) throw new Error(`Module dependency must be pinned: ${dependency}`);
   }
   const required = ['package.json', 'src/bin.js', 'src/server.js', 'src/coordinator.js', 'src/analysis-worker.js', 'ui/index.html', 'ui/app.js', 'ui/app.css'];
   if (required.some(file => !engine.files[file])) throw new Error('Incomplete runtime manifest');
@@ -42,4 +46,5 @@ function verify() {
   if (enginePackage.version !== engine.version || Object.keys(enginePackage.dependencies || {}).length || Object.keys(enginePackage.devDependencies || {}).length) throw new Error('Engine version/dependency contract failed');
   process.stdout.write(workingTree ? 'Runtime content verified; uncommitted working tree is not release approval.\n' : 'Vendored runtime release gate passed.\n');
 }
-try { verify(); } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }
+if (require.main === module) { try { verify(); } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; } }
+module.exports = { isPinnedModuleVersion };

package/_site/scripts/verify-product-runtime.js

@@ -7,6 +7,7 @@ const { safeRelative } = require('./pack-module-candidates');
 function verifyProductRuntime(coreRoot, resolveFrom = path.join(coreRoot, 'package.json')) {
   const manifest = JSON.parse(fs.readFileSync(path.join(coreRoot, 'module-runtime-manifest.json')));
   if (manifest.schema !== 'project-knowledge/module-content/v1' || Object.keys(manifest.modules).length !== 3) throw new Error('Incomplete module content manifest');
+  for (const file of ['ui/index.html', 'ui/product.js', 'ui/product.css', 'ui/favicon.svg']) if (!manifest.productFiles?.[file]) throw new Error(`Product asset missing from content manifest: ${file}`);
   const resolve = createRequire(resolveFrom);
   for (const [relative, expected] of Object.entries(manifest.productFiles || {})) {
     if (!safeRelative(relative) || crypto.createHash('sha256').update(fs.readFileSync(path.join(coreRoot, relative))).digest('hex') !== expected) throw new Error(`Product UI content mismatch: ${relative}`);

package/module-runtime-manifest.json

@@ -1,18 +1,19 @@
 {
   "schema": "project-knowledge/module-content/v1",
   "productFiles": {
-    "ui/index.html": "e7291caab778eba3c5499d8286804ad1f4ef31c87a957f69c8fb77befc01321b",
-    "ui/product.js": "e35c1650df239cec0a9d73197fed7ac069bb09f0c51f4752e03115784a526518",
-    "ui/product.css": "73554abf3f951ea01a2bfe2df81748b702a6ca4488eea16bfe5afe04ef1dea70"
+    "ui/index.html": "db9cc5624132d336ee6b31ba37c93572b89e382f68e4b6331b4b886be8253bb5",
+    "ui/product.js": "50d26a9aa3a95889804f8ca771dada9e1ea89d6956851e58dadf119a75842b9c",
+    "ui/product.css": "3f89daeb52c5f1ed8a79150c9a84200187474a013fd97c6d7c8799d850e5b0b7",
+    "ui/favicon.svg": "c48be946b224112ebb0238b44263f7a61bda31e531afa895c2e9801c0ff24f32"
   },
   "modules": {
     "terminal": {
       "name": "@sanqianx/claude-ai-workbench",
       "installName": "claude-ai-workbench",
-      "version": "0.13.1",
+      "version": "0.13.2-rc.1",
       "files": {
         "LICENSE": "c1b9df1275e769f3dbab000d1e457a2d4b0f28eb5da6c77e48dc37eeba202ed7",
-        "README.md": "07a12d2397f625bd9d3a5e2944012d031a03c0bf1c8237e7c2b6f47cb6636685",
+        "README.md": "7efdf88b6eabdd3280fe69b6b78fce4ad9c1b5373ed5fc59e2a3db39d3f774d0",
         "apps/agent-terminal/app.css": "39cc65ac65bcb390f4aa21d9b783182ca229557f6bec15090f69598120161917",
         "apps/agent-terminal/app.js": "2fedcc79f9515ebae89d1c7dc996d732aa1d0946038eaaa045438121bf27f551",
         "apps/agent-terminal/index.html": "6a52ba210696c8aed99e2786e21d2771340070d51583199dd74c8da41edf0257",
@@ -26,20 +27,20 @@
         "apps/minimal-test-host/README.md": "fa73136f4ee3865c2d91eb97b2e8c03679aa4688e44c1e1c8ec6e27d604b0de5",
         "docs/sdk/FILE_LAYOUT.md": "17882f96505c8161bfb66876684b9d2d3f50021a111b8b844502d3cb4e97870a",
         "docs/sdk/INTEGRATION.md": "d4c0c80d2d2fc610205102d703a429bfaa20f9f3a48f1718f5bab02ee90138df",
-        "docs/sdk/openapi.yaml": "3e6cc332979a58d98073e5e04ceccef1c62aff681e78dc9f705450e6ad95006e",
+        "docs/sdk/openapi.yaml": "c14dd8a1989a6fbb748285d8b488f553e5673d52ff2439c124c435f65a57b570",
         "docs/sdk/README.md": "7ab591d39c36a3b84cfdf487ff567040ec453975f3ef0fba86dc822094667b61",
-        "package.json": "88df20662b9034a4cfca3b5c49cf58f2ad41398d34abfd37078a13fe87642cd7",
+        "package.json": "21b1d94149a71e9678e4a50c3146d292c2672f206ef621ae919850b67660804b",
         "packages/client/index.d.ts": "fb66b7b21ac936cddcb7f74543cf4f3bb7e80c169534ec249ab8ef2356224162",
         "packages/client/index.js": "92fe5ddd32289d729f336f669e47bd9601e562f5a4309ee4fa7f7f15b567edc2",
-        "packages/client/package.json": "4998341161acc712ef4b775004d2e791c232662269c18924029d7fa9e63e7452",
+        "packages/client/package.json": "5b5ea236e6a0769fd71b32759e0d87a33b84f4211ad298fe60452e5e8cb8bc3d",
         "packages/client/README.md": "342dff9b1dcbc85fccc9b980ed3e4e455aa71133af1d0805b8431ea2ac564ef8",
         "packages/contracts/index.d.ts": "edc717067bfb864c6c95df0c408a799fbf90b7552519131e6dc35af3f9eb9006",
         "packages/contracts/index.js": "565b4a88190dbb8994cd0a9309b30b00f64305d65505fff9fa360d7ce69dfb58",
-        "packages/contracts/package.json": "26d81905c0757c918ec9d0272645e4e6c3a5e64cfc7c31eb2e40c4f31f12dde1",
+        "packages/contracts/package.json": "95887ef01fa0e1ccc4f8e22089bfabe8252566e38cbfb8aef0882cfe8fe22e61",
         "packages/contracts/README.md": "44d83a3cc508cec6c5c20dfa1f2c08d5ea03e3afb2853639fdc0a9cc8eb5b9c8",
         "packages/core/index.d.ts": "c95b24a13f8aeeb128497833cf298790563baca6036ea5d29a9d8daff53199d7",
         "packages/core/index.js": "5579ceb1a63d3f962f5656c75f82cf60cd834fd270b4aa95e581bf38e4432448",
-        "packages/core/package.json": "a8dacd7a973ea57bcead83668aa837c3092537397d043b6f4a381a71c7fe7c8e",
+        "packages/core/package.json": "d21084880b3d52e371d208c071ec94a3df456ea483055acc4a65b1aa7ec2fb9a",
         "packages/core/README.md": "e222c546104a168f1038d95c6c4efb8e5603edd6145ab2cab79cab977fb710e5",
         "packages/server/bin/agent-terminal-server.js": "b01297ab245a2b994bf42043b7469bd6e71d8f76a4bb99d4ed651e71844c152f",
         "packages/server/bin/claude-workbench-server.js": "a8c46ed7e71afcc10e00a104ed6f2d0ac05346a743b33c3a5bd11b1314d80f40",
@@ -65,13 +66,13 @@
         "packages/server/lib/json-file.js": "c922e10116655cd519a5365aaac5468266f6d8a76e41db33eaa51f94b79dae13",
         "packages/server/lib/knowledge-context.js": "82023a94472fcb6fd6a74a53be43091473dbef11e6ac94ff9482c8a7fbc5c286",
         "packages/server/lib/model-detection.js": "fa52213200c1f1a1f00e463ada57c415bf1bd4e2aedfebd04de50750509d06cf",
-        "packages/server/lib/profile-store.js": "2a4496970c4b54a814f043cdeda87b897ad80d298dd96385964cf17e8164e6c6",
+        "packages/server/lib/profile-store.js": "70a9ff6aa31fe438ba8431f3e461f72e5d977f3510f2c42d39e9133e2f3491a8",
         "packages/server/lib/project-store.js": "5225c78f3216340f01b99356496c8e2c2d9cfc6247954a3f00b273dd2cc5b692",
         "packages/server/lib/session-archive-store.js": "d3335b832a6e9fb9792991056f6596a997a4959efa6e62b60fb60133fb724196",
         "packages/server/lib/system-doctor.js": "2b0e858d69d8fb268eaed950c9883473ee9850684b532bc2db8e14674a974919",
         "packages/server/lib/ui-preferences-store.js": "e108cb22e7cc1f3438704913d5401e01de2c0e717eb2abd3bdc4727209393819",
         "packages/server/lib/workbench-service.js": "b5caac09665b21a118a0cd826adfa3f3006e68989182e4d80bf3a4554b951250",
-        "packages/server/package.json": "6e80c900440c99144a629458c287bc1215a2aa0841c7493612f8db00e9f5dc66",
+        "packages/server/package.json": "77ded7b6683df90e731a0f0204ea56698a19f2a138959bee18355ba987eb04c2",
         "packages/server/README.md": "a34cfaa4f4e859008b44e2be8e1aafb56e97fe83e6129c968a8562945fa843f3",
         "packages/ui/ai-profile-settings.d.ts": "0551b6c6eda6d18ea89a976daddf01b2161195f4874fe2d67a57cd9ecc6ce643",
         "packages/ui/ai-profile-settings.js": "e92bbac67a1199d473e4e44b32d1cc76c5b6c79306d4fef9d9067a1bb6ec42ca",
@@ -79,7 +80,7 @@
         "packages/ui/claude-terminal.js": "96bd217a4a7e4792ae3fbaaf46249ecee13b0f4e01fc6d25a1b8b22d8f8fe00c",
         "packages/ui/index.d.ts": "e547ab39640fe7519fb367b78442dc8a2c51b2efd17b66f8b0a003b154b36ead",
         "packages/ui/index.js": "f4394aabd395938f5c3fe587e430471d4033e83945a9b9c7e0149ad4040982c9",
-        "packages/ui/package.json": "fd52ffefcb0dca34c5058d84559fe25a8d635469b039c9fd05b499889636731b",
+        "packages/ui/package.json": "47418b48345efd2099b5b0861eed4a04db8cfe613efc95cec4aa181c373af72c",
         "packages/ui/README.md": "793c4a9c286fee23f39062a1976ca3afe9d2816dcdb55e156ba940e1ef514f89",
         "packages/ui/theme.css": "8f03a081272a7db11b196f7a70d0fafb1f8d954778f329f1ba53d110d9d5fd98",
         "src/assets/claude-prompts.json": "cb111f2e0a45afe8a31c251a504d1ab5375966ed61291660e61fd2efd77f6d9f",
@@ -109,9 +110,9 @@
     "vectorHub": {
       "name": "@sanqianx/vector-hub",
       "installName": "@sanqianx/vector-hub",
-      "version": "1.0.7",
+      "version": "1.0.8-rc.1",
       "files": {
-        "README.md": "1998a65a3a50419fee13016b201621aaba6a5868038cb5f18a7f0a15fef74900",
+        "README.md": "801e0d2f258bc6d386b7ab44e1d8157c9f48d9c979b84c813773c34a9ee358c1",
         "dist/cjs/bin.d.ts": "43e818adf60173644896298637f47b01d5819b17eda46eaa32d0c7d64724d012",
         "dist/cjs/bin.js": "8d0317ce087d22074b4ad350d63bf39cd6d218da565496621cd0daf4245cbdc4",
         "dist/cjs/bin.js.map": "818e872380d9c7ba045238ba65ce77111ba822b356be26327ed05936e5667e5e",
@@ -133,12 +134,12 @@
         "dist/cjs/server/folder-picker.d.ts": "b9c59dbc834fff668b1894f516450c2edc985c7bfac31edf9b7b4e766474b32b",
         "dist/cjs/server/folder-picker.js": "053121152a210c899e8593d60670a2a510b435c3b479300c572aa4bc8443e58e",
         "dist/cjs/server/folder-picker.js.map": "dce1ad1b03c8a6a4fba7b3cacec5b65e55c1dfd1886c5e70df384efd1a5c68a6",
-        "dist/cjs/server/manager.d.ts": "f2fc59843006b2a96d9f1d6a39ac02e359e6016068c6f9cc1b16705979b2f03a",
-        "dist/cjs/server/manager.js": "eb10297ef7f37a0a736c7662e4a3f524b25110681c166969df099fce8198468a",
-        "dist/cjs/server/manager.js.map": "6b1e0d041a9d292fc7fdd351e09331477d965c6e7b48bafa7d50ec66902399f5",
+        "dist/cjs/server/manager.d.ts": "8aeb6b7d6e5f8ef94b65d0c078a3333b39e03546b2fc3cf8c0c0e144db4cff01",
+        "dist/cjs/server/manager.js": "1faed06b5efd6bea357ebf86e09af13791277fa07258eacc602af2945ae42845",
+        "dist/cjs/server/manager.js.map": "0d42dc88ad03bc723971a4967fb16b4fbf734ba06845e10ff10d85cf98c7b130",
         "dist/cjs/server/server.d.ts": "13288ace9aa6ec016a2b06dc036868324ac6c23c7e73771e95d120be778f238a",
-        "dist/cjs/server/server.js": "844b981bbbb905552973e74d61cdf773c54e6bf2eb928280de1d286c8f17ad0a",
-        "dist/cjs/server/server.js.map": "b0ca6318fa5aa7bebce6f84c725d2f7329231ad6c195066de96bb1de2e90c588",
+        "dist/cjs/server/server.js": "8b42771d2d1c4f18f51f1d7c305edd702bf86b009ea14e5f02d133a46de3c141",
+        "dist/cjs/server/server.js.map": "701f115fb78fcca13723568fc7514a290acff9dc3fe63c9104a35bdb7120459e",
         "dist/esm/bin.d.ts": "43e818adf60173644896298637f47b01d5819b17eda46eaa32d0c7d64724d012",
         "dist/esm/bin.js": "69f6059ce2336eb7f0d9503f86c83da787aaf74a8bfd804c694ba5b2e1728be0",
         "dist/esm/bin.js.map": "fc174c2b5c66c20ff88184ddeb00577406185945ccadb0bddbb2014909339e9e",
@@ -161,14 +162,14 @@
         "dist/esm/server/folder-picker.d.ts": "b9c59dbc834fff668b1894f516450c2edc985c7bfac31edf9b7b4e766474b32b",
         "dist/esm/server/folder-picker.js": "6c8247e431b7181c45fb169b29e5825a0b3589f44e1625b3a5a291d7b8358042",
         "dist/esm/server/folder-picker.js.map": "f70723213f032a0f10f538289a176a50fc8f02c200b0194479ffc139b5fbb13b",
-        "dist/esm/server/manager.d.ts": "f2fc59843006b2a96d9f1d6a39ac02e359e6016068c6f9cc1b16705979b2f03a",
-        "dist/esm/server/manager.js": "9c89e36fa7d8eef98f29c9180c455d27c1b3dca991df4249d5dcda759b43d9a3",
-        "dist/esm/server/manager.js.map": "c754044a92afa6f95155871054fccb79eb7b9753803dff0a36a3336d99892d76",
+        "dist/esm/server/manager.d.ts": "8aeb6b7d6e5f8ef94b65d0c078a3333b39e03546b2fc3cf8c0c0e144db4cff01",
+        "dist/esm/server/manager.js": "4f9c7a4cb12c7ac6d13f43ce37a8e2984bf1b4229feddb412f08ace12ca6859b",
+        "dist/esm/server/manager.js.map": "286cadd292ff7225a5faaa0946fb3b127e0ede488f1cae9f33aac2c7ec8f7726",
         "dist/esm/server/server.d.ts": "13288ace9aa6ec016a2b06dc036868324ac6c23c7e73771e95d120be778f238a",
-        "dist/esm/server/server.js": "6781d298e17451013e2fe475e282a1e9e853be0788819583cdfab50662d7940f",
-        "dist/esm/server/server.js.map": "3abb22e239bd841307a323e1b02b51ebba43ec0a708d32c9d1ec35aa44967090",
-        "package.json": "3812a503cc8ac2197d980f920a28e54c141193db7ab8e82c8718655b40df4f08",
-        "ui/index.html": "20c11d7e77e4fd57083ea9ecc434231a64d4b49b6f64e49b7c31b3dbaf044f19",
+        "dist/esm/server/server.js": "357f53c83ded73318016256fbb752e78b90f3a94aecfca71607de8326cad9ebf",
+        "dist/esm/server/server.js.map": "97d1cbd3a4fff6ab0cb7994df6c5b73daea03a0dd9c8a1841cec5bb7be82e66c",
+        "package.json": "acb511c809a53643d2ee501a58bb08c74fc85edbac0ecbc35d8f3e7c549389d3",
+        "ui/index.html": "7301a595d625dadcd424069e7bb978004bfb6118eddef7a223bd25449ca6e0eb",
         "ui/vendor/marked.min.js": "c68075672d976e4777390560baa112194855bd4404b13647da4855aae1f9360c"
       }
     },

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@sanqianx/project-knowledge",
-  "version": "5.0.8",
+  "version": "5.0.9-rc.2",
   "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
   "main": "_site/server.js",
   "scripts": {
     "start": "node _site/server.js",
     "test": "node _site/_test/run-all-tests.js",
-    "release:sync": "node _site/scripts/sync-release-version.js",
+    "release:sync": "node _site/scripts/sync-release-version.js --web-only",
     "vendor:modules": "node _site/scripts/vendor-modules.js",
     "runtime:verify": "node _site/scripts/verify-module-runtime.js --working-tree",
-    "release:verify": "node _site/scripts/sync-release-version.js --check && node _site/scripts/verify-module-runtime.js && node _site/scripts/verify-product-runtime.js && node _site/_test/integration-adapters-test.js",
+    "release:verify": "node _site/scripts/sync-release-version.js --check --web-only && node _site/scripts/verify-module-runtime.js && node _site/scripts/verify-product-runtime.js && node _site/_test/integration-adapters-test.js",
     "preversion": "npm run release:verify",
-    "version": "node _site/scripts/sync-release-version.js --stage",
+    "version": "node _site/scripts/sync-release-version.js --stage --web-only",
     "postversion": "npm run release:verify"
   },
   "bin": {
@@ -81,10 +81,10 @@
     "@lancedb/lancedb": "0.31.0",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@sanqianx/ai-coding-event-bridge-console": "0.7.2",
-    "@sanqianx/vector-hub": "1.0.7",
+    "@sanqianx/vector-hub": "1.0.8-rc.1",
     "buffer": "^6.0.3",
     "cheerio": "^1.2.0",
-    "claude-ai-workbench": "npm:@sanqianx/claude-ai-workbench@0.13.1",
+    "claude-ai-workbench": "npm:@sanqianx/claude-ai-workbench@0.13.2-rc.1",
     "cross-spawn": "7.0.6",
     "dotenv": "^17.4.2",
     "gpt-tokenizer": "^3.4.0",

package/plugins/project-knowledge/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "project-knowledge",
-  "version": "5.0.8",
+  "version": "5.0.9-rc.2",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

package/plugins/project-knowledge/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "project-knowledge",
-  "version": "5.0.8",
+  "version": "5.0.9-rc.2",
   "description": "Read durable project decisions and implementation history from Project Knowledge.",
   "author": {
     "name": "SanQianX",

package/plugins/project-knowledge/.mcp.json

@@ -6,7 +6,7 @@
       "args": [
         "-y",
         "--package",
-        "@sanqianx/project-knowledge@5.0.8",
+        "@sanqianx/project-knowledge@5.0.9-rc.2",
         "project-knowledge-mcp"
       ]
     }

package/ui/favicon.svg

@@ -1,38 +1,5 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="AI knowledge automation">
-  <defs>
-    <linearGradient id="bg" x1="8" y1="6" x2="56" y2="58" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#1f3148"/>
-      <stop offset=".54" stop-color="#111827"/>
-      <stop offset="1" stop-color="#06111f"/>
-    </linearGradient>
-    <linearGradient id="core" x1="21" y1="16" x2="45" y2="44" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#dff8ff"/>
-      <stop offset=".48" stop-color="#7dd3fc"/>
-      <stop offset="1" stop-color="#2f7d64"/>
-    </linearGradient>
-    <linearGradient id="book" x1="18" y1="35" x2="48" y2="54" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#f8fafc"/>
-      <stop offset="1" stop-color="#b8c6d8"/>
-    </linearGradient>
-    <filter id="glow" x="-40%" y="-40%" width="180%" height="180%">
-      <feGaussianBlur stdDeviation="1.8" result="blur"/>
-      <feMerge>
-        <feMergeNode in="blur"/>
-        <feMergeNode in="SourceGraphic"/>
-      </feMerge>
-    </filter>
-  </defs>
-  <rect x="4" y="4" width="56" height="56" rx="15" fill="url(#bg)"/>
-  <path d="M16 42c-6-9-3-22 7-28 9-6 21-4 28 5" fill="none" stroke="#38bdf8" stroke-width="3.5" stroke-linecap="round" opacity=".82"/>
-  <path d="M48 18h-8l5 6" fill="none" stroke="#38bdf8" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round" opacity=".82"/>
-  <path d="M50 25c4 10-1 23-12 27-9 4-20 1-25-8" fill="none" stroke="#75b798" stroke-width="3.5" stroke-linecap="round" opacity=".86"/>
-  <path d="M13 44h8l-5-6" fill="none" stroke="#75b798" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round" opacity=".86"/>
-  <path d="M32 13 45 21v15l-13 8-13-8V21z" fill="url(#core)" filter="url(#glow)"/>
-  <path d="M32 18v21M23 24l9-6 9 6M23 33l9 6 9-6" fill="none" stroke="#0f1724" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" opacity=".9"/>
-  <circle cx="16" cy="20" r="4" fill="#c5a15d"/>
-  <circle cx="49" cy="43" r="4" fill="#38bdf8"/>
-  <path d="M20 42h25l5 5-6 6H19l-5-5z" fill="url(#book)"/>
-  <path d="M20 42 14 48l25 1 6-7" fill="#e2e8f0"/>
-  <path d="M19 53h25l6-6" fill="none" stroke="#64748b" stroke-width="2.7" stroke-linecap="round" stroke-linejoin="round"/>
-  <path d="M24 47h14" stroke="#4f6f8f" stroke-width="3" stroke-linecap="round"/>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Project Knowledge">
+  <title>Project Knowledge · 折页 K</title>
+  <rect width="64" height="64" rx="16" fill="#516f89"/>
+  <path d="M16 15h8v13l14-13h10L30 32l18 17H38L24 36v13h-8Z" fill="#fff"/>
+</svg>

package/ui/index.html

@@ -2,12 +2,12 @@
 <html lang="zh-CN" data-theme="light">
 <head>
   <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light dark">
-  <title>Project Knowledge · 我的智脑</title><link rel="icon" href="/favicon.svg"><link rel="stylesheet" href="/product.css">
+  <title>Project Knowledge · 我的智脑</title><link rel="icon" type="image/svg+xml" href="/favicon.svg?v=folded-k-1"><link rel="stylesheet" href="/product.css">
 </head>
 <body>
 <div class="app">
   <aside class="sidebar">
-    <div class="brand"><span class="brand-mark">知</span><div><strong>Project Knowledge</strong><small>个人工程智脑</small></div></div>
+    <div class="brand"><img class="brand-mark" src="/favicon.svg?v=folded-k-1" width="32" height="32" alt=""><div><strong>Project Knowledge</strong><small>个人工程智脑</small></div></div>
     <div id="brainLabel" class="brain-label">我的智脑</div>
     <nav aria-label="主要导航">
       <button data-view="home"><svg viewBox="0 0 24 24"><path d="m3 11 9-7 9 7M5 10v10h14V10"/></svg>智脑首页</button>

package/ui/product.css

@@ -5,6 +5,6 @@
 .knowledge-context{overflow-x:hidden}.reference{overflow-wrap:anywhere}.reference small{min-width:0;max-width:100%}
 html[data-theme=dark]{--page:#171a1f;--surface:#20252d;--surface2:#252b34;--surface3:#2c333e;--line:#39424f;--text:#e6ebf0;--muted:#a0aaba;--faint:#788393;--nav:#1b2028;--accent:#8aa8cf;--accent-soft:#293748;--good:#81b29a;--bad:#d88b8b;--bad-soft:#39292d;color-scheme:dark}
 *{box-sizing:border-box}[hidden]{display:none!important}html,body{height:100%}body{margin:0;overflow:hidden;background:var(--page);color:var(--text);font:13px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei",sans-serif}button,input,select,textarea{font:inherit;color:inherit}button{cursor:pointer;display:inline-flex;align-items:center;justify-content:center;gap:8px;min-height:34px;padding:6px 12px;border:1px solid var(--line);border-radius:8px;background:var(--surface)}button:hover{background:var(--surface3)}button:disabled{opacity:.5;cursor:not-allowed}button.primary{background:var(--accent);color:#fff;border-color:var(--accent)}button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline:2px solid var(--accent);outline-offset:3px}svg{width:18px;height:18px;fill:none;stroke:currentColor;stroke-width:1.7;stroke-linecap:round;stroke-linejoin:round;flex:none}h1,h2,h3,p{margin:0}h1{font-size:18px;font-weight:650}h2{font-size:16px;font-weight:600}h3{font-size:13px;font-weight:600}small,.muted{color:var(--muted)}small{font-size:11px}p{color:var(--muted);margin-top:8px}input,select,textarea{background:var(--surface);border:1px solid var(--line);border-radius:8px;padding:8px 12px;min-width:0}label{display:block;font-size:12px;margin:16px 0;color:var(--muted)}label>input,label>select,label>textarea{display:block;width:100%;margin-top:8px;color:var(--text)}pre{font:12px/1.8 Consolas,"Microsoft YaHei",monospace;white-space:pre-wrap;overflow-wrap:anywhere;color:var(--text)}
-.app{height:100%;display:grid;grid-template-columns:232px minmax(0,1fr)}.sidebar{display:flex;flex-direction:column;border-right:1px solid var(--line);background:var(--nav);min-height:0}.brand{display:flex;align-items:center;gap:8px;padding:24px 20px 16px}.brand-mark{width:28px;height:28px;display:grid;place-items:center;border:1px solid var(--line);border-radius:8px;background:var(--surface);color:var(--accent)}.brand strong{font-size:14px}.brand small{display:block}.brain-label{padding:0 20px 16px;color:var(--muted);overflow-wrap:anywhere}.sidebar nav{display:grid;gap:8px;padding:8px 12px}.sidebar nav button{justify-content:flex-start;min-height:40px;text-align:left;border-color:transparent;background:transparent;color:var(--muted)}.sidebar nav button.active{border-color:var(--line);background:var(--surface);color:var(--text)}.count{margin-left:auto;background:var(--surface3);padding:0 6px;border-radius:4px}.system-button{margin: auto 12px 16px;justify-content:flex-start;min-height:56px;background:transparent;border-color:transparent;padding:8px}.system-button>span:nth-child(2){flex:1;text-align:left}.system-button b,.system-button small{display:block;font-size:11px}.dot{width:7px;height:7px;border-radius:50%;background:var(--faint);flex:none}.dot.up{background:var(--good)}.dot.issue{background:var(--bad)}main{min-width:0;min-height:0;display:flex;flex-direction:column}.topbar{height:72px;flex:none;display:flex;align-items:center;gap:16px;padding:0 24px;background:var(--surface);border-bottom:1px solid var(--line)}.spacer{flex:1}.topbar select{width:240px}.icon-button{padding:8px;min-width:34px}.content{position:relative;flex:1;min-height:0}.view{display:none;height:100%;overflow:auto;padding:32px}.view.active{display:block}.view.module-view{padding:0;overflow:hidden}.module-view.active{display:flex;flex-direction:column}.frame-container{position:relative;flex:1;min-width:0;min-height:0;overflow:hidden;background:var(--surface)}iframe{display:block;width:100%;height:100%;border:0;background:var(--surface)}.work-layout{display:grid;grid-template-columns:minmax(0,1fr) 288px;height:100%;min-height:0}.knowledge-context{background:var(--surface2);border-left:1px solid var(--line);overflow:auto;padding:24px 16px}.knowledge-context header{margin-bottom:24px}.knowledge-context h2{font-size:13px}.module-toolbar{flex:none;min-height:56px;display:flex;justify-content:space-between;align-items:center;gap:16px;padding:8px 24px;border-bottom:1px solid var(--line);background:var(--surface)}.segmented{display:flex;gap:4px}.segmented button{background:transparent;border-color:transparent;color:var(--muted)}.segmented button.active{background:var(--surface);border-color:var(--line);color:var(--text)}
+.app{height:100%;display:grid;grid-template-columns:232px minmax(0,1fr)}.sidebar{display:flex;flex-direction:column;border-right:1px solid var(--line);background:var(--nav);min-height:0}.brand{display:flex;align-items:center;gap:8px;padding:24px 20px 16px}.brand-mark{width:32px;height:32px;display:block;flex:none;object-fit:contain}.brand strong{font-size:14px}.brand small{display:block}.brain-label{padding:0 20px 16px;color:var(--muted);overflow-wrap:anywhere}.sidebar nav{display:grid;gap:8px;padding:8px 12px}.sidebar nav button{justify-content:flex-start;min-height:40px;text-align:left;border-color:transparent;background:transparent;color:var(--muted)}.sidebar nav button.active{border-color:var(--line);background:var(--surface);color:var(--text)}.count{margin-left:auto;background:var(--surface3);padding:0 6px;border-radius:4px}.system-button{margin: auto 12px 16px;justify-content:flex-start;min-height:56px;background:transparent;border-color:transparent;padding:8px}.system-button>span:nth-child(2){flex:1;text-align:left}.system-button b,.system-button small{display:block;font-size:11px}.dot{width:7px;height:7px;border-radius:50%;background:var(--faint);flex:none}.dot.up{background:var(--good)}.dot.issue{background:var(--bad)}main{min-width:0;min-height:0;display:flex;flex-direction:column}.topbar{height:72px;flex:none;display:flex;align-items:center;gap:16px;padding:0 24px;background:var(--surface);border-bottom:1px solid var(--line)}.spacer{flex:1}.topbar select{width:240px}.icon-button{padding:8px;min-width:34px}.content{position:relative;flex:1;min-height:0}.view{display:none;height:100%;overflow:auto;padding:32px}.view.active{display:block}.view.module-view{padding:0;overflow:hidden}.module-view.active{display:flex;flex-direction:column}.frame-container{position:relative;flex:1;min-width:0;min-height:0;overflow:hidden;background:var(--surface)}iframe{display:block;width:100%;height:100%;border:0;background:var(--surface)}.work-layout{display:grid;grid-template-columns:minmax(0,1fr) 288px;height:100%;min-height:0}.knowledge-context{background:var(--surface2);border-left:1px solid var(--line);overflow:auto;padding:24px 16px}.knowledge-context header{margin-bottom:24px}.knowledge-context h2{font-size:13px}.module-toolbar{flex:none;min-height:56px;display:flex;justify-content:space-between;align-items:center;gap:16px;padding:8px 24px;border-bottom:1px solid var(--line);background:var(--surface)}.segmented{display:flex;gap:4px}.segmented button{background:transparent;border-color:transparent;color:var(--muted)}.segmented button.active{background:var(--surface);border-color:var(--line);color:var(--text)}
 .welcome{display:flex;align-items:center;justify-content:space-between;gap:24px;margin-bottom:32px}.welcome h2{font-size:24px;margin-top:8px}.actions{display:flex;gap:8px;align-items:center}.grid2{display:grid;grid-template-columns:minmax(0,1.4fr) minmax(320px,1fr);gap:24px}.stack{display:grid;gap:24px}.panel{border:1px solid var(--line);background:var(--surface);border-radius:8px;padding:24px;min-width:0}.panel h2{margin-bottom:16px}.section-heading{display:flex;align-items:center;justify-content:space-between;gap:24px;margin-bottom:24px}.section-heading p{font-size:12px}.row{display:flex;align-items:center;gap:16px;padding:16px 0;border-bottom:1px solid var(--line)}.row:last-child{border-bottom:0}.row>div{flex:1;min-width:0}.row b{font-weight:600}.row small{display:block;margin-top:4px;overflow-wrap:anywhere}.row time{color:var(--muted);font-size:11px;flex:none}.status{font-size:11px;border:1px solid var(--line);border-radius:4px;padding:2px 8px;white-space:nowrap;color:var(--muted)}.status.up{color:var(--good)}.status.issue{color:var(--bad);background:var(--bad-soft)}.empty{padding:64px 24px;text-align:center;color:var(--muted);background:var(--surface);border-radius:8px;line-height:1.9}.empty button{display:block;margin:16px auto 0}.small-empty{padding:16px 0;text-align:left;background:transparent;font-size:12px}.hierarchy{display:grid;grid-template-columns:296px minmax(0,1fr);gap:24px}.tree h3{margin:24px 0 8px;color:var(--muted);font-size:11px}.tree button{width:100%;justify-content:flex-start;text-align:left;background:transparent;border-color:transparent;margin-top:4px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.tree button.active{background:var(--accent-soft);color:var(--accent)}.detail-path{padding:12px 16px;background:var(--surface2);border:1px solid var(--line);border-radius:8px;margin:8px 0 24px;font:12px/1.8 Consolas,"Microsoft YaHei",monospace;overflow-wrap:anywhere}.detail-label{color:var(--muted);font-size:11px}.memory-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:24px;margin-top:24px}.memory-card{padding:24px;border:1px solid var(--line);border-radius:8px;background:var(--surface)}.memory-card p{color:var(--text);margin:0 0 16px;white-space:pre-wrap}.memory-card .actions{margin-top:16px}.reference{display:block;text-align:left;width:100%;background:transparent;border:0;border-bottom:1px solid var(--line);border-radius:0;padding:16px 0}.reference b,.reference small{display:block;text-align:left}.reference p{font-size:12px;text-align:left}.activity-updates{flex:1;overflow:auto;padding:24px 32px}.run{margin-bottom:16px;background:var(--surface);border:1px solid var(--line);border-radius:8px}.run summary{padding:16px 24px;cursor:pointer;display:flex;align-items:center;gap:16px}.run summary strong{flex:1}.run>div{padding:0 24px 24px}.run .error{color:var(--bad)}.operation{padding:8px 0;color:var(--muted)}
 .drawer-backdrop{position:fixed;inset:0;background:rgba(10,18,25,.25);z-index:20}.drawer{position:fixed;right:0;top:0;height:100%;width:448px;background:var(--surface);border-left:1px solid var(--line);z-index:21;display:flex;flex-direction:column}.drawer>header{height:72px;display:flex;align-items:center;justify-content:space-between;padding:24px;border-bottom:1px solid var(--line)}.drawer-content{overflow:auto;flex:1;padding:24px}.drawer section{padding-bottom:24px;margin-bottom:24px;border-bottom:1px solid var(--line)}.drawer select{width:100%;margin:16px 0}.drawer .actions{flex-wrap:wrap}.drawer section:last-child{border-bottom:0}.input-with-action{display:flex;gap:8px;margin-top:8px}.input-with-action input{flex:1}.input-with-action button{flex:none}.checkbox{display:flex;align-items:center;gap:8px}.checkbox input{width:auto;margin:0}dialog{width:560px;max-width:90vw;max-height:90vh;overflow:auto;background:var(--surface);color:var(--text);border:1px solid var(--line);border-radius:12px;padding:24px}dialog::backdrop{background:rgba(10,18,25,.35)}.dialog-heading{display:flex;align-items:center;justify-content:space-between;margin-bottom:16px}.dialog-heading>button{border:0;background:transparent;font-size:20px}.dialog-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:24px}.feedback{padding:12px 16px;background:var(--surface2);border:1px solid var(--line);border-radius:8px;color:var(--muted);white-space:pre-wrap}.feedback.issue{color:var(--bad)}.reference-dialog{width:880px}.reference-dialog pre{margin-top:24px;max-height:60vh;overflow:auto}.engine-dialog{width:calc(100vw - 96px);height:calc(100vh - 96px);padding:0;overflow:hidden}.engine-dialog .dialog-heading{height:64px;padding:16px 24px;border-bottom:1px solid var(--line);margin:0}.engine-dialog iframe{height:calc(100% - 64px)}.toast{position:fixed;bottom:24px;right:24px;z-index:50;background:var(--surface);padding:12px 16px;border:1px solid var(--line);border-radius:8px;max-width:480px;color:var(--text)}

package/ui/product.js

@@ -113,7 +113,7 @@
     $('activityUpdates').hidden = state.activityTab !== 'updates'; $('activitySessions').hidden = state.activityTab !== 'sessions';
     const runs = state.snapshot.runs.filter(r => r.projectId === state.projectId);
     const open = new Set(all('.run[open]').map(d => d.dataset.runId));
-    $('activityUpdates').innerHTML = state.engineAvailable ? runs.map(r => `<details class="run" data-run-id="${esc(r.runId)}" ${open.has(r.runId) ? 'open' : ''}><summary><time>${time(r.startedAt)}</time><strong>${esc(projectName(r.projectId))} · ${esc(r.commitSha.slice(0, 8))}</strong>${badge(label(r), ['failed', 'index-pending'].includes(r.state) ? 'issue' : r.state === 'succeeded' ? 'up' : '')}</summary><div><p>提交：${esc(r.commitSha)}<br>阶段：${esc(r.phase)} · 入口：${esc(r.trigger)}<br>知识晋升：${time(r.promotedAt)} · 索引：${esc(r.indexState)}</p>${r.error ? `<p class="error">${esc(r.error.message)} (${esc(r.error.code)})</p>` : ''}${(r.staging?.operations || []).map(op => `<div class="operation">${esc(op.operation)} · ${esc(op.path)}<br>${esc(op.reason)}</div>`).join('')}${['failed', 'index-pending'].includes(r.state) ? `<button data-retry-run="${esc(r.runId)}">重试失败阶段</button>` : ''}</div></details>`).join('') || '<div class="empty">当前项目还没有知识维护记录。</div>' : '<div class="empty">知识引擎离线。记录仍保留在本机，连接恢复后自动读取。</div>';
+    $('activityUpdates').innerHTML = state.engineAvailable ? runs.map(r => `<details class="run" data-run-id="${esc(r.runId)}" ${open.has(r.runId) ? 'open' : ''}><summary><time>${time(r.startedAt)}</time><strong>${esc(projectName(r.projectId))} · ${esc(r.commitSha.slice(0, 8))}</strong>${badge(label(r), ['failed', 'index-pending'].includes(r.state) ? 'issue' : r.state === 'succeeded' ? 'up' : '')}</summary><div><p>提交：${esc(r.commitSha)}<br>阶段：${esc(r.phase)} · 入口：${esc(r.trigger)}<br>知识晋升：${time(r.promotedAt)} · 索引：${esc(r.indexState)}</p>${r.error ? `<p class="error">${esc(r.error.message)} (${esc(r.error.code)})</p>${r.error.details ? `<p>失败原因：${esc(r.error.details.upstreamMessage)}<br>类别：${esc(r.error.details.failureKind)} · HTTP：${esc(r.error.details.httpStatus ?? '—')} · 上游代码：${esc(r.error.details.upstreamCode)}<br>请求标识：${esc(r.error.details.requestId || '—')} · 尝试：${esc(r.error.details.attempt)} · 耗时：${esc(r.error.details.durationMs ?? '—')} ms</p>` : ''}` : ''}${(r.staging?.operations || []).map(op => `<div class="operation">${esc(op.operation)} · ${esc(op.path)}<br>${esc(op.reason)}</div>`).join('')}${['failed', 'index-pending'].includes(r.state) ? `<button data-retry-run="${esc(r.runId)}">重试失败阶段</button>` : ''}</div></details>`).join('') || '<div class="empty">当前项目还没有知识维护记录。</div>' : '<div class="empty">知识引擎离线。记录仍保留在本机，连接恢复后自动读取。</div>';
   }
   function renderContext() {
     const saved = state.contexts.get(state.projectId);

package/vendor-manifest.json

@@ -3,19 +3,20 @@
   "modules": {
     "knowledge-engine": {
       "name": "@sanqianx/ai-coding-knowledge-engine",
-      "version": "0.2.2",
+      "version": "0.2.3-rc.1",
       "root": "_modules/knowledge-engine",
       "files": {
-        "README.md": "236dafd8092e13ab731d4a14548e04c4ad3126bdfa63c706a6afe6f9b1dc535d",
-        "package.json": "4fe13c333017a073431c4b730c000a30d2be81012dbb8881dcae3167e3c38643",
+        "README.md": "899de4400e5baf2a981fbfeb1b6adef0b64a0c022a0dbf8d11706d58b0c6b277",
+        "package.json": "a90e49be24b25b526c2325da9a2bf897de3b449b1cfbdb595427fd080484cc9c",
         "src/analysis-contract.js": "fee063967d32eefc955cf0729f7dc8cb31bd690b85e22471c9059494a599c77a",
         "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
         "src/analysis-worker.js": "a105cabe6e1573b2d986b1e7a5aaf615e2fb53524156fc8e4e2c0a71f2c97e55",
         "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
         "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
-        "src/coordinator.js": "c31a7274cc808bc99f2aa15f2611e55f0d0096b9c1273f20de683f5102d83074",
-        "src/diagnostics.js": "1ad8b21e0f26d7c18861d51c711a6d36e5070658205cab19727494279f0801e4",
+        "src/coordinator.js": "1df096060faa83245c49b65a861f32cdaeeb7a190b94abf2ad6477151d7ca2ff",
+        "src/diagnostics.js": "f7b516ace61a1e9faaa6876930b9e2e258499a25857d1203f4e53d28bfd0fa1a",
         "src/headless-analyzer.js": "cfe54b392b2aff6e2c5157481dfeb5ccebc4ce83d1d74aa44f28cf2eb923b013",
+        "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
         "src/memories.js": "0a8667e6daba99fa5022393951a28e96cdadf98af85b6af9a6be96c7f4e896fc",
         "src/retrieval.js": "b3ae3f701a007e3d3ff98811bb80db3505e2fcc87f94aaa9e36057edc7eb71c2",
         "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
@@ -28,7 +29,7 @@
         "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
         "src/runtime/contracts.js": "567fbace85ad0534fb0119f5c0e57d73acc0b76cc799af93d778c5ecbade53df",
         "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
-        "src/runtime/conversation-store.js": "8ea0135588e40dfe0bab0288220a0fb481a470855558ae38b8274d57ce55fc39",
+        "src/runtime/conversation-store.js": "644318f9c04376a3317ced240dd94afa99a79631f0ecc394c5aa298ae2bc0474",
         "src/runtime/evidence-bundle.js": "33d4614849d5e1d69aba8b75c3a43c18b7b6f94e5c78654c82ef631331cc94cc",
         "src/runtime/git-runner.js": "b74fe197bd4dcf3e70635ef7b1f2615edf965c1d9a3ffe5406aabd41b76d74a9",
         "src/runtime/knowledge-promotion.js": "c24aba505caf11cdc8faba763beffc65956c1330ef28ed5fbd6ae16eac640fa6",
@@ -36,10 +37,10 @@
         "src/runtime/layout.js": "c48fa1db62e5df1edefe13218e470c5ceea4ef2781293512c2c18e5c2ba0c7e9",
         "src/runtime/markdown-knowledge-indexer.js": "44a76a9adefad07e78f77b1106b10d6c1cc7873d76362df4c546892b21f3939c",
         "src/runtime/scanner.js": "d99fa8d74a6fbbaae75ca49f62127e14cf9e48b1404e4b4d597ef39df5441410",
-        "src/server.js": "e7f0b07b7a8cf2623690b9d2d23492f2c95737dc974adfeea049610a4b5ded55",
+        "src/server.js": "7deff466d28b94ec8975cd87ebd55c59d0aa6b49a8dfa447b552b1d32aa9c4b7",
         "src/store.js": "71f0417c2c1e42b89429e3dee1adff7b2c09e86682cb3f4843ce6d9e5aafd7ec",
         "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
-        "ui/app.js": "91ee6d8c31712e6af46de2eecbd72bbc5236c06b7cd055800831e7d57f84a0be",
+        "ui/app.js": "33a2ba38f0dafbbb2e30a1eb3fc93476bfcaf528e124e1a9b2edd2fb69221e9e",
         "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
       }
     }