dsh-data-domain-knowledge 0.1.0-alpha.13 → 0.1.0-alpha.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (266) hide show
  1. package/README.md +89 -56
  2. package/cordis.patch.yml +36 -129
  3. package/eval/benchmark-extraction-format.mjs +20 -0
  4. package/lib/client.js +3262 -4142
  5. package/lib/doc-page.js +1 -1
  6. package/lib/pages.js +1147 -364
  7. package/lib/types/axis-registry.d.ts +8 -1
  8. package/lib/types/axis-registry.d.ts.map +1 -1
  9. package/lib/types/axis-registry.js +62 -7
  10. package/lib/types/axis-registry.js.map +1 -1
  11. package/lib/types/convert/host.d.ts.map +1 -1
  12. package/lib/types/convert/host.js +3 -0
  13. package/lib/types/convert/host.js.map +1 -1
  14. package/lib/types/convert/ingest.d.ts +9 -0
  15. package/lib/types/convert/ingest.d.ts.map +1 -1
  16. package/lib/types/convert/ingest.js +68 -9
  17. package/lib/types/convert/ingest.js.map +1 -1
  18. package/lib/types/diagnosis/cards.d.ts +7 -3
  19. package/lib/types/diagnosis/cards.d.ts.map +1 -1
  20. package/lib/types/diagnosis/cards.js +13 -8
  21. package/lib/types/diagnosis/cards.js.map +1 -1
  22. package/lib/types/diagnosis/run.d.ts +4 -13
  23. package/lib/types/diagnosis/run.d.ts.map +1 -1
  24. package/lib/types/diagnosis/run.js +26 -16
  25. package/lib/types/diagnosis/run.js.map +1 -1
  26. package/lib/types/diagnosis/schema.js +2 -2
  27. package/lib/types/diagnosis/schema.js.map +1 -1
  28. package/lib/types/diagnosis/seed-source.d.ts +1 -1
  29. package/lib/types/diagnosis/seed-source.d.ts.map +1 -1
  30. package/lib/types/diagnosis/seed-source.js +5 -4
  31. package/lib/types/diagnosis/seed-source.js.map +1 -1
  32. package/lib/types/diagnosis/seed.d.ts +4 -4
  33. package/lib/types/diagnosis/seed.d.ts.map +1 -1
  34. package/lib/types/diagnosis/seed.js +6 -8
  35. package/lib/types/diagnosis/seed.js.map +1 -1
  36. package/lib/types/diagnosis/store.d.ts +18 -17
  37. package/lib/types/diagnosis/store.d.ts.map +1 -1
  38. package/lib/types/diagnosis/store.js +94 -66
  39. package/lib/types/diagnosis/store.js.map +1 -1
  40. package/lib/types/diagnosis/types.d.ts +10 -16
  41. package/lib/types/diagnosis/types.d.ts.map +1 -1
  42. package/lib/types/diagnosis/types.js.map +1 -1
  43. package/lib/types/environment/dsh-python.d.ts +77 -0
  44. package/lib/types/environment/dsh-python.d.ts.map +1 -0
  45. package/lib/types/environment/dsh-python.js +139 -0
  46. package/lib/types/environment/dsh-python.js.map +1 -0
  47. package/lib/types/environment/install.d.ts +9 -1
  48. package/lib/types/environment/install.d.ts.map +1 -1
  49. package/lib/types/environment/install.js +149 -24
  50. package/lib/types/environment/install.js.map +1 -1
  51. package/lib/types/environment/model-catalog.d.ts +34 -2
  52. package/lib/types/environment/model-catalog.d.ts.map +1 -1
  53. package/lib/types/environment/model-catalog.js +40 -2
  54. package/lib/types/environment/model-catalog.js.map +1 -1
  55. package/lib/types/environment/service.d.ts +13 -3
  56. package/lib/types/environment/service.d.ts.map +1 -1
  57. package/lib/types/environment/service.js +127 -23
  58. package/lib/types/environment/service.js.map +1 -1
  59. package/lib/types/environment/types.d.ts +9 -0
  60. package/lib/types/environment/types.d.ts.map +1 -1
  61. package/lib/types/events.d.ts +2 -0
  62. package/lib/types/events.d.ts.map +1 -1
  63. package/lib/types/events.js +13 -0
  64. package/lib/types/events.js.map +1 -1
  65. package/lib/types/extract-contract.d.ts +1 -1
  66. package/lib/types/extract-contract.d.ts.map +1 -1
  67. package/lib/types/extract-contract.js +34 -31
  68. package/lib/types/extract-contract.js.map +1 -1
  69. package/lib/types/extract-model.d.ts +2 -0
  70. package/lib/types/extract-model.d.ts.map +1 -1
  71. package/lib/types/extract-model.js.map +1 -1
  72. package/lib/types/extract-table-contract.d.ts +3 -0
  73. package/lib/types/extract-table-contract.d.ts.map +1 -0
  74. package/lib/types/extract-table-contract.js +30 -0
  75. package/lib/types/extract-table-contract.js.map +1 -0
  76. package/lib/types/extract-table.d.ts +8 -0
  77. package/lib/types/extract-table.d.ts.map +1 -0
  78. package/lib/types/extract-table.js +151 -0
  79. package/lib/types/extract-table.js.map +1 -0
  80. package/lib/types/extraction-runs.d.ts +30 -6
  81. package/lib/types/extraction-runs.d.ts.map +1 -1
  82. package/lib/types/extraction-runs.js +69 -8
  83. package/lib/types/extraction-runs.js.map +1 -1
  84. package/lib/types/fs-atomic.d.ts +0 -7
  85. package/lib/types/fs-atomic.d.ts.map +1 -1
  86. package/lib/types/fs-atomic.js +17 -2
  87. package/lib/types/fs-atomic.js.map +1 -1
  88. package/lib/types/images.d.ts +1 -1
  89. package/lib/types/images.d.ts.map +1 -1
  90. package/lib/types/images.js +2 -2
  91. package/lib/types/images.js.map +1 -1
  92. package/lib/types/index.d.ts.map +1 -1
  93. package/lib/types/index.js +232 -50
  94. package/lib/types/index.js.map +1 -1
  95. package/lib/types/intent/scope.d.ts.map +1 -1
  96. package/lib/types/intent/scope.js +1 -0
  97. package/lib/types/intent/scope.js.map +1 -1
  98. package/lib/types/intent/tools.d.ts +19 -0
  99. package/lib/types/intent/tools.d.ts.map +1 -1
  100. package/lib/types/intent/tools.js +37 -1
  101. package/lib/types/intent/tools.js.map +1 -1
  102. package/lib/types/knowledge-bases.d.ts.map +1 -1
  103. package/lib/types/knowledge-bases.js +5 -16
  104. package/lib/types/knowledge-bases.js.map +1 -1
  105. package/lib/types/knowledge.d.ts +3 -0
  106. package/lib/types/knowledge.d.ts.map +1 -1
  107. package/lib/types/knowledge.js +21 -5
  108. package/lib/types/knowledge.js.map +1 -1
  109. package/lib/types/materialize-snapshot.d.ts +49 -0
  110. package/lib/types/materialize-snapshot.d.ts.map +1 -0
  111. package/lib/types/materialize-snapshot.js +2 -0
  112. package/lib/types/materialize-snapshot.js.map +1 -0
  113. package/lib/types/model-text.d.ts +1 -1
  114. package/lib/types/model-text.d.ts.map +1 -1
  115. package/lib/types/model-text.js +5 -4
  116. package/lib/types/model-text.js.map +1 -1
  117. package/lib/types/oplog.d.ts.map +1 -1
  118. package/lib/types/oplog.js +7 -0
  119. package/lib/types/oplog.js.map +1 -1
  120. package/lib/types/pipeline/engine.d.ts +60 -0
  121. package/lib/types/pipeline/engine.d.ts.map +1 -0
  122. package/lib/types/pipeline/engine.js +338 -0
  123. package/lib/types/pipeline/engine.js.map +1 -0
  124. package/lib/types/pipeline/store.d.ts +73 -0
  125. package/lib/types/pipeline/store.d.ts.map +1 -0
  126. package/lib/types/pipeline/store.js +143 -0
  127. package/lib/types/pipeline/store.js.map +1 -0
  128. package/lib/types/pipeline/types.d.ts +101 -0
  129. package/lib/types/pipeline/types.d.ts.map +1 -0
  130. package/lib/types/pipeline/types.js +5 -0
  131. package/lib/types/pipeline/types.js.map +1 -0
  132. package/lib/types/present.d.ts +2 -0
  133. package/lib/types/present.d.ts.map +1 -1
  134. package/lib/types/present.js +9 -4
  135. package/lib/types/present.js.map +1 -1
  136. package/lib/types/retention.d.ts +39 -0
  137. package/lib/types/retention.d.ts.map +1 -0
  138. package/lib/types/retention.js +42 -0
  139. package/lib/types/retention.js.map +1 -0
  140. package/lib/types/runtime.d.ts +115 -5
  141. package/lib/types/runtime.d.ts.map +1 -1
  142. package/lib/types/runtime.js +862 -132
  143. package/lib/types/runtime.js.map +1 -1
  144. package/lib/types/source-evidence.d.ts +9 -1
  145. package/lib/types/source-evidence.d.ts.map +1 -1
  146. package/lib/types/source-evidence.js +13 -5
  147. package/lib/types/source-evidence.js.map +1 -1
  148. package/lib/types/store/axis-references.js +3 -3
  149. package/lib/types/store/axis-references.js.map +1 -1
  150. package/lib/types/store/derived.d.ts +1 -1
  151. package/lib/types/store/derived.d.ts.map +1 -1
  152. package/lib/types/store/derived.js +41 -7
  153. package/lib/types/store/derived.js.map +1 -1
  154. package/lib/types/store/knowledge-db.d.ts +18 -0
  155. package/lib/types/store/knowledge-db.d.ts.map +1 -1
  156. package/lib/types/store/knowledge-db.js +111 -6
  157. package/lib/types/store/knowledge-db.js.map +1 -1
  158. package/lib/types/store/migrate.js +1 -1
  159. package/lib/types/store/migrate.js.map +1 -1
  160. package/lib/types/trajectory-types.d.ts +172 -0
  161. package/lib/types/trajectory-types.d.ts.map +1 -0
  162. package/lib/types/trajectory-types.js +36 -0
  163. package/lib/types/trajectory-types.js.map +1 -0
  164. package/lib/types/types.d.ts +3 -4
  165. package/lib/types/types.d.ts.map +1 -1
  166. package/lib/types/types.js.map +1 -1
  167. package/lib/types/wiki-finalize.d.ts +16 -0
  168. package/lib/types/wiki-finalize.d.ts.map +1 -1
  169. package/lib/types/wiki-finalize.js +26 -0
  170. package/lib/types/wiki-finalize.js.map +1 -1
  171. package/lib/types/wiki-materialize.d.ts.map +1 -1
  172. package/lib/types/wiki-materialize.js +3 -15
  173. package/lib/types/wiki-materialize.js.map +1 -1
  174. package/lib/types/wiki-trial-types.d.ts +3 -0
  175. package/lib/types/wiki-trial-types.d.ts.map +1 -1
  176. package/lib/types/wiki-trial.d.ts +2 -0
  177. package/lib/types/wiki-trial.d.ts.map +1 -1
  178. package/lib/types/wiki-trial.js +31 -7
  179. package/lib/types/wiki-trial.js.map +1 -1
  180. package/package.json +6 -3
  181. package/preset/tita-data-agent/agent.cordis.yml +36 -129
  182. package/src/axis-registry.ts +57 -9
  183. package/src/client/AttributionEventGuide.tsx +10 -9
  184. package/src/client/CompileDialogs.tsx +10 -2
  185. package/src/client/EnvironmentSetup.tsx +76 -16
  186. package/src/client/ExpansionGraph.tsx +13 -7
  187. package/src/client/ExtractionTasksPage.tsx +543 -156
  188. package/src/client/ImportFilesDialog.tsx +2 -13
  189. package/src/client/IntentTab.tsx +3 -1
  190. package/src/client/KnowledgeBaseTab.tsx +139 -122
  191. package/src/client/KnowledgeLayerSection.tsx +19 -2
  192. package/src/client/KnowledgePanel.tsx +17 -3
  193. package/src/client/ListPager.tsx +15 -5
  194. package/src/client/MaterializeTrajectoryView.tsx +124 -0
  195. package/src/client/NodeSettings.tsx +90 -25
  196. package/src/client/NormalizeTrajectoryView.tsx +136 -0
  197. package/src/client/PipelineNotice.tsx +26 -0
  198. package/src/client/RecallPanel.tsx +55 -25
  199. package/src/client/TabGuide.tsx +4 -4
  200. package/src/client/TrialReportView.tsx +61 -16
  201. package/src/client/TypeDefinitionDrawer.tsx +33 -9
  202. package/src/client/WikiCardPreview.tsx +43 -10
  203. package/src/client/WikiFlowPanel.tsx +4 -4
  204. package/src/client/architecture.tsx +1 -1
  205. package/src/client/attribution/AttributionTab.tsx +37 -36
  206. package/src/client/attribution/CaseView.tsx +3 -1
  207. package/src/client/attribution/EventView.tsx +14 -4
  208. package/src/client/attribution/RunView.tsx +2 -2
  209. package/src/client/attribution/ViewSwitch.tsx +20 -5
  210. package/src/client/attribution/graph-options.ts +38 -31
  211. package/src/client/attribution/model.ts +16 -9
  212. package/src/client/graph/palette.ts +165 -0
  213. package/src/client/pages.css +224 -28
  214. package/src/client/pages.tsx +33 -11
  215. package/src/client/styles.css +61 -6
  216. package/src/client/wiki-trial.ts +30 -1
  217. package/src/convert/host.ts +3 -0
  218. package/src/convert/ingest.ts +73 -9
  219. package/src/diagnosis/cards.ts +13 -8
  220. package/src/diagnosis/run.ts +27 -17
  221. package/src/diagnosis/schema.ts +2 -2
  222. package/src/diagnosis/seed-source.ts +5 -4
  223. package/src/diagnosis/seed.ts +6 -8
  224. package/src/diagnosis/store.ts +99 -69
  225. package/src/diagnosis/types.ts +10 -16
  226. package/src/environment/dsh-python.ts +156 -0
  227. package/src/environment/install.ts +134 -19
  228. package/src/environment/model-catalog.ts +45 -3
  229. package/src/environment/service.ts +111 -23
  230. package/src/environment/types.ts +6 -0
  231. package/src/events.ts +12 -0
  232. package/src/extract-contract.ts +6 -3
  233. package/src/extract-model.ts +2 -0
  234. package/src/extract-table-contract.ts +29 -0
  235. package/src/extract-table.ts +126 -0
  236. package/src/extraction-runs.ts +70 -11
  237. package/src/fs-atomic.ts +19 -2
  238. package/src/images.ts +2 -2
  239. package/src/index.ts +207 -72
  240. package/src/intent/scope.ts +1 -0
  241. package/src/intent/tools.ts +38 -1
  242. package/src/knowledge-bases.ts +4 -12
  243. package/src/knowledge.ts +24 -4
  244. package/src/materialize-snapshot.ts +46 -0
  245. package/src/model-text.ts +5 -3
  246. package/src/oplog.ts +7 -0
  247. package/src/pipeline/engine.ts +312 -0
  248. package/src/pipeline/store.ts +147 -0
  249. package/src/pipeline/types.ts +92 -0
  250. package/src/present.ts +10 -4
  251. package/src/retention.ts +76 -0
  252. package/src/runtime.ts +853 -131
  253. package/src/source-evidence.ts +12 -5
  254. package/src/store/axis-references.ts +3 -3
  255. package/src/store/derived.ts +40 -7
  256. package/src/store/knowledge-db.ts +111 -5
  257. package/src/store/migrate.ts +1 -1
  258. package/src/trajectory-types.ts +142 -0
  259. package/src/types.ts +3 -4
  260. package/src/wiki-finalize.ts +28 -0
  261. package/src/wiki-materialize.ts +3 -14
  262. package/src/wiki-trial-types.ts +3 -0
  263. package/src/wiki-trial.ts +26 -7
  264. package/src/client/convert/ConvertPanel.tsx +0 -583
  265. package/src/client/convert/styles.css +0 -138
  266. package/src/client/convert/styles.ts +0 -49
