@sanqianx/project-knowledge 5.0.24 → 5.0.26

package/_site/README.md

@@ -1,30 +1,30 @@
-# KB Management Site
-
-本地知识库管理界面，默认监听 `http://127.0.0.1:5757`。
-
-## 启动
-
-```bash
-node _site/server.js
-```
-
-也可以运行项目根目录的 `npm start`，或使用 `_site/start.bat`。
-
-## Commit 自动化
-
-- Git `post-commit` Hook 在应用运行时立即通知服务端。
-- 应用启动时会扫描关闭期间新增的 commit。
-- 每个 commit 生成一个独立 Claude Code 后台任务。
-- 同一项目按提交时间串行执行，不同项目可以并行。
-- 任务直接更新当前项目知识库，没有草稿审核、`autoApply` 或人工批准阶段。
-- 每个 commit 的 `discovered / queued / running / completed / failed` 状态持久化在项目 AI 工作目录中，完成的 commit 不会重复派发。
-
-## 主要接口
-
-- `GET /api/state`：项目与知识库状态。
-- `POST /api/hooks/post-commit`：接收 Hook 事件并执行 commit 对账。
-- `POST /api/projects/:slug/scan`：只读扫描 Git 状态。
-- `GET /api/projects/:slug/automation/runs`：查看自动化运行记录。
-- `GET /api/claude/sessions-stream`：订阅 Claude Code 会话状态。
-
-服务只绑定回环地址。不要将端口直接暴露到公网。
+# KB Management Site
+
+本地知识库管理界面，默认监听 `http://127.0.0.1:5757`。
+
+## 启动
+
+```bash
+node _site/server.js
+```
+
+也可以运行项目根目录的 `npm start`，或使用 `_site/start.bat`。
+
+## Commit 自动化
+
+- Git `post-commit` Hook 在应用运行时立即通知服务端。
+- 应用启动时会扫描关闭期间新增的 commit。
+- 每个 commit 生成一个独立 Claude Code 后台任务。
+- 同一项目按提交时间串行执行，不同项目可以并行。
+- 任务直接更新当前项目知识库，没有草稿审核、`autoApply` 或人工批准阶段。
+- 每个 commit 的 `discovered / queued / running / completed / failed` 状态持久化在项目 AI 工作目录中，完成的 commit 不会重复派发。
+
+## 主要接口
+
+- `GET /api/state`：项目与知识库状态。
+- `POST /api/hooks/post-commit`：接收 Hook 事件并执行 commit 对账。
+- `POST /api/projects/:slug/scan`：只读扫描 Git 状态。
+- `GET /api/projects/:slug/automation/runs`：查看自动化运行记录。
+- `GET /api/claude/sessions-stream`：订阅 Claude Code 会话状态。
+
+服务只绑定回环地址。不要将端口直接暴露到公网。

package/_site/_test/agent-capture-mcp-ui-test.js

