dsh-data-domain-knowledge 0.1.0-alpha.9 → 0.1.1-alpha.2

package/src/client/TypeDefinitionDrawer.tsx

@@ -1,33 +1,139 @@
-/**
- * 知识库定义抽屉。
- *
- * 这里不再保留不参与运行时行为的来源标签入口，只保留真正参与坐标抽取的库级定义。
- */
-
-import { useEffect, useState, type ChangeEvent, type ReactNode } from 'react'
+import { useEffect, useMemo, useRef, useState, type ChangeEvent, type ReactNode } from 'react'
 import { Check } from '@tita-agent/ui/icons'
-import { Button, Field, Textarea } from '@tita-agent/ui/components'
+import { Button, Field, SelectMenu, Textarea, type SelectMenuOption } from '@tita-agent/ui/components'
 import {
   Drawer, DrawerBody, DrawerContent, DrawerHeader, DrawerTitle,
 } from '@tita-agent/ui/overlays'
 import { styles } from './styles.ts'
 import { AxisRegistrySection } from './AxisRegistrySection.tsx'
+import { requestJson } from './request.ts'
+
+export interface CompileModelSelectionView {
+  mode: 'default' | 'fixed'
+  provider?: string
+  model?: string
+  reasoningEffort?: string
+}
+
+interface CompileModelCatalogItem {
+  provider: string
+  id: string
+  name: string
+  description?: string
+  available: boolean
+  current?: boolean
+  reasoning?: { efforts: Array<{ id: string; name: string; description?: string }>; defaultEffort?: string }
+}
+
+interface CompileModelCatalog {
+  selection: CompileModelSelectionView
+  default: { provider?: string; model?: string; reasoningEffort?: string; available: boolean }
+  models: CompileModelCatalogItem[]
+  why?: string
+}
+
+const DEFAULT_MODEL_VALUE = '__dsh_default__'
+const fixedModelValue = (provider: string, model: string): string => `fixed:${encodeURIComponent(provider)}:${encodeURIComponent(model)}`
 
 export interface TypeDefinitionDrawerProps {
   open: boolean
   onOpenChange: (open: boolean) => void
   kbId: string
   busy: string | null
-  /** 坐标提取备注：逐字进入抽取提示词。 */
   extractionNote?: string
   onSaveExtractionNote?: (note: string) => Promise<void>
+  compileModel?: CompileModelSelectionView
+  onSaveCompileModel?: (selection: CompileModelSelectionView) => Promise<void>
 }
 
 export function TypeDefinitionDrawer({
   open, onOpenChange, kbId, busy, extractionNote = '', onSaveExtractionNote,
+  compileModel = { mode: 'default' }, onSaveCompileModel,
 }: TypeDefinitionDrawerProps): ReactNode {
   const [noteDraft, setNoteDraft] = useState(extractionNote)
+  const [modelDraft, setModelDraft] = useState(DEFAULT_MODEL_VALUE)
+  const [effortDraft, setEffortDraft] = useState(compileModel.reasoningEffort ?? '__default__')
+  useEffect(() => { setEffortDraft(compileModel.reasoningEffort ?? '__default__') }, [compileModel.reasoningEffort])
+  const [catalog, setCatalog] = useState<CompileModelCatalog | null>(null)
+  const [catalogError, setCatalogError] = useState('')
+  /**
+   * 上一次读回来的默认模型。
+   *
+   * 放进 ref 而不是当成 effect 的依赖：这份 effect **自己会写 `catalog`**，把
+   * `catalog?.default.provider` 列进依赖就是让输出当输入 —— 每读一次目录都会再触发
+   * 一次自己，打开抽屉要打两三次 `/knowledge/models`。ref 让它读到最新值，但不触发。
+   */
+  const catalogRef = useRef<CompileModelCatalog | null>(null)
+  catalogRef.current = catalog
   useEffect(() => { setNoteDraft(extractionNote) }, [extractionNote])
+  useEffect(() => {
+    if (compileModel.mode === 'fixed' && compileModel.provider && compileModel.model) {
+      setModelDraft(fixedModelValue(compileModel.provider, compileModel.model))
+    } else {
+      setModelDraft(DEFAULT_MODEL_VALUE)
+    }
+  }, [compileModel.mode, compileModel.provider, compileModel.model])
+  useEffect(() => {
+    if (!open || onSaveCompileModel === undefined) return undefined
+    let cancelled = false
+    setCatalogError('')
+    const route = modelDraft.startsWith('fixed:') ? modelDraft.split(':').slice(1).map(decodeURIComponent) : [catalogRef.current?.default.provider, catalogRef.current?.default.model]
+    const params = new URLSearchParams({ kb: kbId })
+    if (route[0] && route[1]) { params.set('provider', route[0]); params.set('model', route[1]) }
+    void requestJson<CompileModelCatalog>(`/knowledge/models?${params}`).then(result => {
+      if (!cancelled) setCatalog(result.data ?? null)
+    }).catch(error => {
+      if (!cancelled) setCatalogError(error instanceof Error ? error.message : String(error))
+    })
+    return () => { cancelled = true }
+  }, [kbId, onSaveCompileModel, open, modelDraft])
+
+  const modelOptions = useMemo(() => {
+    const options: SelectMenuOption[] = [{
+      value: DEFAULT_MODEL_VALUE,
+      label: catalog?.default?.provider && catalog.default.model
+        ? `跟随 DSH 默认模型（${catalog.default.provider} / ${catalog.default.model}）`
+        : '跟随 DSH 默认模型',
+    }]
+    for (const item of catalog?.models ?? []) {
+      options.push({
+        value: fixedModelValue(item.provider, item.id),
+        label: item.available
+          ? `${item.name}（${item.provider} / ${item.id}）`
+          : `当前已失效：${item.provider} / ${item.id}`,
+        ...(item.available ? {} : { disabled: true }),
+      })
+    }
+    if (compileModel.mode === 'fixed' && compileModel.provider && compileModel.model
+      && !options.some(option => option.value === fixedModelValue(compileModel.provider!, compileModel.model!))) {
+      options.push({
+        value: fixedModelValue(compileModel.provider, compileModel.model),
+        label: `当前已失效：${compileModel.provider} / ${compileModel.model}`,
+        disabled: true,
+      })
+    }
+    return options
+  }, [catalog, compileModel.mode, compileModel.model, compileModel.provider])
+
+  const modelChanged = effortDraft !== (compileModel.reasoningEffort ?? '__default__') || modelDraft !== (compileModel.mode === 'fixed' && compileModel.provider && compileModel.model
+    ? fixedModelValue(compileModel.provider, compileModel.model)
+    : DEFAULT_MODEL_VALUE)
+  const saveCompileModel = async (): Promise<void> => {
+    if (onSaveCompileModel === undefined) return
+    if (modelDraft === DEFAULT_MODEL_VALUE) {
+      await onSaveCompileModel({ mode: 'default', ...(effortDraft === '__default__' ? {} : { reasoningEffort: effortDraft }) })
+      return
+    }
+    const selected = catalog?.models.find(item => fixedModelValue(item.provider, item.id) === modelDraft && item.available)
+    if (!selected) return
+    await onSaveCompileModel({ mode: 'fixed', provider: selected.provider, model: selected.id, ...(effortDraft === '__default__' ? {} : { reasoningEffort: effortDraft }) })
+  }
+
+  const selectedModel = catalog?.models.find(item => modelDraft === DEFAULT_MODEL_VALUE
+    ? item.provider === catalog.default.provider && item.id === catalog.default.model
+    : fixedModelValue(item.provider, item.id) === modelDraft)
+  const effortOptions: SelectMenuOption[] = [{ value: '__default__', label: '跟随模型默认强度' }, ...(selectedModel?.reasoning?.efforts ?? []).map(item => ({ value: item.id, label: item.name }))]
+  if (effortDraft !== '__default__' && !effortOptions.some(option => option.value === effortDraft)) effortOptions.push({ value: effortDraft, label: `当前不可用：${effortDraft}`, disabled: true })
 
   return <Drawer open={open} onOpenChange={onOpenChange}>
     {open && <DrawerContent
@@ -36,28 +142,49 @@ export function TypeDefinitionDrawer({
       resizeKey="tita-typedef-drawer"
     >
       <DrawerHeader>
-        <DrawerTitle>知识库定义</DrawerTitle>
+        <DrawerTitle>编译设置</DrawerTitle>
       </DrawerHeader>
       <DrawerBody>
         <div className={styles.settingsStack}>
+          {onSaveCompileModel !== undefined && <section className={styles.settingsSection}>
+            <div className={styles.settingsSectionHeader}>
+              <div><h3>编译模型</h3></div>
+            </div>
+            <Field as="div" label="模型" hint="用于抽取、归一补判与卡片组织；任务启动时保存实际选择。">
+              <SelectMenu value={modelDraft} disabled={busy !== null || (catalog === null && catalogError === '')} onValueChange={value => { setModelDraft(value); setEffortDraft('__default__') }}
+                options={modelOptions} placeholder="加载 DSH 模型目录…" aria-label="编译模型" />
+            </Field>
+            <Field as="div" label="思考强度" hint={selectedModel?.reasoning?.efforts.length ? '档位来自当前模型的 DSH 目录。' : '当前模型未提供可选档位，使用模型默认值。'}>
+              <SelectMenu value={effortDraft} options={effortOptions} onValueChange={setEffortDraft} disabled={busy !== null || !selectedModel?.reasoning?.efforts.length} aria-label="编译模型思考强度" />
+            </Field>
+            {catalog?.default && !catalog.default.available && <p className={styles.kbHint} role="status">
+              DSH 默认模型不可用；可在 DSH 设置中修复，或选择固定模型。
+            </p>}
+            {catalogError !== '' && <p className={styles.kbHint} role="alert">模型目录读取失败：{catalogError}</p>}
+            {catalog?.why && <p className={styles.kbHint} role="status">模型目录提示：{catalog.why}</p>}
+            {modelChanged && <div className={styles.settingsSectionActions}>
+              <Button variant="outline" size="sm" disabled={busy !== null || (catalog === null && modelDraft !== DEFAULT_MODEL_VALUE)}
+                onClick={() => void saveCompileModel()}>
+                <Check size={12} />保存
+              </Button>
+            </div>}
+          </section>}
+
           {onSaveExtractionNote !== undefined && <section className={styles.settingsSection}>
             <div className={styles.settingsSectionHeader}>
-              <div><h3>坐标提取备注</h3></div>
-              <span className={styles.kbCount}>{extractionNote.trim() === '' ? '没有备注' : `${extractionNote.length} 字`}</span>
+              <div><h3>提取备注</h3></div>
             </div>
-            <p className={styles.kbHint}>
-              这段话<b>逐字进每一次抽取的提示词</b>，用来交代这个库的坐标怎么定。
-              <b>抽取规则本身不可编辑</b>：这条备注只补充这个库自己的判断约定。
-            </p>
-            <Field label="备注">
-              <Textarea value={noteDraft} spellCheck={false} disabled={busy !== null}
-                placeholder={'本库约定：spm 的 a / b / c / d 是四个独立对象，别并成一个。\n「楼层」在不同页面分期下是不同对象，认的时候看作用域。'}
+            <Field label="坐标约定" hint="逐字加入每次抽取提示词。">
+              <Textarea value={noteDraft} rows={3} spellCheck={false} disabled={busy !== null}
+                aria-label="坐标提取备注" placeholder="填写本库特有的坐标约定。"
                 onChange={(event: ChangeEvent<HTMLTextAreaElement>) => setNoteDraft(event.target.value)} />
             </Field>
-            <Button variant="outline" size="sm" disabled={busy !== null || noteDraft === extractionNote}
-              onClick={() => void onSaveExtractionNote(noteDraft)}>
-              <Check size={12} />保存备注
-            </Button>
+            {noteDraft !== extractionNote && <div className={styles.settingsSectionActions}>
+              <Button variant="outline" size="sm" disabled={busy !== null}
+                onClick={() => void onSaveExtractionNote(noteDraft)}>
+                <Check size={12} />保存
+              </Button>
+            </div>}
           </section>}
 
           <AxisRegistrySection kbId={kbId} canEdit={busy === null} />

package/src/client/WikiCardPreview.tsx

@@ -20,8 +20,9 @@
  */
 
 import { useEffect, useMemo, useState, type ReactNode } from 'react'
-import { AlertCircle, Check, RefreshCw } from '@tita-agent/ui/icons'
-import { Button, cn } from '@tita-agent/ui/components'
+import { AlertCircle, Check, CircleDot, GitCompare, RefreshCw } from '@tita-agent/ui/icons'
+import { Badge, Button, cn } from '@tita-agent/ui/components'
+import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle } from '@tita-agent/ui/overlays'
 import type { AssetRef } from './asset-images.ts'
 import type { VersionManagerEntry } from '@tita-agent/ui/versions'
 import { PreviewContent, PreviewMeta, PreviewRelated, PreviewVersions, VersionContentDiff, splitSections, type KnowledgeLine, type VersionContentDiffData } from './PreviewSections.tsx'
@@ -33,13 +34,10 @@ import { STATUS_VIEW } from './WikiCardRow.tsx'
 import { styles } from './styles.ts'
 import { formatDateTime } from './format.ts'
 import type { CardRelatedView, KnowledgeCardView, WikiCardVersionView } from './KnowledgeBaseTab.tsx'
+import type { AttributionEvent } from './attribution/model.ts'
 
-/**
- * 正文档里那一节「相关」的小节名。与 `wiki-finalize.ts` 的 `RELATED_HEADING` 同值 ——
- * 客户端不能 import 服务端模块（那边拉 node: 内置），所以这里重列一次，并由一条测试
- * 钉住两边相等（同 `SOURCE_FORMAT_LABEL` 那类「契约重列」的处置）。
- */
-const RELATED_SECTION = ['相关']
+/** 正文里的生成式导航小节名；它们由结构化引用展示，不重复留在正文。 */
+const RELATED_SECTION = ['相关', '关联 Event', '关联 Events', '关联事件']
 
 /** 一张卡片的完整预览数据（正文 + 版本 + 图片 + 相关 + 坐标名字）。 */
 export interface CardPreviewDetail {
@@ -81,15 +79,17 @@ export interface WikiCardPreviewProps {
   kbId: string
   detail: CardPreviewDetail
   versionEntries: VersionManagerEntry[]
-  /** 当前版本的 id：只有它可回滚（回滚到当前版本是无操作）。 */
+  /** 当前版本的 id：用于在只读时间线上标记当前版本。 */
   currentVersionId?: string
   loading: boolean
   /** 卡片状态被 review / 备注改过之后，让宿主重新读这张卡片与列表。 */
   onChanged: () => void | Promise<void>
-  onRestore: (entry: VersionManagerEntry) => void
   onCompare?: (entry: VersionManagerEntry) => void
   versionDiff?: { data?: VersionContentDiffData; loading: boolean; error?: string }
   onOpenRelated: (link: { entityType: string; entityId: string; title: string }) => void
+  /** 打开 Event 栏并定位到这张卡片引用的事件。 */
+  onOpenEvent: (eventId: string) => void
+  events?: AttributionEvent[]
   /**
    * SourceRaw 的 docId → 文档标题。
    *
@@ -113,16 +113,36 @@ function sourceRefsText(refs: string[], titles?: Map<string, string>): string {
 
 export function WikiCardPreview({
   kbId, detail, versionEntries, currentVersionId, loading,
-  onChanged, onRestore, onOpenRelated, sourceTitles,
+  onChanged, onOpenRelated, onOpenEvent, events = [], sourceTitles,
   onCompare, versionDiff = { loading: false },
 }: WikiCardPreviewProps): ReactNode {
   const [recompiling, setRecompiling] = useState(false)
   const [recompileNotice, setRecompileNotice] = useState<{ tone: 'success' | 'error'; text: string } | null>(null)
+  const [compareOpen, setCompareOpen] = useState(false)
   const status = STATUS_VIEW[detail.card.status]?.label ?? detail.card.status
   const refs = sourceRefsText(detail.card.sourceRefs, sourceTitles)
   const knowledge = useCardKnowledge(kbId, detail.card.entityId, sourceTitles)
+  const relatedEvents = useMemo(() => {
+    const raw = detail.card.metadata?.event_refs
+    let ids: string[] = []
+    if (Array.isArray(raw)) ids = raw.filter((item): item is string => typeof item === 'string')
+    else if (typeof raw === 'string') {
+      try {
+        const parsed: unknown = JSON.parse(raw)
+        if (Array.isArray(parsed)) ids = parsed.filter((item): item is string => typeof item === 'string')
+      } catch { /* 无效派生引用不显示 */ }
+    }
+    const byId = new Map(events.map(event => [event.id, event]))
+    return [...new Set(ids)].map(id => byId.get(id) ?? { id }).map(event => ({
+      id: event.id,
+      title: 'title' in event ? event.title : event.id,
+      summary: 'summary' in event ? event.summary : '',
+      occurredAt: 'occurredAt' in event ? event.occurredAt : undefined,
+    }))
+  }, [detail.card.metadata, events])
+  useEffect(() => { setCompareOpen(false) }, [detail.card.entityId])
   /**
-   * 先移除旧版本只在面板下方由关系图展示的「相关」区块，再补普通引用清单。
+   * 移除旧版本正文里的生成式导航区块，再显示结构化卡片与 Event 引用。
    *
    * 投影顺序固定为：物化正文 → 去掉旧导航区 → 补引用清单。
    */
@@ -204,6 +224,21 @@ export function WikiCardPreview({
         {recompiling ? '编译中…' : '按坐标重新编译'}</Button>}
     />
 
+    {relatedEvents.length > 0 && <section className="flex min-w-0 flex-col gap-1.5" aria-label="关联 Event">
+      <h3 className="m-0 flex items-center gap-1.5 text-[11px] font-semibold text-tita-ink">
+        <CircleDot size={12} aria-hidden="true" />关联 Event <Badge tone="neutral">{relatedEvents.length}</Badge>
+      </h3>
+      <ul className="m-0 grid list-none gap-1 p-0">
+        {relatedEvents.map(event => <li key={event.id} className="min-w-0 rounded-md border border-tita-line px-2 py-1.5">
+          <Button variant="ghost" size="sm" className="h-auto max-w-full justify-start px-0 py-0 text-left text-[10.5px]" onClick={() => onOpenEvent(event.id)}>
+            <span className="min-w-0 truncate">{event.title}</span>
+            {event.occurredAt && <span className="shrink-0 text-[9px] text-tita-ink-faint">· {event.occurredAt}</span>}
+          </Button>
+          {event.summary && <p className="m-0 mt-0.5 line-clamp-2 text-[10px] leading-relaxed text-tita-ink-muted">{event.summary}</p>}
+        </li>)}
+      </ul>
+    </section>}
+
     {recompileNotice && <div className={cn(styles.cardRecompileNotice, recompileNotice.tone === 'error' ? styles.cardRecompileNoticeError : styles.cardRecompileNoticeSuccess)} role="status">
       {recompileNotice.tone === 'error' ? <AlertCircle size={12} aria-hidden="true" /> : <Check size={12} aria-hidden="true" />}
       <span>{recompileNotice.text}</span>
@@ -230,13 +265,24 @@ export function WikiCardPreview({
     />
 
     <PreviewVersions
-      hint="卡片正文每次变化前都会留一份快照；回滚是往前的写入，所以回滚前的那一版也会被快照 —— 回滚本身也可以回滚。"
+      hint="卡片正文变化前会保存快照，可查看历史版本并比较正文差异。"
       entries={versionEntries}
       loading={loading}
       emptyLabel="这张卡片还没有历史版本（正文变化时才会生成快照；只改状态不会造版本）。"
-      actions={{ restorableId: currentVersionId, onRestore, ...(onCompare === undefined ? {} : { onCompare }) }}
-      ><VersionContentDiff data={versionDiff.data} loading={versionDiff.loading} error={versionDiff.error} />
-    </PreviewVersions>
+      actions={{
+        restorableId: currentVersionId,
+        ...(onCompare === undefined ? {} : { onCompare: (entry: VersionManagerEntry) => { setCompareOpen(true); onCompare(entry) } }),
+      }}
+    />
+    <Dialog open={compareOpen} onOpenChange={setCompareOpen}>
+      <DialogContent className="w-[min(900px,calc(100vw-32px))] max-w-[min(900px,calc(100vw-32px))] max-h-[calc(100vh-32px)]">
+        <DialogHeader>
+          <DialogTitle className="flex items-center gap-[6px]"><GitCompare size={15} aria-hidden="true" /> WikiCard 版本差异</DialogTitle>
+          <DialogDescription>只读比较所选历史正文与当前正文。关闭窗口不会改变卡片内容。</DialogDescription>
+        </DialogHeader>
+        <VersionContentDiff data={versionDiff.data} loading={versionDiff.loading} error={versionDiff.error} fullText />
+      </DialogContent>
+    </Dialog>
   </div>
 }
 

package/src/client/WikiFlowPanel.tsx

@@ -165,7 +165,7 @@ const STAGES: Stage[] = [
     body: [
       '**三个轴分别归一**：先找 canonical，再找 alias，最后才新建候选。匹配不唯一时，**不猜**。',
       '每条知识绑定一个**坐标**：三个轴实体 id 的**复合键**。**Coordinate 不是实体**，没有自己的表。',
-      '同义知识合并，`sources` 追加；相互矛盾的说法保留，并标记为 disputed。',
+      '归一化文本一致时合并并追加来源；语义相似只记候选，不自动合并。相互矛盾的说法需显式标记 disputed。',
     ],
     rule: {
       order: '2',
@@ -176,7 +176,7 @@ const STAGES: Stage[] = [
     produces: {
       layer: 'Canonical Knowledge',
       ask: '在哪里',
-      note: '轴已归一并绑成 id；同义合并过，冲突留着',
+      note: '轴绑定为 id；同文事实合并，语义候选待确认',
     },
   },
   {
@@ -198,7 +198,7 @@ const STAGES: Stage[] = [
       title: '坐标决定卡片身份，卡名只是显示',
       body: '一个坐标最多一张卡。坐标是数据库主键；标题由对象、场景和动作生成，只是**显示名**，不参与判重。',
     },
-    model: '系统（确定）',
+    model: '系统分组，可选模型组织',
     produces: {
       layer: 'Wiki Card',
       ask: '怎么组织这些知道的东西',
@@ -217,7 +217,7 @@ const STAGES: Stage[] = [
       '**Knowledge 是证据层，不是第二个检索入口**：命中 Section 后，再带出对应知识、状态和出处。',
       '向量、关键词和图谱 boost 都属于**可重建的派生层**（`derived.db`）。**轴注册表不是索引**，而是坐标解析时使用的命名真源。',
     ],
-    model: '不调模型',
+    model: '系统切分 + 向量编码',
     produces: {
       layer: '可检索 Wiki',
       /* 派生层，所以没有 ask —— 它不是实体，不回答上面那三个问题。 */

package/src/client/arch/NodeLogicPanel.tsx

@@ -38,7 +38,7 @@ export interface NodeLogicPanelProps {
   version: number
   /** 跳到节点所属的功能 tab；`knowledgeTab` 存在时还要落到知识库里那一栏。 */
   onJump: (tab: PanelTab, knowledgeTab?: KnowledgeTab) => void
-  /** 打开一个工作区页面（Table / Notebook / 画布）。 */
+  /** 打开一个工作区页面（Table / 画布）。 */
   onOpenTab?: (kind: WorkspaceTabKind) => void
   onClose: () => void
 }
@@ -124,10 +124,9 @@ export function NodeLogicPanel({ selected, stats, version, onJump, onOpenTab, on
             去配置<ArrowRight size={14} />
           </Button>
           : <p className={styles.archPanelHint}><CircleHelp size={13} />这个节点没有可配置页：{meta.status === 'host' ? '它由宿主提供' : meta.status === 'planned' ? '它还没实现，先在这里说明设计意图' : '它的行为由代码决定，没有可调参数'}。</p>}
-        {(selected === 'answer' || selected === 'data-sheet' || selected === 'data-notebook' || selected === 'data-canvas') && onOpenTab && <div className={styles.archPanelActions}>
+        {(selected === 'answer' || selected === 'data-sheet' || selected === 'data-canvas') && onOpenTab && <div className={styles.archPanelActions}>
           <Button variant="outline" size="sm" onClick={() => onOpenTab('data-sheet')}><ChevronRight size={13} />打开 Table</Button>
-          <Button variant="outline" size="sm" onClick={() => onOpenTab('data-notebook')}><ChevronRight size={13} />打开 Notebook</Button>
-          {/* 画布与 Table / Notebook 并列：三者都是这一格的输出产物，之前少列了一个。 */}
+          {/* 画布与 Table 并列，都是可编辑的工作区产物。 */}
           <Button variant="outline" size="sm" onClick={() => onOpenTab('data-excalidraw')}><ChevronRight size={13} />打开画布</Button>
         </div>}
       </PanelSection>

package/src/client/arch/model.ts

@@ -46,7 +46,7 @@ export const NODE_H_STACKED = 80
  * 一列竖排**三张**时的卡片高度（2026-09-26 加画布带来的第三张）。
  *
  * 它比两排矮一档，不是审美选择，是算术：三张要挤进同一条带，而带高是全图共享的。
- * 内容也正好只差一行 —— 这一列的 Table / Notebook / 画布都没有计数行，两行文字
+ * 内容也正好只差一行 —— 这一列的 Table / 画布都没有计数行，两行文字
  * （标题 + 说明）加 8px 上下内边距正好 52px；而情节 / 操作记忆两张带计数行，需要 73px，
  * 所以它们仍用 80。写死一个高度给两种内容，不是裁掉计数就是白留一条空带。
  */
@@ -65,7 +65,7 @@ export const STACK_GAP = 14
  * 测试会断言两者一致（一处写三张、另一处只放两张是最容易犯的错，而且肉眼看不出来）。
  */
 export const STACK_COLUMNS: ReadonlyArray<{ lane: number; col: number; count: number }> = [
-  { lane: 0, col: 4, count: 3 },
+  { lane: 0, col: 4, count: 2 },
   { lane: 2, col: 3, count: 2 },
 ]
 
@@ -210,8 +210,7 @@ export const ARCH_SLOTS: Record<NodeId, Slot> = {
   runtime: { lane: 0, col: 2 },
   answer: { lane: 0, col: 3 },
   'data-sheet': { lane: 0, col: 4, stack: 0 },
-  'data-notebook': { lane: 0, col: 4, stack: 1 },
-  'data-canvas': { lane: 0, col: 4, stack: 2 },
+  'data-canvas': { lane: 0, col: 4, stack: 1 },
 
   'source-raw': { lane: 1, col: 0 },
   compile: { lane: 1, col: 1 },
@@ -284,9 +283,8 @@ export const ARCH_EDGES: ArchEdge[] = [
   { id: 'a2', source: 'intent', target: 'runtime', kind: 'flow' },
   { id: 'a3', source: 'runtime', target: 'answer', kind: 'flow' },
   { id: 'a4', source: 'answer', target: 'data-sheet', kind: 'branch' },
-  { id: 'a5', source: 'answer', target: 'data-notebook', kind: 'branch' },
-  // 画布与 Table / Notebook 是同一格的三种输出产物，所以也是同一种边。
-  { id: 'a6', source: 'answer', target: 'data-canvas', kind: 'branch' },
+  // 画布与 Table 是同一格的两种可编辑输出产物。
+  { id: 'a5', source: 'answer', target: 'data-canvas', kind: 'branch' },
 
   // B · 知识编译与召回链路（写入侧 → 读取侧）
   { id: 'b1', source: 'source-raw', target: 'compile', kind: 'flow' },
@@ -367,7 +365,6 @@ export function isBusEdge(edgeId: string): boolean {
  * ```
  *  回答 ──┐                      拐点 1 把三条边锁在同一个 y（发点的中心），
  *         ├──▶ Table             所以三根箭头从**同一个点**出来；
- *         ├──▶ Notebook          拐点 2 各自落在目标那一行。
  *         └──▶ 画布
  * ```
  *
@@ -923,7 +920,7 @@ export function recordRows(id: NodeId, stats: KnowledgeStats, version: number):
       rows.push(indexRow)
       break
     case 'recall':
-      rows.push(['默认路线', stats.recallMode ?? 'hybrid'])
+      rows.push(['召回方式', '多路径融合'])
       rows.push(['召回 topK', String(stats.recallTopK ?? 10)])
       rows.push(['检索后端', stats.searchBackend === 'hybrid' ? 'Hybrid（Coordinate + 关键词 + 向量）' : 'FTS fallback'])
       rows.push(indexRow)

package/src/client/architecture.tsx

@@ -11,7 +11,7 @@
  */
 
 import {
-  BarChart3, Box, BrainCircuit, ClipboardCheck, Clock3, Database, FileCode2, FileText,
+  BarChart3, Box, BrainCircuit, ClipboardCheck, Clock3, Database, FileText,
   HardDrive, Layers3, MessageCircle, PenTool, Quote, RefreshCw, Search,
   Share2, Table2, UserRound,
 } from '@tita-agent/ui/icons'
@@ -51,7 +51,7 @@ export type KnowledgeTab = 'source-raw' | 'knowledge' | 'wiki' | 'recall'
 /**
  * 「回答 / 数据工具」这个节点能打开的**工作区页面**。
  *
- * 三个 kind 各由一个别的插件注册（`dsh-data-table` / `dsh-data-notebook` /
+ * 两个 kind 各由一个别的插件注册（`dsh-data-table` /
  * `dsh-data-excalidraw`）—— 这里只写 kind 字符串，不 import 它们的代码，所以某个
  * 插件没装时按钮依然在，宿主会就着这个 kind 显示「没有页面类型能打开它」。
  *
@@ -59,11 +59,9 @@ export type KnowledgeTab = 'source-raw' | 'knowledge' | 'wiki' | 'recall'
  * 把它交给宿主的 `openTab`。三处各写一份，迟早出现「面板多了一个按钮，入口的类型
  * 还不认它」——加画布这次就正好会踩到。
  *
- * 「回答 / 数据工具」的输出产物就是这三样：可编辑表格、可复现 Notebook、可编辑画布。
- * 画布是 2026-09-26 补上的第四个出口：Excalidraw 画布已经在宿主里跑着，而这张架构图
- * 上原先只列了 Table 与 Notebook，读起来像是「Agent 出不了图」。
+ * 「回答 / 数据工具」的可编辑工作区产物是表格和画布；分析报告由 DRender 生成。
  */
-export type WorkspaceTabKind = 'data-sheet' | 'data-notebook' | 'data-excalidraw'
+export type WorkspaceTabKind = 'data-sheet' | 'data-excalidraw'
 
 /**
  * 四个分栏的顺序、名字与图标。**定义在这里而不是在 `KnowledgeBaseTab` 里**：
@@ -76,9 +74,8 @@ export type WorkspaceTabKind = 'data-sheet' | 'data-notebook' | 'data-excalidraw
  */
 export const KNOWLEDGE_TABS: Array<{ id: KnowledgeTab; label: string; step: string; icon: LucideIcon }> = [
   { id: 'source-raw', label: 'SourceRaw', step: '收录', icon: Database },
-  /* Knowledge 是 0063 的**事实真源**，所以它有自己的一栏（原先它挤在 Wiki 那一栏里，
-     压在卡片列表上方）。它装的是 Extract 与 Resolve 两段：抽出来的知识，和归一后的坐标。 */
-  { id: 'knowledge', label: 'Knowledge', step: '抽取 · 归一', icon: Quote },
+  /* Knowledge 与 Event 都是抽取真源，放在同一栏用二级切换区分；两者都属于 Extract 与 Resolve。 */
+  { id: 'knowledge', label: 'Knowledge & Event', step: '抽取 · 归一', icon: Quote },
   /* WikiCard 这一栏现在只回答一件事：**这些知识被组织成了哪些页**（Materialize）。
      构建（向量 + 图谱）没有自己的栏，它的参数 chip 挂在这一栏的卡片头上。 */
   { id: 'wiki', label: 'WikiCard', step: '物化', icon: Layers3 },
@@ -110,7 +107,7 @@ export const NODE_LANES: LaneMeta[] = [
 ]
 
 export type NodeId =
-  | 'conversation' | 'intent' | 'runtime' | 'answer' | 'data-sheet' | 'data-notebook' | 'data-canvas'
+  | 'conversation' | 'intent' | 'runtime' | 'answer' | 'data-sheet' | 'data-canvas'
   | 'source-raw' | 'compile' | 'build' | 'recall' | 'context'
   | 'interaction' | 'episodic-memory' | 'procedural-memory' | 'memory-quality' | 'daily-update'
 
@@ -118,7 +115,7 @@ export type NodeId =
  * 实现状态。**这是这张图最容易被写坏的一格**：把待实现的画成已实现，图就从契约
  * 退化成宣传。所以状态只有四档，且每一档都要在 `statusNote` 里说清依据。
  *
- * - `host`：不是本插件的代码（Runtime / Table / Notebook 由宿主提供），不冒充我们的进度。
+ * - `host`：不是本插件的代码（Runtime / Table 由宿主提供），不冒充我们的进度。
  */
 export type NodeStatus = 'live' | 'partial' | 'planned' | 'host'
 
@@ -209,8 +206,9 @@ icon: MessageCircle, lane: 'interaction',
     input: '用户原文 + 会话 + 当前 Query', output: 'intent 记录 + Query Analysis（Intent / OAS）',
     steps: [
       { label: '固定审计契约', detail: '按内置分类、act 与 relation 规则记录会话事实', state: 'done' },
-      { label: '记录不拦截执行', detail: '模型无法判定时记录 unknown，不阻塞后续请求', state: 'done' },
-      { label: '置信度与兜底', detail: '低于阈值的记录标 lowConfidence；漏调由 Host 补一条 fallback', state: 'done' },
+      { label: '数据域门控', detail: '只有标准模式的数据轮次进入意图链路，普通聊天不生成记录', state: 'done' },
+      { label: '记录不拦截执行', detail: '模型无法判定时记录 unknown，不阻塞后续请求；非数据轮次不补记录', state: 'done' },
+      { label: '置信度与兜底', detail: '低于阈值的记录标 lowConfidence；数据轮次漏调由 Host 补一条 fallback', state: 'done' },
       { label: '召回侧解析', detail: '当前 Query 解析 Intent + Object / Action / Scene，交给 Coordinate 路', state: 'done' },
     ],
     status: 'live', statusNote: '会话意图记录已落盘；召回侧 Query Analysis 在知识库 → 召回重排中实时展示。',
@@ -218,25 +216,25 @@ icon: BrainCircuit, lane: 'interaction', tab: 'intent',
   },
   runtime: {
     title: 'Tita Agent Runtime', shortTitle: 'Agent Runtime', subtitle: '规划、调用工具、执行分析',
-    detail: 'Agent 核心运行时：编排知识召回、数据表格、Notebook 和自进化记忆，组织结果并返回给用户。',
+    detail: 'Agent 核心运行时：编排知识召回、数据表格和自进化记忆，组织结果并返回给用户。',
     input: '意图与上下文 + 召回得到的知识', output: '回答、引用、结构化数据',
     steps: [
       { label: '接收 Agent Context', detail: '重排后的 Section 归并为完整 WikiCard，连同 Knowledge 与 Source provenance 返回', state: 'done' },
-      { label: '调用工具', detail: '取数、表格、Notebook、知识写入都由工具完成', state: 'done' },
-      { label: '组织回答', detail: '解释与引用一起返回，结构化结果转交 Table / Notebook', state: 'done' },
+      { label: '调用工具', detail: '取数、表格、知识写入都由工具完成', state: 'done' },
+      { label: '组织回答', detail: '解释与引用一起返回，结构化结果可转交 Table / 画布或 DRender 报告', state: 'done' },
     ],
     status: 'host', statusNote: 'Runtime 是宿主 Agent 本体；本插件以「召回上下文 + 知识工具」的方式接入它。',
 icon: Box, lane: 'interaction',
   },
   answer: {
     title: '回答 / 数据工具', subtitle: '生成结果、可视化与方案',
-    detail: '输出解释、引用和数据结果，并把结构化结果继续交给 Table、Notebook 或画布处理。',
-    input: '模型回答 + 工具返回值', output: '可读回答、可编辑表格、可复现 Notebook、可编辑画布',
+    detail: '输出解释、引用和数据结果，并把结构化结果交给 Table、画布或 DRender 报告处理。',
+    input: '模型回答 + 工具返回值', output: '可读回答、可编辑表格、DRender 报告、可编辑画布',
     steps: [
       { label: '回答与引用', detail: '每一条结论都能指回 wiki 与 SourceRaw', state: 'done' },
-      { label: '转交数据工具', detail: '结构化结果可继续在 Table / Notebook / 画布里加工', state: 'done' },
+      { label: '转交数据工具', detail: '结构化结果可继续在 Table / 画布里加工，或由 DRender 生成报告', state: 'done' },
     ],
-    status: 'host', statusNote: '回答渲染与 Table / Notebook / 画布由宿主工作区提供。',
+    status: 'host', statusNote: '回答渲染与 Table / 画布由宿主工作区提供；DRender 负责报告生成。',
 icon: BarChart3, lane: 'interaction',
   },
   'data-sheet': {
@@ -246,14 +244,6 @@ icon: BarChart3, lane: 'interaction',
     steps: [{ label: '打开数据表格', detail: '由宿主的 Table 插件承载', state: 'done' }],
     status: 'host', statusNote: '属于 `dsh-data-table` 插件，这里只画调用关系。',
 icon: Table2, lane: 'interaction',
-  },
-  'data-notebook': {
-    title: 'Notebook', subtitle: '生成 / 分析 Notebook',
-    detail: '把查询、SQL、Markdown 和图表组织成可复用的分析 Notebook。',
-    input: '查询与代码片段', output: '可复现的分析 Notebook',
-    steps: [{ label: '打开数据笔记本', detail: '由宿主的 Notebook 插件承载', state: 'done' }],
-    status: 'host', statusNote: '属于 `dsh-data-notebook` 插件，这里只画调用关系。',
-icon: FileCode2, lane: 'interaction',
   },
   'data-canvas': {
     title: '画布', subtitle: '生成 / 编辑 Excalidraw 画布',
@@ -286,7 +276,7 @@ icon: Database, lane: 'knowledge', tab: 'knowledge', knowledgeTab: 'source-raw',
       { label: '物化 WikiCard', detail: '按 (对象, 动作, 场景) 分组，卡名由公式推导（对象名 + 场景 + 动作名）；小节与字段作为组织提示，卡片直接入库，review 与备注在预览中处理', state: 'done' },
       { label: '建索引', detail: '切召回单元、写索引页与相关卡片、检查断链，不调模型', state: 'done' },
     ],
-    status: 'live', statusNote: '四段都已实现：抽 Knowledge、归一坐标、按坐标物化卡片、切召回单元并建索引（模型不可用时退回规则抽取，此时没有坐标，正文按小节切）。入库后的 review 与备注在卡片的预览侧栏里。',
+    status: 'live', statusNote: '导入默认只保存来源；抽取 Knowledge / Event、归一、物化分别运行，也可全链路运行。未变文档复用检查点；构建成功后统一发布索引。模型不可用时任务明确失败，可查看输出与历史后重试。',
 icon: RefreshCw, lane: 'knowledge', tab: 'knowledge', knowledgeTab: 'wiki',
   },
   build: {
@@ -334,7 +324,7 @@ icon: Layers3, lane: 'knowledge', tab: 'knowledge', knowledgeTab: 'recall',
     detail: '记录用户做了什么、采用了什么结果，以及对分析结果的反馈，为自进化闭环提供输入。',
     input: '每一轮的意图记录与工具调用', output: '可回溯的交互审计流',
     steps: [
-      { label: '意图审计流', detail: '每轮一条 intent 记录，只标注不拦截', state: 'done' },
+      { label: '意图审计流', detail: '每个数据轮次一条 intent 记录，只标注不拦截', state: 'done' },
       { label: '结果采纳与反馈', detail: '用户是否采用了结果、事后评价还没采集', state: 'todo' },
     ],
     status: 'partial', statusNote: '意图记录已经是一条真实的审计流；「结果是否被采用」这类反馈还没有采集入口。',
@@ -499,7 +489,7 @@ export function nodeMetrics(id: NodeId, stats: KnowledgeStats, version: number):
     case 'recall':
       return [
         { label: 'topK', value: String(stats.recallTopK ?? 10) },
-        { label: '默认路线', value: stats.recallMode ?? 'hybrid' },
+        { label: '召回方式', value: '多路径融合' },
       ]
     case 'context':
       return [
@@ -533,12 +523,12 @@ export function metricsByNode(stats: KnowledgeStats, version: number): Partial<R
 
 /** 节点在图上出现的顺序：按链路，再按链内阅读顺序。它就是键盘可达列表的顺序。 */
 export const NODE_ORDER: NodeId[] = [
-  'conversation', 'intent', 'runtime', 'answer', 'data-sheet', 'data-notebook', 'data-canvas',
+  'conversation', 'intent', 'runtime', 'answer', 'data-sheet', 'data-canvas',
   'source-raw', 'compile', 'build', 'recall', 'context',
   'interaction', 'episodic-memory', 'procedural-memory', 'memory-quality', 'daily-update',
 ]
 
-/** 只在面板里出现、不占图上格子的节点（0025 起 Table / Notebook 已上图，这里保留给未来）。 */
+/** 只在面板里出现、不占图上格子的节点（这里保留给未来扩展）。 */
 export const DERIVED_NODES: NodeId[] = []
 
 /** 某个节点归属的链路定义；找不到（例如未来新增节点漏填 lane）时返回 null 而不是猜。 */