@@ -31,7 +31,7 @@ import { AlertCircle, Check, FileText, RefreshCw, Trash2, Upload, X } from '@tit
31
31
  import { Button, cn } from '@tita-agent/ui/components'
32
32
  import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from '@tita-agent/ui/overlays'
33
33
  import { styles } from './styles.ts'
34
- import { COMPILE_STEP_TITLE, type CompileProgressView } from './CompileDialogs.tsx'
34
+ import { COMPILE_STEP_TITLE, compileRatio, type CompileProgressView } from './CompileDialogs.tsx'
35
35
  import type { ImportSummaryView } from './KnowledgeBaseTab.tsx'
36
36
 
37
37
  /** 一个文件在这一趟里走到哪了。**两段**(转 → 入库),编译那一段是整批共用的。 */
@@ -168,7 +168,7 @@ export function ImportFilesDialog({
168
168
 
169
169
  {compileProgress !== null && <>
170
170
  <div className={cn(styles.compileBar, styles.importBar)}>
171
- <span style={{ inlineSize: `${ratioOf(compileProgress)}%` }} />
171
+ <span style={{ inlineSize: `${Math.round(compileRatio(compileProgress) * 100)}%` }} />
172
172
  </div>
173
173
  {/* 五段与编译弹窗、SourceRaw 抽取轨迹共用同一套名称和状态。
174
174
  这里回答的是「整批到哪了」,但不能再画成另一套不对应的步骤。 */}
@@ -318,14 +318,3 @@ function CompileStage({ title, note, children }: { title: string; note: string;
318
318
  <p className={styles.importStageBody}>{children}</p>
319
319
  </div>
320
320
  }
321
-
322
- /** 与编译对话框同一条算法:按阶段均分,正在跑的那一段再按文档数细分。 */
323
- function ratioOf(progress: CompileProgressView): number {
324
- if (progress.finishedAt !== undefined) return 100
325
- const total = progress.steps.length || 1
326
- const done = progress.steps.filter(step => step.state === 'done').length
327
- const running = progress.steps.find(step => step.state === 'running')
328
- if (running === undefined) return Math.round((done / total) * 100)
329
- const inner = running.id === 'knowledge' && progress.sourcesTotal > 0 ? progress.sourcesDone / progress.sourcesTotal : 0.5
330
- return Math.min(99, Math.round(((done + inner) / total) * 100))
331
- }
@@ -304,7 +304,9 @@ export function IntentTab({ visible }: { visible: boolean }): ReactNode {
304
304
 
305
305
  {pageNotice !== null && <p className={styles.kbNotice} role="alert">
306
306
  <AlertCircle size={13} /><span>{pageNotice}</span>
307
- <button type="button" className={styles.kbNoticeClose} aria-label="关闭提示" onClick={() => setPageNotice(null)}><X size={12} /></button>
307
+ {/* 这一枚原来是手写的 `<button>`,命中区只有 12px、图标用自己的字号档,焦点圈
308
+ 也是另写的一条。现在用与面板里其余关闭动作同一枚共享控件。 */}
309
+ <Button className={styles.kbNoticeClose} variant="ghost" size="icon" aria-label="关闭提示" title="关闭提示" onClick={() => setPageNotice(null)}><X size={13} /></Button>
308
310
  </p>}
309
311
  {error && <p className={styles.kbNotice}><AlertCircle size={13} /><span>{error}</span></p>}
310
312
 
@@ -36,7 +36,7 @@
36
36
  import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, type ChangeEvent, type ReactNode } from 'react'
37
37
  import {
38
38
  AlertCircle, Check, ChevronDown, Eye, ExternalLink, FileText, FileUp, FolderOpen,
39
- Layers3, ListOrdered, RefreshCw, Sparkles, Tags, Trash2, TriangleAlert, Upload, X,
39
+ Layers3, RefreshCw, Sparkles, Tags, Trash2, TriangleAlert, Upload, X,
40
40
  } from '@tita-agent/ui/icons'
41
41
  import type { LucideIcon } from '@tita-agent/ui/icons'
42
42
  import {
@@ -65,7 +65,9 @@ import {
65
65
  sweepOrphans, requestExtractionRuns, requestKnowledge,
66
66
  type DocumentDeleteImpact, type ExtractionRunSummary,
67
67
  type KnowledgeStats, type KnowledgeView,
68
+ trajectoryStageOf,
68
69
  } from './wiki-trial.ts'
70
+ import { TRAJECTORY_STAGE_LABEL, TRAJECTORY_STAGE_SHORT } from '../trajectory-types.js'
69
71
  import {
70
72
  axisLookupOf, coordinateOf, KNOWLEDGE_STATUS_LABEL, KNOWLEDGE_TONE,
71
73
  type AxisLookup, type AxisOption,
@@ -78,6 +80,7 @@ import { ImportFilesDialog, type ImportItemView, type ImportStage } from './Impo
78
80
  import { TypeDefinitionDrawer, type CompileModelSelectionView } from './TypeDefinitionDrawer.tsx'
79
81
  import { DeleteDocumentDialog } from './DeleteDocumentDialog.tsx'
80
82
  import { InfoHint } from './InfoHint.tsx'
83
+ import { PipelineNotice } from './PipelineNotice.tsx'
81
84
 
82
85
  // ------------------------------------------------------------------ contract
83
86
  // Mirrors the plugin HTTP contract (see plugins/dsh-data-domain-knowledge/README.md).
@@ -603,6 +606,14 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
603
606
  * 所以它不进 `KnowledgeDocument`,单独一张按 docId 查的表。
604
607
  */
605
608
  const [docRunCounts, setDocRunCounts] = useState<Record<string, number>>({})
609
+ /** 服务端给的文件类型计数(搜索之后、类型筛选之前)。下拉的数量读它,不读当前页。 */
610
+ const [docExtCounts, setDocExtCounts] = useState<Record<string, number>>({})
611
+ /** 防抖之后的查询词:取数只跟它,不跟每一次击键。 */
612
+ const [docQuery, setDocQuery] = useState('')
613
+ /** 外部要求重取一页时的信号(刷新按钮、写入之后)。 */
614
+ const [docReloadToken, setDocReloadToken] = useState(0)
615
+ /** 文件列表自己的请求序号:旧响应不许覆盖新响应。 */
616
+ const documentsRequestRef = useRef(0)
606
617
  /**
607
618
  * Knowledge 层的计数(0063)。步轨上 Knowledge 那一步的第二行读它 ——
608
619
  * 它与 `KnowledgeLayerSection` 各自拉一次同一个接口,是有意的:那一节可以不在这一栏
@@ -613,6 +624,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
613
624
  const [eventsLoading, setEventsLoading] = useState(false)
614
625
  const [eventsError, setEventsError] = useState('')
615
626
  const [knowledgeContent, setKnowledgeContent] = useState<'knowledge' | 'event'>('knowledge')
627
+ const [focusedEventId, setFocusedEventId] = useState<string>()
616
628
  const eventsRequestRef = useRef(0)
617
629
  /** 当前打开的文档的轨迹列表(不含报告本体)。报告整页读(见 `openRunPage`)。 */
618
630
  const [detailRuns, setDetailRuns] = useState<ExtractionRunSummary[]>([])
@@ -646,6 +658,14 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
646
658
  const [cardStatus, setCardStatus] = useState('')
647
659
  /** WikiCard 矩阵的坐标筛选。点击矩阵只改变列表范围,不改变 Knowledge 的筛选。 */
648
660
  const [cardMatrixFilter, setCardMatrixFilter] = useState<CardMatrixFilter>({})
661
+ /**
662
+ * 两栏的页码状态。它们必须**在这里**(组件顶层)而不能挪到取数用的 effect 之后:
663
+ * 文件列表的取数 effect 依赖 `docPage`,而 hook 的调用顺序是固定的 ——
664
+ * 声明晚于使用就是「block-scoped variable used before declaration」。
665
+ * 页码的变化会复位:筛选一变就回第 1 页(见 `usePage` 的说明)。
666
+ */
667
+ const [docPage, setDocPage] = usePage(`${activeId}|${query}|${extFilter}`)
668
+ const [cardPage, setCardPage] = usePage(`${activeId}|${cardQuery}|${cardStatus}|${JSON.stringify(cardMatrixFilter)}`)
649
669
  const [cardMatrixFull, setCardMatrixFull] = useState(false)
650
670
  const [loading, setLoading] = useState(false)
651
671
  const [busy, setBusy] = useState<string | null>(null)
@@ -725,6 +745,11 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
725
745
  setTab(next)
726
746
  remember('knowledgeTab', next)
727
747
  }, [])
748
+ const openEvent = useCallback((eventId: string): void => {
749
+ setFocusedEventId(eventId)
750
+ changeTab('knowledge')
751
+ setKnowledgeContent('event')
752
+ }, [changeTab])
728
753
  /** 编译设置抽屉:本库的编译模型、坐标实体与抽取备注。 */
729
754
  const [typeDef, setTypeDef] = useState(false)
730
755
  const [detail, setDetail] = useState<{ document: KnowledgeDocumentDetail; versions: DocumentVersion[] } | null>(null)
@@ -832,18 +857,32 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
832
857
  }, [])
833
858
 
834
859
  /**
835
- * 文件列表。搜索交给服务端,文件类型没有对应的服务端口,所以在拿回来的一页里筛。
860
+ * 文件列表:**搜索、类型筛选、分页三件事都在服务端**(0070)。
836
861
  *
837
- * `limit=500` 是接口允许的上限:文件类型筛在客户端做,只取默认的 50 条会让
838
- * 「筛出 3 个」变成「这一页里有 3 个」—— 两个意思差得很远。
862
+ * 原来是「取前 500 份,然后在客户端这一页里筛类型、切页」:超过 500 份的库,
863
+ * 第 501 份起在面板上不可达,而表头把这种截断显示成「筛出 500 / 600 个」——
864
+ * 读起来像用户自己开了筛选。接口本来就支持 `offset`,所以这里改成按页取。
865
+ * 类型计数由服务端随列表返回(`extCounts`),否则下拉里的数量会随翻页变来变去。
839
866
  */
840
- const loadDocuments = useCallback(async (baseId: string, search: string): Promise<void> => {
841
- const params = new URLSearchParams({ kb: baseId, limit: '500' })
867
+ const loadDocuments = useCallback(async (baseId: string, search: string, ext: string, page: number, requestId: number): Promise<void> => {
868
+ const params = new URLSearchParams({
869
+ kb: baseId,
870
+ limit: String(PAGE_SIZE),
871
+ offset: String(Math.max(0, (Math.max(1, page) - 1) * PAGE_SIZE)),
872
+ })
842
873
  if (search.trim()) params.set('query', search.trim())
843
- const payload = await requestJson<{ documents: KnowledgeDocument[]; total: number; extractionRuns?: Record<string, number> }>(`/knowledge/documents?${params.toString()}`)
844
- const all = payload.data?.documents ?? []
845
- setDocuments(all)
846
- setTotal(payload.data?.total ?? all.length)
874
+ if (ext) params.set('ext', ext)
875
+ const payload = await requestJson<{ documents: KnowledgeDocument[]; total: number; extCounts?: Record<string, number>; extractionRuns?: Record<string, number> }>(`/knowledge/documents?${params.toString()}`)
876
+ /**
877
+ * 旧响应不许覆盖新响应 —— 而且**四个 setState 都要挡**,不能只挡加载态。
878
+ * 慢的第 1 页后到,会把已经翻到第 2 页的列表、总数和类型计数一起退回去,
879
+ * 于是控件说第 2 页、列表是第 1 页的内容。
880
+ */
881
+ if (documentsRequestRef.current !== requestId) return
882
+ const rows = payload.data?.documents ?? []
883
+ setDocuments(rows)
884
+ setTotal(payload.data?.total ?? rows.length)
885
+ setDocExtCounts(payload.data?.extCounts ?? {})
847
886
  // 每份文档有几条抽取轨迹,跟着同一份响应回来 —— 列表徽标要用它。
848
887
  setDocRunCounts(payload.data?.extractionRuns ?? {})
849
888
  }, [])
@@ -902,8 +941,16 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
902
941
  const refresh = useCallback(async (preferred?: string, search = ''): Promise<void> => {
903
942
  setLoading(true)
904
943
  try {
944
+ const previousBase = activeIdRef.current
905
945
  const { resolved } = await loadBases(preferred)
906
- if (resolved) await Promise.all([loadDocuments(resolved, search), loadCards(resolved), loadStats(resolved), loadKnowledge(resolved)])
946
+ /**
947
+ * 文件列表不在这里直接取:它有自己的分页状态(页码 / 类型 / 防抖查询词),
948
+ * 在这里传一份「可能是上一帧的值」会取错页。这里只发一个重取信号。
949
+ *
950
+ * **换了库就不发**:那时 `activeId` 自己会触发一次取数,再发信号就是同一页取两遍。
951
+ */
952
+ if (resolved) await Promise.all([loadCards(resolved), loadStats(resolved), loadKnowledge(resolved)])
953
+ if (resolved && resolved === previousBase) setDocReloadToken(current => current + 1)
907
954
  } catch (error) {
908
955
  setNotice({ tone: 'error', text: error instanceof Error ? error.message : String(error) })
909
956
  } finally {
@@ -932,19 +979,28 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
932
979
  return () => { cancelled = true }
933
980
  }, [visible, activeId])
934
981
 
982
+ /** 搜索框是连续输入,所以防抖 250ms;分页与类型筛选是离散动作,不等。 */
983
+ useEffect(() => {
984
+ const timer = setTimeout(() => setDocQuery(query), 250)
985
+ return () => clearTimeout(timer)
986
+ }, [query])
987
+
935
988
  /**
936
- * 搜索框:打字是**连续输入**,所以防抖 250ms,不必每个字符打一次服务端。
937
- *
938
- * 这里**只跟 `query`**,因为它是连续输入,需要防抖。
989
+ * 文件列表**唯一的取数点**。页码、类型、防抖查询词、重取信号都在依赖里 ——
990
+ * 少了任何一个都会出现「控件变了而列表没变」。带请求序号,旧响应不许覆盖新响应。
939
991
  */
940
992
  useEffect(() => {
941
993
  if (!visible) return undefined
942
- const timer = setTimeout(() => {
943
- const baseId = activeIdRef.current
944
- if (baseId) void loadDocuments(baseId, query).catch(() => undefined)
945
- }, 250)
946
- return () => clearTimeout(timer)
947
- }, [visible, activeId, query, loadDocuments])
994
+ const baseId = activeIdRef.current
995
+ if (!baseId) return undefined
996
+ const requestId = documentsRequestRef.current + 1
997
+ documentsRequestRef.current = requestId
998
+ setLoading(true)
999
+ void loadDocuments(baseId, docQuery, extFilter, docPage, requestId)
1000
+ .catch(() => undefined)
1001
+ .finally(() => { if (documentsRequestRef.current === requestId) setLoading(false) })
1002
+ return () => { documentsRequestRef.current += 1 }
1003
+ }, [visible, activeId, docQuery, extFilter, docPage, docReloadToken, loadDocuments])
948
1004
 
949
1005
  const say = (tone: 'success' | 'error', text: string): void => { setNotice({ tone, text }); onChanged?.() }
950
1006
 
@@ -1202,16 +1258,16 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1202
1258
  }
1203
1259
  }
1204
1260
  await loadBases(base.id)
1205
- await Promise.all([loadDocuments(base.id, query), loadCards(base.id)])
1206
- let report: RebuildReportView | null = null
1261
+ /**
1262
+ * 文件列表由它自己的 effect 取(页码 / 类型 / 防抖查询词是那份状态的一部分),
1263
+ * 这里只发重取信号 —— 直接在这里传一份当前渲染的 `query` 会取错页。
1264
+ */
1265
+ setDocReloadToken(current => current + 1)
1266
+ await loadCards(base.id)
1207
1267
  if (done > 0) {
1208
- setCompileProgress(null)
1209
- report = await rebuild('wiki')
1210
- await Promise.all([loadCards(base.id), loadStats(base.id), loadKnowledge(base.id)])
1211
- say(failedCount === 0 ? 'success' : 'error',
1212
- failedCount === 0
1213
- ? `已导入并编译 ${done} 个文件到「${base.name}」`
1214
- : `导入 ${done} 个、失败 ${failedCount} 个 —— 已对成功的那些跑了增量编译`)
1268
+ say(failedCount === 0 ? 'success' : 'error', failedCount === 0
1269
+ ? `已保存 ${done} 个文件到「${base.name}」,可单独运行抽取`
1270
+ : `已保存 ${done} 个文件,失败 ${failedCount} 个;成功文件可单独抽取`)
1215
1271
  }
1216
1272
  /**
1217
1273
  * 收尾摘要。它是**这一批处理结果的唯一一处汇总** —— 对话框下半截显示它,处理日志里
@@ -1220,46 +1276,15 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1220
1276
  const summary: ImportSummaryView = {
1221
1277
  files: outcomes,
1222
1278
  done, failed: failedCount,
1223
- compile: report === null ? null : {
1224
- version: report.version,
1225
- skipped: report.skipped === true,
1226
- entities: report.detail?.entities ?? null,
1227
- phases: report.detail?.phases ?? null,
1228
- cards: report.detail?.cards ?? null,
1229
- notes: report.detail?.notes ?? null,
1230
- relatedLinks: report.detail?.relatedLinks,
1231
- deadLinks: report.detail?.deadLinks,
1232
- build: report.graphNodes === undefined
1233
- ? null
1234
- : {
1235
- graphNodes: report.graphNodes,
1236
- graphEdges: report.graphEdges ?? 0,
1237
- embedding: report.embedding ?? 'skipped',
1238
- embeddingItems: report.embeddingItems ?? 0,
1239
- embeddingReused: report.embeddingReused ?? 0,
1240
- },
1241
- extractModel: (report.warnings ?? []).some(warning => warning.includes('模型抽取已开启')) ? 'unavailable' : 'ok',
1242
- },
1279
+ compile: null,
1243
1280
  }
1244
1281
  setImportSummary(summary)
1245
1282
  await settleBatchLog(batch, {
1246
1283
  status: failedCount === 0 ? 'done' : done > 0 ? 'partial' : 'failed',
1247
1284
  summary: done === 0
1248
1285
  ? `${failedCount} 个文件全部失败,没有东西进入知识库。`
1249
- : `入库 ${done} 个${failedCount > 0 ? `、失败 ${failedCount} 个` : ''};`
1250
- /**
1251
- * `report === null` 说的是**这一批的编译没读到结论**,不是「没有编译」(0066)。
1252
- *
1253
- * 这句原来是「这一批没有触发编译。」—— 而面板从没有过判断这件事的依据:它只知道
1254
- * 自己那条请求的结局。实机上那条请求在 300 秒被切断,编译在 312 秒成功,于是日志
1255
- * 里留下了一句与事实相反的话。**只写自己知道的事**:
1256
- */
1257
- + (report === null
1258
- ? '编译已发起,但没读到它的结论(可能仍在跑);结论看那一次的处理日志。'
1259
- : report.skipped === true
1260
- ? `编译:语料没变化,索引仍为 v${report.version}。`
1261
- : `编译:新建 ${report.detail?.cards?.created.length ?? 0} 张、并入 ${report.detail?.cards?.updated.length ?? 0} 张、复用 ${report.detail?.cards?.reused.length ?? 0} 张,索引 v${report.version}。`),
1262
- detail: { files: outcomes, ...(report?.detail === undefined ? {} : { compile: report.detail }) },
1286
+ : `入库 ${done} 个${failedCount > 0 ? `、失败 ${failedCount} 个` : ''};本次只保存来源,可在知识处理中运行抽取。`,
1287
+ detail: { files: outcomes },
1263
1288
  })
