dsh-data-domain-knowledge 0.1.1-alpha.2 → 0.1.1-alpha.3

package/src/client/attribution/AttributionTab.tsx

@@ -1,9 +1,10 @@
 import {
-  CircleDot, Database, GitBranch, History, Sparkles, Stethoscope, X,
+  CircleDot, Database, GitBranch, History, Library, Sparkles, Stethoscope, X,
 } from '@tita-agent/ui/icons'
 import { useCallback, useEffect, useMemo, useState, type ReactNode } from 'react'
-import { Button } from '@tita-agent/ui/components'
+import { Badge, Button } from '@tita-agent/ui/components'
 import { Dialog, DialogContent, DialogTitle } from '@tita-agent/ui/overlays'
+import { requestJson } from '../request.ts'
 import { AttributionGraph } from './AttributionGraph.tsx'
 import { CaseView } from './CaseView.tsx'
 import { EventView } from './EventView.tsx'
@@ -35,6 +36,16 @@ interface DiagnosisPayload {
   canLoadSample?: boolean
 }
 
+/** 客户端只消费搜索返回的这几个字段，不直接依赖服务端 KnowledgeCard 模块。 */
+interface EvidenceWikiCard {
+  entityId: string
+  entityType: string
+  title: string
+  summary?: string
+  content: string
+  metadata?: Record<string, unknown>
+}
+
 /** 服务端的三种来源 → 徽标上那句人话。 */
 function sourceLabelOf(source: string | undefined): string {
   if (source === 'cards') return '可复用诊断卡片'
@@ -43,7 +54,7 @@ function sourceLabelOf(source: string | undefined): string {
   return '还没有排查知识'
 }
 
-type SubView = 'graph' | 'case' | 'event' | 'run'
+type SubView = 'graph' | 'case' | 'event' | 'run' | 'knowledge'
 
 function normalizeQuestion(value: string): string {
   return value.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, '')
@@ -80,15 +91,19 @@ function symptomMatchOf(question: string | undefined, symptoms: readonly Attribu
  * - 画布左上 = 操作（四组按动线顺序）；右上 = 读法（四个开关同排）；
  *   左下 = 读数（统计 + 来源）；底中 = 搜索；右侧 = 图例正文 / 节点详情。
  */
-export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
+export function AttributionTab({ visible, activeQuestion, kbId, onOpenKnowledge, onOpenWiki }: {
   visible: boolean
   /** 当前会话最近一条用户消息；仅精确匹配到唯一现象时自动高亮。 */
   activeQuestion?: string
+  /** 与知识库分栏当前选中的库保持一致。 */
+  kbId?: string
   /**
    * 切到「知识库」那一栏。空态的主操作要用它 —— 排查知识是从来源与卡片编译来的，
    * 空的时候该把人送去**录知识的那一栏**，而不是让人在这一栏里等。
    */
   onOpenKnowledge?: () => void
+  /** 打开召回卡片的原 Wiki。 */
+  onOpenWiki?: (card: Pick<EvidenceWikiCard, 'entityId' | 'entityType'>) => void
 }): ReactNode {
   const [subView, setSubView] = useState<SubView>('graph')
   /** 默认关系图：空问题态先看完整排查关系。 */
@@ -211,7 +226,8 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
     setPhase('loading')
     void (async () => {
       try {
-        const response = await fetch('/diagnosis/graph')
+        const query = kbId ? `?kb=${encodeURIComponent(kbId)}` : ''
+        const response = await fetch(`/diagnosis/graph${query}`)
         if (!response.ok) throw new Error(`HTTP ${response.status}`)
         const body = await response.json() as { data?: DiagnosisPayload }
         if (cancelled) return
@@ -222,7 +238,7 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
       }
     })()
     return () => { cancelled = true }
-  }, [visible, reloadToken, applyPayload])
+  }, [visible, reloadToken, applyPayload, kbId])
 
   /**
    * 载入内置示例：**显式的一次写**，将来源记录与可复用诊断卡写入当前知识库。
@@ -232,7 +248,8 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
   const loadSample = async (): Promise<void> => {
     setSampleBusy(true); setSampleError(null)
     try {
-      const response = await fetch('/diagnosis/sample', { method: 'POST' })
+      const query = kbId ? `?kb=${encodeURIComponent(kbId)}` : ''
+      const response = await fetch(`/diagnosis/sample${query}`, { method: 'POST' })
       const body = await response.json() as { ok?: boolean; data?: DiagnosisPayload; error?: { message?: string } }
       if (!response.ok || body.ok === false) throw new Error(body.error?.message ?? `HTTP ${response.status}`)
       applyPayload(body.data ?? {})
@@ -275,6 +292,8 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
   const symptomCounts = useMemo(() => symptomCountByProblemClass(data.nodes), [data])
   const symptoms = useMemo(() => data.nodes.filter(node => node.kind === 'symptom'), [data])
   const matchedSymptom = useMemo(() => symptomMatchOf(activeQuestion, symptoms), [activeQuestion, symptoms])
+  const selectedSymptom = selectedId ? symptoms.find(node => node.id === selectedId) : undefined
+  const evidenceQuery = activeQuestion?.trim() || selectedSymptom?.title || matchedSymptom?.title || ''
   useEffect(() => {
     // 新会话问题或新载入的图谱：只在唯一、明确匹配时预选；其余情况保持全图。
     setSelectedId(matchedSymptom?.id)
@@ -434,6 +453,10 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
       hint: '剪枝：按优先分排出下一步该查什么，每个检查点都有主操作。',
       meta: String(candidateCount),
     },
+    {
+      id: 'knowledge', label: '知识', icon: Library,
+      hint: '依据：按当前问题召回 Wiki Fact / Wiki Way；可打开原 Wiki 核对。',
+    },
   ]
 
   const layoutHint = layout === 'line'
@@ -517,6 +540,7 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
     />}
     {...(subView === 'case' ? { layer: <CaseView cases={cases} activeId={activeCase} onActiveChange={setActiveCase} /> } : {})}
     {...(subView === 'event' ? { layer: <EventView events={events} /> } : {})}
+    {...(subView === 'knowledge' ? { layer: <KnowledgeEvidenceView query={evidenceQuery} kbId={kbId} onOpenWiki={onOpenWiki} /> } : {})}
     {...(subView === 'run' ? {
       layer: <RunView
         data={data}
@@ -621,8 +645,10 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
   if (phase !== 'ready' || (data.nodes.length === 0 && events.length === 0)) {
     return <div className="flex min-h-0 flex-1 flex-col gap-1.5">
       {helpError && <AttributionHelpNotice message={helpError} onDismiss={() => setHelpError(null)} />}
-      <div className="flex min-w-0 items-center justify-end">{helpHint}</div>
-      <AttributionEmpty
+      <div className="flex min-w-0 flex-wrap items-center justify-between gap-1.5">{switcher}{helpHint}</div>
+      {subView === 'knowledge'
+        ? <div className="min-h-0 flex-1 overflow-y-auto px-2"><KnowledgeEvidenceView query={evidenceQuery} kbId={kbId} onOpenWiki={onOpenWiki} /></div>
+        : <AttributionEmpty
         phase={phase}
         canLoadSample={canLoadSample}
         busy={sampleBusy}
@@ -630,7 +656,7 @@ export function AttributionTab({ visible, activeQuestion, onOpenKnowledge }: {
         onLoadSample={() => void loadSample()}
         onRetry={() => setReloadToken(token => token + 1)}
         {...(onOpenKnowledge ? { onOpenKnowledge } : {})}
-      />
+      />}
     </div>
   }
 
@@ -731,6 +757,111 @@ function AttributionHelpNotice({ message, onDismiss }: { message: string; onDism
   </div>
 }
 
+/**
+ * 只读查看当前问题从知识库召回的 Wiki Fact / Wiki Way。
+ *
+ * 这里消费正式的 `/knowledge/search` 结果，不再保存第二份问题定位知识。召回顺序保留，
+ * 每条结果都能跳回原 Wiki；正文默认收起，避免把完整 Wiki 挤进窄栏。
+ */
+function KnowledgeEvidenceView({ query, kbId, onOpenWiki }: {
+  query: string
+  kbId?: string
+  onOpenWiki?: (card: Pick<EvidenceWikiCard, 'entityId' | 'entityType'>) => void
+}): ReactNode {
+  const [items, setItems] = useState<EvidenceWikiCard[]>([])
+  const [phase, setPhase] = useState<'idle' | 'loading' | 'ready' | 'error'>('idle')
+  const [error, setError] = useState('')
+  const [retry, setRetry] = useState(0)
+  const [expanded, setExpanded] = useState<ReadonlySet<string>>(new Set())
+
+  useEffect(() => {
+    const trimmed = query.trim()
+    if (!trimmed) {
+      setItems([])
+      setPhase('idle')
+      setError('')
+      return undefined
+    }
+    let cancelled = false
+    setPhase('loading')
+    setItems([])
+    setExpanded(new Set())
+    setError('')
+    const params = new URLSearchParams({ query: trimmed, top_k: '30', top_n: '20' })
+    if (kbId) params.set('kb', kbId)
+    void requestJson<{ wiki?: EvidenceWikiCard[] }>(`/knowledge/search?${params.toString()}`)
+      .then(payload => {
+        if (cancelled) return
+        setItems((payload.data?.wiki ?? []).filter(card => card.metadata?.wiki_kind === 'fact' || card.metadata?.wiki_kind === 'way'))
+        setPhase('ready')
+      })
+      .catch(cause => {
+        if (cancelled) return
+        setItems([])
+        setError(cause instanceof Error ? cause.message : String(cause))
+        setPhase('error')
+      })
+    return () => { cancelled = true }
+  }, [query, kbId, retry])
+
+  const toggleExpanded = (id: string): void => setExpanded(current => {
+    const next = new Set(current)
+    if (next.has(id)) next.delete(id)
+    else next.add(id)
+    return next
+  })
+
+  return <section className="mx-auto flex w-full max-w-3xl flex-col gap-2 py-1" aria-label="知识库召回依据">
+    <header className="border-b border-tita-line pb-2">
+      <h3 className="text-[13px] font-semibold text-tita-ink">问题定位相关 Wiki</h3>
+      <p className="mt-1 text-[10.5px] leading-relaxed text-tita-ink-muted">
+        按当前问题召回已有 Wiki Fact / Wiki Way。这里只读展示，不会创建或修改知识。
+      </p>
+      {query.trim() && <p className="mt-1 line-clamp-2 break-words text-[10.5px] leading-relaxed text-tita-ink" title={query}>{query}</p>}
+    </header>
+
+    {phase === 'idle' && <p className="py-5 text-center text-[11px] text-tita-ink-muted">
+      当前没有可用于召回的问题。请在会话中提出问题，或先在图谱里选择一个问题现象。
+    </p>}
+    {phase === 'loading' && <p role="status" className="py-5 text-center text-[11px] text-tita-ink-muted">
+      正在召回 Wiki Fact / Wiki Way…
+    </p>}
+    {phase === 'error' && <div className="flex flex-col items-start gap-2 py-3">
+      <p role="alert" className="text-[10.5px] leading-relaxed text-tita-danger">知识召回失败：{error}</p>
+      <Button size="sm" variant="outline" className="h-[26px] min-h-[26px] px-2 text-[10.5px]" onClick={() => setRetry(value => value + 1)}>重试召回</Button>
+    </div>}
+    {phase === 'ready' && items.length === 0 && <p className="py-5 text-center text-[11px] leading-relaxed text-tita-ink-muted">
+      当前问题没有召回到 Wiki Fact 或 Wiki Way。可以补充问题现象，或到知识库检查相关 Wiki 是否已编译。
+    </p>}
+    {items.length > 0 && <ol className="divide-y divide-tita-line">
+      {items.map(card => {
+        const wikiKind = card.metadata?.wiki_kind === 'way' ? 'way' : 'fact'
+        const open = expanded.has(card.entityId)
+        return <li key={`${card.entityType}:${card.entityId}`} className="py-2.5 first:pt-1">
+          <article className="flex min-w-0 flex-col gap-1.5">
+            <header className="flex min-w-0 items-start gap-1.5">
+              <Badge tone={wikiKind === 'way' ? 'success' : 'neutral'} className="mt-0.5 shrink-0">
+                {wikiKind === 'way' ? 'Wiki Way' : 'Wiki Fact'}
+              </Badge>
+              <h4 className="min-w-0 break-words text-[11.5px] font-semibold leading-snug text-tita-ink">{card.title}</h4>
+            </header>
+            {card.summary && <p className="break-words text-[10.5px] leading-relaxed text-tita-ink-muted">{card.summary}</p>}
+            <div className="flex flex-wrap items-center gap-1">
+              <Button size="sm" variant="ghost" className="h-[25px] min-h-[25px] px-1.5 text-[10px]" onClick={() => toggleExpanded(card.entityId)}>
+                {open ? '收起 Wiki 正文' : '展开 Wiki 正文'}
+              </Button>
+              {onOpenWiki && <Button size="sm" variant="outline" className="h-[25px] min-h-[25px] px-1.5 text-[10px]" onClick={() => onOpenWiki(card)}>
+                打开原 Wiki
+              </Button>}
+            </div>
+            {open && <pre className="max-h-[36vh] overflow-auto overscroll-contain whitespace-pre-wrap break-words rounded-md bg-tita-surface-muted p-2 text-[10px] leading-relaxed text-tita-ink">{card.content}</pre>}
+          </article>
+        </li>
+      })}
+    </ol>}
+  </section>
+}
+
 /** 大类 id → 它下面的子类 id。取消大类时要把这些子类一起撤掉。 */
 const PROBLEM_CLASS_IDS_TO_SUBCLASSES: Record<string, string[]> = Object.fromEntries(
   PROBLEM_CLASSES.map(item => [item.id, item.subclasses.map(sub => sub.id)]),

package/src/client/pages.css

@@ -1,12 +1,12 @@
 /*
- * 通用整页（抽取试跑 / 编译链路 / 意图的逻辑）的页面样式。
+ * 通用整页（抽取试跑 / 编译链路）的页面样式。
  *
  * 它和 `doc-page.css` 是同一种东西：一份**单独的浏览器文档**，没有 DSH 外壳、没有侧栏
  * 那 380px 的宽度限制。所以这里的决定围绕两件事：
  *
  * 1. **一条常驻的窄条**回答「我在哪一页、看的是哪个库」—— 整页可以滚很久，标题滚走了
  *    就只剩内容，而这三页都需要知道自己在哪。
- * 2. **两条内容宽度**：说明类（编译链路、意图的逻辑）是读排版，约 860px 就够；试跑报告
+ * 2. **两条内容宽度**：说明类（编译链路）是读排版，约 860px 就够；试跑报告
  *    里有一张矩阵，给它 1180px。宽度是**内容**的属性，所以按页给，不按壳给。
  *
  * 颜色全部走共享令牌（`@tita-agent/ui/styles.css` 带进来的那一套）。插件自己的

package/src/client/pages.tsx

@@ -1,5 +1,5 @@
 /**
- * 通用整页：**抽取试跑 / 抽取轨迹 / 编译和召回链路 / 意图的逻辑 / Agent 方案说明**。
+ * 通用整页：**抽取试跑 / 抽取轨迹 / 编译和召回链路 / Agent 方案说明**。
  *
  * 这些页面共用一个 bundle、一条宿主路由（`/knowledge/pages/<...>`），因为它们是同一种东西：
  * 「在面板里放不下、也不该挤进 380px 侧栏」的内容。**它们开在真的浏览器窗口里** ——
@@ -15,9 +15,8 @@
  * - **抽取轨迹**：同一份理由的另一面 —— 报告几十 KB，2026-10-06 从抽屉里就地展开
  *   改成开整页（用户点名「点击要在浏览器打开」）。
  * - **编译和召回链路**：按架构说明 SourceRaw 如何变成 Wiki，以及一次 Query 如何变成 Agent Context。
- * - **意图的逻辑**：同上，讲的是词表为什么这么设计。
  *
- * 说明类内容原来住在表单里（编译流程对话框的第二个页签、意图页的第二个页签）。抽成
+ * 说明类内容原来住在表单里（编译流程对话框的说明页）。抽成
  * 整页之后，**每个容器只装一种东西**：浮层装要动手的，整页装要读的。
  *
  * ## 地址形状
@@ -26,7 +25,6 @@
  * /knowledge/pages/trial?kb=<知识库 id>     抽取试跑
  * /knowledge/pages/run?kb=<库 id>&run=<轨迹 id>   一次抽取的完整报告
  * /knowledge/pages/help/compile             编译和召回链路
- * /knowledge/pages/help/intent              意图的逻辑
  * /knowledge/pages/help/attribution         智能归因事件
  * /knowledge/pages/help/overview?node=...   TitaAgent 完整架构和逻辑说明
  * ```
@@ -40,7 +38,6 @@ import '@tita-agent/ui/styles.css'
 import './styles.css'
 import './pages.css'
 import { AttributionEventGuide } from './AttributionEventGuide.tsx'
-import { IntentLogic } from './IntentLogic.tsx'
 import { TabGuidePage } from './TabGuide.tsx'
 import { WikiFlowPanel } from './WikiFlowPanel.tsx'
 import { WikiTrialRun, type TrialDocumentOption } from './WikiTrialRun.tsx'
@@ -59,7 +56,7 @@ type PageRoute =
   | { kind: 'trial'; kb: string }
   | { kind: 'run'; kb: string; run: string }
   | { kind: 'tasks'; kb: string }
-  | { kind: 'help'; topic: 'intent' | 'compile' | 'attribution' | 'overview'; node?: string }
+  | { kind: 'help'; topic: 'compile' | 'attribution' | 'overview'; node?: string }
   | { kind: 'unknown' }
 
 /**
@@ -78,7 +75,7 @@ function routeOf(location: Location): PageRoute {
   if (parts[0] === 'help' && parts[1] === 'overview') {
     return { kind: 'help', topic: 'overview', node: params.get('node') ?? undefined }
   }
-  if (parts[0] === 'help' && (parts[1] === 'intent' || parts[1] === 'compile' || parts[1] === 'attribution')) {
+  if (parts[0] === 'help' && (parts[1] === 'compile' || parts[1] === 'attribution')) {
     return { kind: 'help', topic: parts[1] }
   }
   return { kind: 'unknown' }
@@ -256,9 +253,6 @@ function App(): ReactNode {
     if (route.topic === 'overview') {
       return <PageShell title="TitaAgent 完整架构" meta="从理解请求到持续改进的三层闭环" column="guide"><TabGuidePage initialNode={route.node} /></PageShell>
     }
-    if (route.topic === 'intent') {
-      return <PageShell title="意图的逻辑" meta="这套词表为什么这样设计" column="help"><IntentLogic /></PageShell>
-    }
     if (route.topic === 'compile') {
       return <PageShell title="编译和召回链路" meta="信息编译为知识，然后才值得被召回使用" column="help"><WikiFlowPanel /></PageShell>
     }
@@ -272,7 +266,6 @@ function App(): ReactNode {
       <code>/knowledge/pages/run?kb=&lt;知识库 id&gt;&amp;run=&lt;轨迹 id&gt;</code> · 一次抽取的报告<br />
       <code>/knowledge/pages/tasks?kb=&lt;知识库 id&gt;</code> · 知识处理与运行记录<br />
       <code>/knowledge/pages/help/compile</code> · 编译和召回链路<br />
-      <code>/knowledge/pages/help/intent</code> · 意图的逻辑<br />
       <code>/knowledge/pages/help/attribution</code> · 智能归因事件<br />
       <code>/knowledge/pages/help/overview?node=knowledge</code> · 五个 Tab 的方案说明</p>
     <p>它们都由面板上的入口打开，不需要手写。</p>

package/src/client/styles.css

@@ -672,7 +672,7 @@ html[data-platform='darwin'] [data-window-drag] [data-conversation-tabs] > [role
    同一个图标有两种含义时，光标是零成本的那条线索。 */
 .tita-infoHintAction { cursor: pointer; }
 .tita-infoHintAction:hover { color: var(--tita-ink); }
-/* 说明靠右（2026-10-05）：知识库与意图两条工具栏同一条规矩 —— 动作一组靠左，
+/* 说明靠右（2026-10-05）：知识库工具栏的排版规矩 —— 动作一组靠左，
    `?` 自己站在最右端。`margin-left: auto` 在换行时也成立：它落到第二行，仍然右对齐。 */
 .tita-kbToolbarHint { flex: 0 0 auto; margin-left: auto; }
 /* 标题里的说明入口（设置小节同理）：与标题文字留一格气，
@@ -852,7 +852,7 @@ html[data-platform='darwin'] [data-window-drag] [data-conversation-tabs] > [role
 /*
  * 行右侧的次要事实（类型 · 时间 / N 个来源 / N 张）。
  *
- * 0042 补的定义：这个类名被五处用着（卡片行、原文抽屉的编译产物、意图任务、
+ * 0042 补的定义：这个类名被五处用着（卡片行、原文抽屉的编译产物、
  * 类型定义、卡片类型编辑器）却**一直没有样式** —— 于是它只传递了一个名字，
  * 右对齐与「比主文字轻」全靠父级的 flex 碰运气。一次定义到位。
  */
@@ -1014,91 +1014,11 @@ html[data-platform='darwin'] [data-window-drag] [data-conversation-tabs] > [role
 .tita-kbInlineImage { margin: 10px 0; text-align: center; }
 .tita-kbInlineImage img { display: block; width: auto; max-width: 100%; max-height: 360px; margin: 0 auto; object-fit: contain; }
 .tita-kbPre { max-height: 320px; margin: 0; border: 1px solid var(--tita-line); border-radius: 9px; background: var(--tita-surface); color: var(--tita-ink); padding: 10px; overflow: auto; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 10.5px; line-height: 1.6; white-space: pre-wrap; overflow-wrap: anywhere; }
-/* 文本视图的 `<pre>` 自带 max-height（它同时被意图 / 类型定义两处用），进了正文块之后
+/* 文本视图的 `<pre>` 自带 max-height（类型定义视图也会用），进了正文块之后
    由外层那一层负责滚 —— 同一件事不画两条滚动条。 */
 .tita-drawerBody .tita-kbPre { max-height: none; border: 0; border-radius: 0; background: transparent; padding: 0; }
 
-/* ------------------------------------------------------ intent (session audit) */
-.tita-intentTop { display: flex; min-width: 0; align-items: flex-start; justify-content: space-between; gap: 12px; border-bottom: 1px solid var(--tita-line); padding-bottom: 12px; }
-.tita-intentTop h2 { margin: 0; color: var(--tita-ink); font-size: 17px; font-weight: 780; letter-spacing: -.025em; line-height: 1.3; }
-.tita-intentTop p { max-width: 320px; margin: 5px 0 0; color: var(--tita-ink-muted); font-size: 11px; line-height: 1.6; }
-.tita-intentControls { display: grid; gap: 8px; border-bottom: 1px solid var(--tita-line); padding-bottom: 12px; }
-.tita-intentPrimaryFilter { display: grid; grid-template-columns: auto minmax(0, 1fr) auto; min-width: 0; align-items: center; gap: 7px; }
-.tita-intentFilterHeading { display: grid; min-width: 42px; gap: 1px; }
-.tita-intentFilterHeading small { color: var(--tita-primary); font-size: 9px; font-weight: 700; white-space: nowrap; }
-.tita-intentFilterCount { color: var(--tita-ink-faint); font-size: 10px; font-variant-numeric: tabular-nums; white-space: nowrap; }
-.tita-intentSecondaryFilters { display: grid; grid-template-columns: auto minmax(0, .7fr) auto minmax(0, 1.3fr) auto; min-width: 0; align-items: center; gap: 7px; }
-.tita-intentControlLabel { color: var(--tita-ink-muted); font-size: 11px; white-space: nowrap; }
-.tita-intentFilterSummary { display: flex; min-width: 0; flex-wrap: wrap; align-items: center; gap: 5px 7px; border-radius: 8px; background: var(--tita-surface-muted); padding: 6px 8px; color: var(--tita-ink-faint); font-size: 10px; line-height: 1.4; }
-.tita-intentFilterSummary > span { color: var(--tita-ink-muted); font-weight: 650; }
-.tita-intentSectionHead { display: flex; min-width: 0; align-items: flex-start; justify-content: space-between; gap: 12px; }
-.tita-intentSectionHead h3 { margin: 0; color: var(--tita-ink); font-size: 13.5px; font-weight: 760; }
-.tita-intentSectionSubhead { margin: 3px 0 0; color: var(--tita-ink-faint); font-size: 10px; line-height: 1.45; }
-.tita-intentSectionHead > time, .tita-intentSectionCount { flex: 0 0 auto; color: var(--tita-ink-faint); font-size: 10px; font-variant-numeric: tabular-nums; }
-.tita-intentEyebrow { display: inline-flex; align-items: center; gap: 5px; color: var(--tita-ink-faint); font-size: 9.5px; font-weight: 750; letter-spacing: .08em; text-transform: uppercase; }
-.tita-intentInterpretation { display: grid; gap: 11px; border-color: var(--tita-line-strong); padding: 14px 15px; }
-.tita-intentUserBlock { min-width: 0; border: 1px solid var(--tita-line); border-radius: 9px; background: var(--tita-surface-muted); padding: 10px 11px; }
-.tita-intentStepLabel { display: block; color: var(--tita-ink-faint); font-size: 10px; font-weight: 700; }
-.tita-intentUserInput { margin: 5px 0 0; color: var(--tita-ink); font-size: 12px; line-height: 1.65; overflow-wrap: anywhere; }
-.tita-intentVerdict { min-width: 0; border: 1px solid var(--tita-primary); border-radius: 9px; background: var(--tita-primary-soft); padding: 11px; }
-.tita-intentVerdictHead { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
-.tita-intentResultTitle { margin: 5px 0 0; color: var(--tita-ink); font-size: 15px; font-weight: 780; letter-spacing: -.02em; line-height: 1.35; overflow-wrap: anywhere; }
-.tita-intentResultText { margin: 4px 0 0; color: var(--tita-ink-muted); font-size: 11px; line-height: 1.6; }
-.tita-intentResultTags { display: flex; min-width: 0; flex-wrap: wrap; align-items: center; gap: 5px; margin-top: 8px; }
-.tita-intentLowConfidence { color: var(--tita-tone-amber); font-size: 10px; font-weight: 650; }
-.tita-intentMetaGrid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 8px; }
-.tita-intentMetaCell { display: grid; min-width: 0; gap: 3px; border-top: 1px solid var(--tita-line); padding-top: 8px; }
-.tita-intentMetaCell span { color: var(--tita-ink-faint); font-size: 9.5px; }
-.tita-intentMetaCell strong { color: var(--tita-ink-muted); font-size: 10.5px; font-weight: 650; overflow-wrap: anywhere; }
-.tita-intentDiagnostics { border-top: 1px solid var(--tita-line); padding-top: 9px; }
-.tita-intentDiagnostics summary { color: var(--tita-ink-faint); font-size: 10px; cursor: pointer; list-style-position: inside; }
-.tita-intentDiagnostics summary:hover { color: var(--tita-ink-muted); }
-.tita-intentDiagnosticsBody { display: grid; gap: 5px; margin: 8px 0 0 15px; color: var(--tita-ink-faint); font-size: 10px; line-height: 1.5; }
-.tita-intentDiagnosticsBody code { border-radius: 4px; background: var(--tita-surface-muted); padding: 1px 4px; color: var(--tita-tone-violet); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 9.5px; }
-.tita-intentEmptyCard { display: grid; justify-items: center; gap: 6px; padding: 25px 15px; text-align: center; }
-.tita-intentEmptyCard > svg { color: var(--tita-ink-faint); }
-.tita-intentEmptyCard strong { color: var(--tita-ink); font-size: 12px; }
-.tita-intentEmptyCard p, .tita-intentEmpty { margin: 0; color: var(--tita-ink-faint); font-size: 11px; line-height: 1.6; }
-.tita-intentHistory { border-top: 1px solid var(--tita-line); padding-top: 13px; }
-.tita-intentHistoryList { display: grid; margin: 10px 0 0; padding: 0; list-style: none; }
-.tita-intentHistoryItem { display: grid; min-width: 0; gap: 4px; border-bottom: 1px solid var(--tita-line); padding: 10px 0 11px; }
-.tita-intentHistoryItem:first-child { padding-top: 0; }
-.tita-intentHistoryItem:last-child { border-bottom: 0; }
-.tita-intentHistoryPrimary { display: flex; min-width: 0; align-items: baseline; justify-content: space-between; gap: 9px; }
-.tita-intentHistoryPrimary strong { min-width: 0; color: var(--tita-ink); font-size: 12px; font-weight: 720; overflow-wrap: anywhere; }
-.tita-intentHistoryPrimary time { display: inline-flex; flex: 0 0 auto; align-items: center; gap: 4px; color: var(--tita-ink-muted); font-size: 10px; font-variant-numeric: tabular-nums; }
-.tita-intentHistoryMeta { display: flex; min-width: 0; flex-wrap: wrap; align-items: center; gap: 4px 9px; color: var(--tita-ink-faint); font-size: 10px; }
-.tita-intentHistoryMeta span + span::before { content: '·'; margin-right: 9px; color: var(--tita-line-strong); }
-.tita-intentHistoryWarning { color: var(--tita-tone-amber); }
-.tita-intentHistoryItem p { margin: 0; color: var(--tita-ink-muted); font-size: 11px; line-height: 1.55; overflow-wrap: anywhere; }
-.tita-intentFooter { display: flex; flex-wrap: wrap; gap: 5px 12px; border-top: 1px solid var(--tita-line); padding-top: 10px; color: var(--tita-ink-faint); font-size: 10px; }
-.tita-intentFooter span + span::before { content: '·'; margin-right: 12px; color: var(--tita-line-strong); }
-
-/* 「意图的逻辑」：说明性内容，读的是排版而不是控件。它现在是一份整页
-   （`/knowledge/pages/help/intent`），所以这几条规则同时服务面板与那一页。 */
-.tita-intentDocList { display: grid; margin: 3px 0 0; padding-left: 18px; gap: 5px; color: var(--tita-ink); font-size: 11.5px; line-height: 1.75; }
-.tita-intentDocList b { color: var(--tita-ink); }
-.tita-intentDocList code, .tita-kbHint code { border-radius: 4px; background: var(--tita-surface-muted); padding: 0 4px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 10.5px; }
-.tita-intentDocGrid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 8px; margin-top: 10px; }
-.tita-intentDocGrid > div { display: grid; gap: 3px; border: 1px solid var(--tita-line); border-radius: 9px; background: var(--tita-surface); padding: 9px 11px; }
-.tita-intentDocGrid strong { color: var(--tita-ink); font-size: 11.5px; }
-.tita-intentDocGrid span { color: var(--tita-ink-faint); font-size: 10.5px; line-height: 1.6; }
-.tita-intentDocTableWrap { overflow-x: auto; margin-top: 8px; }
-.tita-intentDocTable { width: 100%; border-collapse: collapse; font-size: 11px; }
-.tita-intentDocTable th { border-bottom: 1px solid var(--tita-line); color: var(--tita-ink-muted); padding: 6px 8px; font-weight: 700; text-align: left; white-space: nowrap; }
-.tita-intentDocTable td { border-bottom: 1px solid var(--tita-surface-muted); color: var(--tita-ink); padding: 6px 8px; line-height: 1.65; vertical-align: top; }
-.tita-intentDocTable td:first-child code { border-radius: 4px; background: var(--tita-surface-muted); padding: 1px 4px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 10.5px; }
-.tita-intentDocTable td:nth-child(2) { color: var(--tita-tone-green); text-align: center; }
-.tita-intentPaperList { display: grid; margin: 8px 0 0; padding: 0; list-style: none; gap: 10px; }
-.tita-intentPaperList > li { border: 1px solid var(--tita-line); border-radius: 8px; background: var(--tita-surface); padding: 9px 11px; }
-.tita-intentPaperList a { color: var(--tita-primary); font-size: 12px; font-weight: 640; text-decoration: none; }
-.tita-intentPaperList a:hover { text-decoration: underline; }
-.tita-intentPaperMeta { display: block; margin-top: 2px; color: var(--tita-ink-faint); font-size: 10px; }
-.tita-intentPaperList p { margin: 6px 0 0; color: var(--tita-ink-muted); font-size: 11px; line-height: 1.75; }
-.tita-intentPaperNote { color: var(--tita-ink-faint) !important; font-size: 10.5px !important; }
-.tita-intentOasLegend { display: flex; flex-wrap: wrap; align-items: center; gap: 5px 12px; margin-top: 9px; color: var(--tita-ink-faint); font-size: 10px; }
-.tita-intentOasLegend span { display: inline-flex; align-items: center; gap: 4px; }
-.tita-intentOasLegend svg { color: var(--tita-primary); }
+.tita-kbHint code { border-radius: 4px; background: var(--tita-surface-muted); padding: 0 4px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 10.5px; }
 
 /* Wiki 编译与召回流程：总览图 + 当前选中节点说明。 */
 .tita-wikiFlowSection + .tita-wikiFlowSection { margin-top: 30px; border-top: 1px solid var(--tita-line); padding-top: 24px; }
@@ -1414,6 +1334,7 @@ html[data-platform='darwin'] [data-window-drag] [data-conversation-tabs] > [role
 .tita-trialMatrixGrid tbody th > .tita-trialMatrixAxisPick { margin-bottom: 3px; }
 .tita-trialMatrixObjectHead { text-align: center; }
 .tita-trialMatrixLoose { display: block; width: 100%; max-width: 100%; margin: 0; border: 1px solid transparent; border-radius: 5px; color: var(--tita-ink-faint); padding: 0 3px; font: inherit; font-size: 9px; font-weight: 500; line-height: 1.5; text-align: center; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.tita-trialMatrixLooseStack { display: grid; min-width: 0; justify-items: center; gap: 1px; }
 .tita-trialMatrixLooseEmpty { display: block; height: 14px; }
 .tita-trialMatrixLoosePick { border-color: var(--tita-line); background: none; cursor: pointer; }
 .tita-trialMatrixLoosePick:hover { border-color: var(--tita-line-strong); color: var(--tita-ink-muted); }
@@ -1450,6 +1371,16 @@ html[data-platform='darwin'] [data-window-drag] [data-conversation-tabs] > [role
 .tita-trialMatrixCellPick:focus-visible { outline: 2px solid var(--tita-focus-ring); outline-offset: 0; }
 .tita-trialMatrixCellPickOn { border-color: var(--tita-primary); background: var(--tita-primary-soft); color: var(--tita-primary); }
 .tita-trialMatrixCellValue { font-size: 11px; font-weight: 700; font-variant-numeric: tabular-nums; }
+.tita-trialMatrixCellStack { display: grid; min-width: 0; justify-items: center; gap: 1px; }
+.tita-trialMatrixCellStack .tita-trialMatrixCellPick,
+.tita-trialMatrixCellStack .tita-trialMatrixCellStatic { min-height: 20px; }
+.tita-trialMatrixBreakdown { display: flex; min-width: 0; flex-wrap: wrap; justify-content: center; gap: 2px; }
+.tita-trialMatrixBreakdownItem { display: inline-flex; align-items: center; justify-content: center; border: 1px solid transparent; border-radius: 4px; color: var(--tita-ink-muted); padding: 0 2px; font-size: 8px; font-weight: 650; line-height: 1.35; font-variant-numeric: tabular-nums; white-space: nowrap; }
+.tita-trialMatrixBreakdownPick { background: transparent; cursor: pointer; }
+.tita-trialMatrixBreakdownPick:hover { border-color: var(--tita-line-strong); background: var(--tita-surface-muted); color: var(--tita-ink); }
+.tita-trialMatrixBreakdownPick:focus-visible { outline: 2px solid var(--tita-focus-ring); outline-offset: 1px; }
+.tita-trialMatrixBreakdownOn { border-color: var(--tita-primary); background: var(--tita-primary-soft); color: var(--tita-primary); }
+.tita-trialMatrixBreakdownOn:hover { background: var(--tita-primary-soft); color: var(--tita-primary); }
 .tita-trialMatrixGroups { display: grid; gap: 0; }
 .tita-trialMatrixGroupLine { display: block; min-width: 0; }
 .tita-trialMatrixGroupLine + .tita-trialMatrixGroupLine { border-top: 1px dashed var(--tita-line); }
@@ -2049,8 +1980,6 @@ button.tita-trialMatrixGroup:focus-visible { outline: 2px solid var(--tita-focus
 .tita-recallAnalysisTitle > svg { flex: 0 0 auto; color: var(--tita-tone-violet); }
 .tita-recallAnalysisTitle h4 { margin: 0; color: var(--tita-ink); font-size: 11.5px; font-weight: 720; }
 .tita-recallAnalysisTitle span { display: block; margin-top: 1px; color: var(--tita-ink-faint); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 9.5px; }
-.tita-recallAnalysisIntent { display: inline-flex; flex: 0 0 auto; align-items: baseline; gap: 5px; border-radius: 999px; background: var(--tita-tone-violet-tint); color: var(--tita-tone-violet); padding: 3px 8px; font-size: 10.5px; font-weight: 700; }
-.tita-recallAnalysisIntent b { color: var(--tita-ink-faint); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 9px; font-weight: 600; }
 .tita-recallAnalysisAxes { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 7px; }
 .tita-recallAnalysisAxis { display: grid; min-width: 0; gap: 5px; border: 1px solid var(--tita-line); border-radius: 8px; background: var(--tita-surface); padding: 7px 8px; }
 .tita-recallAnalysisAxisHead { display: flex; align-items: center; gap: 5px; color: var(--tita-ink-muted); font-size: 10px; }
@@ -2161,16 +2090,6 @@ button.tita-trialMatrixGroup:focus-visible { outline: 2px solid var(--tita-focus
 .tita-hitSnippet { margin: 0; color: var(--tita-ink-muted); font-size: 11px; line-height: 1.6; overflow-wrap: anywhere; }
 .tita-hitFoot { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; color: var(--tita-ink-faint); font-size: 10px; }
 
-/* 意图：从最近记录里归纳出的分布（act / 分类 / 低置信度）。 */
-.tita-distList { display: grid; gap: 7px; margin: 10px 0 0; }
-.tita-distRow { display: grid; grid-template-columns: minmax(56px, 96px) minmax(0, 1fr) 34px; align-items: center; gap: 8px; }
-.tita-distRow > span { overflow: hidden; color: var(--tita-ink-muted); font-size: 11px; text-overflow: ellipsis; white-space: nowrap; }
-.tita-distBar { height: 7px; overflow: hidden; border-radius: 999px; background: var(--tita-surface-muted); }
-.tita-distBar > i { display: block; height: 100%; border-radius: 999px; background: var(--tita-tone-violet); }
-.tita-distBarFts > i { background: var(--tita-primary); }
-.tita-distBarGraph > i { background: var(--tita-tone-green); }
-.tita-distCount { color: var(--tita-ink-faint); font-size: 10.5px; text-align: right; }
-
 /* 记忆：真实落盘计数（04_memory）与「示意」卡片分开摆，避免把占位数字读成真实数据。 */
 .tita-memoryReal { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 10px; margin-bottom: 14px; }
 

package/src/config-schema.ts

@@ -9,7 +9,7 @@
  * （`{op:'set', path:['knowledge','recallTopK']}`）。
  *
  * `knowledge` / `convert` 沿用原来的配置边界；`behaviorRules` 保存可关闭的系统提示词
- * 扩展开关。会话意图审计仍使用固定内置契约，不属于 entry config。
+ * 扩展开关。
  *
  * 「单独一个模块」的理由和 `settings-schema.ts` 一样，
  * 是**可测**：`tests/settings-schema.test.mjs` 要能 import 这个 schema 并把它解析

package/src/convert/host.ts

@@ -91,14 +91,13 @@ export interface ConvertHostDeps {
    * 0.1.7 起设置不再是命名空间，而是随 `apply(ctx, config)` 进来的 entry config，
    * 所以这里由调用方把那一组传下来。省略时用 `DEFAULT_CONVERT_CONFIG`。
    *
-   * 允许给**函数**的理由与意图那组相同（见 `intent/host.ts` 的 `IntentHostDeps.config`）：
-   * 字段是 volatile，解包是一次快照，而 volatile 改动不会重载插件。
+   * 给函数可响应设置热更新：字段是 volatile，解包是一次快照，而 volatile 改动不会重载插件。
    */
   config?: Partial<ConvertPluginConfig> | (() => Partial<ConvertPluginConfig>)
 }
 
 /**
- * `applyConvert` 交给组合根的那一个把手，与 `intent/host.ts` 的 `IntentHost` 同形。
+ * `applyConvert` 交给组合根的那一个把手。
  *
  * 转换这一组也有 volatile 字段（`maxConcurrent` / `maxInputBytes` / `retentionDays` /
  * `toolWaitMs` / `ingestEnabled`），其中一个解包漏了就是沉默的错误：`maxInputBytes`
@@ -131,7 +130,7 @@ function lineageOf(args: Args, exec?: ToolRunContext): Record<string, string> |
   const sessionId = typeof args.session_key === 'string' && args.session_key.trim() ? args.session_key.trim() : exec?.agent?.session.header.id
   if (sessionId) lineage.sessionId = sessionId
   const fields: Array<[string, string]> = [
-    ['turnId', 'turn_id'], ['intentId', 'intent_id'], ['taskId', 'task_id'],
+    ['turnId', 'turn_id'], ['taskId', 'task_id'],
     ['subtaskId', 'subtask_id'], ['parentSubtaskId', 'parent_subtask_id'], ['runId', 'run_id'], ['traceId', 'trace_id'], ['domain', 'domain'],
   ]
   for (const [target, source] of fields) if (typeof args[source] === 'string' && args[source].trim()) lineage[target] = args[source].trim().slice(0, 160)
@@ -506,7 +505,8 @@ export function applyConvert(ctx: Context, deps: ConvertHostDeps): ConvertHost {
       convert_task_id: { type: 'string', required: true },
       kb: { type: 'string', description: '目标知识库 id；省略则写入默认知识库' },
       title: { type: 'string' },
-      source_id: { type: 'string', description: '写进这一条已有的 SourceRaw（同一实体的新版本）。省略则按 external_id / 内容算一个新来源 —— 给一份「已经录进库的文档重新转换」时应当传它，否则会多出一条来源。' },
+      source_id: { type: 'string', description: '导入前分配的稳定 Source Raw ID；重试沿用，更新已有来源时明确传入其 ID。' },
+      allow_duplicate_title: { type: 'boolean', description: '显式允许同名独立来源；来源身份由 source_id 指定。' },
       plan_only: { type: 'boolean' },
       session_key: { type: 'string' },
       task_id: { type: 'string' },
@@ -533,6 +533,7 @@ export function applyConvert(ctx: Context, deps: ConvertHostDeps): ConvertHost {
         knowledgeRoot: target.knowledgeRoot,
         ...(typeof args.title === 'string' && args.title.trim() ? { title: args.title.trim() } : {}),
         ...(typeof args.source_id === 'string' && args.source_id.trim() ? { sourceId: args.source_id.trim() } : {}),
+        ...(args.allow_duplicate_title === true ? { allowDuplicateTitle: true } : {}),
         planOnly: args.plan_only === true,
         ...(lineageOf(args, exec) ? { lineage: lineageOf(args, exec)! } : {}),
       })
@@ -588,6 +589,7 @@ export function applyConvert(ctx: Context, deps: ConvertHostDeps): ConvertHost {
             knowledgeRoot: target.knowledgeRoot,
             ...(typeof body.title === 'string' && body.title.trim() ? { title: body.title.trim() } : {}),
             ...(typeof body.source_id === 'string' && body.source_id.trim() ? { sourceId: body.source_id.trim() } : {}),
+            ...(body.allow_duplicate_title === true ? { allowDuplicateTitle: true } : {}),
             planOnly: body.plan_only === true,
             ...(body.lineage && typeof body.lineage === 'object' ? { lineage: body.lineage as Record<string, string> } : {}),
           })

package/src/convert/ingest.ts

@@ -46,6 +46,7 @@ export interface IngestTarget {
     externalId?: string
     metadata?: Record<string, unknown>
     sourceId?: string
+    allowDuplicateTitle?: boolean
     lineage?: LineageContext
     /** OKF v0.2 溯源信息（0048）：写成 front matter 的顶层键，不塞进 metadata。 */
     provenance?: SourceProvenance
@@ -77,6 +78,7 @@ export interface IngestOptions {
    * 历史保留、卡片与知识的出处不变、正文与图片引用一起更新。
    */
   sourceId?: string
+  allowDuplicateTitle?: boolean
   metadata?: Record<string, unknown>
   lineage?: Record<string, unknown>
   /** Dry run: build the plan without copying assets or writing the source. */
@@ -455,6 +457,7 @@ export async function ingestDelivery(options: IngestOptions): Promise<Envelope<I
       metadata,
       provenance,
       ...(options.sourceId?.trim() ? { sourceId: options.sourceId.trim() } : {}),
+      ...(options.allowDuplicateTitle === true ? { allowDuplicateTitle: true } : {}),
       ...(options.lineage ? { lineage: options.lineage as LineageContext } : {}),
     })
 

package/src/diagnosis/types.ts

@@ -5,7 +5,7 @@
  * `/diagnosis/graph`）。视图是消费者，不是所有者 —— 模型放在领域层，客户端和宿主
  * 各自 import，谁都不能私自改形状。
  *
- * 目录约定：`src/diagnosis/` 与 `src/intent/`、`src/convert/` 平级，都是领域子模块；
+ * 目录约定：`src/diagnosis/` 与 `src/convert/` 平级，都是领域子模块；
  * `src/client/` 只放渲染。判据与 0020 第 3 条一致：**目录镜像领域流水线，不镜像技术层次**。
  */
 

package/src/images.ts

@@ -185,7 +185,7 @@ export async function publishKnowledgeImage(
     throw new ImagePublishError('ASSET_NAME_COLLISION', '目标文件名已被不同内容占用，未覆盖现有图片。')
   }
   if (!existing?.equals(bytes)) await writeBufferAtomic(join(assetDir, storedFilename), bytes)
-  // Standalone hosted images have no SourceRaw or card by design. Keep that intent beside the
+  // Standalone hosted images have no SourceRaw or card by design. Keep that reason beside the
   // asset so the orphan sweep does not mistake it for a disposable extraction artifact.
   await writeTextAtomic(join(assetDir, PUBLISHED_IMAGE_MARKER), 'image_publish\n')
   const relativePath = `${ASSETS_DIR}/${bucket}/${storedFilename}`