@@ -1,68 +1,68 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const http = require('node:http');
-const { createRequire } = require('node:module');
-const coreRoot = path.resolve(process.env.KB_CAPTURE_TEST_CORE_ROOT || path.join(__dirname, '../..'));
-const fromCore = createRequire(path.join(coreRoot, 'package.json'));
-const { createRuntime, initializeRuntime, createRequestHandler } = fromCore('./_site/lib/server-app');
-const { BridgeAdapter } = fromCore('./_site/lib/bridge-adapter');
-const { ModuleBridge } = fromCore('./_site/lib/module-bridge');
-const { findChrome } = require('./helpers/find-chrome');
-const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
-
-const HOSTILE_DETAIL = '<img src=x onerror="window.__kbXssProbe=1"> INJECT-STATUS-MARKER sk-abcdef123456';
-
-function clientFixture(client, label) {
-  const mcpCapable = client === 'claude' || client === 'codex';
-  return {
-    client, label, available: false, configFound: false,
-    knowledgeIntegration: { ok: true, state: 'installed' },
-    automaticContext: { supported: client !== 'opencode', configured: false, state: 'check-failed', detail: HOSTILE_DETAIL },
-    developmentCapture: { ok: true, state: 'installed', installed: true, detail: HOSTILE_DETAIL },
-    mcpStartup: mcpCapable ? { state: 'failed', checkedAt: new Date().toISOString(), scope: 'client:' + client, code: 'PROBE_TIMEOUT', expectedVersion: '9.9.9-test', detail: HOSTILE_DETAIL } : undefined,
-  };
-}
-
-async function main() {
-  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-agent-mcp-ui-'));
-  const dataDir = path.join(temp, 'data');
-  const homeDir = path.join(temp, 'home');
-  const eventsHome = path.join(dataDir, 'events');
-  const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: 'offline stub' } })); });
-  await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
-  const offlineUrl = 'http://127.0.0.1:' + offline.address().port;
-  const runtime = createRuntime({ dataDir, analysisOwner: 'engine', bridgeAdapter: new BridgeAdapter({ dataDir, bridgeHomeDir: eventsHome }), moduleBridge: new ModuleBridge({ terminalUrl: offlineUrl, engineUrl: offlineUrl, eventBridgeUrl: offlineUrl, vectorHubUrl: offlineUrl }) });
-  await initializeRuntime(runtime);
-  const server = http.createServer(createRequestHandler(runtime, { integrationOptions: { homeDir, env: {}, commandResolver: () => '' } }));
-  await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
-  const base = 'http://127.0.0.1:' + server.address().port;
-  const payload = JSON.stringify({ bridge: { ok: true }, scan: { state: 'ready' }, clients: [clientFixture('claude', 'Claude Code'), clientFixture('codex', 'Codex'), clientFixture('zcode', 'ZCode'), clientFixture('opencode', 'OpenCode')] });
-  let browser;
-  try {
-    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(temp, 'browser'), url: base, width: 1440, height: 900 });
-    const run = expression => browser.evaluate(expression);
-    const click = selector => run('document.querySelector(' + JSON.stringify(selector) + ').click()');
-    await run('(() => { const original = window.fetch; window.__originalFetch = original; window.fetch = (input, init) => { const url = String(input && input.url || input); if (url.includes(\'/api/integrations/status\')) { return Promise.resolve({ ok: true, json: async () => (' + payload + ') }); } return original(input, init); }; })()');
-    await click('#openSystem');
-    await waitFor(() => run("document.querySelectorAll('#agentCaptureList .agent-capture-row').length === 4"), 'capture rows render');
-    assert(await run("document.getElementById('agentCaptureList').textContent.includes('PROBE_TIMEOUT')"), 'the MCP startup failure code must be rendered for MCP-capable clients');
-    const claudeRowHtml = await run("document.querySelector('#agentCaptureList .agent-capture-row').innerHTML");
-    assert(claudeRowHtml.includes('&lt;img'), 'hostile mcpStartup detail must be HTML-escaped, got: ' + claudeRowHtml.slice(0, 300));
-    assert(!claudeRowHtml.includes('<img'), 'no raw hostile markup may reach the DOM');
-    assert.equal(await run('window.__kbXssProbe'), undefined, 'the hostile onerror must never execute');
-    const smalls = await run("[...document.querySelectorAll('#agentCaptureList small')].map(el => el.textContent).join('|')");
-    assert(smalls.split('|').some(text => text.startsWith('MCP')), 'the MCP diagnostic is its own line item, got: ' + smalls);
-    assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));
-    console.log('agent-capture-mcp-ui-test PASS (MCP line rendered separately; hostile detail escaped; no XSS execution)');
-  } finally {
-    runtime.integrationStatusScan?.close();
-    await browser?.close(); server.closeAllConnections(); await new Promise(resolve => server.close(resolve));
-    offline.closeAllConnections(); await new Promise(resolve => offline.close(resolve)); await runtime.logger.close();
-    assert.equal(path.dirname(temp), path.resolve(os.tmpdir())); assert.ok(path.basename(temp).startsWith('kb-agent-mcp-ui-'));
-    await fs.promises.rm(temp, { recursive: true, force: true, maxRetries: 12, retryDelay: 200 });
-  }
-}
-main().catch(error => { console.error(error.stack); process.exitCode = 1; });
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const http = require('node:http');
+const { createRequire } = require('node:module');
+const coreRoot = path.resolve(process.env.KB_CAPTURE_TEST_CORE_ROOT || path.join(__dirname, '../..'));
+const fromCore = createRequire(path.join(coreRoot, 'package.json'));
+const { createRuntime, initializeRuntime, createRequestHandler } = fromCore('./_site/lib/server-app');
+const { BridgeAdapter } = fromCore('./_site/lib/bridge-adapter');
+const { ModuleBridge } = fromCore('./_site/lib/module-bridge');
+const { findChrome } = require('./helpers/find-chrome');
+const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
+
+const HOSTILE_DETAIL = '<img src=x onerror="window.__kbXssProbe=1"> INJECT-STATUS-MARKER sk-abcdef123456';
+
+function clientFixture(client, label) {
+  const mcpCapable = client === 'claude' || client === 'codex';
+  return {
+    client, label, available: false, configFound: false,
+    knowledgeIntegration: { ok: true, state: 'installed' },
+    automaticContext: { supported: client !== 'opencode', configured: false, state: 'check-failed', detail: HOSTILE_DETAIL },
+    developmentCapture: { ok: true, state: 'installed', installed: true, detail: HOSTILE_DETAIL },
+    mcpStartup: mcpCapable ? { state: 'failed', checkedAt: new Date().toISOString(), scope: 'client:' + client, code: 'PROBE_TIMEOUT', expectedVersion: '9.9.9-test', detail: HOSTILE_DETAIL } : undefined,
+  };
+}
+
+async function main() {
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-agent-mcp-ui-'));
+  const dataDir = path.join(temp, 'data');
+  const homeDir = path.join(temp, 'home');
+  const eventsHome = path.join(dataDir, 'events');
+  const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: 'offline stub' } })); });
+  await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
+  const offlineUrl = 'http://127.0.0.1:' + offline.address().port;
+  const runtime = createRuntime({ dataDir, analysisOwner: 'engine', bridgeAdapter: new BridgeAdapter({ dataDir, bridgeHomeDir: eventsHome }), moduleBridge: new ModuleBridge({ terminalUrl: offlineUrl, engineUrl: offlineUrl, eventBridgeUrl: offlineUrl, vectorHubUrl: offlineUrl }) });
+  await initializeRuntime(runtime);
+  const server = http.createServer(createRequestHandler(runtime, { integrationOptions: { homeDir, env: {}, commandResolver: () => '' } }));
+  await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+  const base = 'http://127.0.0.1:' + server.address().port;
+  const payload = JSON.stringify({ bridge: { ok: true }, scan: { state: 'ready' }, clients: [clientFixture('claude', 'Claude Code'), clientFixture('codex', 'Codex'), clientFixture('zcode', 'ZCode'), clientFixture('opencode', 'OpenCode')] });
+  let browser;
+  try {
+    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(temp, 'browser'), url: base, width: 1440, height: 900 });
+    const run = expression => browser.evaluate(expression);
+    const click = selector => run('document.querySelector(' + JSON.stringify(selector) + ').click()');
+    await run('(() => { const original = window.fetch; window.__originalFetch = original; window.fetch = (input, init) => { const url = String(input && input.url || input); if (url.includes(\'/api/integrations/status\')) { return Promise.resolve({ ok: true, json: async () => (' + payload + ') }); } return original(input, init); }; })()');
+    await click('#openSystem');
+    await waitFor(() => run("document.querySelectorAll('#agentCaptureList .agent-capture-row').length === 4"), 'capture rows render');
+    assert(await run("document.getElementById('agentCaptureList').textContent.includes('PROBE_TIMEOUT')"), 'the MCP startup failure code must be rendered for MCP-capable clients');
+    const claudeRowHtml = await run("document.querySelector('#agentCaptureList .agent-capture-row').innerHTML");
+    assert(claudeRowHtml.includes('&lt;img'), 'hostile mcpStartup detail must be HTML-escaped, got: ' + claudeRowHtml.slice(0, 300));
+    assert(!claudeRowHtml.includes('<img'), 'no raw hostile markup may reach the DOM');
+    assert.equal(await run('window.__kbXssProbe'), undefined, 'the hostile onerror must never execute');
+    const smalls = await run("[...document.querySelectorAll('#agentCaptureList small')].map(el => el.textContent).join('|')");
+    assert(smalls.split('|').some(text => text.startsWith('MCP')), 'the MCP diagnostic is its own line item, got: ' + smalls);
+    assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));
+    console.log('agent-capture-mcp-ui-test PASS (MCP line rendered separately; hostile detail escaped; no XSS execution)');
+  } finally {
+    runtime.integrationStatusScan?.close();
+    await browser?.close(); server.closeAllConnections(); await new Promise(resolve => server.close(resolve));
+    offline.closeAllConnections(); await new Promise(resolve => offline.close(resolve)); await runtime.logger.close();
+    assert.equal(path.dirname(temp), path.resolve(os.tmpdir())); assert.ok(path.basename(temp).startsWith('kb-agent-mcp-ui-'));
+    await fs.promises.rm(temp, { recursive: true, force: true, maxRetries: 12, retryDelay: 200 });
+  }
+}
+main().catch(error => { console.error(error.stack); process.exitCode = 1; });

