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

package/src/client/KnowledgeBaseTab.tsx

@@ -35,21 +35,25 @@
 
 import { useCallback, useEffect, useMemo, useRef, useState, type ChangeEvent, type ReactNode } from 'react'
 import {
-  AlertCircle, Check, Eye, FileText, FileUp, FolderOpen,
+  AlertCircle, Check, ChevronDown, Eye, ExternalLink, FileText, FileUp, FolderOpen,
   Layers3, RefreshCw, Search, ShieldCheck, Tags, Trash2, Upload, X,
 } from '@tita-data-agent/ui/icons'
 import type { LucideIcon } from '@tita-data-agent/ui/icons'
-import { Badge, Button, Card, Input, Label, SelectMenu, cn } from '@tita-data-agent/ui/components'
+import {
+  Badge, Button, Card, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger,
+  Field, Input, SelectMenu, Tabs, TabsContent, TabsList, TabsTrigger, cn,
+} from '@tita-data-agent/ui/components'
 import {
   Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle,
   Drawer, DrawerBody, DrawerContent, DrawerDescription, DrawerHeader, DrawerTitle,
 } from '@tita-data-agent/ui/overlays'
 import { ObjectPicker } from '@tita-data-agent/ui/workspace'
 import { RestoreDialog, type VersionManagerEntry } from '@tita-data-agent/ui/versions'
+import { readRemembered, readRememberedId, remember } from './panel-state.ts'
 import { styles } from './styles.ts'
 import { formatBytes, formatDateTime, formatTime } from './format.ts'
 import { PreviewContent, PreviewMeta, PreviewVersions } from './PreviewSections.tsx'
-import type { KnowledgeTab } from './architecture.tsx'
+import { KNOWLEDGE_TABS, type KnowledgeTab } from './architecture.tsx'
 import { KnowledgeStepRail } from './KnowledgeStepRail.tsx'
 import { NodeSettingsPanel, SettingsChip, useScope, type SettingsNode, type SettingsScopeLike } from './NodeSettings.tsx'
 import { RecallPanel } from './RecallPanel.tsx'
@@ -58,6 +62,7 @@ import type { GraphEdgeView, GraphNodeView } from './graph/layout.ts'
 import type { WikiTypeView } from './WikiTypeEditor.tsx'
 import { WikiFlowCard } from './WikiFlowCard.tsx'
 import { TypeDefinitionDrawer } from './TypeDefinitionDrawer.tsx'
+import { ProposalReview } from './ProposalReview.tsx'
 
 // ------------------------------------------------------------------ contract
 // Mirrors the plugin HTTP contract (see plugins/dsh-data-domain-knowledge/README.md).
