@sanqianx/claude-ai-workbench 0.12.0 → 0.13.1

package/README.md

@@ -4,6 +4,16 @@
 
 0.3.0 起，仓库同时提供 **Agent Terminal**：一个通用多 Agent 对话终端（Claude Code / Codex / OpenCode / ZCode），带多项目工作区、自定义模型供应商管理、Agent 发现与能力矩阵、推理力度与上下文用量显示。
 
+## 作为智脑产品的嵌入模块
+
+外壳使用真实 Agent Terminal 页面和 REST/SSE，不重新实现消息流。`embed=1` 与可配置 `apiBase` 隐藏重复品牌/项目管理，并接受同源父窗口的项目、主题与知识范围消息；独立产品行为保持不变。
+
+受信任本地外壳通过 `KB_WORKBENCH_RUNTIME_TOKEN`、`KB_EVENT_BRIDGE_URL` 和引擎地址连接后台服务。原生工作台捕获原始用户输入及成功最终回答，通过持久化 outbox 投递到 bridge 的鉴权入口；不捕获系统提示词、注入的知识、工具输出或供应商凭据。`/api/health` 中 `conversationCapture` 展示启用状态、待投递数和错误；已有用户显式关闭的捕获设置不会被覆盖。桥接不可用时保留待投递记录，恢复或重启后继续，不伪造会话。
+
+工作台是产品供应商与凭据的活动配置源。后台维护默认模型持久化，不随会话临时模型切换；解析后的凭据只交给鉴权本地服务，不进入浏览器消息。SDK 会话从当前项目登记的工作区恢复，也兼容旧登记文件。
+
+Windows 上 Claude Code 探测与实际启动使用同一解析结果：失效的 `CLAUDE_CODE_EXECPATH` 不遮住有效安装，npm/CMD/PowerShell 启动脚本解析成实际文件，JavaScript 入口用当前 Node 探测版本。`/system/doctor` 返回实际启动路径、被跳过的失效路径及版本探测错误。发现和会话失败使用 `log/v2`；受外壳守护时写入外壳统一诊断，独立运行保存在工作台数据目录的 `diagnostics.jsonl`，不记录凭据或原始提示词。
+
 ## 仓库结构
 
 - `packages/`：可发布的 SDK 源码。

package/apps/agent-terminal/app.css

