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

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' }
@@ -250,15 +247,14 @@ function App(): ReactNode {
 
   if (route.kind === 'run') return <RunPage kb={route.kb} runId={route.run} />
 
-  if (route.kind === 'tasks') return <PageShell title="知识处理" column="tasks"><ExtractionTasksPage kb={route.kb} /></PageShell>
+  if (route.kind === 'tasks') {
+    return <PageShell title="知识处理" meta="从来源到检索索引，一条可核对的流水线" column="tasks"><ExtractionTasksPage kb={route.kb} /></PageShell>
+  }
 
   if (route.kind === 'help') {
     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 +268,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,10 @@ 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。' },
+      source_url: { type: 'string', description: '明确的原始访问 URL，保留参数和 fragment。网页文件内自带 canonical 地址不会自动作为身份。' },
+      source_identity: { type: 'json', description: '{system, scope, document_id, document_type?, url?}；链接也可传 {url, scope?}。' },
+      allow_duplicate_title: { type: 'boolean', description: '显式允许同名独立来源；URL 或平台 ID 已匹配时复用已有来源。' },
       plan_only: { type: 'boolean' },
       session_key: { type: 'string' },
       task_id: { type: 'string' },
@@ -533,6 +535,9 @@ 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.source_url === undefined ? {} : { sourceUrl: args.source_url }),
+        ...(args.source_identity === undefined ? {} : { sourceIdentity: args.source_identity }),
+        ...(args.allow_duplicate_title === true ? { allowDuplicateTitle: true } : {}),
         planOnly: args.plan_only === true,
         ...(lineageOf(args, exec) ? { lineage: lineageOf(args, exec)! } : {}),
       })
@@ -588,6 +593,9 @@ 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.source_url === undefined ? {} : { sourceUrl: body.source_url }),
+            ...(body.source_identity === undefined ? {} : { sourceIdentity: body.source_identity }),
+            ...(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

@@ -1,3 +1,4 @@
+import type { SourceIdentity, SourceIdentityInput } from '../source-identity.js'
 /**
  * The knowledge-ingestion seam.
  *
@@ -46,6 +47,9 @@ export interface IngestTarget {
     externalId?: string
     metadata?: Record<string, unknown>
     sourceId?: string
+    sourceUrl?: string
+    sourceIdentity?: SourceIdentityInput
+    allowDuplicateTitle?: boolean
     lineage?: LineageContext
     /** OKF v0.2 溯源信息（0048）：写成 front matter 的顶层键，不塞进 metadata。 */
     provenance?: SourceProvenance
@@ -55,7 +59,7 @@ export interface IngestTarget {
      * `path` 是可选的：0062 v2 起正文进库，没有对应的文件了。调用方只能依赖 `sourceId`
      * —— 那本来就是稳定身份，而路径从来不是（0051 起文件名跟着标题走）。
      */
-    data: { sourceId: string; path?: string }
+    data: { sourceId: string; path?: string; reusedSource?: boolean; sourceIdentity?: SourceIdentity[]; candidates?: string[] }
     error?: { code?: string; message?: string; suggestion?: string } | null
   }>
 }