@@ -165,6 +170,13 @@ export interface KnowledgeDocument {
 
 export interface KnowledgeDocumentDetail extends KnowledgeDocument {
   content: string
+  /**
+   * 正文总字符数。`content` 可能只是前一段 —— 明细接口按 `SOURCE_PREVIEW_CHARS`
+   * 封顶（4000），所以**不能**再用 `content.length` 当「全文有多少」。
+   */
+  contentChars: number
+  /** `content` 是不是被截断过。为真时给「新页面打开」。 */
+  contentTruncated: boolean
   frontmatter: Record<string, unknown>
   assets: Array<{ rel: string; bytes: number; url: string }>
   lineage?: Record<string, string>
@@ -205,25 +217,7 @@ export interface WikiCardVersionView {
   isCurrent: boolean
 }
 
-interface Envelope<T> { ok?: boolean; data?: T; warnings?: string[]; error?: { code?: string; message?: string; suggestion?: string } | null }
-
-async function requestJson<T>(url: string, init?: RequestInit): Promise<Envelope<T>> {
-  const response = await fetch(url, init)
-  const text = await response.text()
-  if (!text.trim()) throw new Error(`服务端返回空响应（HTTP ${response.status}）`)
-  let payload: Envelope<T>
-  try {
-    payload = JSON.parse(text) as Envelope<T>
-  } catch {
-    throw new Error(`服务端返回了无效响应（HTTP ${response.status}）`)
-  }
-  const error = payload.error
-  if (!response.ok || payload.ok === false) {
-    const detail = [error?.code, error?.message].filter(Boolean).join(' · ') || `请求失败（${response.status}）`
-    throw new Error(error?.suggestion ? `${detail} — ${error.suggestion}` : detail)
-  }
-  return payload
-}
+import { requestJson, type Envelope } from './request.ts'
 
 /** Text-ish formats the browser can read and POST as SourceRaw directly. */
 const DIRECT_READ_EXT = new Set(['.md', '.markdown', '.txt', '.json', '.tsv', '.csv', '.html'])
@@ -275,7 +269,22 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
   const [loading, setLoading] = useState(false)
   const [busy, setBusy] = useState<string | null>(null)
   const [notice, setNotice] = useState<{ tone: 'success' | 'error'; text: string } | null>(null)
-  const [tab, setTab] = useState<KnowledgeTab>('source-raw')
+  /**
+   * 分栏与选中的知识库。**起始值来自记住的位置**（`panel-state.ts`）：面板会被 DSH
+   * 重新挂载（刷新页面必然），只放在 `useState` 里的话，用户每次回来都落回
+   * 「SourceRaw + 默认知识库」。分栏存的是上一版的 id 时先对着 `KNOWLEDGE_TABS` 校验；
+   * 知识库 id 是服务端数据、没有注册表可校验，所以由 `loadBases` 用它自己的
+   * 「不存在就退回默认库」那条规则兜底。
+   */
+  const [tab, setTab] = useState<KnowledgeTab>(() => readRemembered('knowledgeTab', KNOWLEDGE_TABS.map(item => item.id)) ?? 'source-raw')
+  /**
+   * wiki 栏内部的二级 tab（0042）：卡片 / 抽取流程。
+   *
+   * **不记进 `panel-state.ts`**：那里记的是「上次看到哪儿」的三个大位置（一级 tab、
+   * 分栏、知识库），而这是某一栏内部的两种读法 —— 面板重新挂载时落回「卡片」
+   * （这一栏的第一件事）是正确的默认，而且不必为一个二级 tab 去改那个模块的 key 表。
+   */
+  const [wikiTab, setWikiTab] = useState<'cards' | 'flow'>('cards')
   const [editOpen, setEditOpen] = useState(false)
   const [draft, setDraft] = useState({ id: '', name: '', description: '' })
   /**
@@ -284,6 +293,15 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
    * 拉取，因为停用的分类要在提示词里标记出来。
    */
   const [catalog, setCatalog] = useState<SourceTypeCatalog | null>(null)
+
+  /**
+   * 换分栏的**唯一入口**：顺手记一笔，下次挂载落回同一栏。两个调用点（步骤轨点击、
+   * 从架构图节点跳过来）都走它，所以不会出现「这个入口记得、那个入口不记得」。
+   */
+  const changeTab = useCallback((next: KnowledgeTab): void => {
+    setTab(next)
+    remember('knowledgeTab', next)
+  }, [])
   /**
    * 「类型定义」抽屉（0034）：本库的词汇表 —— 来源分类 + Wiki 卡片 schema。
    * 弹窗草稿在抽屉内部，这里只留开关与写路径。
@@ -349,7 +367,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
 
   /** 架构图节点跳转：落到对应分栏。 */
   useEffect(() => {
-    if (visible && focus) setTab(focus.tab)
+    if (visible && focus) changeTab(focus.tab)
   }, [visible, focus?.tab, focus?.nonce]) // eslint-disable-line react-hooks/exhaustive-deps
 
   /** `sourceId → wiki cards`, so a file row can say how many slices it produced. */
@@ -369,13 +387,16 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
   const loadBases = useCallback(async (preferred?: string): Promise<{ next: KnowledgeBase[]; resolved: string }> => {
     const payload = await requestJson<{ bases: KnowledgeBase[]; defaultBaseId: string }>('/knowledge/bases')
     const next = payload.data?.bases ?? []
-    const requested = preferred ?? activeIdRef.current
+    // 优先级：显式指定（新建 / 编辑后回到那一个）→ 本次挂载里已经选中的 → **记住的那个**。
+    // 最后一档就是「刷新之后还在原来那个库」，而它不合法时下面那句会退回默认库。
+    const requested = preferred ?? (activeIdRef.current !== '' ? activeIdRef.current : readRememberedId('knowledgeBase'))
     const resolved = next.some(base => base.id === requested)
       ? requested
       : payload.data?.defaultBaseId ?? next[0]?.id ?? ''
     setBases(next)
     setActiveId(resolved)
     activeIdRef.current = resolved
+    remember('knowledgeBase', resolved)
     return { next, resolved }
   }, [])
 
@@ -738,11 +759,18 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
     // 的**原文状态重新满足 `open`，于是面板「自己又弹回来」——互斥必须两边都成立。
     setCardDetail(null)
     setDetailLoading(true)
-    setDetail({ document: { ...document, content: '', frontmatter: {}, assets: [] }, versions: [] })
+    setDetail({ document: { ...document, content: '', contentChars: 0, contentTruncated: false, frontmatter: {}, assets: [] }, versions: [] })
     try {
       const q = `?kb=${encodeURIComponent(baseId)}`
-      const docPayload = await requestJson<{ document: KnowledgeDocumentDetail }>(`/knowledge/documents/${encodeURIComponent(document.docId)}${q}`)
-      const versionPayload = await requestJson<{ versions: DocumentVersion[] }>(`/knowledge/documents/${encodeURIComponent(document.docId)}/versions${q}`)
+      /**
+       * 两条请求**并行**。原来是串行的（先详情、再版本），于是一次打开弹层的等待
+       * 是两段的和 —— 而它们之间没有任何依赖。详情返回之后弹层就能读，
+       * 版本时间线自己在 `detailLoading` 里补。
+       */
+      const [docPayload, versionPayload] = await Promise.all([
+        requestJson<{ document: KnowledgeDocumentDetail }>(`/knowledge/documents/${encodeURIComponent(document.docId)}${q}`),
+        requestJson<{ versions: DocumentVersion[] }>(`/knowledge/documents/${encodeURIComponent(document.docId)}/versions${q}`),
+      ])
       if (docPayload.data?.document) {
         setDetail({ document: docPayload.data.document, versions: versionPayload.data?.versions ?? [] })
       }
@@ -917,15 +945,31 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
       .map(([ext, count]) => ({ value: ext, label: `${ext}（${count}）` }))
   }, [documents])
   /**
-   * `/knowledge/stats` 在这里是 `Record<string, unknown>`（它同时承载编译设置快照），
-   * 所以 `lastBuild` 要显式收窄一次再读 —— 否则每个字段都得写一遍类型断言。
+   * 一次性迁移里没有静默处理掉的事（来源分类改名冲突、卡片改名迁移失败）。
+   *
+   * 它必须显示出来：**迁移失败而没人知道，等价于数据已经丢了**。放在卡片列表上方，
+   * 因为它比「库里有什么」更紧急。
    */
-  const lastBuild = (stats.lastBuild ?? {}) as Record<string, unknown>
+  const migrationProblems = Array.isArray(stats.migrationProblems) ? stats.migrationProblems as string[] : []
   const currentVersionId = detail?.versions.find(version => version.isCurrent)?.versionId
   const currentCardVersionId = cardDetail?.versions.find(version => version.isCurrent)?.versionId
   const detailCards = detail ? cardsBySource.get(detail.document.docId) ?? [] : []
   const pendingCards = cards.filter(card => schemaIssuesOf(card).length > 0)
 
+  /**
+   * 在独立整页里读这份原文。
+   *
+   * 抽屉宽 380px，而原文可能是一份几十万字的转换文档 —— 那里只显示前 4000 字符
+   * （`SOURCE_PREVIEW_CHARS`），剩下的出口是这个整页：新标签、可整页搜索、自带分页，
+   * 一次只取一段。
+   */
+  const openFullDocument = useCallback((document: KnowledgeDocument): void => {
+    const kb = activeIdRef.current
+    if (!kb) return
+    const url = `/knowledge/documents/${encodeURIComponent(document.docId)}/view?kb=${encodeURIComponent(kb)}`
+    window.open(url, '_blank', 'noopener,noreferrer')
+  }, [])
+
   /**
    * 文件类型筛在客户端做（接口没有这个过滤口），其余两个筛选在服务端。
    * 列表与计数都读这一份派生值，所以「筛出 3 个」与表头的数字不可能对不上。
@@ -949,14 +993,21 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
   /**
    * 步骤轨上每一步的真实事实。计数来自落盘与设置：`active` 的计数是服务端算的，
    * 图谱计数优先读 `/knowledge/stats`（它统计的是全量），拿不到才退回这一页拉到的前 50 条。
+   *
+   * 0042：wiki 这一步的 note 补上 wikiNotes 数、索引版本、增量指纹与卡片快照 ——
+   * 它们原来在「编译 wiki 与 wikiNotes」那张卡里，卡删掉之后这几条数得有地方去。
+   * 顺序按重要性排：窄栏下 note 会省略号截断，先看到的必须是更该看到的。
    */
   const stepFacts = useMemo(() => ({
     'source-raw': { value: active ? `${active.sourceCount} 个文件` : '—', note: '按格式路由解析，同 external_id 幂等' },
-    wiki: { value: active ? `${active.cardCount} 张卡片` : '—', note: '卡片 → wikiNotes，未变的逐字复用' },
+    wiki: {
+      value: active ? `${active.cardCount} 张卡片` : '—',
+      note: `${active?.noteCount ?? 0} 条 wikiNotes · 索引 v${active?.buildVersion ?? 0} · 指纹 ${String(stats.trackedCards ?? '—')} · 快照 ${String(stats.cardVersions ?? 0)}`,
+    },
     graph: { value: `${stats.graphNodes ?? graph.nodes.length} 节点 / ${stats.graphEdges ?? graph.edges.length} 边`, note: 'supported_by 溯源边 + relates_to 关系边' },
     recall: { value: `topK ${String(knowledgeValue?.recallTopK ?? 10)}`, note: `${String(knowledgeValue?.recallMode ?? 'hybrid')} 三路融合` },
     rerank: { value: `topN ${String(knowledgeValue?.contextTopN ?? 5)}`, note: 'BERT cross-encoder 精排' },
-  }), [active, stats.graphNodes, stats.graphEdges, graph.nodes.length, graph.edges.length, knowledgeValue?.recallTopK, knowledgeValue?.recallMode, knowledgeValue?.contextTopN])
+  }), [active, stats.graphNodes, stats.graphEdges, stats.trackedCards, stats.cardVersions, graph.nodes.length, graph.edges.length, knowledgeValue?.recallTopK, knowledgeValue?.recallMode, knowledgeValue?.contextTopN])
 
   // --------------------------------------------------------------- 分栏内容
 