1264
1289
  setImportRunning(false)
1265
1290
  }
@@ -1383,7 +1408,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1383
1408
  if (!kb) return
1384
1409
  void fullPage.open({
1385
1410
  src: `/knowledge/pages/run?kb=${encodeURIComponent(kb)}&run=${encodeURIComponent(run.id)}`,
1386
- title: `抽取轨迹 · ${formatDateTime(run.createdAt)}`,
1411
+ // 标题按**这条轨迹自己的**阶段写:三段共用同一个地址(见 `pages.tsx` 的 `RunPage`)。
1412
+ title: `${TRAJECTORY_STAGE_LABEL[trajectoryStageOf(run)]} · ${formatDateTime(run.createdAt)}`,
1387
1413
  })
1388
1414
  }
1389
1415
 
@@ -1401,7 +1427,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1401
1427
  })
1402
1428
  setRestoreTarget(null)
1403
1429
  await openDetail(current.document)
1404
- await Promise.all([loadDocuments(baseId, query), loadCards(baseId)])
1430
+ setDocReloadToken(current => current + 1)
1431
+ await loadCards(baseId)
1405
1432
  say('success', `已回滚到 V${target.number}`)
1406
1433
  } catch (error) {
1407
1434
  say('error', error instanceof Error ? error.message : String(error))
@@ -1448,7 +1475,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1448
1475
  * 不跟着刷新,屏幕上会留着一个已经不成立的数字。
1449
1476
  */
1450
1477
  await loadBases(baseId)
1451
- await Promise.all([loadDocuments(baseId, query), loadCards(baseId), loadKnowledge(baseId)])
1478
+ setDocReloadToken(current => current + 1)
1479
+ await Promise.all([loadCards(baseId), loadKnowledge(baseId)])
1452
1480
  /**
1453
1481
  * 级联是**尽力而为**的,所以「删除成功」不等于「清干净了」。
1454
1482
  *
@@ -1529,7 +1557,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1529
1557
  try {
1530
1558
  const swept = await sweepOrphans({ kb: baseId })
1531
1559
  await loadBases(baseId)
1532
- await Promise.all([loadDocuments(baseId, query), loadCards(baseId), loadKnowledge(baseId)])
1560
+ setDocReloadToken(current => current + 1)
1561
+ await Promise.all([loadCards(baseId), loadKnowledge(baseId)])
1533
1562
  const { knowledge, cards, events, assets } = swept
1534
1563
  const total = knowledge.knowledgeDeleted + cards.deleted + events.deleted + events.updated + assets.files
1535
1564
  say('success', total === 0
@@ -1768,7 +1797,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1768
1797
  headers: { 'content-type': 'application/json' },
1769
1798
  // 面板的「重新编译」也承担存量数据修复:明确开启抽取,并绕过旧指纹,
1770
1799
  // 否则旧版本留下的空坐标会被当成未变化结果永久复用。
1771
- body: JSON.stringify({ only, kb: baseId, extract: true, forceExtract: only === 'all' }),
1800
+ body: JSON.stringify({ only, kb: baseId, extract: false, forceExtract: false }),
1772
1801
  })
1773
1802
  compileStartPendingRef.current = false
1774
1803
  runId = started.data?.runId ?? null
@@ -1851,13 +1880,10 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1851
1880
  * 0029 之前它来自每个库那份「文件类型规则」表:既会列出 0 个文件的类型,也会
1852
1881
  * 漏掉文档里有、但没人登记过的扩展名。按实际文档算,两项毛病都没有。
1853
1882
  */
1854
- const extOptions = useMemo(() => {
1855
- const counts = new Map<string, number>()
1856
- for (const document of documents) counts.set(document.ext, (counts.get(document.ext) ?? 0) + 1)
1857
- return [...counts.entries()]
1858
- .sort((a, b) => a[0].localeCompare(b[0]))
1859
- .map(([ext, count]) => ({ value: ext, label: `${ext}(${count})` }))
1860
- }, [documents])
1883
+ const extOptions = useMemo(() => Object.entries(docExtCounts)
1884
+ .filter(([ext]) => ext !== '—')
1885
+ .sort((a, b) => a[0].localeCompare(b[0]))
1886
+ .map(([ext, count]) => ({ value: ext, label: `${ext}(${count})` })), [docExtCounts])
1861
1887
  /**
1862
1888
  * 一次性迁移里没有静默处理掉的事(改名冲突、并入失败…)。
1863
1889
  *
@@ -1921,10 +1947,11 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
1921
1947
  * 文件类型筛在客户端做(接口没有这个过滤口),其余两个筛选在服务端。
1922
1948
  * 列表与计数都读这一份派生值,所以「筛出 3 个」与表头的数字不可能对不上。
1923
1949
  */
1924
- const visibleDocuments = useMemo(
1925
- () => extFilter ? documents.filter(document => document.ext === extFilter) : documents,
1926
- [documents, extFilter],
1927
- )
1950
+ /**
1951
+ * 文件列表现在**就是**服务端给的那一页:类型筛选与分页都在服务端做,
1952
+ * 所以这里不再二次过滤(再筛一次会变成「这一页里符合的有几条」)。
1953
+ */
1954
+ const visibleDocuments = documents
1928
1955
 
1929
1956
  const cardMatrix = useMemo(() => cardMatrixOf(cards, axisLookup), [cards, axisLookup])
1930
1957
  const cardMatrixView = cardMatrix.view
@@ -2001,9 +2028,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2001
2028
  * 是按当前分栏条件调用的,在它们里面写 `useState` 会让 hook 的调用顺序随分栏变化 ——
2002
2029
  * 那是 React 明确禁止的写法。
2003
2030
  */
2004
- const [docPage, setDocPage] = usePage(`${activeId}|${query}|${extFilter}`)
2005
- const [cardPage, setCardPage] = usePage(`${activeId}|${cardQuery}|${cardStatus}|${JSON.stringify(cardMatrixFilter)}`)
2006
- const pagedDocuments = pageSlice(visibleDocuments, docPage)
2031
+ /** 文件列表的分页由服务端给:页码直接用,总数用服务端 total。 */
2032
+ const documentPageCount = Math.max(1, Math.ceil(total / PAGE_SIZE))
2007
2033
  const pagedCards = pageSlice(visibleCards, cardPage)
2008
2034
 
2009
2035
  /**
@@ -2045,7 +2071,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2045
2071
  挤在筛选行里,宿主侧栏的宽度下它必然被挤到第二行单独站着。 */}
