dsh-data-domain-knowledge 0.1.0-alpha.1

package/src/client/IntentTab.tsx

@@ -0,0 +1,715 @@
+/**
+ * 意图 Tab —— 读本插件的 `/intent/overview`、`/intent/store`、`/intent/registry`，
+ * 并**就地编辑**预置的意图分类（issue 0023）。
+ *
+ * 意图记录本身是 per-session、内存内、有 TTL 的审计事实（issues/0012），所以记录区
+ * 只读；分类注册表则是配置，走 `settings.intent` 命名空间写回 DSH，保存后引擎立刻
+ * 按新配置生成路由提示词。
+ *
+ * 0020 把意图的宿主实现并进了本插件（`src/intent/`），但这条 HTTP 边界**必须保留**：
+ * 面板跑在浏览器半、意图引擎跑在宿主半，二者无法直接互相 import。
+ */
+
+import { useCallback, useEffect, useMemo, useState, useSyncExternalStore, type ChangeEvent, type ReactNode } from 'react'
+import {
+  AlertCircle, BarChart3, BrainCircuit, Check, Clock3, Eye, GitBranch, Lightbulb, Pencil, Plus, RefreshCw, RotateCcw, Settings2, ShieldCheck, Trash2, X, Zap,
+} from '@tita-data-agent/ui/icons'
+import { Badge, Button, Card, Input, Label, SelectMenu, Switch, Tabs, TabsContent, TabsList, TabsTrigger, cn } from '@tita-data-agent/ui/components'
+import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from '@tita-data-agent/ui/overlays'
+import { styles } from './styles.ts'
+import { NodeSettingsPanel, type SettingsScopeLike, type SettingsSnapshot } from './NodeSettings.tsx'
+import { IntentLogicTab } from './IntentLogicTab.tsx'
+
+interface IntentRecord {
+  id: string
+  act: string
+  category?: string
+  predicate?: string
+  confidence?: number
+  lowConfidence?: boolean
+  relation: string
+  source: 'model' | 'fallback'
+  userInput: string
+  createdAt: string
+  updatedAt: string
+  lineage: Record<string, string>
+  meta: Record<string, unknown>
+}
+
+interface SessionSummary {
+  sessionKey: string
+  recordCount: number
+  lastAt: string
+  lastAct?: string
+  lastCategory?: string
+  lastRelation?: string
+  lastConfidence?: number
+  activeIntentId?: string
+  activeTaskId?: string
+  tasks?: Array<{ taskId: string; lastSubtaskId?: string; category?: string; ageSeconds: number }>
+}
+
+interface StoreView {
+  sessionKey: string
+  activeTaskId?: string
+  activeIntentId?: string
+  expiresAt?: string
+  tasks: Array<{ taskId: string; lastSubtaskId?: string; category?: string; ageSeconds: number }>
+  recent: IntentRecord[]
+}
+
+/** 一条可编辑的预置意图分类（与宿主 `IntentCategory` 同形）。 */
+interface RegistryCategory {
+  id: string
+  label: string
+  route: string
+  description: string
+  examples: string[]
+  enabled: boolean
+}
+
+/** 一条可编辑的 act（与宿主 `IntentActDef` 同形）。 */
+interface RegistryAct {
+  id: string
+  label: string
+  description: string
+  enabled: boolean
+}
+
+interface Registry { acts: RegistryAct[]; categories: RegistryCategory[]; predicates: string[] }
+
+/** 新增 / 编辑分类的草稿；`examples` 在表单里是「一行一条」。 */
+interface CategoryDraft {
+  open: boolean
+  mode: 'create' | 'edit'
+  id: string
+  label: string
+  route: string
+  description: string
+  examples: string
+}
+
+/** 新增 / 编辑 act 的草稿。 */
+interface ActDraft {
+  open: boolean
+  mode: 'create' | 'edit'
+  id: string
+  label: string
+  description: string
+}
+
+const EMPTY_ACT_DRAFT: ActDraft = { open: false, mode: 'create', id: '', label: '', description: '' }
+
+/** act id 的形状：写进每条记录的稳定标识。 */
+const ACT_ID_PATTERN = /^[a-z][a-z0-9_]{1,40}$/
+
+/** 意图页的三个 tab：记录（只读审计）、配置（注册表）、逻辑（说明）。 */
+type IntentSection = 'records' | 'config' | 'logic'
+
+const EMPTY_CATEGORY_DRAFT: CategoryDraft = { open: false, mode: 'create', id: '', label: '', route: 'query', description: '', examples: '' }
+
+/** 分类 id 的形状：写进 lineage 的稳定标识，小写 + 下划线。 */
+const CATEGORY_ID_PATTERN = /^[a-z][a-z0-9_]{1,40}$/
+
+const UNAVAILABLE_SNAPSHOT: SettingsSnapshot = { status: 'unavailable', writable: false, mode: 'memory' }
+
+async function getJson<T>(url: string): Promise<T> {
+  const response = await fetch(url)
+  const text = await response.text()
+  if (!text.trim()) throw new Error(`服务端返回空响应（HTTP ${response.status}）`)
+  const payload = JSON.parse(text) as { ok?: boolean; data?: T; error?: { message?: string } | null }
+  if (!response.ok || payload.ok === false) throw new Error(payload.error?.message ?? `请求失败（${response.status}）`)
+  if (payload.data === undefined) throw new Error('响应缺少 data')
+  return payload.data
+}
+
+async function postJson<T>(url: string, body: unknown): Promise<T> {
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(body),
+  })
+  const text = await response.text()
+  if (!text.trim()) throw new Error(`服务端返回空响应（HTTP ${response.status}）`)
+  const payload = JSON.parse(text) as { ok?: boolean; data?: T; error?: { message?: string } | null }
+  // 400 也带着 data（当前生效的注册表 + error），所以先看 data 再判状态码 ——
+  // 否则「写被拒」会丢掉「现在生效的是什么」这条最该显示的信息。
+  if (payload.data !== undefined) return payload.data
+  if (!response.ok || payload.ok === false) throw new Error(payload.error?.message ?? `请求失败（${response.status}）`)
+  throw new Error('响应缺少 data')
+}
+
+function formatTime(value: string | undefined): string {
+  if (!value) return '—'
+  const date = new Date(value)
+  if (Number.isNaN(date.getTime())) return '—'
+  return date.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit', second: '2-digit' })
+}
+
+function formatAge(seconds: number): string {
+  if (seconds < 60) return `${seconds}s`
+  if (seconds < 3600) return `${Math.round(seconds / 60)}m`
+  return `${Math.round(seconds / 3600)}h`
+}
+
+const SOURCE_LABEL: Record<IntentRecord['source'], string> = { model: '模型记录', fallback: 'Host 兜底' }
+
+/** `user` 层里存在该字段 = 用户改过，可以「恢复默认」。 */
+function hasOverride(user: unknown, key: string): boolean {
+  return user !== null && typeof user === 'object' && Object.prototype.hasOwnProperty.call(user, key)
+}
+
+/** Top-N 分布：记录本身是流水，这里把流水压成「这段会话主要在干什么」。 */
+function Distribution({ title, rows, tone }: { title: string; rows: Array<[string, number]>; tone?: 'violet' | 'blue' | 'green' }): ReactNode {
+  const max = Math.max(1, ...rows.map(([, count]) => count))
+  const barClass = tone === 'blue' ? styles.distBarFts : tone === 'green' ? styles.distBarGraph : undefined
+  return <div>
+    <h4>{title}</h4>
+    {rows.length === 0
+      ? <p className={styles.kbHint}>还没有记录。</p>
+      : <div className={styles.distList}>
+        {rows.map(([label, count]) => <div className={styles.distRow} key={label}>
+          <span title={label}>{label}</span>
+          <span className={cn(styles.distBar, barClass)}><i style={{ width: `${Math.round((count / max) * 100)}%` }} /></span>
+          <span className={styles.distCount}>{count}</span>
+        </div>)}
+      </div>}
+  </div>
+}
+
+export function IntentTab({ visible, intent }: { visible: boolean; intent?: SettingsScopeLike }): ReactNode {
+  const [section, setSection] = useState<IntentSection>('records')
+  const [sessions, setSessions] = useState<SessionSummary[]>([])
+  const [sessionKey, setSessionKey] = useState('')
+  const [store, setStore] = useState<StoreView | null>(null)
+  const [registry, setRegistry] = useState<Registry | null>(null)
+  /** 真实注入 system prompt 的那段文本：让「预置分类怎么起作用」看得见。 */
+  const [prompt, setPrompt] = useState('')
+  const [loading, setLoading] = useState(false)
+  const [error, setError] = useState<string | null>(null)
+  const [categoryDraft, setCategoryDraft] = useState<CategoryDraft>(EMPTY_CATEGORY_DRAFT)
+  const [actDraft, setActDraft] = useState<ActDraft>(EMPTY_ACT_DRAFT)
+  const [categoryBusy, setCategoryBusy] = useState<string | null>(null)
+  const [categoryNotice, setCategoryNotice] = useState<{ tone: 'success' | 'error'; text: string } | null>(null)
+
+  const snapshot = useSyncExternalStore(
+    listener => intent?.subscribe(listener) ?? (() => undefined),
+    () => intent?.getSnapshot() ?? UNAVAILABLE_SNAPSHOT,
+    () => intent?.getSnapshot() ?? UNAVAILABLE_SNAPSHOT,
+  )
+  /**
+   * 词表能不能编辑。
+   *
+   * **判据是「文件接口能不能写」，不是「设置作用域可不可写」**（0033）：分类与 act
+   * 现在写 `<agentRoot>/intent/registry.json`，与宿主的 settings 文档无关。继续用
+   * `snapshot.writable` 会让「设置服务不可用」连带把词表编辑也锁死 —— 而那两件事
+   * 的可用性本来就没有关系。
+   */
+  const [registryWritable, setRegistryWritable] = useState(true)
+  const canEdit = registryWritable && (Boolean(intent) ? snapshot.status !== 'loading' : true)
+  /**
+   * 「已自定义」的判据来自**服务端**（0033）。
+   *
+   * 原来读 `settings.user.categories` —— 那是「宿主设置文档里有没有用户层覆盖」。
+   * 现在词表的真源是 `<agentRoot>/intent/registry.json`，与 settings 无关，所以
+   * 那个判据会在搬完家之后永远显示「未自定义」，而「恢复出厂」按钮也跟着灰掉。
+   */
+  const [customized, setCustomized] = useState<{ categories: boolean; acts: boolean }>({ categories: false, acts: false })
+  const categoriesCustomized = customized.categories
+  const actsCustomized = customized.acts
+
+  const load = useCallback(async (preferred?: string): Promise<void> => {
+    setLoading(true)
+    try {
+      const [overview, reg] = await Promise.all([
+        getJson<{ sessions: SessionSummary[] }>('/intent/overview'),
+        getJson<{ registry: Registry; prompt: string; customized?: { categories: boolean; acts: boolean }; path?: string }>('/intent/registry'),
+      ])
+      const list = overview.sessions ?? []
+      setSessions(list)
+      setRegistry(reg.registry)
+      setPrompt(reg.prompt ?? '')
+      if (reg.customized) setCustomized(reg.customized)
+      setRegistryWritable(Boolean(reg.path))
+      const key = preferred && list.some(item => item.sessionKey === preferred)
+        ? preferred
+        : list[0]?.sessionKey ?? ''
+      setSessionKey(key)
+      setStore(key ? await getJson<{ store: StoreView }>(`/intent/store?session_key=${encodeURIComponent(key)}`).then(payload => payload.store) : null)
+      setError(null)
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : String(cause))
+    } finally {
+      setLoading(false)
+    }
+  }, [])
+
+  useEffect(() => { if (visible) void load(sessionKey || undefined) }, [visible]) // eslint-disable-line react-hooks/exhaustive-deps
+
+  const selectSession = async (key: string): Promise<void> => {
+    setSessionKey(key)
+    setLoading(true)
+    try {
+      setStore((await getJson<{ store: StoreView }>(`/intent/store?session_key=${encodeURIComponent(key)}`)).store)
+      setError(null)
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : String(cause))
+    } finally {
+      setLoading(false)
+    }
+  }
+
+  // ------------------------------------------------- 预置分类编辑（issue 0023）
+
+  /** 只重读注册表与提示词：编辑分类后用它确认写入是否真的落地。 */
+  const reloadRegistry = useCallback(async (): Promise<Registry | null> => {
+    try {
+      const fresh = await getJson<{ registry: Registry; prompt: string; customized?: { categories: boolean; acts: boolean }; path?: string }>('/intent/registry')
+      setRegistry(fresh.registry)
+      setPrompt(fresh.prompt ?? '')
+      if (fresh.customized) setCustomized(fresh.customized)
+      // 服务端给得出文件路径 = 意图目录已就绪，写就能落地。
+      setRegistryWritable(Boolean(fresh.path))
+      return fresh.registry
+    } catch (cause) {
+      setCategoryNotice({ tone: 'error', text: cause instanceof Error ? cause.message : String(cause) })
+      return null
+    }
+  }, [])
+
+  /**
+   * 写注册表字段（categories / acts），然后**按生效结果**回话。
+   *
+   * 0033 起写的是 `<agentRoot>/intent/registry.json`（POST `/intent/registry`），
+   * 不再走设置作用域 —— 词表是这个 Agent 自己的文件，不是宿主的配置。
+   *
+   * 「写完必须重读比对」这条纪律保留：服务端可能拒绝（schema 不过、目录不可写），
+   * 而**报成功但没生效**比报错更糟。所以这里比对的是重读回来的签名。
+   */
+  const applyRegistry = useCallback(async (
+    field: 'categories' | 'acts',
+    value: Array<{ id: string; enabled: boolean }>,
+    describe: string,
+  ): Promise<void> => {
+    setCategoryBusy(field)
+    try {
+      const written = await postJson<{ registry: Registry; prompt: string; customized?: { categories: boolean; acts: boolean }; error?: string }>(
+        '/intent/registry', { [field]: value })
+      if (written.error) throw new Error(written.error)
+      const fresh = await reloadRegistry()
+      const signature = (list: Array<{ id: string; enabled: boolean }>): string => list.map(item => `${item.id}:${item.enabled ? 1 : 0}`).join(',')
+      if (!fresh || signature(fresh[field]) !== signature(value)) {
+        setCategoryNotice({ tone: 'error', text: '写入没有被接受，下面显示的仍是当前生效的配置。' })
+        return
+      }
+      setCategoryNotice({ tone: 'success', text: describe })
+    } catch (cause) {
+      setCategoryNotice({ tone: 'error', text: cause instanceof Error ? cause.message : String(cause) })
+    } finally {
+      setCategoryBusy(null)
+    }
+  }, [reloadRegistry])
+
+  const applyCategories = useCallback((next: RegistryCategory[], describe: string): Promise<void> => applyRegistry('categories', next, describe), [applyRegistry])
+  const applyActs = useCallback((next: RegistryAct[], describe: string): Promise<void> => applyRegistry('acts', next, describe), [applyRegistry])
+
+  /** 回到出厂预置：把出厂词表**写回文件**（而不是删掉文件）。`field` 省略时两样都重置。 */
+  const resetRegistry = async (field?: 'categories' | 'acts'): Promise<void> => {
+    setCategoryBusy('reset')
+    try {
+      await postJson('/intent/registry', { reset: field ?? 'all' })
+      const fresh = await reloadRegistry()
+      setCategoryNotice(fresh
+        ? { tone: 'success', text: `已恢复出厂预置（${fresh.categories.length} 个分类 / ${fresh.acts.length} 个 act）` }
+        : { tone: 'error', text: '恢复默认后未能读回注册表' })
+    } catch (cause) {
+      setCategoryNotice({ tone: 'error', text: cause instanceof Error ? cause.message : String(cause) })
+    } finally {
+      setCategoryBusy(null)
+    }
+  }
+
+  const openCategoryEditor = (category?: RegistryCategory): void => {
+    setCategoryNotice(null)
+    setCategoryDraft(category
+      ? { open: true, mode: 'edit', id: category.id, label: category.label, route: category.route, description: category.description, examples: (category.examples ?? []).join('\n') }
+      : { ...EMPTY_CATEGORY_DRAFT, open: true, route: registry?.acts.find(act => act.enabled)?.id ?? 'query' })
+  }
+
+  const saveCategory = async (): Promise<void> => {
+    const current = registry?.categories ?? []
+    const id = categoryDraft.id.trim()
+    const label = categoryDraft.label.trim()
+    const description = categoryDraft.description.trim()
+    const examples = categoryDraft.examples.split('\n').map(line => line.trim()).filter(Boolean)
+    if (!CATEGORY_ID_PATTERN.test(id)) { setCategoryNotice({ tone: 'error', text: '分类 id 必须是小写字母开头的 2–41 位小写字母 / 数字 / 下划线，例如 test_review' }); return }
+    if (categoryDraft.mode === 'create' && current.some(item => item.id === id)) { setCategoryNotice({ tone: 'error', text: `分类 id 已存在：${id}` }); return }
+    if (!label) { setCategoryNotice({ tone: 'error', text: '显示名不能为空' }); return }
+    if (description.length < 4) { setCategoryNotice({ tone: 'error', text: '定义必填：写清这一类「是什么」，模型靠它匹配' }); return }
+    if (examples.length === 0) { setCategoryNotice({ tone: 'error', text: '至少写一条"例如"，否则模型只能靠猜' }); return }
+    const entry: RegistryCategory = { id, label, route: categoryDraft.route, description, examples, enabled: current.find(item => item.id === id)?.enabled ?? true }
+    const next = categoryDraft.mode === 'create'
+      ? [...current, entry]
+      : current.map(item => item.id === id ? { ...item, ...entry } : item)
+    setCategoryDraft(EMPTY_CATEGORY_DRAFT)
+    await applyCategories(next, categoryDraft.mode === 'create' ? `已新增分类「${label}」` : `分类「${label}」已更新`)
+  }
+
+  const toggleCategory = async (category: RegistryCategory, enabled: boolean): Promise<void> => {
+    await applyCategories((registry?.categories ?? []).map(item => item.id === category.id ? { ...item, enabled } : item), `${category.label} 已${enabled ? '启用' : '停用'}`)
+  }
+
+  const removeCategory = async (category: RegistryCategory): Promise<void> => {
+    await applyCategories((registry?.categories ?? []).filter(item => item.id !== category.id), `已删除分类「${category.label}」`)
+  }
+
+  // ------------------------------------------------- act 词表编辑（issue 0023）
+
+  const openActEditor = (act?: RegistryAct): void => {
+    setCategoryNotice(null)
+    setActDraft(act
+      ? { open: true, mode: 'edit', id: act.id, label: act.label, description: act.description }
+      : { ...EMPTY_ACT_DRAFT, open: true })
+  }
+
+  const saveAct = async (): Promise<void> => {
+    const current = registry?.acts ?? []
+    const id = actDraft.id.trim()
+    const label = actDraft.label.trim()
+    const description = actDraft.description.trim()
+    if (!ACT_ID_PATTERN.test(id)) { setCategoryNotice({ tone: 'error', text: 'act id 必须是小写字母开头的 2–41 位小写字母 / 数字 / 下划线，例如 audit' }); return }
+    if (actDraft.mode === 'create' && current.some(item => item.id === id)) { setCategoryNotice({ tone: 'error', text: `act id 已存在：${id}` }); return }
+    if (!label) { setCategoryNotice({ tone: 'error', text: 'act 显示名不能为空' }); return }
+    if (description.length < 4) { setCategoryNotice({ tone: 'error', text: 'act 说明必填：写清这个动作是什么，模型靠它区分 query 与 request' }); return }
+    const entry: RegistryAct = { id, label, description, enabled: current.find(item => item.id === id)?.enabled ?? true }
+    const next = actDraft.mode === 'create'
+      ? [...current, entry]
+      : current.map(item => item.id === id ? { ...item, ...entry } : item)
+    setActDraft(EMPTY_ACT_DRAFT)
+    await applyActs(next, actDraft.mode === 'create' ? `已新增 act「${label}」` : `act「${label}」已更新`)
+  }
+
+  const toggleAct = async (act: RegistryAct, enabled: boolean): Promise<void> => {
+    await applyActs((registry?.acts ?? []).map(item => item.id === act.id ? { ...item, enabled } : item), `${act.label} 已${enabled ? '启用' : '停用'}`)
+  }
+
+  const removeAct = async (act: RegistryAct): Promise<void> => {
+    const used = (registry?.categories ?? []).some(category => category.route === act.id)
+    if (used) { setCategoryNotice({ tone: 'error', text: `还有分类把 ${act.id} 当作默认 act，先改掉那些分类再删。` }); return }
+    await applyActs((registry?.acts ?? []).filter(item => item.id !== act.id), `已删除 act「${act.label}」`)
+  }
+
+  const active = sessions.find(item => item.sessionKey === sessionKey)
+
+  /** 从最近记录里归纳：这段会话主要在做什么，有多少低置信度需要人看。 */
+  const summary = useMemo(() => {
+    const records = store?.recent ?? []
+    const top = (pick: (record: IntentRecord) => string | undefined): Array<[string, number]> => {
+      const counts = new Map<string, number>()
+      for (const record of records) {
+        const key = pick(record)
+        if (!key) continue
+        counts.set(key, (counts.get(key) ?? 0) + 1)
+      }
+      return [...counts.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 5)
+    }
+    return {
+      total: records.length,
+      byAct: top(record => record.act),
+      byCategory: top(record => record.category),
+      byPredicate: top(record => record.predicate),
+      lowConfidence: records.filter(record => record.lowConfidence).length,
+      fallback: records.filter(record => record.source === 'fallback').length,
+      subtasks: records.filter(record => record.relation === 'subtask_of').length,
+    }
+  }, [store])
+
+  return <div className={styles.viewStack}>
+    {/* 三个 tab 而不是上下堆叠：记录是"看"，配置是"改"，逻辑是"为什么这么设计"。 */}
+    <Tabs className={styles.intentSections} value={section} onValueChange={value => setSection(value as IntentSection)}>
+      <div className={styles.intentSectionBar}>
+        <TabsList className={styles.tabsList}>
+          <TabsTrigger value="records"><Clock3 size={13} />意图记录</TabsTrigger>
+          <TabsTrigger value="config"><Settings2 size={13} />意图配置</TabsTrigger>
+          <TabsTrigger value="logic"><Lightbulb size={13} />意图的逻辑</TabsTrigger>
+        </TabsList>
+      </div>
+
+      {error && <p className={styles.kbNotice}><AlertCircle size={13} /><span>{error}</span></p>}
+
+      <TabsContent value="records">
+      <div className={styles.viewStack}>
+    {/* 会话切换属于"看记录"，所以它跟记录内容在一起，不占 tab 栏。 */}
+    <div className={styles.intentHead}>
+      <SelectMenu
+        className="max-w-[320px]"
+        value={sessionKey}
+        onValueChange={next => void selectSession(next)}
+        disabled={sessions.length === 0}
+        aria-label="选择意图记录会话"
+        placeholder={sessions.length === 0 ? '还没有会话记录' : '选择会话'}
+        options={sessions.map(item => ({ value: item.sessionKey, label: `${item.sessionKey.slice(0, 18)} · ${item.recordCount} 条 · ${formatTime(item.lastAt)}` }))}
+      />
+      <Button variant="ghost" size="icon" title="刷新" aria-label="刷新意图记录" onClick={() => void load(sessionKey)} disabled={loading}><RefreshCw size={14} /></Button>
+    </div>
+
+    <div className={styles.statsRow}>
+      <Card className={styles.intentMetric}>
+        <small>当前 act</small>
+        <strong>{active?.lastAct ?? '—'}</strong>
+        <em>{active?.lastCategory ?? '未分类'}</em>
+      </Card>
+      <Card className={styles.intentMetric}>
+        <small>置信度</small>
+        <strong>{active?.lastConfidence !== undefined ? active.lastConfidence.toFixed(2) : '—'}</strong>
+        <em>{active?.lastRelation ?? '—'}</em>
+      </Card>
+      <Card className={styles.intentMetric}>
+        <small>记录数</small>
+        <strong>{active?.recordCount ?? 0}</strong>
+        <em>TTL 内有效</em>
+      </Card>
+      <Card className={styles.intentMetric}>
+        <small>活动任务</small>
+        <strong>{store?.tasks.length ?? 0}</strong>
+        <em>{store?.activeTaskId ? store.activeTaskId.slice(0, 14) : '无'}</em>
+      </Card>
+    </div>
+
+    <Card className={styles.kbCard}>
+      <div className={styles.kbCardHead}>
+        <div><h3><BarChart3 size={13} />记录分布</h3></div>
+        <span className={styles.kbCount}>{summary.total} 条记录</span>
+      </div>
+      <p className={styles.kbHint}>
+        TTL 内的记录在这里被归纳：低置信度 {summary.lowConfidence} 条、Host 兜底 {summary.fallback} 条、子任务 {summary.subtasks} 条。
+        低置信度只标注、不拦截 —— 记录器的契约就是不阻塞请求。
+      </p>
+      <div className={styles.intentRegistry}>
+        <Distribution title="act" rows={summary.byAct} tone="blue" />
+        <Distribution title="分类" rows={summary.byCategory} tone="violet" />
+        <Distribution title="predicate" rows={summary.byPredicate} tone="green" />
+      </div>
+    </Card>
+
+    <Card className={styles.kbCard}>
+      <div className={styles.kbCardHead}>
+        <div><h3><GitBranch size={13} />活动任务</h3></div>
+        <span className={styles.kbCount}>{store?.tasks.length ?? 0} 个</span>
+      </div>
+      {(store?.tasks.length ?? 0) === 0 && <p className={styles.kbEmpty}>这个会话还没有绑定任务。</p>}
+      <ul className={styles.intentTaskList}>
+        {(store?.tasks ?? []).map(task => <li key={task.taskId}>
+          <span className={styles.intentTaskId}><GitBranch size={12} />{task.taskId}</span>
+          {task.lastSubtaskId && <span className={styles.kbCode}>{task.lastSubtaskId}</span>}
+          {task.category && <Badge tone="violet">{task.category}</Badge>}
+          <span className={styles.kbTypeCount}>{formatAge(task.ageSeconds)} 前</span>
+        </li>)}
+      </ul>
+    </Card>
+
+    <Card className={styles.kbCard}>
+      <div className={styles.kbCardHead}>
+        <div><h3><BrainCircuit size={13} />最近意图记录</h3></div>
+        <span className={styles.kbCount}>{store?.recent.length ?? 0} 条</span>
+      </div>
+      <p className={styles.kbHint}>
+        每轮记录一条，只做审计：默认不阻塞、不确认。{store?.expiresAt ? `本会话记录 ${formatTime(store.expiresAt)} 前有效。` : ''}
+      </p>
+      {(store?.recent.length ?? 0) === 0 && <p className={styles.kbEmpty}>还没有意图记录。</p>}
+      <ul className={styles.intentList}>
+        {(store?.recent ?? []).map(record => <li key={record.id} className={styles.intentRow}>
+          <div className={styles.intentRowHead}>
+            <Badge tone={record.lowConfidence ? 'warning' : 'neutral'}>{record.act}</Badge>
+            {record.category && <Badge tone="violet">{record.category}</Badge>}
+            {record.predicate && <span className={styles.kbCode}>{record.predicate}</span>}
+            <span className={styles.intentRelation}>{record.relation === 'subtask_of' ? '子任务' : record.relation === 'new_task' ? '新任务' : '未判定'}</span>
+            <span className={styles.intentTime}><Clock3 size={11} />{formatTime(record.updatedAt)}</span>
+          </div>
+          <p className={styles.intentInput}>{record.userInput.slice(0, 220) || '（无用户原文）'}</p>
+          <div className={styles.intentRowFoot}>
+            <span>{SOURCE_LABEL[record.source]}</span>
+            {record.confidence !== undefined && <span>confidence {record.confidence.toFixed(2)}</span>}
+            {record.lineage.taskId && <span className={styles.kbCode}>{record.lineage.taskId}</span>}
+            {record.lineage.subtaskId && <span className={styles.kbCode}>{record.lineage.subtaskId}</span>}
+          </div>
+        </li>)}
+      </ul>
+    </Card>
+      </div>
+      </TabsContent>
+
+      <TabsContent value="config">
+      <div className={styles.viewStack}>
+    {/* 标量设置复用架构节点那套表单：同一个命名空间、同一个组件，两处不会漂移。 */}
+    <NodeSettingsPanel node="intent" intent={intent} />
+
+    <Card className={styles.kbCard}>
+      <div className={styles.kbCardHead}>
+        <div><h3><ShieldCheck size={13} />意图分类（预置）</h3></div>
+        <div className={styles.kbCardActions}>
+          <span className={styles.kbCount}>
+            {registry?.categories.filter(category => category.enabled).length ?? 0} / {registry?.categories.length ?? 0} 启用
+            {categoriesCustomized ? ' · 已自定义' : ''}
+          </span>
+          {canEdit && <Button
+            variant="ghost" size="sm"
+            disabled={categoryBusy !== null || !categoriesCustomized}
+            title={categoriesCustomized ? '清除自定义，回到出厂预置' : '当前就是出厂预置'}
+            onClick={() => void resetRegistry('categories')}
+          ><RotateCcw size={13} />恢复默认</Button>}
+          <Button variant="outline" size="sm" disabled={!canEdit || categoryBusy !== null} onClick={() => openCategoryEditor()}><Plus size={13} />新增分类</Button>
+        </div>
+      </div>
+      <p className={styles.kbHint}>
+        判定是<b>两段式</b>的：模型先拿用户的话比对这里的<b>定义</b>与<b>例如</b>，命中就直接用该分类 id；
+        全不命中才自行判断（新起一个 id 或 unknown）。预置写得越具体，模型越不需要每轮从零分类。
+        {canEdit ? '' : '（意图目录还没就绪，只能查看。）'}
+      </p>
+      {categoryNotice && <p className={cn(styles.kbNotice, categoryNotice.tone === 'error' && styles.kbNoticeError)} role="status">
+        <AlertCircle size={13} /><span>{categoryNotice.text}</span>
+        <button type="button" className={styles.kbNoticeClose} aria-label="关闭提示" onClick={() => setCategoryNotice(null)}><X size={12} /></button>
+      </p>}
+      <ul className={styles.intentCategoryList}>
+        {(registry?.categories ?? []).map(category => <li key={category.id} className={styles.intentCategoryRow}>
+          <span className={styles.intentCategoryName}>
+            <span className={styles.intentCategoryLabel}>{category.label}</span>
+            <code className={styles.kbSourceId}>{category.id}</code>
+            <span className={styles.kbCode}>{category.route}</span>
+          </span>
+          <span className={styles.intentCategoryExample}>
+            {category.description || '（没有定义：模型只能靠猜）'}
+            {(category.examples ?? []).length > 0 ? `　例如：${(category.examples ?? []).join(' / ')}` : '　（没有例如）'}
+          </span>
+          <Switch checked={category.enabled} disabled={!canEdit || categoryBusy !== null} onCheckedChange={checked => void toggleCategory(category, checked)} />
+          <Button variant="ghost" size="icon" title={`编辑 ${category.label}`} aria-label={`编辑分类 ${category.label}`} disabled={!canEdit || categoryBusy !== null} onClick={() => openCategoryEditor(category)}><Pencil size={13} /></Button>
+          <Button variant="ghost" size="icon" title={`删除 ${category.label}`} aria-label={`删除分类 ${category.label}`} disabled={!canEdit || categoryBusy !== null} onClick={() => void removeCategory(category)}><Trash2 size={13} /></Button>
+        </li>)}
+      </ul>
+
+      {prompt && <details className={styles.kbPrompt}>
+        <summary><Eye size={12} /> 模型看到的提示词（只读，随上面的配置实时生成；它就是 intent_record 的工具描述）</summary>
+        <pre className={styles.kbPre}>{prompt}</pre>
+      </details>}
+    </Card>
+
+    <Card className={styles.kbCard}>
+      <div className={styles.kbCardHead}>
+        <div><h3><Zap size={13} />act 词表（这一轮在做什么）</h3></div>
+        <div className={styles.kbCardActions}>
+          <span className={styles.kbCount}>
+            {registry?.acts.filter(act => act.enabled).length ?? 0} / {registry?.acts.length ?? 0} 启用
+            {actsCustomized ? ' · 已自定义' : ''}
+          </span>
+          {canEdit && <Button
+            variant="ghost" size="sm"
+            disabled={categoryBusy !== null || !actsCustomized}
+            title={actsCustomized ? '清除自定义，回到出厂词表' : '当前就是出厂词表'}
+            onClick={() => void resetRegistry('acts')}
+          ><RotateCcw size={13} />恢复默认</Button>}
+          <Button variant="outline" size="sm" disabled={!canEdit || categoryBusy !== null} onClick={() => openActEditor()}><Plus size={13} />新增 act</Button>
+        </div>
+      </div>
+      <p className={styles.kbHint}>
+        act 回答"用户这一轮在<b>做什么</b>"，与分类（哪一类业务）正交：<b>query</b> 是提问要答案，
+        <b>request</b> 是让 Agent 做事并产生副作用。说明会进工具描述，所以写清两者的差别比加动作更重要。
+      </p>
+      <ul className={styles.intentCategoryList}>
+        {(registry?.acts ?? []).map(act => <li key={act.id} className={styles.intentCategoryRow}>
+          <span className={styles.intentCategoryName}>
+            <span className={styles.intentCategoryLabel}>{act.label}</span>
+            <code className={styles.kbSourceId}>{act.id}</code>
+          </span>
+          <span className={styles.intentCategoryExample}>{act.description || '（没有说明：模型只能靠猜）'}</span>
+          <Switch checked={act.enabled} disabled={!canEdit || categoryBusy !== null} onCheckedChange={checked => void toggleAct(act, checked)} />
+          <Button variant="ghost" size="icon" title={`编辑 ${act.label}`} aria-label={`编辑 act ${act.label}`} disabled={!canEdit || categoryBusy !== null} onClick={() => openActEditor(act)}><Pencil size={13} /></Button>
+          <Button variant="ghost" size="icon" title={`删除 ${act.label}`} aria-label={`删除 act ${act.label}`} disabled={!canEdit || categoryBusy !== null} onClick={() => void removeAct(act)}><Trash2 size={13} /></Button>
+        </li>)}
+      </ul>
+
+      <div className={styles.intentRegistry}>
+        <div>
+          <h4>predicate（只读）</h4>
+          <div className={styles.intentChips}>{(registry?.predicates ?? []).map(predicate => <span key={predicate} className={cn(styles.kbCode, styles.intentPredicate)}>{predicate}</span>)}</div>
+          <p className={styles.kbHint}>predicate 是真实工具名，应来自工具注册表本身，所以不在这里手写。</p>
+        </div>
+      </div>
+    </Card>
+      </div>
+      </TabsContent>
+
+      <TabsContent value="logic">
+        <IntentLogicTab />
+      </TabsContent>
+    </Tabs>
+
+    <Dialog open={categoryDraft.open} onOpenChange={open => { if (!open) setCategoryDraft(EMPTY_CATEGORY_DRAFT) }}>
+      {categoryDraft.open && <DialogContent>
+        <DialogHeader><DialogTitle>{categoryDraft.mode === 'create' ? '新增意图分类' : `编辑意图分类 · ${categoryDraft.label}`}</DialogTitle></DialogHeader>
+        <div className={styles.kbForm}>
+          <label className={styles.kbField}><Label>分类 id</Label>
+            <Input value={categoryDraft.id} disabled={categoryDraft.mode === 'edit'} spellCheck={false} placeholder="test_review"
+              onChange={(event: ChangeEvent<HTMLInputElement>) => setCategoryDraft({ ...categoryDraft, id: event.target.value })} />
+            <span className={styles.kbHint}>小写字母 / 数字 / 下划线，创建后不可修改——它会被写进每轮意图记录。</span>
+          </label>
+          <label className={styles.kbField}><Label>显示名</Label>
+            <Input value={categoryDraft.label} placeholder="测试评审"
+              onChange={(event: ChangeEvent<HTMLInputElement>) => setCategoryDraft({ ...categoryDraft, label: event.target.value })} />
+          </label>
+          <label className={styles.kbField}><Label>对应 act</Label>
+            <SelectMenu
+              value={categoryDraft.route}
+              onValueChange={next => setCategoryDraft({ ...categoryDraft, route: next })}
+              aria-label="对应 act"
+              options={(registry?.acts ?? []).filter(act => act.enabled || act.id === categoryDraft.route).map(act => ({ value: act.id, label: `${act.label}（${act.id}）` }))}
+            />
+            <span className={styles.kbHint}>命中这个分类时记录用的 act。</span>
+          </label>
+          <label className={styles.kbField}><Label>定义（必填）</Label>
+            <textarea className={styles.kbTextarea} value={categoryDraft.description} spellCheck={false}
+              placeholder="审查测试用例覆盖度、质量与遗漏场景的请求。"
+              onChange={(event: ChangeEvent<HTMLTextAreaElement>) => setCategoryDraft({ ...categoryDraft, description: event.target.value })} />
+            <span className={styles.kbHint}>写清这一类「是什么」，而不是「包含哪些词」——这是模型匹配的第一依据。</span>
+          </label>
+          <label className={styles.kbField}><Label>例如 · 用户会怎么说（每行一条，至少 1 条）</Label>
+            <textarea className={styles.kbTextarea} value={categoryDraft.examples} spellCheck={false}
+              placeholder={'帮我看看这批用例覆盖全了没\n这个需求的测试用例补一下'}
+              onChange={(event: ChangeEvent<HTMLTextAreaElement>) => setCategoryDraft({ ...categoryDraft, examples: event.target.value })} />
+            <span className={styles.kbHint}>按用户的真实说法写，不要只写关键词：模型靠它们判断「这句话属不属于这一类」。</span>
+          </label>
+        </div>
+        <DialogFooter>
+          <Button variant="ghost" onClick={() => setCategoryDraft(EMPTY_CATEGORY_DRAFT)}>取消</Button>
+          <Button variant="default" disabled={categoryBusy !== null || !categoryDraft.id.trim() || !categoryDraft.label.trim()} onClick={() => void saveCategory()}><Check size={13} />保存</Button>
+        </DialogFooter>
+      </DialogContent>}
+    </Dialog>
+
+    <Dialog open={actDraft.open} onOpenChange={open => { if (!open) setActDraft(EMPTY_ACT_DRAFT) }}>
+      {actDraft.open && <DialogContent>
+        <DialogHeader><DialogTitle>{actDraft.mode === 'create' ? '新增 act' : `编辑 act · ${actDraft.label}`}</DialogTitle></DialogHeader>
+        <div className={styles.kbForm}>
+          <label className={styles.kbField}><Label>act id</Label>
+            <Input value={actDraft.id} disabled={actDraft.mode === 'edit'} spellCheck={false} placeholder="audit"
+              onChange={(event: ChangeEvent<HTMLInputElement>) => setActDraft({ ...actDraft, id: event.target.value })} />
+            <span className={styles.kbHint}>小写字母 / 数字 / 下划线，创建后不可修改——它会被写进每轮意图记录。</span>
+          </label>
+          <label className={styles.kbField}><Label>显示名</Label>
+            <Input value={actDraft.label} placeholder="审计"
+              onChange={(event: ChangeEvent<HTMLInputElement>) => setActDraft({ ...actDraft, label: event.target.value })} />
+          </label>
+          <label className={styles.kbField}><Label>说明（必填）</Label>
+            <textarea className={styles.kbTextarea} value={actDraft.description} spellCheck={false}
+              placeholder="要求对已有数据做合规或口径审计。"
+              onChange={(event: ChangeEvent<HTMLTextAreaElement>) => setActDraft({ ...actDraft, description: event.target.value })} />
+            <span className={styles.kbHint}>写清"这个动作是什么"，并且要和相邻 act 的差别可见（例如 query 与 request）。</span>
+          </label>
+        </div>
+        <DialogFooter>
+          <Button variant="ghost" onClick={() => setActDraft(EMPTY_ACT_DRAFT)}>取消</Button>
+          <Button variant="default" disabled={categoryBusy !== null || !actDraft.id.trim() || !actDraft.label.trim()} onClick={() => void saveAct()}><Check size={13} />保存</Button>
+        </DialogFooter>
+      </DialogContent>}
+    </Dialog>
+  </div>
+}