@@ -1056,9 +1107,47 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
         这里不再留任何指路文字：工具栏与卡片头各自带着入口，路牌只是搬迁留下的债。 */}
   </div>
 
-  /** Wiki：卡片列表（一等内容）+ 编译 + 抽取流程 + schema 注册表。 */
+  /**
+   * Wiki：**两种内容，两枚 tab**（0042）。
+   *
+   * 0042 之前这里是三块竖排：卡片列表 → 「编译 wiki 与 wikiNotes」→ 抽取流程。
+   * 中间那一块同时讲动作（增量 / 全量按钮）与结果（8 行计数）—— 动作是「对这个库
+   * 做什么」，归工具栏；结果是「这一段现在有多少东西」，归步骤轨。把它留在这里，
+   * 等于让一栏内容替工具栏收着一枚按钮，还占掉一屏。
+   *
+   * **待办提议不进 tab**：它是这一屏唯一需要人动手的东西（0021 §6.1），藏进 tab
+   * 等于没人看。它继续待在 tab 之上，没有待办时整块不渲染（现状如此）。
+   */
   const renderWiki = (): ReactNode => <div className={styles.viewStack}>
-    {/* 卡片列表排在第一位，和 SourceRaw 的文件列表同一个位置、同一套筛选行 ——
+    {/* 迁移里没静默处理掉的事排在最前面：**迁移失败而没人知道，等价于数据已经丢了**。
+        它比「库里有什么」更紧急，所以不藏在统计里、也不只进日志。 */}
+    {migrationProblems.length > 0 && <p className={cn(styles.kbNotice, styles.kbNoticeError)} role="alert">
+      <AlertCircle size={13} />
+      <span>
+        <b>有 {migrationProblems.length} 处改名迁移没有生效</b>，旧文件都留在原地（没有覆盖、没有删除）：
+        {migrationProblems.join('；')}
+      </span>
+    </p>}
+    {/* **待办排在卡片列表之前。** 它是这一屏唯一需要人动手的东西（0021 §6.1）：
+        未确认的提议不落 `02_wiki/`，所以「库里有哪些卡片」和「有哪些卡片在等人点头」
+        是两件事，而后者更紧急。没有待办时整块不渲染 —— 不留一句「暂无待办」的废话。 */}
+    {active && <ProposalReview
+      kbId={active.id}
+      onApplied={() => void loadCards(active.id)}
+      onOpenWikiTypes={() => setTypeDefOpen(true)}
+    />}
+    {/* Pass 0 的候选 / 提议计数（`candidatesExtracted` / `proposalsCreated` / `proposalsMerged`）
+        曾经显示在这里。0042 撤掉了：这三个数**没有指向任何可动手的东西** ——
+        「上一轮抽出 0 个候选」既不是待办，也不是这一栏的内容，它只解释「为什么没有卡片」，
+        而那句解释已经写在下面卡片列表的空态里（「先『编译』…」）。数字本身还在
+        build-manifest 里，排查编译问题时从产物读，不占这一屏。 */}
+    <Tabs className={styles.kbSubTabs} value={wikiTab} onValueChange={next => setWikiTab(next as 'cards' | 'flow')}>
+      <TabsList className={cn(styles.tabsList, styles.kbSubTabsList)}>
+        <TabsTrigger value="cards"><FileText size={12} />卡片</TabsTrigger>
+        <TabsTrigger value="flow"><Layers3 size={12} />抽取流程</TabsTrigger>
+      </TabsList>
+      <TabsContent value="cards">
+    {/* 卡片列表和 SourceRaw 的文件列表同一个位置、同一套筛选行 ——
         两栏的「这一层有什么」都应该是打开就能看到的第一件东西。0027 之前这里
         先是一张编译统计卡，卡片列表在第三位，得先读过参数才看得到内容。 */}
     <Card className={styles.kbCard}>