2046
2072
  <div className={styles.kbCardActions}>
2047
2073
  <span className={styles.kbCount}>
2048
- {visibleDocuments.length === total ? `${total} 个` : `筛出 ${visibleDocuments.length} / ${total} 个`}
2074
+ {`${total} 个`}
2049
2075
  </span>
2050
2076
  {/* 0034:收录闸门在设置里,这里**读它**。此前这个开关没有任何一处读 —— 闸门
2051
2077
  关着时按钮照样可点,然后由服务端报错。参数搬进抽屉之后,「它现在是不是开着」
@@ -2086,7 +2112,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2086
2112
  : '这个知识库还没有文件。用右边的「添加文件」开始:纯文本直读,Word / PDF / 表格走转换内核。'}
2087
2113
  </p>}
2088
2114
  <ul className={styles.kbDocList}>
2089
- {pagedDocuments.slice.map(document => {
2115
+ {visibleDocuments.map(document => {
2090
2116
  const docCards = cardsBySource.get(document.docId) ?? []
2091
2117
  return <li key={document.docId} className={styles.kbDocRow}>
2092
2118
  <button type="button" className={styles.kbDocMain} onClick={() => void openDetail(document)}>
@@ -2111,7 +2137,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2111
2137
  </li>
2112
2138
  })}
2113
2139
  </ul>
2114
- <ListPager page={pagedDocuments.page} pageCount={pagedDocuments.pageCount} total={visibleDocuments.length} onChange={setDocPage} />
2140
+ <ListPager page={docPage} pageCount={documentPageCount} total={total} onChange={setDocPage} />
2115
2141
  </Card>
2116
2142
 
2117
2143
  {/* SourceRaw 收录与存储(方案级闸门)在顶部齿轮的设置抽屉里;这里不重复放设置入口。 */}