@@ -565,3 +565,37 @@ body.light .msg.ai.error { color:#b42318; border-color:rgba(180,35,24,.25); back
 
 /* ===== embed 模式（被知识库壳嵌入）：折叠左侧项目栏，由壳 postMessage 控制 ===== */
 body.embed-collapse .sidebar { display: none; }
+
+/* Embedded product tokens are owned by the shell; standalone styling stays. */
+body.kb-embedded.light {
+  --page:#ffffff; --side:#f8f9fb; --surface:#f3f5f7; --surface2:#edf1f4;
+  --line:#dce2e8; --line2:#dce2e8; --pop:#ffffff;
+  --text:#202733; --muted:#687587; --faint:#8e99a7;
+  --good:#397761; --bad:#a05252; --blue:#516f89; --blue-soft:#e6edf3;
+  --code-bg:#f3f5f7; --code-line:#dce2e8;
+}
+body.kb-embedded:not(.light) {
+  --page:#20252d; --side:#1b2028; --surface:#252b34; --surface2:#2c333e;
+  --line:#39424f; --line2:#39424f; --pop:#252b34;
+  --text:#e6ebf0; --muted:#a0aaba; --faint:#788393; --blue:#8aa8cf; --blue-soft:#293748;
+  --good:#81b29a; --bad:#d88b8b; --code-bg:#252b34; --code-line:#39424f;
+}
+body.kb-embedded { --accent:var(--blue); --accent-soft:var(--blue-soft); }
+body.kb-embedded .agent-badge { background:var(--blue); }
+body.kb-embedded .sidebar { display:flex; width:208px; min-width:208px; border-right:1px solid var(--line); }
+body.kb-embedded .brand, body.kb-embedded .group-label, body.kb-embedded .add-proj,
+body.kb-embedded .proj-item .row-acts, body.kb-embedded .sidebar-foot, body.kb-embedded #btn-top-settings { display:none; }
+body.kb-embedded .new-session { margin:16px 16px 8px; }
+body.kb-embedded .hint-spark, body.kb-embedded .hint-art { display:none; }
+body.kb-embedded .empty-hint .big { display:none; }
+.embedded-hint { display:none; }
+body.kb-embedded .standalone-hint { display:none; }
+body.kb-embedded .embedded-hint { display:block; }
+body.kb-embedded .cmdrow { min-width:0; }
+body.kb-embedded .cmdrow > .bar-btn, body.kb-embedded .send { flex-shrink:0; }
+body.kb-embedded .cmdrow > .anchor { flex:0 0 auto; }
+body.kb-embedded .cmdrow > .model-anchor { flex:0 1 auto; min-width:0; }
+body.kb-embedded #btn-model { min-width:0; max-width:100%; }
+body.kb-embedded #model-label { display:block; min-width:0; max-width:100%; }
+body.kb-embedded #btn-ctx .ctx-mini { display:none; }
+body.kb-embedded .ctx-mini i { background:var(--blue); }

package/apps/agent-terminal/app.js

@@ -1,8 +1,52 @@
 /* Agent Terminal — full-page UI over the versioned REST/SSE API. */
 'use strict';
 
+const embedParams = new URLSearchParams(location.search);
+const embedded = embedParams.get('embed') === '1';
+const configuredApiBase = embedParams.get('apiBase');
+const apiBase = configuredApiBase && /^\/api\/[a-z0-9/-]+$/i.test(configuredApiBase) ? configuredApiBase.replace(/\/$/, '') : '/api/claude-workbench/v1';
+let selectionEpoch = 0;
+let sessionEpoch = 0;
+let sessionCreationEpoch = 0;
+const projectDrafts = new Map();
+function savedProjectDraft(projectId, text) {
+  try {
+    const key = `kb.workbench.drafts:${apiBase}`;
+    const drafts = JSON.parse(localStorage.getItem(key) || '{}');
+    if (text !== undefined) {
+      delete drafts[projectId];
+      if (text) drafts[projectId] = String(text).slice(0, 100000);
+      localStorage.setItem(key, JSON.stringify(Object.fromEntries(Object.entries(drafts).slice(-20))));
+    }
+    return typeof drafts[projectId] === 'string' ? drafts[projectId] : '';
+  } catch { return ''; }
+}
+function rememberProjectDraft(projectId, draft) {
+  if (!projectId) return;
+  projectDrafts.set(projectId, draft);
+  savedProjectDraft(projectId, draft.text || '');
+}
+function savedProjectSession(projectId, sessionId) {
+  try {
+    const key = `kb.workbench.sessions:${apiBase}`;
+    const saved = JSON.parse(localStorage.getItem(key) || '{}');
+    if (sessionId !== undefined) {
+      if (sessionId) saved[projectId] = sessionId; else delete saved[projectId];
+      localStorage.setItem(key, JSON.stringify(saved));
+    }
+    return typeof saved[projectId] === 'string' ? saved[projectId] : null;
+  } catch { return null; }
+}
+function forgetSessionSelection(sessionId) {
+  for (const project of state.projects) {
+    if (savedProjectSession(project.id) === sessionId) savedProjectSession(project.id, null);
+    const draft = projectDrafts.get(project.id);
+    if (draft?.sessionId === sessionId) projectDrafts.set(project.id, { ...draft, sessionId: null });
+  }
+}
+
 const client = window.createClaudeWorkbenchClient
-  ? window.createClaudeWorkbenchClient({ apiBase: '/api/claude-workbench/v1' })
+  ? window.createClaudeWorkbenchClient({ apiBase })
   : null;
 
 const PERMISSION_LABELS = { default: '默认防护', acceptEdits: '接受编辑', plan: '计划模式', bypassPermissions: '完全访问' };
@@ -76,7 +120,7 @@ function applyPreferences(values) {
 
 async function loadPreferences() {
   try {
-    const response = await fetch('/api/claude-workbench/v1/ui-preferences');
+    const response = await fetch(`${apiBase}/ui-preferences`);
     if (!response.ok) return;
     const body = await response.json();
     savedPreferences = { ...(body && body.values || {}) };
@@ -91,7 +135,7 @@ function savePreferences(partial) {
   clearTimeout(prefsSaveTimer);
   prefsSaveTimer = setTimeout(() => {
     if (typeof fetch !== 'function') return; // non-browser harness (unit tests)
-    fetch('/api/claude-workbench/v1/ui-preferences', {
+    fetch(`${apiBase}/ui-preferences`, {
       method: 'PUT',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(partial),
@@ -110,14 +154,13 @@ async function init() {
   await Promise.all([refreshAgents(), refreshProfiles()]);
   await loadPreferences();
   await refreshProjects();
-  // 首个 kb:ready 在项目清单就绪前就已发出（上方 health/agents/profiles 都要
-  // 先跑完），壳届时下发的 kb:select-project 会扑空。清单就绪后再广播一次，
-  // 让壳重新选中项目，避免嵌入态卡在"未登记/无项目可选"。
-  if (window.parent !== window) window.parent.postMessage({ type: 'kb:ready', app: 'agent-terminal' }, '*');
   wireChrome();
   wireComposer();
   wireSettings();
   wireProjectModal();
+  // Ready is the usable-page boundary: the host may immediately select a
+  // project or open settings, so data and handlers must both be available.
+  if (window.parent !== window) window.parent.postMessage({ type: 'kb:ready', app: 'agent-terminal' }, '*');
 }
 
 /* ===================== agents & capabilities ===================== */
@@ -404,6 +447,7 @@ async function renderProjectListOnce() {
     return;
   }
   for (const project of state.projects) {
+    if (embedded && project.id !== state.activeProjectId) continue;
     const proj = el('div', 'proj' + (state.activeProjectId === project.id ? ' active' : ''));
     proj.dataset.project = project.id;
     const head = el('button', 'proj-item');
@@ -482,6 +526,7 @@ function sessionRow(summary, projectId) {
     ev.stopPropagation();
     try {
       await client.archiveSession(summary.sessionId);
+      forgetSessionSelection(summary.sessionId);
       if (state.activeSessionId === summary.sessionId) detachSession();
       await renderProjectList();
     } catch (error) { toast(error.message, true); }
@@ -499,6 +544,7 @@ async function renderArchived() {
   list.textContent = '';
   const rows = [];
   for (const project of state.projects) {
+    if (embedded && project.id !== state.activeProjectId) continue;
     let archived = [];
     try { archived = await client.listSessions(project.id, { archived: true }); } catch { archived = []; }
     for (const summary of archived) {
@@ -547,11 +593,13 @@ function shortWhen(iso) {
 
 async function newSession() {
   if (!state.activeProjectId) { openProjectModal(); return; }
+  const projectId = state.activeProjectId, epoch = selectionEpoch, creation = ++sessionCreationEpoch;
   try {
     const summary = await client.startSession(
       { contextId: state.activeProjectId, workspaceRef: state.activeProjectId, aiProfileId: state.currentProfileId, displayName: (state.projects.find(p => p.id === state.activeProjectId) || {}).name },
       { agentId: state.currentAgent, model: state.currentProfileId === undefined ? undefined : state.currentModel || undefined, permissionMode: state.permissionMode, effort: state.caps && state.caps.generationParams.includes('effort') ? state.effort : undefined },
     );
+    if (epoch !== selectionEpoch || state.activeProjectId !== projectId || creation !== sessionCreationEpoch) { const draft = projectDrafts.get(projectId) || {}; if (!draft.sessionId) projectDrafts.set(projectId, { ...draft, sessionId: summary.sessionId }); return; }
     if (state.activeSessionId === summary.sessionId) return;
     state.sessionTitles.set(summary.sessionId, '新会话');
     await openSession(summary.sessionId, { preserveAttachments: true });
@@ -561,14 +609,18 @@ async function newSession() {
 }
 
 async function openSession(sessionId, options = {}) {
+  sessionCreationEpoch++;
   detachSession(options);
+  const epoch = sessionEpoch;
   state.activeSessionId = sessionId;
   resetStream();
   let snapshot;
-  try { snapshot = await client.loadSession(sessionId); } catch (error) { state.activeSessionId = null; toast(error.message, true); return; }
+  try { snapshot = await client.loadSession(sessionId); } catch (error) { if (epoch !== sessionEpoch) return; state.activeSessionId = null; if (error.status === 404) forgetSessionSelection(sessionId); toast(error.message, true); return; }
+  if (epoch !== sessionEpoch || state.activeSessionId !== sessionId) return;
   const summary = snapshot.session;
   state.sessionSummary = summary;
   state.activeProjectId = summary.contextId || state.activeProjectId;
+  if (state.activeProjectId) savedProjectSession(state.activeProjectId, sessionId);
   state.currentAgent = summary.agentId || 'claude-code';
   state.currentProfileId = summary.aiProfileId || null;
   state.currentModel = summary.selectedModel || summary.model || null;
@@ -586,12 +638,24 @@ async function openSession(sessionId, options = {}) {
     for (const event of snapshot.events || []) { renderEvent(event); last = Math.max(last, event.sequence || 0); }
   } finally { state.replaying = false; }
   rememberTitleFromEvents(snapshot.events || []);
-  state.unsub = client.subscribe(sessionId, event => renderEvent(event), () => {}, { afterSequence: last });
+  state.unsub = client.subscribe(sessionId, event => { if (epoch === sessionEpoch && state.activeSessionId === sessionId) renderEvent(event); }, () => {}, { afterSequence: last });
   await renderProjectList();
   refreshContextUsage();
+  if (embedded) {
+    try {
+      const response = await fetch(`${apiBase}/sessions/${encodeURIComponent(sessionId)}/knowledge`);
+      const knowledge = response.ok ? await response.json() : null;
+      if (epoch === sessionEpoch && state.activeSessionId === sessionId && knowledge) publishKnowledge(summary.contextId, sessionId, knowledge);
+    } catch { /* The native conversation remains usable if knowledge is offline. */ }
+  }
+}
+
+function publishKnowledge(projectId, sessionId, knowledge) {
+  if (embedded) window.parent.postMessage({ type: 'kb:knowledge', app: 'agent-terminal', projectId, sessionId, knowledge }, document.referrer ? new URL(document.referrer).origin : location.origin);
 }
 
 function detachSession(options = {}) {
+  sessionEpoch++;
   if (state.unsub) { try { state.unsub(); } catch {} state.unsub = null; }
   state.activeSessionId = null;
   state.sessionSummary = null;
@@ -1014,7 +1078,7 @@ function renderEvent(event) {
           setMarkdown(body, String(event.result));
         }
         const lastMsg = [...col.children].reverse().find(node => node.classList && node.classList.contains('ai'));
-        if (lastMsg) lastMsg.append(msgFooter(String(event.result || lastMsg.textContent), lastPrompt, { model: turnModel }));
+        if (lastMsg) lastMsg.append(msgFooter(String(event.result || lastMsg.textContent), lastPrompt, { model: turnModel, at: event.at }));
         if (turnChanges && turnChanges.size) col.append(renderTurnDiffs(turnChanges));
       }
       setBusyState('idle');
@@ -1218,7 +1282,8 @@ function msgFooter(text, lastPrompt, options = {}) {
   const bits = [];
   if (options.model) bits.push(options.model);
   if (options.interrupted) bits.push('已中断');
-  bits.push(new Date().toTimeString().slice(0, 5));
+  const timestamp = options.at ? new Date(options.at) : state.replaying ? null : new Date();
+  if (timestamp && !Number.isNaN(timestamp.getTime())) bits.push(timestamp.toTimeString().slice(0, 5));
   row.append(el('span', 'foot-time', bits.join(' · ')));
   return row;
 }
@@ -1522,9 +1587,10 @@ function setBusyState(sessionState) {
 
 async function refreshContextUsage() {
   if (!state.activeSessionId) return;
+  const sessionId = state.activeSessionId, epoch = sessionEpoch;
   try {
-    const usage = await fetch(`/api/claude-workbench/v1/sessions/${encodeURIComponent(state.activeSessionId)}/context-usage`).then(r => (r.ok ? r.json() : null));
-    if (!usage) return;
+    const usage = await fetch(`${apiBase}/sessions/${encodeURIComponent(sessionId)}/context-usage`).then(r => (r.ok ? r.json() : null));
+    if (!usage || epoch !== sessionEpoch || state.activeSessionId !== sessionId) return;
     $('btn-ctx').hidden = false;
     $('btn-ctx').title = usage.percent != null ? `上下文用量 ${usage.percent}%` : '上下文用量';
     $('ctx-label').textContent = `${fmtTokens(usage.used)} / ${fmtTokens(usage.contextWindow)}`;
@@ -1565,6 +1631,7 @@ function wireComposer() {
   input.addEventListener('input', () => {
     input.style.height = 'auto';
     input.style.height = `${Math.min(150, input.scrollHeight)}px`;
+    if (embedded && state.activeProjectId) rememberProjectDraft(state.activeProjectId, { text: input.value, attachments: [...state.attachments], sessionId: state.activeSessionId });
   });
   input.addEventListener('keydown', event => {
     if (event.key === 'Enter' && !event.shiftKey) { event.preventDefault(); sendCurrent(); }
@@ -1655,26 +1722,37 @@ async function sendCurrent() {
   const text = input.value.trim();
   if (!text && !state.attachments.length) return;
   state.sending = true;
-  if (!state.activeSessionId) { await newSession(); if (!state.activeSessionId) { state.sending = false; return; } }
+  const originProjectId = state.activeProjectId, originEpoch = selectionEpoch;
+  if (!state.activeSessionId) { await newSession(); if (!state.activeSessionId || state.activeProjectId !== originProjectId || selectionEpoch !== originEpoch) { state.sending = false; return; } }
   input.value = '';
   input.style.height = 'auto';
   const attachments = state.attachments.splice(0);
   renderAttachmentTray();
+  const sentSessionId = state.activeSessionId, sentProjectId = state.activeProjectId;
+  rememberProjectDraft(sentProjectId, { text: '', attachments: [], sessionId: sentSessionId });
   try {
-    await client.send({
+    const accepted = await client.send({
       sessionId: state.activeSessionId,
       text,
       attachments: attachments.map(item => ({ name: item.name, mediaType: item.mediaType, data: item.data })),
       // Effort rides on every message so mid-session switches take effect.
       options: { effort: state.caps && state.caps.generationParams.includes('effort') ? state.effort : undefined },
     });
-    setBusyState('running');
+    if (accepted?.knowledge && state.activeSessionId === sentSessionId) publishKnowledge(sentProjectId, sentSessionId, accepted.knowledge);
+    if (state.activeSessionId !== sentSessionId) return;
+    setBusyState(accepted?.state || 'running');
     state.follow = true; // sending a message re-engages follow mode
   } catch (error) {
+    if (state.activeProjectId !== sentProjectId || state.activeSessionId !== sentSessionId) {
+      const draft = projectDrafts.get(sentProjectId) || {};
+      rememberProjectDraft(sentProjectId, { ...draft, text: draft.text || text, attachments: [...attachments, ...(draft.attachments || [])], sessionId: sentSessionId });
+      return;
+    }
     toast(error.message, true);
     input.value = text;
     state.attachments.unshift(...attachments);
     renderAttachmentTray();
+    rememberProjectDraft(sentProjectId, { text, attachments: [...state.attachments], sessionId: sentSessionId });
   } finally {
     state.sending = false;
   }
@@ -1770,7 +1848,7 @@ function wireSettings() {
 
 /* ===================== 会话捕获（终端对话是否留档） ===================== */
 
-const CAPTURE_API = '/api/claude-workbench/v1/capture-settings';
+const CAPTURE_API = `${apiBase}/capture-settings`;
 
 function renderCaptureNote(text, bad) {
   const note = $('capture-note');
@@ -2145,7 +2223,7 @@ function wireProjectModal() {
   };
 
   let pickingProject = false;
-  const pickerUrl = () => '/api/claude-workbench/v1/system/pick-folder';
+  const pickerUrl = () => `${apiBase}/system/pick-folder`;
   const addProjectViaPicker = async () => {
     if (pickingProject) return;
     pickingProject = true;
@@ -2278,10 +2356,8 @@ function wireChrome() {
  *   kb:sessions / kb:session / kb:archived / kb:removed-project（各操作回执）。
  * URL 参数：?embed=1 进入嵌入态（默认折叠项目栏，sidebar=1 保持展开），project= 预选。 */
 function embedAllowedOrigin(origin) {
-  if (origin === 'null') return true; // file:// 壳
   try {
-    const u = new URL(origin);
-    return u.hostname === 'localhost' || u.hostname === '127.0.0.1' || u.hostname === '[::1]';
+    return origin === (document.referrer ? new URL(document.referrer).origin : location.origin);
   } catch { return false; }
 }
 function setEmbedSidebarVisible(visible) {
@@ -2296,6 +2372,7 @@ function embedSelectProject(ref) {
   const project = embedFindProject(ref);
   if (!project) return false;
   if (state.activeProjectId !== project.id) {
+    if (state.activeProjectId) rememberProjectDraft(state.activeProjectId, { text: $('chat-input').value, attachments: [...state.attachments], sessionId: state.activeSessionId });
     detachSession();
     resetStream();
     setBusyState('idle');
@@ -2306,18 +2383,33 @@ function embedSelectProject(ref) {
     $('session-title').textContent = '新会话';
     applyCapabilityGates();
     renderModelLabel();
+    const draft = projectDrafts.get(project.id) || { text: savedProjectDraft(project.id), sessionId: savedProjectSession(project.id) };
+    $('chat-input').value = draft?.text || '';
+    state.attachments = draft?.attachments || [];
+    renderAttachmentTray();
+    if (draft?.sessionId) openSession(draft.sessionId, { preserveAttachments: true });
+    else publishKnowledge(project.id, null, { status: 'not-retrieved', references: [] });
+  }
+  if (!state.activeSessionId) {
+    const sessionId = projectDrafts.get(project.id)?.sessionId || savedProjectSession(project.id);
+    if (sessionId) openSession(sessionId, { preserveAttachments: true });
   }
   state.expanded.add(project.id);
   renderProjectList();
   return true;
 }
 window.addEventListener('message', async ev => {
-  if (!embedAllowedOrigin(ev.origin)) return;
+  if (ev.source !== window.parent || !embedAllowedOrigin(ev.origin)) return;
   const data = ev.data;
   if (!data || typeof data !== 'object') return;
-  const reply = payload => { if (ev.source) ev.source.postMessage(Object.assign({ app: 'agent-terminal' }, payload), '*'); };
+  const reply = payload => { if (ev.source) ev.source.postMessage(Object.assign({ app: 'agent-terminal', requestId: data.requestId }, payload), ev.origin); };
+  if (data.type === 'kb:theme') { document.body.classList.toggle('light', data.theme !== 'dark'); document.body.dataset.kbTheme = data.theme === 'dark' ? 'dark' : 'light'; reply({ type: 'kb:configured', theme: document.body.dataset.kbTheme }); return; }
+  if (data.type === 'kb:open-settings') { openSettings('providers'); return; }
   if (data.type === 'kb:sidebar') setEmbedSidebarVisible(!!data.visible);
   else if (data.type === 'kb:select-project') {
+    const epoch = ++selectionEpoch;
+    if (!embedFindProject(data.project)) await refreshProjects();
+    if (epoch !== selectionEpoch) return;
     reply({ type: 'kb:projects', ok: embedSelectProject(data.project), activeProjectId: state.activeProjectId,
       projects: state.projects.map(p => ({ id: p.id, name: p.name, rootPath: p.rootPath })) });
   } else if (data.type === 'kb:list-sessions') {
@@ -2345,6 +2437,7 @@ window.addEventListener('message', async ev => {
     const sessionId = String(data.sessionId || '');
     try {
       await client.archiveSession(sessionId);
+      forgetSessionSelection(sessionId);
       if (state.activeSessionId === sessionId) detachSession();
       await renderProjectList();
       reply({ type: 'kb:archived', ok: true, sessionId });
@@ -2370,14 +2463,16 @@ window.addEventListener('message', async ev => {
 function embedInit() {
   const q = new URLSearchParams(location.search);
   if (q.get('embed') === '1') {
-    setEmbedSidebarVisible(q.get('sidebar') !== '1');
+    document.body.classList.add('kb-embedded');
+    document.body.classList.toggle('light', q.get('theme') !== 'dark');
+    document.body.dataset.kbTheme = q.get('theme') === 'dark' ? 'dark' : 'light';
+    setEmbedSidebarVisible(true);
     const preset = q.get('project');
     if (preset) {
       const trySelect = () => { if (!embedSelectProject(preset)) setTimeout(trySelect, 500); };
       setTimeout(trySelect, 0);
     }
   }
-  if (window.parent !== window) window.parent.postMessage({ type: 'kb:ready', app: 'agent-terminal' }, '*');
 }
 embedInit();
 // 主区顶栏常驻设置入口（嵌入折叠侧栏后仍可达；与模型弹层内「管理模型」同目标）

package/apps/agent-terminal/index.html

@@ -44,8 +44,9 @@
       <div class="col" id="stream-col">
         <div class="empty-hint" id="empty-hint">
           <div class="big"><span class="hint-wrap"><span class="hint-art"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="m5 8 4 4-4 4"/><path d="M13 16h6"/></svg></span><span class="hint-spark"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3l1.9 5.8L20 12l-6.1 3.2L12 21l-1.9-5.8L4 12l6.1-3.2z"/></svg></span></span></div>
-          <p>从左侧选择一个项目,或 <button class="linklike" id="hint-add-proj">添加项目</button> 开始。<br>
+          <p class="standalone-hint">从左侧选择一个项目,或 <button class="linklike" id="hint-add-proj">添加项目</button> 开始。<br>
           新会话将使用底部选中的 Agent 与模型。</p>
+          <p class="embedded-hint">输入当前项目的任务，开始新会话。<br>相关知识会在发送前检索，并在右侧显示来源。</p>
         </div>
       </div>
     </div>
@@ -67,7 +68,7 @@
             <button class="bar-btn" id="btn-ctx" title="上下文用量" hidden><span id="ctx-label"></span></button>
             <div class="pop from-right ctx-pop" id="pop-ctx" hidden></div>
           </span>
-          <span class="anchor">
+          <span class="anchor model-anchor">
             <button class="bar-btn" id="btn-model" title="选择供应商与模型"><span id="model-label">Agent 自身登录 · 默认模型</span> <span class="chev"><svg class="ics" viewBox="0 0 24 24" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span></button>
             <div class="pop from-right" id="pop-model" hidden></div>
           </span>
@@ -152,7 +153,7 @@
 
 <div class="toast-host" id="toast" aria-live="polite"></div>
 
-<script src="/packages/client/index.js"></script>
+<script src="../packages/client/index.js"></script>
 <script src="./app.js"></script>
 </body>
 </html>

package/docs/sdk/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Claude AI Workbench API
-  version: 0.12.0
+  version: 0.13.1
   description: Versioned local API for AI Profile, credential and Claude Code session management.
 servers:
   - url: http://127.0.0.1:5760/api/claude-workbench/v1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanqianx/claude-ai-workbench",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Shared Claude Code terminal and Anthropic-compatible AI profile modules for local developer tools.",
   "type": "commonjs",
   "main": "src/index.js",

package/packages/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-ai-workbench/client",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "type": "commonjs",
   "main": "index.js",
   "browser": "index.js",
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@claude-ai-workbench/contracts": "0.12.0"
+    "@claude-ai-workbench/contracts": "0.13.1"
   },
   "engines": {
     "node": ">=18"

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-ai-workbench/contracts",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "type": "commonjs",
   "main": "index.js",
   "types": "index.d.ts",

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-ai-workbench/core",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "type": "commonjs",
   "main": "index.js",
   "browser": "index.js",
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@claude-ai-workbench/contracts": "0.12.0"
+    "@claude-ai-workbench/contracts": "0.13.1"
   },
   "engines": {
     "node": ">=18"

package/packages/server/bin/agent-terminal-server.js

@@ -25,12 +25,17 @@ app.server.listen(port, host, () => {
   // Compile the folder-picker helper up front so the first "browse…" click
   // pops the dialog in milliseconds instead of paying the powershell +
   // Add-Type startup. Never blocks or crashes the server.
-  warmFolderPicker({ title: '选择项目文件夹' }).catch(() => {});
+  if (process.env.KB_WORKBENCH_DISABLE_PICKER !== '1') warmFolderPicker({ title: '选择项目文件夹' }).catch(() => {});
 });
 
+let stopping = false;
 function shutdown() {
+  if (stopping) return; stopping = true;
+  app.service.destroy();
+  app.server.closeAllConnections?.();
   app.server.close(() => process.exit(0));
   setTimeout(() => process.exit(0), 3000).unref();
 }
 process.on('SIGINT', shutdown);
 process.on('SIGTERM', shutdown);
+process.on('message', message => { if (message?.type === 'kb:shutdown') shutdown(); });

package/packages/server/index.js

@@ -15,7 +15,8 @@ const { AttachmentStore } = require('./lib/attachment-store');
 const { ProjectStore } = require('./lib/project-store');
 const { SessionArchiveStore } = require('./lib/session-archive-store');
 const { AgentRegistry } = require('./lib/agent-registry');
-const { createAgentDiscovery, probeExecutableVersion } = require('./lib/agent-discovery');
+const { createAgentDiscovery, probeExecutable } = require('./lib/agent-discovery');
+const { createDiagnostics } = require('./lib/diagnostics');
 const { createSystemDoctor } = require('./lib/system-doctor');
 const { createModelDetection } = require('./lib/model-detection');
 const { createCodexDriver } = require('./lib/drivers/codex-driver');
@@ -38,7 +39,10 @@ function createWorkbenchServer(options = {}) {
     ...projects.toWorkspaceMap(),
   };
   const profiles = options.profiles || new ProfileStore({ dataDir });
-  const captureSettings = options.captureSettings || new CaptureSettingsStore({ dataDir });
+  const bridgeUrl = options.bridgeUrl || process.env.KB_EVENT_BRIDGE_URL;
+  const runtimeToken = options.runtimeToken || process.env.KB_WORKBENCH_RUNTIME_TOKEN;
+  const conversationCapture = options.conversationCapture || (bridgeUrl && runtimeToken ? new (require('./lib/conversation-capture').ConversationCapture)({ file: path.join(dataDir, 'capture-outbox.v1.json'), bridgeUrl, token: runtimeToken }) : null);
+  const captureSettings = options.captureSettings || new CaptureSettingsStore({ dataDir, defaultConversations: !!conversationCapture });
   const uiPreferences = options.uiPreferences || new UiPreferencesStore({ dataDir });
   const attachments = options.attachments || new AttachmentStore({ root: path.join(dataDir, 'attachments') });
   const contexts = options.contexts || new ContextResolver({ workspaces, createMissing: options.createMissingWorkspaces !== false });
@@ -48,7 +52,9 @@ function createWorkbenchServer(options = {}) {
   // the driver at boot and re-applied on every settings save.
   const applyBridgeCapture = enabled => {
     if (claudeDriver && typeof claudeDriver.setBridgeCaptureConversation === 'function') {
-      claudeDriver.setBridgeCaptureConversation(enabled);
+      // Native capture records the original input, not the augmented SDK
+      // prompt. Suppress inherited CLI hooks to avoid duplicate capture.
+      claudeDriver.setBridgeCaptureConversation(conversationCapture ? false : enabled);
     }
   };
   applyBridgeCapture(captureSettings.read().terminalConversations);
@@ -63,6 +69,7 @@ function createWorkbenchServer(options = {}) {
     },
   });
   const runner = registry.asRunner();
+  const diagnostics = options.logger || createDiagnostics({ dataDir, secrets: () => [...Object.values(profiles._credentials().credentials), process.env.ANTHROPIC_API_KEY, process.env.ANTHROPIC_AUTH_TOKEN] });
   const agentDiscovery = options.agentDiscovery || createAgentDiscovery({
     claudeProbe: () => {
       try {
@@ -72,11 +79,17 @@ function createWorkbenchServer(options = {}) {
         const cmd = typeof executable === 'string'
           ? executable
           : executable && executable.cmd;
-        if (!cmd) return { available: false, version: null };
+        if (!cmd) {
+          const reason = executable?.reason || '未发现可用的 Claude Code 启动文件。';
+          diagnostics.error('agent.discovery.failed', 'Claude Code 不可用。', { phase: 'discovery', error: { code: 'CLAUDE_EXECUTABLE_NOT_FOUND', message: reason }, context: { agent: 'claude-code', rejectedPaths: executable?.rejected || [] } });
+          return { available: false, version: null, reason };
+        }
         // Honest probe: spawn the resolved executable with --version. Same
         // contract as every other agent: no version, no availability claim.
-        const version = probeExecutableVersion(cmd);
-        return { available: version != null, version };
+        const probe = probeExecutable(cmd);
+        if (!probe.available) diagnostics.error('agent.discovery.failed', 'Claude Code 版本探测失败。', { phase: 'version-probe', error: { code: probe.code, message: probe.reason }, context: { agent: 'claude-code', executable: cmd, exitCode: probe.exitCode } });
+        else if (executable.rejected?.length) diagnostics.warn('agent.discovery.recovered', '已跳过失效的 Claude Code 启动路径，使用有效安装。', { phase: 'discovery', context: { executable: cmd, rejectedPaths: executable.rejected } });
+        return probe;
       } catch { return { available: false, version: null }; }
     },
   });
@@ -84,23 +97,31 @@ function createWorkbenchServer(options = {}) {
   const modelDetection = options.modelDetection || createModelDetection({
     contextLookup: modelContextWindows && modelContextWindows.lookupContextWindow,
   });
-  const doctor = options.doctor || createSystemDoctor({
+  const collectDoctor = options.doctor || createSystemDoctor({
     resolveClaudeExecutable: () => {
       try { return claudeDriver.findClaudeExecutableForSdk(); } catch { return { cmd: null }; }
     },
     discoverZCodeCli,
     probeZCodeVersion,
   });
+  const doctor = () => {
+    const report = collectDoctor();
+    const claude = report.agents?.['claude-code'];
+    if (claude && !claude.versionProbe?.ok) diagnostics.error('agent.doctor.failed', 'Claude Code 环境诊断失败。', { phase: 'doctor', error: { code: 'CLAUDE_PROBE_FAILED', message: claude.versionProbe?.error || claude.resolutionReason }, context: { agent: 'claude-code', executable: claude.resolvedExecutable, rejectedPaths: claude.rejectedPaths, exitCode: claude.versionProbe?.exitCode } });
+    return report;
+  };
   const service = options.service || new WorkbenchService({
-    runner, profiles, contexts, attachments, apiPrefix,
+    knowledge: options.knowledge || new (require('./lib/knowledge-context').KnowledgeContext)({ engineUrl: options.engineUrl || process.env.KB_KNOWLEDGE_ENGINE_URL, contextFile: path.join(dataDir, 'knowledge-contexts.v1.json') }),
+    runner, profiles, contexts, attachments, apiPrefix, diagnostics,
     projects, sessionArchive, agentDiscovery, modelContextWindows, modelDetection,
     archiveRetentionDays: options.archiveRetentionDays,
     captureSettings, uiPreferences, onCaptureSettingsSaved: applyBridgeCapture,
+    conversationCapture,
     testWorkspace: path.join(testRoot, 'profile-test'), auditFile: path.join(dataDir, 'audit.jsonl'),
     version: options.version || require('./package.json').version,
     maxSessions: options.maxSessions, maxConcurrentRuns: options.maxConcurrentRuns,
   });
-  const handleApi = createHttpHandler(service, { apiPrefix, corsOrigin: options.corsOrigin, doctor });
+  const handleApi = createHttpHandler(service, { apiPrefix, corsOrigin: options.corsOrigin, doctor, runtimeToken: options.runtimeToken || process.env.KB_WORKBENCH_RUNTIME_TOKEN });
   const distributionRoot = resolveDistributionRoot();
   const staticRoot = path.resolve(options.staticRoot || path.join(distributionRoot, 'apps', 'minimal-test-host'));
   const profileSettingsRoot = path.resolve(options.profileSettingsRoot || path.join(distributionRoot, 'apps', 'ai-profile-settings-host'));