package/_site/_test/agent-capture-ui-test.js

@@ -1,101 +1,101 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const http = require('node:http');
-const { createRequire } = require('node:module');
-const coreRoot = path.resolve(process.env.KB_CAPTURE_TEST_CORE_ROOT || path.join(__dirname, '../..'));
-const fromCore = createRequire(path.join(coreRoot, 'package.json'));
-const { createRuntime, initializeRuntime, createRequestHandler } = fromCore('./_site/lib/server-app');
-const { BridgeAdapter } = fromCore('./_site/lib/bridge-adapter');
-const { ModuleBridge } = fromCore('./_site/lib/module-bridge');
-const { findChrome } = require('./helpers/find-chrome');
-const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
-const { Journal } = fromCore('@sanqianx/ai-coding-event-bridge-console/src/bridge');
-const { spawnSync } = require('node:child_process');
-
-async function main() {
-  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-agent-capture-ui-'));
-  const dataDir = path.join(temp, 'data');
-  const homeDir = path.join(temp, '用户 空格');
-  const eventsHome = path.join(dataDir, 'events');
-  const configFile = path.join(homeDir, '.zcode', 'cli', 'config.json');
-  const intentFile = path.join(dataDir, 'integration-intent.json');
-  fs.mkdirSync(path.dirname(configFile), { recursive: true });
-  fs.writeFileSync(configFile, JSON.stringify({ provider: { name: 'retain' } }));
-  const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: '本轮测试中非采集模块离线' } })); });
-  await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
-  const offlineUrl = `http://127.0.0.1:${offline.address().port}`;
-  const runtime = createRuntime({ dataDir, analysisOwner: 'engine', bridgeAdapter: new BridgeAdapter({ dataDir, bridgeHomeDir: eventsHome }), moduleBridge: new ModuleBridge({ terminalUrl: offlineUrl, engineUrl: offlineUrl, eventBridgeUrl: offlineUrl, vectorHubUrl: offlineUrl }) });
-  await initializeRuntime(runtime);
-  const server = http.createServer(createRequestHandler(runtime, { integrationOptions: { homeDir, env: {}, commandResolver: () => '' } }));
-  await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
-  const base = `http://127.0.0.1:${server.address().port}`;
-  let browser;
-  try {
-    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(temp, 'browser'), url: base, width: 1920, height: 1080 });
-    await browser.setViewport(1920, 1080);
-    const run = expression => browser.evaluate(expression);
-    const click = selector => run(`document.querySelector(${JSON.stringify(selector)}).click()`);
-    await click('#openSystem');
-    await waitFor(() => run("document.querySelectorAll('#agentCaptureList .agent-capture-row').length === 4"), 'four capture statuses');
-    // Single-switch rows: claude undetected -> disabled switch; zcode configured -> enabled, badge 未接入.
-    assert.equal(await run("document.querySelector('[data-agent-client=claude][data-agent-switch]').disabled"), true);
-    assert.equal(await run("document.querySelector('[data-agent-client=zcode][data-agent-switch]').disabled"), false);
-    await waitFor(() => run("document.querySelector('[data-agent-client=zcode]').closest('.agent-capture-row').textContent.includes('未接入')"), 'zcode badge settles to disconnected');
-    assert(await run("document.getElementById('agentCaptureList').textContent.includes('检测到配置')"));
-    assert.equal(await run("document.querySelector('[data-agent-client=zcode]').closest('.agent-capture-row').querySelector('details.agent-detail').open"), false, 'details must be collapsed by default');
-    assert.equal(await run("document.getElementById('refreshAgentCapture')"), null, 'manual status button removed');
-    // Switch ON: full install (knowledge + capture), real config written.
-    await click('[data-agent-client=zcode][data-agent-switch=install]');
-    await waitFor(() => run("document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') !== null"), 'connected status reloaded from backend');
-    assert(await run("document.querySelector('[data-agent-client=zcode]').closest('.agent-capture-row').textContent.includes('已接入')"));
-    const config = JSON.parse(fs.readFileSync(configFile));
-    assert.equal(config.hooks.enabled, true);
-    const intent = JSON.parse(fs.readFileSync(intentFile));
-    assert.equal(intent.clients.zcode, 'connected', 'successful install records intent');
-    const env = { ...process.env }; delete env.AI_CODING_EVENT_BRIDGE_HOME; delete env.AI_CODING_EVENT_BRIDGE_CAPTURE;
-    // Full install wires every UserPromptSubmit hook (context pre-read first,
-    // capture second) — run them all like the real client does.
-    for (const hook of config.hooks.events.UserPromptSubmit.flatMap(entry => entry.hooks)) {
-      const child = spawnSync(process.execPath, hook.args, { env, input: JSON.stringify({ hook_event_name: 'UserPromptSubmit', session_id: 'ui-zcode-session', cwd: temp, prompt: '从网页接入后写入真实 journal' }), encoding: 'utf8', timeout: 15000 });
-      assert.equal(child.status, 0, child.stderr);
-    }
-    const events = await new Journal(path.join(eventsHome, 'journal')).readEvents({});
-    assert.equal(events.length, 1); assert.equal(events[0].source, 'zcode');
-    assert.equal(await run('document.documentElement.scrollWidth > innerWidth'), false);
-    const artifacts = path.resolve(process.env.KB_CAPTURE_TEST_ARTIFACTS || path.join(__dirname, '../..', '.agent-state/acceptance/agent-capture'));
-    await browser.screenshot(path.join(artifacts, '1920-light.png'));
-    await click('#closeSystem'); await click('#themeToggle'); await click('#openSystem');
-    await waitFor(() => run("document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') !== null"), 'theme retains capture status');
-    await browser.screenshot(path.join(artifacts, '1920-dark.png'));
-    // Broken config: the single switch acts as the explicit repair path.
-    fs.writeFileSync(configFile, '{invalid JSON');
-    await click('#closeSystem'); await click('#openSystem');
-    await waitFor(() => run("(() => { const b = document.querySelector('[data-agent-client=zcode][data-agent-switch=install]'); return b !== null && !b.disabled; })()"), 'capture row settled before invalid config');
-    await click('[data-agent-client=zcode][data-agent-switch=install]');
-    await waitFor(() => run("document.getElementById('agentCaptureFeedback').textContent.includes('操作未完成')"), 'partial failure rendered');
-    assert(await run("document.getElementById('agentCaptureFeedback').classList.contains('issue')"));
-    const logs = (await (await fetch(base + '/api/logs?event=integration.capture.failed')).json()).entries;
-    assert(logs.length > 0 && logs[0].error.message.includes('valid JSON'));
-    fs.writeFileSync(configFile, JSON.stringify(config));
-    await click('#closeSystem'); await click('#openSystem');
-    await waitFor(() => run("document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') !== null"), 'switch repair succeeds');
-    // Switch OFF: removal keeps third-party config and prior evidence.
-    await click('[data-agent-client=zcode][data-agent-switch=uninstall]');
-    await waitFor(() => run("!document.querySelector('[data-agent-client=zcode][data-agent-switch]').disabled && document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') === null"), 'removed capture status');
-    assert.equal(JSON.parse(fs.readFileSync(configFile)).provider.name, 'retain');
-    assert.equal(JSON.parse(fs.readFileSync(intentFile)).clients.zcode, 'disconnected', 'uninstall records disconnected intent');
-    assert.equal((await new Journal(path.join(eventsHome, 'journal')).readEvents({})).length, 1, 'removal retains prior evidence');
-    assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));
-    console.log(`agent-capture-ui-test PASS (1920x1080; single-switch install/repair/Hook/journal/error logs/intent/removal/light+dark; core=${coreRoot})`);
-  } finally {
-    runtime.integrationStatusScan?.close();
-    await browser?.close(); server.closeAllConnections(); await new Promise(resolve => server.close(resolve));
-    offline.closeAllConnections(); await new Promise(resolve => offline.close(resolve)); await runtime.logger.close();
-    assert.equal(path.dirname(temp), path.resolve(os.tmpdir())); assert.ok(path.basename(temp).startsWith('kb-agent-capture-ui-'));
-    await fs.promises.rm(temp, { recursive: true, force: true, maxRetries: 12, retryDelay: 200 });
-  }
-}
-main().catch(error => { console.error(error.stack); process.exitCode = 1; });
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const http = require('node:http');
+const { createRequire } = require('node:module');
+const coreRoot = path.resolve(process.env.KB_CAPTURE_TEST_CORE_ROOT || path.join(__dirname, '../..'));
+const fromCore = createRequire(path.join(coreRoot, 'package.json'));
+const { createRuntime, initializeRuntime, createRequestHandler } = fromCore('./_site/lib/server-app');
+const { BridgeAdapter } = fromCore('./_site/lib/bridge-adapter');
+const { ModuleBridge } = fromCore('./_site/lib/module-bridge');
+const { findChrome } = require('./helpers/find-chrome');
+const { launchCdpBrowser, waitFor } = require('./helpers/cdp-browser');
+const { Journal } = fromCore('@sanqianx/ai-coding-event-bridge-console/src/bridge');
+const { spawnSync } = require('node:child_process');
+
+async function main() {
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'kb-agent-capture-ui-'));
+  const dataDir = path.join(temp, 'data');
+  const homeDir = path.join(temp, '用户 空格');
+  const eventsHome = path.join(dataDir, 'events');
+  const configFile = path.join(homeDir, '.zcode', 'cli', 'config.json');
+  const intentFile = path.join(dataDir, 'integration-intent.json');
+  fs.mkdirSync(path.dirname(configFile), { recursive: true });
+  fs.writeFileSync(configFile, JSON.stringify({ provider: { name: 'retain' } }));
+  const offline = http.createServer((req, res) => { res.writeHead(503, { 'content-type': 'application/json' }); res.end(JSON.stringify({ ok: false, error: { message: '本轮测试中非采集模块离线' } })); });
+  await new Promise(resolve => offline.listen(0, '127.0.0.1', resolve));
+  const offlineUrl = `http://127.0.0.1:${offline.address().port}`;
+  const runtime = createRuntime({ dataDir, analysisOwner: 'engine', bridgeAdapter: new BridgeAdapter({ dataDir, bridgeHomeDir: eventsHome }), moduleBridge: new ModuleBridge({ terminalUrl: offlineUrl, engineUrl: offlineUrl, eventBridgeUrl: offlineUrl, vectorHubUrl: offlineUrl }) });
+  await initializeRuntime(runtime);
+  const server = http.createServer(createRequestHandler(runtime, { integrationOptions: { homeDir, env: {}, commandResolver: () => '' } }));
+  await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+  const base = `http://127.0.0.1:${server.address().port}`;
+  let browser;
+  try {
+    browser = await launchCdpBrowser({ chrome: findChrome(), profileDir: path.join(temp, 'browser'), url: base, width: 1920, height: 1080 });
+    await browser.setViewport(1920, 1080);
+    const run = expression => browser.evaluate(expression);
+    const click = selector => run(`document.querySelector(${JSON.stringify(selector)}).click()`);
+    await click('#openSystem');
+    await waitFor(() => run("document.querySelectorAll('#agentCaptureList .agent-capture-row').length === 4"), 'four capture statuses');
+    // Single-switch rows: claude undetected -> disabled switch; zcode configured -> enabled, badge 未接入.
+    assert.equal(await run("document.querySelector('[data-agent-client=claude][data-agent-switch]').disabled"), true);
+    assert.equal(await run("document.querySelector('[data-agent-client=zcode][data-agent-switch]').disabled"), false);
+    await waitFor(() => run("document.querySelector('[data-agent-client=zcode]').closest('.agent-capture-row').textContent.includes('未接入')"), 'zcode badge settles to disconnected');
+    assert(await run("document.getElementById('agentCaptureList').textContent.includes('检测到配置')"));
+    assert.equal(await run("document.querySelector('[data-agent-client=zcode]').closest('.agent-capture-row').querySelector('details.agent-detail').open"), false, 'details must be collapsed by default');
+    assert.equal(await run("document.getElementById('refreshAgentCapture')"), null, 'manual status button removed');
+    // Switch ON: full install (knowledge + capture), real config written.
+    await click('[data-agent-client=zcode][data-agent-switch=install]');
+    await waitFor(() => run("document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') !== null"), 'connected status reloaded from backend');
+    assert(await run("document.querySelector('[data-agent-client=zcode]').closest('.agent-capture-row').textContent.includes('已接入')"));
+    const config = JSON.parse(fs.readFileSync(configFile));
+    assert.equal(config.hooks.enabled, true);
+    const intent = JSON.parse(fs.readFileSync(intentFile));
+    assert.equal(intent.clients.zcode, 'connected', 'successful install records intent');
+    const env = { ...process.env }; delete env.AI_CODING_EVENT_BRIDGE_HOME; delete env.AI_CODING_EVENT_BRIDGE_CAPTURE;
+    // Full install wires every UserPromptSubmit hook (context pre-read first,
+    // capture second) — run them all like the real client does.
+    for (const hook of config.hooks.events.UserPromptSubmit.flatMap(entry => entry.hooks)) {
+      const child = spawnSync(process.execPath, hook.args, { env, input: JSON.stringify({ hook_event_name: 'UserPromptSubmit', session_id: 'ui-zcode-session', cwd: temp, prompt: '从网页接入后写入真实 journal' }), encoding: 'utf8', timeout: 15000 });
+      assert.equal(child.status, 0, child.stderr);
+    }
+    const events = await new Journal(path.join(eventsHome, 'journal')).readEvents({});
+    assert.equal(events.length, 1); assert.equal(events[0].source, 'zcode');
+    assert.equal(await run('document.documentElement.scrollWidth > innerWidth'), false);
+    const artifacts = path.resolve(process.env.KB_CAPTURE_TEST_ARTIFACTS || path.join(__dirname, '../..', '.agent-state/acceptance/agent-capture'));
+    await browser.screenshot(path.join(artifacts, '1920-light.png'));
+    await click('#closeSystem'); await click('#themeToggle'); await click('#openSystem');
+    await waitFor(() => run("document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') !== null"), 'theme retains capture status');
+    await browser.screenshot(path.join(artifacts, '1920-dark.png'));
+    // Broken config: the single switch acts as the explicit repair path.
+    fs.writeFileSync(configFile, '{invalid JSON');
+    await click('#closeSystem'); await click('#openSystem');
+    await waitFor(() => run("(() => { const b = document.querySelector('[data-agent-client=zcode][data-agent-switch=install]'); return b !== null && !b.disabled; })()"), 'capture row settled before invalid config');
+    await click('[data-agent-client=zcode][data-agent-switch=install]');
+    await waitFor(() => run("document.getElementById('agentCaptureFeedback').textContent.includes('操作未完成')"), 'partial failure rendered');
+    assert(await run("document.getElementById('agentCaptureFeedback').classList.contains('issue')"));
+    const logs = (await (await fetch(base + '/api/logs?event=integration.capture.failed')).json()).entries;
+    assert(logs.length > 0 && logs[0].error.message.includes('valid JSON'));
+    fs.writeFileSync(configFile, JSON.stringify(config));
+    await click('#closeSystem'); await click('#openSystem');
+    await waitFor(() => run("document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') !== null"), 'switch repair succeeds');
+    // Switch OFF: removal keeps third-party config and prior evidence.
+    await click('[data-agent-client=zcode][data-agent-switch=uninstall]');
+    await waitFor(() => run("!document.querySelector('[data-agent-client=zcode][data-agent-switch]').disabled && document.querySelector('[data-agent-client=zcode][data-agent-switch=uninstall]') === null"), 'removed capture status');
+    assert.equal(JSON.parse(fs.readFileSync(configFile)).provider.name, 'retain');
+    assert.equal(JSON.parse(fs.readFileSync(intentFile)).clients.zcode, 'disconnected', 'uninstall records disconnected intent');
+    assert.equal((await new Journal(path.join(eventsHome, 'journal')).readEvents({})).length, 1, 'removal retains prior evidence');
+    assert.equal(browser.exceptions.length, 0, JSON.stringify(browser.exceptions));
+    console.log(`agent-capture-ui-test PASS (1920x1080; single-switch install/repair/Hook/journal/error logs/intent/removal/light+dark; core=${coreRoot})`);
+  } finally {
+    runtime.integrationStatusScan?.close();
+    await browser?.close(); server.closeAllConnections(); await new Promise(resolve => server.close(resolve));
+    offline.closeAllConnections(); await new Promise(resolve => offline.close(resolve)); await runtime.logger.close();
+    assert.equal(path.dirname(temp), path.resolve(os.tmpdir())); assert.ok(path.basename(temp).startsWith('kb-agent-capture-ui-'));
+    await fs.promises.rm(temp, { recursive: true, force: true, maxRetries: 12, retryDelay: 200 });
+  }
+}
+main().catch(error => { console.error(error.stack); process.exitCode = 1; });