@@ -71,12 +75,15 @@ export interface IngestOptions {
   /**
    * 写进**哪一条** SourceRaw（0070）。
    *
-   * 省略时 `addSource` 按 `external_id ?? content` 算一个新 id —— 于是「把一份已经录进库
+   * 省略时按持久转换任务 ID 派生稳定的来源 ID（不使用正文、文件名或 external_id） —— 于是「把一份已经录进库
    * 的文档重新转换一次（比如这次补上了它的图）」会**多出一条来源**，而旧那条仍挂着断引用、
    * 它的卡片与知识也还指着旧 id。给出 `sourceId` 时走的是同一实体的新版本：
    * 历史保留、卡片与知识的出处不变、正文与图片引用一起更新。
    */
   sourceId?: string
+  sourceUrl?: string
+  sourceIdentity?: SourceIdentityInput
+  allowDuplicateTitle?: boolean
   metadata?: Record<string, unknown>
   lineage?: Record<string, unknown>
   /** Dry run: build the plan without copying assets or writing the source. */
@@ -99,6 +106,9 @@ export interface PlacedOriginal {
 }
 
 export interface IngestOutcome {
+  reusedSource?: boolean
+  sourceIdentity?: SourceIdentity[]
+  candidateSourceIds?: string[]
   taskId: string
   sourceId?: string
   sourcePath?: string
@@ -433,12 +443,12 @@ export async function ingestDelivery(options: IngestOptions): Promise<Envelope<I
    */
   const provenance: SourceProvenance = {
     ...(payload.document?.description ? { description: payload.document.description } : {}),
-    ...(payload.sourceUrl ? { resource: payload.sourceUrl } : {}),
+    ...((options.sourceUrl ?? options.sourceIdentity?.url ?? payload.sourceUrl) ? { resource: options.sourceUrl ?? options.sourceIdentity?.url ?? payload.sourceUrl } : {}),
     generatedBy: `convert/${payload.parser}`,
     generatedAt: new Date().toISOString(),
     sources: [{
       id: 'origin',
-      resource: payload.sourceUrl ?? payload.original?.rel ?? payload.sourcePath ?? title,
+      resource: options.sourceUrl ?? options.sourceIdentity?.url ?? payload.sourceUrl ?? payload.original?.rel ?? payload.sourcePath ?? title,
       title,
       ...(payload.document?.siteName ? { author: payload.document.siteName } : {}),
       ...(!payload.document?.siteName && payload.document?.author ? { author: payload.document.author } : {}),
@@ -454,7 +464,10 @@ export async function ingestDelivery(options: IngestOptions): Promise<Envelope<I
       externalId,
       metadata,
       provenance,
-      ...(options.sourceId?.trim() ? { sourceId: options.sourceId.trim() } : {}),
+      ...(options.sourceUrl === undefined ? {} : { sourceUrl: options.sourceUrl }),
+      ...(options.sourceIdentity === undefined ? {} : { sourceIdentity: options.sourceIdentity }),
+      sourceId: options.sourceId?.trim() || `src_convert_${createHash('sha256').update(`convert-task:${taskId}`).digest('hex').slice(0, 32)}`,
+      ...(options.allowDuplicateTitle === true ? { allowDuplicateTitle: true } : {}),
       ...(options.lineage ? { lineage: options.lineage as LineageContext } : {}),
     })
 
@@ -472,7 +485,7 @@ export async function ingestDelivery(options: IngestOptions): Promise<Envelope<I
        */
       await removeCreated(created)
       return failure(
-        emptyOutcome(taskId, options.knowledgeRoot),
+        { ...emptyOutcome(taskId, options.knowledgeRoot), candidateSourceIds: result.data.candidates },
         code,
         result.error?.message ?? '知识库拒绝了该来源',
         false,
@@ -491,7 +504,7 @@ export async function ingestDelivery(options: IngestOptions): Promise<Envelope<I
     return success<IngestOutcome>(
       {
         taskId,
-        sourceId,
+        sourceId, reusedSource: result.data.reusedSource, sourceIdentity: result.data.sourceIdentity,
         ...(sourcePath ? { sourcePath } : {}),
         knowledgeRoot: options.knowledgeRoot,
         externalId,

package/src/diagnosis/store.ts

@@ -373,7 +373,7 @@ export class DiagnosisStore {
   /**
    * 一次排查结束只写一条 SourceRaw。案例视图从这条记录派生；Knowledge / Event 的抽取与归一
    * 仍由知识处理阶段执行，避免把同一份排查过程再写成另一张 WikiCard。
-   * 幂等：`externalId` = runId，同一次排查重跑不会写出第二条来源。
+   * 幂等：显式 sourceId = diagnosis:<runId>，同一次排查重跑不会写出第二条来源。
    */
   async recordRun(record: DiagnosisRunRecord): Promise<{ sourceId?: string; problems: string[] }> {
     const problems: string[] = []
@@ -427,13 +427,18 @@ export class DiagnosisStore {
    * 落原始材料。
    *
    * 一个细节：种子手册与三篇复盘在**非首次**运行时可能已经存在（用户的知识根里），
-   * `addSource` 用 `externalId` 幂等，所以重复调用不会写出第二份。
+   * 种子来源复用已有 sourceId；新种子使用稳定的内部 ID，不依赖 addSource 隐式合并。
    */
   private async writeSources(sources: SeedSource[]): Promise<{ problems: string[]; refs: Map<string, string> }> {
     const problems: string[] = []
     const refs = new Map<string, string>()
+    const known = await this.host.loadSources()
     for (const source of sources) {
+      // Compatibility resolution is limited to this internal seed namespace. Keep existing source IDs.
+      const matches = known.filter(item => item.externalId === `diagnosis-seed:${source.id}`)
+      if (matches.length > 1) { problems.push(`种子来源 ${source.id} 存在多个历史 ID，未自动覆盖。`); continue }
       const added = await this.host.addSource({
+        sourceId: matches[0]?.sourceId ?? `diagnosis-seed:${source.id}`,
         title: source.title,
         content: source.content,
         externalId: `diagnosis-seed:${source.id}`,

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/extract-model.ts

@@ -62,6 +62,9 @@ import type { KnowledgeCard, SchemaType, SourceRaw, WikiTypeDef } from './types.
 export type ModelCall = (request: {
   system: string
   prompt: string
+  signal?: AbortSignal
+  retryAttempts?: number
+  maxTokens?: number
   sessionId?: string
   /** 可选观察本次请求的 provider 用量；普通调用方可以忽略。 */
   onUsage?: (usage: TrialTokenUsage) => void

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}`