@@ -1106,48 +1195,25 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
           const extracted = card.metadata?.extraction === 'pass0'
           return <li key={card.entityId} className={styles.cardRow}>
             <button type="button" className={styles.cardRowMain} onClick={() => void openCard(card)}>
-              <div className={styles.cardRowHead}>
+              {/* 一行一条：状态 + 标题 + 两枚状态徽标 +（右侧）类型与时间。
+                  0042 撤掉了摘要行与「类型 · id · 出处」行 —— 三行内容让每一张卡片都
+                  长成一个框，一屏三张卡就是三个框。扫一眼只需要认出「是哪一张」，
+                  摘要、entity_id、出处数都进抽屉（title 里挂 id 与出处数）。 */}
+              <span className={styles.cardRowHead}>
                 <Badge tone={card.status === 'active' || card.status === 'reviewed' ? 'success' : card.status === 'problem' ? 'warning' : 'neutral'}>{card.status}</Badge>
-                <span className={styles.cardRowTitle} title={card.entityId}>{card.title}</span>
+                <span className={styles.cardRowTitle} title={`${card.entityId} · ${card.sourceRefs.length} 个出处`}>{card.title}</span>
                 {extracted && <Badge tone="blue">候选</Badge>}
                 {issues.length > 0 && <Badge tone="warning">待补 {issues.length}</Badge>}