@@ -2305,7 +2331,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2305
2331
  ? <p className="rounded-md border border-tita-line bg-tita-surface-muted px-2.5 py-2 text-[10.5px] leading-relaxed text-tita-danger" role="alert">Event 加载失败:{eventsError}</p>
2306
2332
  : eventsLoading && events.length === 0
2307
2333
  ? <p className="py-5 text-center text-[11px] text-tita-ink-muted" role="status">正在读取 Event…</p>
2308
- : <EventView events={events} />}
2334
+ : <EventView events={events} focusEventId={focusedEventId} />}
2309
2335
  </TabsContent>
2310
2336
  </Tabs>
2311
2337
 
@@ -2361,36 +2387,13 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2361
2387
  title={active ? `编辑 ${active.name} 的编译设置` : '先选择一个知识库'}
2362
2388
  onClick={() => setTypeDef(true)}
2363
2389
  ><Tags size={13} />编译设置</Button>
2364
- {/* 一枚按钮,一个含义:**全量重新编译**。
2365
- 原先它是一枚带下拉的「编译 ⌄」,两档(增量 / 全量)让人选。撤掉下拉的理由:
2366
- 增量编译**已经是默认行为** —— 写入来源时服务端会顺手跑一次增量编译
2367
- (`importSources` 的 `compile: 'wiki'`),而它本身在语料未变时是空操作。
2368
- 把它摆成一枚需要人选的按钮,是让人替机器做机器的决定。
2369
- 留下的这一档是「我怀疑产物不对,强制重来一次」—— 那才需要人明确说出来,
2370
- 所以它带一个确认浮层。 */}
2371
- <span className="kbCompileAction">
2372
- <Button
2373
- variant="outline"
2374
- size="sm"
2375
- className="kbCompileActionMain"
2376
- disabled={busy !== null || !active}
2377
- title={active ? `重新编译「${active.name}」的全部 SourceRaw` : '先选择一个知识库'}
2378
- onClick={() => setConfirmOpen(true)}
2379
- ><RefreshCw size={14} />{busy === 'compile' ? '编译中…' : '重新编译'}</Button>
2380
- <DropdownMenu>
2381
- <DropdownMenuTrigger asChild disabled={!active}>
2382
- <Button variant="outline" size="sm" className="kbCompileActionMenu" aria-label="编译任务">
2383
- <ChevronDown size={13} />
2384
- </Button>
2385
- </DropdownMenuTrigger>
2386
- <DropdownMenuContent align="end" sideOffset={5}>
2387
- <DropdownMenuItem onSelect={() => {
2388
- const kb = activeIdRef.current
2389
- if (kb) void fullPage.open({ src: `/knowledge/pages/tasks?kb=${encodeURIComponent(kb)}`, title: '抽取任务' })
2390
- }}><ListOrdered size={14} />抽取任务</DropdownMenuItem>
2391
- </DropdownMenuContent>
2392
- </DropdownMenu>
2393
- </span>
2390
+ {/* 一行顶栏里**一个入口**。此前这里是两枚(「知识处理」与「任务历史」),
2391
+ 打开的却是同一个地址的两个位置 —— 同一样东西两个入口,人就会以为它们是两件事,
2392
+ 点完一个再点另一个来确认「历史是不是同一份」。整合后只剩这一枚:
2393
+ 页面上半段是四段阶段,下半段右侧就是运行记录,一屏之内都读得到。 */}
2394
+ <Button variant="outline" size="sm" disabled={!active} title="运行阶段、处理范围与运行记录" onClick={() => {
2395
+ if (active) void fullPage.open({ src: `/knowledge/pages/tasks?kb=${encodeURIComponent(active.id)}`, title: '知识处理与运行记录' })
2396
+ }}><Layers3 size={14} />知识处理</Button>
2394
2397
  <Button