-                <span className={styles.kbTypeCount}>{formatTime(card.updatedAt)}</span>
-              </div>
-              <p className={styles.cardRowText}>{card.summary || card.content.replace(/!\[[^\]]*\]\([^)]*\)/g, ' ').replace(/\s+/g, ' ').slice(0, 160) || '（空卡片）'}</p>
-              <span className={styles.kbCode}>{card.entityType} · {card.entityId} · {card.sourceRefs.length} 个出处</span>
+                <span className={styles.kbTypeCount}>{card.entityType} · {formatTime(card.updatedAt)}</span>
+              </span>
             </button>
           </li>
         })}
       </ul>
     </Card>
-
-    <Card className={styles.kbCard}>
-      <div className={styles.kbCardHead}>
-        <div><h3><Layers3 size={13} />编译 wiki 与 wikiNotes</h3></div>
-        <div className={styles.kbCardActions}>
-          <Button variant="outline" size="sm" onClick={() => void rebuild('wiki')} disabled={busy !== null}><RefreshCw size={13} />{busy === 'compile' ? '编译中…' : '增量编译'}</Button>
-          <Button variant="ghost" size="sm" onClick={() => void rebuild('all')} disabled={busy !== null}>全量重编</Button>
-        </div>
-      </div>
-      <p className={styles.kbHint}>
-        <b>增量</b>：只有正文 / 标题 / 状态 / 出处变过的卡片会重新切分成 wikiNotes，其余卡片的召回单元**逐字复用**（unitId 不变，向量也不重编码）。
-        语料完全没变时这一次编译是**空操作**：不写产物、不升版本，因为升版本会让整份向量缓存作废。
-      </p>
-      <div className={styles.infoList}>
-        <div><span>wiki 卡片</span><strong>{active?.cardCount ?? 0}</strong></div>
-        <div><span>wikiNotes</span><strong>{active?.noteCount ?? 0}</strong></div>
-        <div><span>已纳入增量指纹</span><strong>{String(stats.trackedCards ?? '—')}</strong></div>
-        <div><span>卡片版本快照</span><strong>{String(stats.cardVersions ?? 0)}</strong></div>
-        <div><span>索引版本</span><strong>v{active?.buildVersion ?? 0}</strong></div>
-        <div><span>待补 schema 的卡片</span><strong>{pendingCards.length}</strong></div>
-        {/* Pass 0 的四个诚实计数：抽了几个候选、拒了几个、建了几张、并进几张。
-            它们来自上一轮编译的 build-manifest，不是估算。 */}
-        <div><span>上一轮抽出候选</span><strong>{String(lastBuild.candidatesExtracted ?? '—')}</strong></div>
-        <div><span>新建 / 合并卡片</span><strong>{stats.lastBuild ? `${lastBuild.cardsCreated ?? 0} / ${lastBuild.cardsMerged ?? 0}` : '—'}</strong></div>
-      </div>
-    </Card>
-
-    <WikiFlowCard />
+      </TabsContent>
+      <TabsContent value="flow"><WikiFlowCard /></TabsContent>
+    </Tabs>
 
     {/* **Wiki 类型**（卡片 schema）也不在这一栏了（0034）：它和来源类型是同一类东西
         —— 按库持久化的词汇表，一个决定「一份文件以什么业务身份进来」，一个决定「一张
@@ -1247,7 +1313,10 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
       />
       {/* 三个动作同形：图标 + 文字的 outline 按钮，同一个 30px 高。内核控制台是一个
           **链接**，所以它走 `Button asChild` 拿到同一套外观 —— 早先它是一枚裸的
-          `.tita-uiButton` 锚点，在这两枚按钮旁边读起来像第三种控件。 */}
+          `.tita-uiButton` 锚点，在这两枚按钮旁边读起来像第三种控件。
+          0042：「编译」原本在 wiki 栏的统计卡里（增量 + 全量两枚），现在它是**工具栏的
+          一个动作**，两档收进同一枚按钮的下拉里 —— 编译是「对这个库做什么」，
+          它和「选哪个库」「类型定义」同层，不属于任何一栏的内容。 */}
       <span className={styles.kbToolbarActions}>
         <Button
           variant="outline"
@@ -1256,7 +1325,30 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
           title={active ? `编辑 ${active.name} 的来源类型与 Wiki 类型` : '先选择一个知识库'}
           onClick={() => setTypeDefOpen(true)}
         ><Tags size={13} />类型定义</Button>