2395
2398
  variant="outline"
2396
2399
  size="sm"
@@ -2414,6 +2417,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2414
2417
 
2415
2418
  {/* 分栏是**一条流水线**,所以切换器是步骤轨而不是一排等宽 tab:收录 → 抽取归一 →
2416
2419
  物化 → 检索精排。方向本身就是信息(写入侧在左、读取侧在右)。 */}
2420
+ {active && <PipelineNotice kb={active.id} revision={active.updatedAt} onOpen={() => { void fullPage.open({ src: `/knowledge/pages/tasks?kb=${encodeURIComponent(active.id)}`, title: '知识处理' }) }} />}
2417
2421
  <KnowledgeStepRail tab={tab} onChange={changeTab} facts={stepFacts} />
2418
2422
 
2419
2423
  {/* 删除确认:**先查账再弹框**(见 `askDeleteDocument`)。 */}
@@ -2445,7 +2449,9 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2445
2449
 
2446
2450
  {notice && <p className={cn(styles.kbNotice, notice.tone === 'error' && styles.kbNoticeError)} role="status">
2447
2451
  <AlertCircle size={13} /><span>{notice.text}</span>
2448
- <button type="button" className={styles.kbNoticeClose} aria-label="关闭提示" onClick={() => setNotice(null)}><X size={12} /></button>
2452
+ {/* 同一种「关掉这条提示」的控件在面板里有四处,全部用共享的 ghost 图标按钮:
2453
+ 12px 的字形本身不够当命中区,而且各写一份的焦点环会和共享层不一致。 */}
2454
+ <Button variant="ghost" size="icon" className={styles.kbNoticeClose} aria-label="关闭提示" title="关闭提示" onClick={() => setNotice(null)}><X size={14} /></Button>
2449
2455
  </p>}
2450
2456
 
2451
2457
  {/* 分栏内容按当前值渲染:切换器是步骤轨(不是 Radix Tabs),所以这里自己按值渲染。 */}
@@ -2622,7 +2628,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2622
2628
  ? <p className={styles.kbHint}>
2623
2629
  {detailKnowledgeLoading
2624
2630
  ? '正在取这份来源抽出的知识…'
2625
- : <>这份来源还没有抽出知识。导入文档后会自动抽取;也可以点工具栏的「重新编译」。</>}
2631
+ : <>这份来源还没有抽出知识。请在「知识处理」中运行抽取,再运行归一合并。</>}
2626
2632
  </p>
2627
2633
  : <>
2628
2634
  <ul className={styles.knowledgeList}>
@@ -2670,12 +2676,17 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2670
2676
  ><ExternalLink size={12} />{detail.document.original.name}</Button>
2671
2677
  </div>}
2672
2678
 
2673
- {/* 抽取轨迹(0063)。它是这份文档的**审计** —— 「当时模型判了什么」——
2679
+ {/* 轨迹(0063;2026-10-18 起三段)。它是这份文档的**审计** —— 「当时判了什么」——
2674
2680
  所以它排在「提取的 Knowledge」(现在的结论)之后、「版本」(改过几次)之前:
2675
- 先看它变成了什么,再看它是怎么被看出来的,最后看它改过几版。 */}
2681
+ 先看它变成了什么,再看它是怎么被看出来的,最后看它改过几版。
2682
+ 抽取与归一都是「一份文档 × 一次」,所以都挂在这里;物化是「一个卡片分组 × 一次」,
2683
+ 分组可能跨文档 —— 它的入口在任务页的物化阶段,不假装属于某一份文档。 */}
2676
2684
  <div className={styles.drawerSection}>