-        <Button variant="outline" size="sm" onClick={() => void rebuild('wiki')} disabled={busy !== null || !active}><RefreshCw size={14} />{busy === 'compile' ? '编译中…' : '编译'}</Button>
+        <DropdownMenu>
+          <DropdownMenuTrigger asChild>
+            <Button variant="outline" size="sm" disabled={busy !== null || !active}>
+              <RefreshCw size={14} />{busy === 'compile' ? '编译中…' : '编译'}<ChevronDown size={12} />
+            </Button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end" className={styles.kbCompileMenu}>
+            {/* 每一项是「名字 + 一行说明」两层，不是一句长句子。
+                共享组件的菜单默认把宽度锁成触发器的宽度（`编译 ⌄` 只有 90px 上下），
+                长句子进去就是一根 8 个字一行的竖条 —— 宽度由 CSS 纠正，句子由这里拆短。 */}
+            <DropdownMenuItem onSelect={() => void rebuild('wiki')}>
+              <span className={styles.kbCompileItem}>
+                <b>增量编译</b>
+                <small>只重切变过的卡片，其余 wikiNotes 逐字复用</small>
+              </span>
+            </DropdownMenuItem>
+            <DropdownMenuItem onSelect={() => void rebuild('all')}>
+              <span className={styles.kbCompileItem}>
+                <b>全量重编</b>
+                <small>全部重切，并把索引版本加一</small>
+              </span>
+            </DropdownMenuItem>
+          </DropdownMenuContent>
+        </DropdownMenu>
         <Button variant="outline" size="sm" asChild>
           <a href="/convert/" target="_blank" rel="noreferrer" title="打开解析内核控制台"><FileUp size={14} />解析内核</a>
         </Button>
@@ -1265,7 +1357,7 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
 
     {/* 分栏是**一条流水线**，所以切换器是步骤轨而不是一排等宽 tab：收录 → 编译 →
         关联 → 检索 → 精排。方向本身就是信息（写入侧在左、读取侧在右）。 */}
-    <KnowledgeStepRail tab={tab} onChange={setTab} facts={stepFacts} />
+    <KnowledgeStepRail tab={tab} onChange={changeTab} facts={stepFacts} />
 
     {notice && <p className={cn(styles.kbNotice, notice.tone === 'error' && styles.kbNoticeError)} role="status">
       <AlertCircle size={13} /><span>{notice.text}</span>
@@ -1291,13 +1383,12 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
       {editOpen && <DialogContent>
         <DialogHeader><DialogTitle>{draft.id ? '编辑知识库' : '新建知识库'}</DialogTitle></DialogHeader>
         <div className={styles.kbForm}>
-          <label className={styles.kbField}><Label>名称</Label>
+          <Field label="名称">
             <Input value={draft.name} onChange={(event: ChangeEvent<HTMLInputElement>) => setDraft({ ...draft, name: event.target.value })} placeholder="例如：产品文档" />
-          </label>
-          <label className={styles.kbField}><Label>描述</Label>
+          </Field>
+          <Field label="描述" hint="每个知识库有自己的根目录、来源分类与 Wiki 类型注册表；默认知识库沿用现有的知识库根目录。">
             <Input value={draft.description} onChange={(event: ChangeEvent<HTMLInputElement>) => setDraft({ ...draft, description: event.target.value })} placeholder="这个知识库放什么" />
-          </label>
-          <p className={styles.kbHint}>每个知识库有自己的根目录、来源分类与 Wiki 类型注册表；默认知识库沿用现有的知识库根目录。</p>
+          </Field>
         </div>
         <DialogFooter>
           <Button variant="ghost" onClick={() => setEditOpen(false)}>取消</Button>
@@ -1355,9 +1446,24 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
         一个 state —— 「同时开两个」在这里变成不可表达的状态。 */}
     <Drawer open={detail !== null && cardDetail === null} onOpenChange={next => { if (!next) setDetail(null) }}>
       {detail && <DrawerContent className={styles.drawer} resizable resizeKey="tita-source-preview">
+        {/* 抽屉头：标题 + 一行「它是什么」+ **全文出口**。
+            0042 把「新页面打开」从正文块里搬到这一行，两个理由：
+            1. 它是「这份东西还能去哪看」，位置要固定 —— 头不参与滚动，正文块滚多久它都在；
+            2. 它原来**只在正文被截断时**才渲染，于是短文档上根本不存在（用户报告的原话是
+               「那个按钮我也没看到」）。入口的显隐不能依赖内容长度。
+            头部这一行只放**一种**动作，所以不与正文块里的读法切换抢位置。 */}
         <DrawerHeader>
-          <DrawerTitle>{detail.document.title}</DrawerTitle>
-          <DrawerDescription>{detail.document.relativePath}</DrawerDescription>
+          <div className={styles.drawerHead}>
+            <div className={styles.drawerHeadCopy}>
+              <DrawerTitle>{detail.document.title}</DrawerTitle>
+              <DrawerDescription>{detail.document.relativePath}</DrawerDescription>
+            </div>
+            <Button
+              variant="outline" size="sm" className={styles.drawerHeadAction}
+              title="在一个独立的整页里读完整原文（新标签页，可分页搜索）"
+              onClick={() => openFullDocument(detail.document)}
+            ><ExternalLink size={12} />新页面打开</Button>
+          </div>
         </DrawerHeader>
         <DrawerBody className={styles.drawerStack}>
           {/* 0035：两种预览是**同一套分块**（元信息 → 内容 → 版本），SourceRaw 只多一块
@@ -1376,7 +1482,11 @@ export function KnowledgeBaseTab({ visible, onChanged, onActiveBaseChange, knowl
             { label: '更新', value: formatDateTime(detail.document.updatedAt) },
           ]} />
 
-          <PreviewContent content={detail.document.content} assets={detail.document.assets} />
+          <PreviewContent
+            content={detail.document.content}
+            assets={detail.document.assets}
+            totalChars={detail.document.contentChars}
+          />
 
           <div className={styles.drawerSection}>
           {/* WeKnora 的详情页在文件下面列分块；这里列的是这个 SourceRaw 编译出的 wiki 卡片。 */}

package/src/client/KnowledgePanel.tsx

@@ -13,7 +13,7 @@ import { LayoutPreview, useAgentLayout } from './DirectoryPicker.tsx'
 import { AgentPresetCard, type AgentPresetRemote } from './AgentPresetCard.tsx'
 import {
   NODE_META, NODE_ORDER, NODE_STATUS_LABEL, noteCountOf, sourceCountOf,
-  type KnowledgeStats, type KnowledgeTab, type NodeId, type PanelTab, type Tone,
+  type KnowledgeStats, type KnowledgeTab, type NodeId, type PanelTab, type Tone, type WorkspaceTabKind,
 } from './architecture.tsx'
 import { AgentArchitectureGraph } from './arch/AgentArchitectureGraph.tsx'
 import { NodeLogicPanel } from './arch/NodeLogicPanel.tsx'
@@ -24,13 +24,14 @@ import { AttributionTab } from './attribution/AttributionTab.tsx'
 import { KnowledgeBaseTab } from './KnowledgeBaseTab.tsx'
 import { IntentTab } from './IntentTab.tsx'
 import { RecallPanel } from './RecallPanel.tsx'
+import { readRemembered, remember } from './panel-state.ts'
 import { styles, toneSuffix } from './styles.ts'
 import '@tita-data-agent/ui/styles.css'
 import './styles.css'
 
 interface Props {
   visible: boolean
-  onOpenTab?: (kind: 'data-sheet' | 'data-notebook') => void
+  onOpenTab?: (kind: WorkspaceTabKind) => void
   settings?: {
     intent?: SettingsScopeLike
     knowledge?: SettingsScopeLike
@@ -167,7 +168,13 @@ function EvalTab({ visible, settings, onSelect }: { visible: boolean; settings?:
 }
 
 export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props): ReactNode {
-  const [activeTab, setActiveTab] = useState<ViewId>('overview')
+  /**
+   * 一级 tab。**起始值来自记住的位置**（`panel-state.ts`）：DSH 会重新挂载这个面板
+   * （刷新页面必然、换会话按宿主策略也会），只放在 `useState` 里的话，用户每次回来都
+   * 跳回「Agent 概览」。存的值先对着 `VIEW_ORDER` 校验 —— 上一版写下的旧 id 不能让面板
+   * 走进一个不存在的 tab。
+   */
+  const [activeTab, setActiveTab] = useState<ViewId>(() => readRemembered('view', VIEW_ORDER) ?? 'overview')
   const [stats, setStats] = useState<KnowledgeStats>({})
   const [statsLoading, setStatsLoading] = useState(false)
   const [statsError, setStatsError] = useState<string | null>(null)
@@ -230,9 +237,19 @@ export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props):
   const selectNode = (id: NodeId | null): void => { setSelected(id); setSelectedDomain(null); setNotice(null) }
   const selectDomain = (id: string | null): void => { setSelectedDomain(id); setSelected(null); setNotice(null) }
 
+  /**
+   * **换一级 tab 的唯一入口。** 三处都会换（tab 栏、节点面板的「去配置」、归因空态送人
+   * 去知识库录来源），每一处都顺手记一笔 —— 分头写的话，迟早有一处忘了记，
+   * 而那种漏表现为「从这个入口过去不记得、从那个入口过去记得」。
+   */
+  const changeTab = useCallback((tab: ViewId): void => {
+    setActiveTab(tab)
+    remember('view', tab)
+  }, [])
+
   /** 架构图节点 → 功能 tab。这是节点面板上「去配置」按钮唯一的落点。 */
   const jumpTo = (tab: PanelTab, knowledgeTab?: KnowledgeTab): void => {
-    setActiveTab(tab)
+    changeTab(tab)
     if (tab === 'knowledge' && knowledgeTab) setKnowledgeFocus({ tab: knowledgeTab, nonce: Date.now() })
   }
 
@@ -258,7 +275,7 @@ export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props):
 
   return <section className={styles.panel} aria-label="Tita Data Agent">
     {/* Tab 切换是面板外壳的一部分：它不参与 `.tita-content` 的滚动，永远停在顶部。 */}
-    <Tabs className={styles.panelTabs} value={activeTab} onValueChange={value => setActiveTab(value as ViewId)}>
+    <Tabs className={styles.panelTabs} value={activeTab} onValueChange={value => changeTab(value as ViewId)}>
       <div className={styles.tabBar}>
         <TabsList className={styles.tabsList}>
           {VIEW_ORDER.map(id => {
@@ -273,7 +290,10 @@ export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props):
         ><Settings2 size={15} /></Button>
       </div>
 
-      <div className={cn(styles.content, activeTab === 'attribution' && styles.contentStage)}>
+      {/* 两栏走「舞台」版式（自己占满高度、不参与面板滚动）：智能归因是图 + 运行面板，
+          概览是画布 + 画布内浮层。同一套语汇，同一个理由 —— 它们的内容都要自己撑满
+          可视区，让面板替它们滚会把画布推成一条可以滚出视口的纸。 */}
+      <div className={cn(styles.content, (activeTab === 'attribution' || activeTab === 'overview') && styles.contentStage)}>
 
         {/* 一级 tab 已经说明「现在是哪一页」，这里不再重复一遍标题与说明。
             只有真的出问题时才占一行：读取失败 / 读取中。 */}
@@ -286,11 +306,13 @@ export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props):
           <Button variant="ghost" size="icon" aria-label="关闭提示" title="关闭提示" onClick={() => setNotice(null)}><X size={14} /></Button>
         </Card>}
 
-        <TabsContent value="overview">
+        <TabsContent value="overview" className={styles.stageContent}>
           {/* 概览 = **一个画布**。0027 之前这里是「画布 + 右侧栏」，而问题域还收在栏底的
               折叠区里 —— 三块内容、两条边框，读起来是三个东西。现在画布是四条带
               （A/B/C 三条链路 + 一条问题域带），点节点或问题域牌子都在**画布内**的
               浮层里展开详情：不占侧栏、不缩字、可关闭。
+              0042：这一栏改走「舞台」版式，画布不再是一张会自动收缩的卡片 ——
+              它占满可视高度、只按宽度适应，纵向溢出靠空格 + 拖拽平移。
               设置不在这里：面板上唯一的设置入口在顶部 tab 栏最右边的齿轮里。 */}
           <AgentArchitectureGraph
             stats={stats} version={version} selected={selected}
@@ -312,7 +334,13 @@ export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props):
           <IntentTab visible={visible && activeTab === 'intent'} intent={settings?.intent} />
         </TabsContent>
 
-        <TabsContent value="knowledge">
+        {/* `forceMount`：知识库这一栏**不要在离开 tab 时卸载**。
+            它有一整套已经拉回来的状态（库列表、文件、卡片、图谱、统计），而 Radix 的
+            `TabsContent` 默认是卸载的 —— 于是每次从别的 tab 切回来，选择器先显示
+            「加载中…」、「类型定义」按钮跟着变灰，整栏白一下再长出来。那些数据并没有
+            过期，重拉一遍也不该把已经画好的东西先擦掉。
+            只有这一栏这么做：其余五栏拉的是各自独立的只读数据，卸载它们反而省事。 */}
+        <TabsContent value="knowledge" forceMount>
           <KnowledgeBaseTab
             visible={visible && activeTab === 'knowledge'}
             onChanged={() => void refreshStats()}
@@ -323,7 +351,12 @@ export function KnowledgePanel({ visible, onOpenTab, settings, remote }: Props):
         </TabsContent>
 
         <TabsContent value="attribution" className={styles.stageContent}>
-          <AttributionTab visible={visible && activeTab === 'attribution'} />
+          {/* 空态的主操作是「去知识库录来源」，所以这一栏要能把人送过去 ——
+              排查知识是从来源与卡片编译来的，它自己产不出第一份知识。 */}
+          <AttributionTab
+            visible={visible && activeTab === 'attribution'}
+            onOpenKnowledge={() => changeTab('knowledge')}
+          />
         </TabsContent>
 
         <TabsContent value="memory">

package/src/client/KnowledgeStepRail.tsx

@@ -39,6 +39,9 @@ export function KnowledgeStepRail({ tab, onChange, facts }: KnowledgeStepRailPro
           type="button"
           className={cn(styles.kbStep, on && styles.kbStepOn)}
           aria-current={on ? 'step' : undefined}
+          // 第二行的说明在窄栏下会省略号截断（它是 `nowrap` + ellipsis），
+          // 所以完整那句挂在这里 —— 截断的信息要有地方读得到。
+          title={`${item.label}：${fact.value} · ${fact.note}`}
           onClick={() => onChange(item.id)}
         >
           {/* 两行，不是一行挤四样东西。一行放「图标 + 名字 + 动作 + 计数」在宿主侧栏