2677
2685
  <div className={styles.kbSubHead}>
2678
- <h4><Sparkles size={13} />抽取轨迹</h4>
2686
+ <h4><Sparkles size={13} />轨迹</h4>
2687
+ <Button variant="outline" size="sm" onClick={() => {
2688
+ if (active) void fullPage.open({ src: `/knowledge/pages/tasks?kb=${encodeURIComponent(active.id)}&source=${encodeURIComponent(detail.document.docId)}`, title: '单文档抽取' })
2689
+ }}>单独抽取此文档</Button>
2679
2690
  <span>{detailRuns.length > 0 ? `${detailRuns.length} 次` : '还没有'}</span>
2680
2691
  </div>
2681
2692
  {detail !== null && compileProgress !== null && compileProgress.finishedAt === undefined
@@ -2711,7 +2722,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2711
2722
  </p>
2712
2723
  : detailRuns.length === 0
2713
2724
  ? <p className={styles.kbHint}>
2714
- 这份文档还没有抽取轨迹。导入后会自动生成;重新编译也会新增一条轨迹。
2725
+ 这份文档还没有轨迹。保存来源后,在「知识处理」中运行抽取,再运行归一。
2715
2726
  </p>
2716
2727
  : <ul className={styles.trialRunList}>
2717
2728
  {detailRuns.map(run => <li key={run.id}>
@@ -2727,6 +2738,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2727
2738
  onClick={() => openRunPage(run)}
2728
2739
  >
2729
2740
  <span className={styles.trialRunTime}>{formatDateTime(run.createdAt)}</span>
2741
+ {/* 阶段徽标:同一条列表里现在混着抽取与归一,不标出来就得靠标题猜。 */}
2742
+ <span className={styles.trialRunFlag} data-stage={trajectoryStageOf(run)}>{TRAJECTORY_STAGE_SHORT[trajectoryStageOf(run)]}</span>
2730
2743
  <span className={styles.trialRunSummary}>{run.summary || '(没有规模描述)'}</span>
2731
2744
  <span className={styles.trialRunFlags}>
2732
2745
  <span className={styles.trialRunFlag} data-ok={run.modelOk}>{run.modelOk ? '模型跑通' : '模型没跑通'}</span>
@@ -2786,6 +2799,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2786
2799
  onCompare={entry => void compareCardVersion(entry)}
2787
2800
  versionDiff={cardDiff}
2788
2801
  onOpenRelated={link => void openCard(link)}
2802
+ onOpenEvent={openEvent}
2803
+ events={events}
2789
2804
  sourceTitles={sourceTitles}
2790
2805
  />
2791
2806
  </DrawerBody>
@@ -2817,6 +2832,8 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
2817
2832
  onCompare={entry => void compareCardVersion(entry)}
2818
2833
  versionDiff={cardDiff}
2819
2834
  onOpenRelated={link => void openCard(link)}
2835
+ onOpenEvent={openEvent}
2836
+ events={events}
2820
2837
  sourceTitles={sourceTitles}
2821
2838
  />
2822
2839
  </DrawerBody>
@@ -54,7 +54,7 @@
54
54
  * `limit` / `offset`,而 `total` 报的是**筛选之后**的总数。
55
55
  */
56
56
 
57
- import { useCallback, useEffect, useMemo, useState, type ChangeEvent, type ReactNode } from 'react'
57
+ import { useCallback, useEffect, useMemo, useRef, useState, type ChangeEvent, type ReactNode } from 'react'
58
58
  import { Check, Library, LoaderCircle, Table2, TriangleAlert, X } from '@tita-agent/ui/icons'
59
59
  import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@tita-agent/ui/overlays'
60
60
  import { Button, Input, cn } from '@tita-agent/ui/components'
@@ -135,6 +135,15 @@ export function KnowledgeLayerSection({ kbId, canEdit, onChanged, onOpenCard, fo
135
135
  * 同一份数据、同一个选中状态 —— 所以两处不会有第二种画法,选中也跟着走。
136
136
  */
137
137
  const [matrixFull, setMatrixFull] = useState(false)
138
+ /**
139
+ * 取数请求的序号。**慢的那个请求不允许后落地**:连点两下筛选会发两个请求,
140
+ * 先发的可能后回,而它会用旧筛选的数据覆盖新的 —— 列表、总数、分面都换了,
141
+ * 唯独筛选控件还显示着新的条件,读起来像「筛了但不生效」。
142
+ *
143
+ * 与卡片列表那份(`KnowledgeBaseTab` 的 `eventsRequestRef`)同一条纪律:
144
+ * 每个 `setState` 之前都比一次票号,过期就整段丢掉。
145
+ */
146
+ const requestRef = useRef(0)
138
147
 
139
148
  /**
140
149
  * 筛选条件的稳定指纹。两件事都靠它:页码复位,以及取数 effect 的依赖。
@@ -180,6 +189,8 @@ export function KnowledgeLayerSection({ kbId, canEdit, onChanged, onOpenCard, fo
180
189
  */
181
190
  const load = useCallback(async (): Promise<void> => {
182
191
  if (!kbId) return
192
+ const ticket = requestRef.current + 1
193
+ requestRef.current = ticket
183
194
  setLoading(true)
184
195
  try {
185
196
  const [data, axisPage] = await Promise.all([
@@ -187,6 +198,7 @@ export function KnowledgeLayerSection({ kbId, canEdit, onChanged, onOpenCard, fo
187
198
  // 坐标存的是轴实体 id,界面要显示名字 —— 两个请求并行,它们之间没有依赖。
188
199
  requestJson<{ entities: AxisOption[] }>(`/knowledge/axes?kb=${encodeURIComponent(kbId)}`).catch(() => null),
189
200
  ])
201
+ if (requestRef.current !== ticket) return
190
202
  setItems(data.knowledge)
191
203
  setTotal(data.total)
192
204
  setStats(data.stats)
@@ -198,14 +210,19 @@ export function KnowledgeLayerSection({ kbId, canEdit, onChanged, onOpenCard, fo
198
210
  * 夹紧页码。筛选之后总数可能掉到当前页之外(改状态不会,但别处会),
199
211
  * 那时页面会**空着**,而空着与「没有结果」在界面上长得一样。
200
212
  * 一次修正就收敛:目标是最后一页,而最后一页一定非空。
213
+ *
214
+ * 夹紧走的是**同一个票号**:过期的响应不许把页码推走,否则它会把人送回
215
+ * 一个和新筛选无关的页。
201
216
  */
202
217
  if (data.total > 0 && (page - 1) * PAGE_SIZE >= data.total) {
203
218
  setPage(Math.max(1, Math.ceil(data.total / PAGE_SIZE)))
204
219
  }
205
220
  } catch (cause) {
221
+ // 失败也要比票号:过期请求的错误盖掉新请求的成功,同样是一种错。
222
+ if (requestRef.current !== ticket) return
206
223
  setError(cause instanceof Error ? cause.message : String(cause))
207
224
  } finally {
208
- setLoading(false)
225
+ if (requestRef.current === ticket) setLoading(false)
209
226
  }
210
227
  }, [kbId, filter, page, setPage])
211
228