@lemoncat7/dsh-knowledge 1.1.0 → 1.1.2

package/web/app.js

@@ -29,6 +29,13 @@ const app = document.querySelector('#app')
 const toastRegion = document.querySelector('#toast-region')
 const savedDocumentLayout = readDocumentLayout()
 
+function createDocumentViewState(overrides = {}) {
+  return {
+    knowledgeBaseId: '', documentId: '', query: '', mode: 'preview', treeOpen: false,
+    expandedBases: new Set(), editor: null, ...overrides,
+  }
+}
+
 const state = {
   token: sessionStorage.getItem(TOKEN_KEY) || '',
   view: 'entries',
@@ -51,14 +58,15 @@ const state = {
   nextCursor: null,
   entryFilters: { query: '', type: '', status: 'active', projectId: '', knowledgeBaseId: '' },
   documents: [],
-  documentView: {
-    knowledgeBaseId: '', documentId: '', query: '',
-    mode: 'preview',
-    treeOpen: false,
+  documentView: createDocumentViewState({
     sidebarHidden: savedDocumentLayout.sidebarHidden,
     sidebarWidth: savedDocumentLayout.sidebarWidth,
-    expandedBases: new Set(),
-    editor: null,
+  }),
+  libraryDetail: {
+    knowledgeBaseId: '',
+    documents: [],
+    error: '',
+    view: createDocumentViewState(),
   },
   candidates: [],
   candidateTargets: new Map(),
@@ -76,34 +84,45 @@ const state = {
 let scrollRestoreFrame = 0
 
 function installHostThemeBridge() {
-  if (window.parent === window) return
+  if (window.parent === window) return Promise.resolve()
   const parentOrigin = referrerOrigin()
-  window.addEventListener('message', event => {
-    if (event.source !== window.parent) return
-    if (parentOrigin && event.origin !== parentOrigin) return
-    const message = event.data
-    if (!message || message.type !== HOST_THEME_MESSAGE || message.version !== HOST_THEME_PROTOCOL_VERSION) return
-    if (message.colorScheme !== 'light' && message.colorScheme !== 'dark') return
-    if (!message.tokens || typeof message.tokens !== 'object' || Array.isArray(message.tokens)) return
-
-    const root = document.documentElement
-    for (const name of [...HOST_THEME_COLOR_TOKENS, ...HOST_THEME_STYLE_TOKENS]) root.style.removeProperty(name)
-    for (const [name, value] of Object.entries(message.tokens)) {
-      if (typeof value !== 'string' || value.length === 0 || value.length > 512) continue
-      if (HOST_THEME_COLOR_TOKENS.has(name) && CSS.supports('color', value)) root.style.setProperty(name, value)
-      else if (HOST_THEME_STYLE_TOKENS.has(name) && CSS.supports('box-shadow', value)) root.style.setProperty(name, value)
+  return new Promise(resolve => {
+    let initialThemeSettled = false
+    const settleInitialTheme = () => {
+      if (initialThemeSettled) return
+      initialThemeSettled = true
+      window.clearTimeout(fallback)
+      resolve()
     }
-    root.dataset.dshHostTheme = 'true'
-    root.style.colorScheme = message.colorScheme
-    root.style.setProperty('--dialog-surface', message.colorScheme === 'dark' ? '#1c1c1e' : '#ffffff')
-    document.querySelector('meta[name="color-scheme"]')?.setAttribute('content', message.colorScheme)
-    const background = root.style.getPropertyValue('--bg')
-    if (background) document.querySelector('meta[name="theme-color"]')?.setAttribute('content', background)
+    const fallback = window.setTimeout(settleInitialTheme, 160)
+    window.addEventListener('message', event => {
+      if (event.source !== window.parent) return
+      if (parentOrigin && event.origin !== parentOrigin) return
+      const message = event.data
+      if (!message || message.type !== HOST_THEME_MESSAGE || message.version !== HOST_THEME_PROTOCOL_VERSION) return
+      if (message.colorScheme !== 'light' && message.colorScheme !== 'dark') return
+      if (!message.tokens || typeof message.tokens !== 'object' || Array.isArray(message.tokens)) return
+
+      const root = document.documentElement
+      for (const name of [...HOST_THEME_COLOR_TOKENS, ...HOST_THEME_STYLE_TOKENS]) root.style.removeProperty(name)
+      for (const [name, value] of Object.entries(message.tokens)) {
+        if (typeof value !== 'string' || value.length === 0 || value.length > 512) continue
+        if (HOST_THEME_COLOR_TOKENS.has(name) && CSS.supports('color', value)) root.style.setProperty(name, value)
+        else if (HOST_THEME_STYLE_TOKENS.has(name) && CSS.supports('box-shadow', value)) root.style.setProperty(name, value)
+      }
+      root.dataset.dshHostTheme = 'true'
+      root.style.colorScheme = message.colorScheme
+      root.style.setProperty('--dialog-surface', root.style.getPropertyValue('--surface-raised') || root.style.getPropertyValue('--surface'))
+      document.querySelector('meta[name="color-scheme"]')?.setAttribute('content', message.colorScheme)
+      const background = root.style.getPropertyValue('--bg')
+      if (background) document.querySelector('meta[name="theme-color"]')?.setAttribute('content', background)
+      settleInitialTheme()
+    })
+    window.parent.postMessage({
+      type: HOST_THEME_READY_MESSAGE,
+      version: HOST_THEME_PROTOCOL_VERSION,
+    }, parentOrigin || '*')
   })
-  window.parent.postMessage({
-    type: HOST_THEME_READY_MESSAGE,
-    version: HOST_THEME_PROTOCOL_VERSION,
-  }, parentOrigin || '*')
 }
 
 function referrerOrigin() {
@@ -152,12 +171,16 @@ function captureScrollPosition() {
     const key = node.getAttribute('data-scroll-key')
     if (key) regions[key] = { left: node.scrollLeft, top: node.scrollTop }
   })
-  state.scrollPositions.set(shell.dataset.view, {
+  state.scrollPositions.set(shell.dataset.scrollState || shell.dataset.view, {
     window: { left: window.scrollX, top: window.scrollY },
     regions,
   })
 }
 
+function currentScrollState() {
+  return state.view === 'bases' ? `bases:${state.knowledgeBaseView}` : state.view
+}
+
 function restoreScrollPosition(view) {
   if (state.loading) return
   const saved = state.scrollPositions.get(view)
@@ -319,6 +342,10 @@ function signOut() {
 }
 
 async function navigate(view) {
+  const previousView = state.view
+  if (view === 'bases' && previousView !== 'bases' && state.knowledgeBaseView === 'detail') {
+    state.knowledgeBaseView = 'libraries'
+  }
   state.view = view
   state.menuOpen = false
   state.loading = true
@@ -412,15 +439,16 @@ async function loadDocuments() {
   state.resolvedMounts = resolved
   const visibleBaseIds = new Set(documentKnowledgeBases(bases).map(base => base.id))
   state.documents = documents.filter(document => visibleBaseIds.has(document.knowledgeBaseId))
-  const view = state.documentView
+  const workspace = sessionDocumentWorkspace()
+  const view = workspace.view
   const availableBaseIds = visibleBaseIds
   if (!view.knowledgeBaseId || !availableBaseIds.has(view.knowledgeBaseId)) {
     view.knowledgeBaseId = state.entryFilters.knowledgeBaseId && availableBaseIds.has(state.entryFilters.knowledgeBaseId)
       ? state.entryFilters.knowledgeBaseId
       : documentKnowledgeBases(bases)[0]?.id || ''
   }
-  selectDefaultDocument()
-  if (view.documentId) await loadDocumentEditor(view.documentId)
+  selectDefaultDocument(workspace)
+  if (view.documentId) await loadDocumentEditor(workspace, view.documentId)
   else view.editor = null
   if (!state.stats) await refreshStats()
 }
@@ -432,19 +460,65 @@ function documentKnowledgeBases(bases = state.knowledgeBases) {
   return active.filter(base => mountedIds.has(base.id))
 }
 
-function selectDefaultDocument() {
-  const view = state.documentView
-  const documents = state.documents.filter(document => document.knowledgeBaseId === view.knowledgeBaseId)
+function sessionDocumentWorkspace() {
+  return { kind: 'session', view: state.documentView }
+}
+
+function libraryDocumentWorkspace() {
+  return { kind: 'library', view: state.libraryDetail.view }
+}
+
+function activeDocumentWorkspace() {
+  if (state.view === 'entries') return sessionDocumentWorkspace()
+  if (state.view === 'bases' && state.knowledgeBaseView === 'detail') return libraryDocumentWorkspace()
+  return null
+}
+
+function documentWorkspaceDocuments(workspace) {
+  return workspace.kind === 'library' ? state.libraryDetail.documents : state.documents
+}
+
+function setDocumentWorkspaceDocuments(workspace, documents) {
+  if (workspace.kind === 'library') state.libraryDetail.documents = documents
+  else state.documents = documents
+}
+
+function documentWorkspaceBases(workspace) {
+  if (workspace.kind === 'library') {
+    const base = state.knowledgeBases.find(item => item.id === state.libraryDetail.knowledgeBaseId)
+    return base ? [base] : []
+  }
+  return documentKnowledgeBases()
+}
+
+function documentWorkspaceReadOnly(workspace) {
+  return workspace.kind === 'library' && documentWorkspaceBases(workspace)[0]?.status === 'archived'
+}
+
+async function reloadDocumentWorkspace(workspace) {
+  const documents = workspace.kind === 'library'
+    ? await api(`documents?knowledgeBaseId=${encodeURIComponent(state.libraryDetail.knowledgeBaseId)}`)
+    : await api('documents')
+  if (workspace.kind === 'library') setDocumentWorkspaceDocuments(workspace, documents)
+  else {
+    const visibleBaseIds = new Set(documentKnowledgeBases().map(base => base.id))
+    setDocumentWorkspaceDocuments(workspace, documents.filter(document => visibleBaseIds.has(document.knowledgeBaseId)))
+  }
+}
+
+function selectDefaultDocument(workspace) {
+  const view = workspace.view
+  const documents = documentWorkspaceDocuments(workspace).filter(document => document.knowledgeBaseId === view.knowledgeBaseId)
   if (!documents.some(document => document.id === view.documentId)) {
     view.documentId = documents[0]?.id || ''
   }
   if (view.knowledgeBaseId) view.expandedBases.add(view.knowledgeBaseId)
 }
 
-async function loadDocumentEditor(id) {
+async function loadDocumentEditor(workspace, id) {
   const entry = await api(`entries/${encodeURIComponent(id)}`)
-  state.documentView.mode = 'preview'
-  state.documentView.editor = {
+  workspace.view.mode = 'preview'
+  workspace.view.editor = {
     ...entry,
     tagsText: entry.tags.join(', '),
     dirty: false,
@@ -453,10 +527,10 @@ async function loadDocumentEditor(id) {
   }
 }
 
-function createBlankDocument(baseId) {
+function createBlankDocument(workspace, baseId) {
   const base = state.knowledgeBases.find(item => item.id === baseId && item.status === 'active')
   if (!base) return showToast('请先选择一个可用知识库。', 'error')
-  const view = state.documentView
+  const view = workspace.view
   view.knowledgeBaseId = base.id
   view.documentId = ''
   view.mode = 'edit'
@@ -470,20 +544,20 @@ function createBlankDocument(baseId) {
   document.querySelector('.note-title-input')?.focus()
 }
 
-async function startBlankDocument(baseId) {
-  const editor = state.documentView.editor
+async function startBlankDocument(workspace, baseId) {
+  const editor = workspace.view.editor
   const emptyDraft = editor?.isNew && !editor.title.trim() && !editor.body.trim()
-  if (editor?.dirty && !emptyDraft && !await saveDocumentEditor()) return
-  createBlankDocument(baseId)
+  if (editor?.dirty && !emptyDraft && !await saveDocumentEditor(workspace)) return
+  createBlankDocument(workspace, baseId)
 }
 
-async function selectDocument(id) {
-  const editor = state.documentView.editor
+async function selectDocument(workspace, id) {
+  const editor = workspace.view.editor
   const emptyDraft = editor?.isNew && !editor.title.trim() && !editor.body.trim()
-  if (editor?.dirty && !emptyDraft && !await saveDocumentEditor()) return
-  state.documentView.documentId = id
-  state.documentView.treeOpen = false
-  await loadDocumentEditor(id)
+  if (editor?.dirty && !emptyDraft && !await saveDocumentEditor(workspace)) return
+  workspace.view.documentId = id
+  workspace.view.treeOpen = false
+  await loadDocumentEditor(workspace, id)
   renderShell()
 }
 
@@ -500,8 +574,9 @@ function editorDraft(editor) {
   }
 }
 
-async function saveDocumentEditor() {
-  const editor = state.documentView.editor
+async function saveDocumentEditor(workspace = activeDocumentWorkspace()) {
+  if (!workspace) return false
+  const editor = workspace.view.editor
   if (!editor || !editor.dirty) return true
   if (!editor.isNew && editor.documentState !== 'open') {
     showToast('这篇文档已经结束并封存；请先重新打开。', 'error')
@@ -523,10 +598,9 @@ async function saveDocumentEditor() {
     editor.dirty = false
     editor.updatedAt = saved.updatedAt
     editor.saveState = '已保存'
-    state.documentView.documentId = saved.id
+    workspace.view.documentId = saved.id
     updateEditorSaveState(editor.saveState)
-    const documents = await api('documents')
-    state.documents = documents
+    await reloadDocumentWorkspace(workspace)
     return true
   } catch (error) {
     editor.saveState = '保存失败'
@@ -576,6 +650,8 @@ function renderShell() {
   const shell = element('div', {
     class: 'app-shell', 'data-menu-open': String(state.menuOpen),
     'data-view': state.view, 'data-loading': String(state.loading),
+    'data-scroll-state': currentScrollState(),
+    'data-base-detail': String(state.view === 'bases' && state.knowledgeBaseView === 'detail'),
     'data-sidebar-hidden': String(state.documentView.sidebarHidden),
     style: `--sidebar-width: ${state.documentView.sidebarWidth}px`,
   },
@@ -586,8 +662,10 @@ function renderShell() {
         element('div', { class: 'topbar-title' },
           actionButton('☰', () => { state.menuOpen = !state.menuOpen; renderShell() }, 'ghost mobile-menu', { 'aria-label': '打开导航菜单' }),
           paneToggleButton('main', !state.documentView.sidebarHidden, () => setSidebarHidden(!state.documentView.sidebarHidden), '主导航栏'),
-          state.view === 'entries' ? paneToggleButton('library', state.documentView.treeOpen, () => {
-            state.documentView.treeOpen = !state.documentView.treeOpen
+          activeDocumentWorkspace() ? paneToggleButton('library', activeDocumentWorkspace().view.treeOpen, () => {
+            const workspace = activeDocumentWorkspace()
+            if (!workspace) return
+            workspace.view.treeOpen = !workspace.view.treeOpen
             renderShell()
           }, '知识目录') : null,
           element('div', {}, element('h1', {}, title), element('p', {}, subtitle)),
@@ -600,7 +678,7 @@ function renderShell() {
     if (event.target === shell) { state.menuOpen = false; renderShell() }
   })
   app.replaceChildren(shell)
-  restoreScrollPosition(state.view)
+  restoreScrollPosition(currentScrollState())
 }
 
 function renderAppSidebarResizer() {
@@ -751,6 +829,7 @@ function renderOverview() {
 function renderKnowledgeBases() {
   const activeBases = state.knowledgeBases.filter(base => base.status === 'active')
   const archivedBases = state.knowledgeBases.filter(base => base.status === 'archived')
+  if (state.knowledgeBaseView === 'detail') return renderKnowledgeBaseDetail()
   const contextAvailable = Boolean(state.mountContext.projectId || state.mountContext.sessionId)
   const query = state.knowledgeBaseQuery.trim().toLocaleLowerCase()
   const matchesQuery = base => !query || [base.name, base.description, base.defaultTags.join(' ')]
@@ -820,6 +899,82 @@ function renderKnowledgeBases() {
   )
 }
 
+async function openKnowledgeBaseDocuments(base) {
+  captureScrollPosition()
+  const detail = state.libraryDetail
+  const changingBase = detail.knowledgeBaseId !== base.id
+  detail.knowledgeBaseId = base.id
+  if (changingBase) {
+    detail.documents = []
+    detail.view = createDocumentViewState({ knowledgeBaseId: base.id })
+  } else {
+    detail.view.knowledgeBaseId = base.id
+  }
+  state.knowledgeBaseView = 'detail'
+  state.loading = true
+  detail.error = ''
+  renderShell()
+  const workspace = libraryDocumentWorkspace()
+  try {
+    await reloadDocumentWorkspace(workspace)
+    selectDefaultDocument(workspace)
+    if (workspace.view.documentId) await loadDocumentEditor(workspace, workspace.view.documentId)
+    else workspace.view.editor = null
+  } catch (error) {
+    detail.error = friendlyError(error)
+  } finally {
+    state.loading = false
+    renderShell()
+    window.requestAnimationFrame(() => document.querySelector('.library-detail-back')?.focus())
+  }
+}
+
+async function closeKnowledgeBaseDetail() {
+  const workspace = libraryDocumentWorkspace()
+  const editor = workspace.view.editor
+  const emptyDraft = editor?.isNew && !editor.title.trim() && !editor.body.trim()
+  if (editor?.dirty && !emptyDraft && !await saveDocumentEditor(workspace)) return
+  const baseId = state.libraryDetail.knowledgeBaseId
+  state.knowledgeBaseView = 'libraries'
+  state.libraryDetail.error = ''
+  renderShell()
+  window.requestAnimationFrame(() => document.querySelector(`[data-open-knowledge-base="${CSS.escape(baseId)}"]`)?.focus())
+}
+
+function renderKnowledgeBaseDetail() {
+  const base = state.knowledgeBases.find(item => item.id === state.libraryDetail.knowledgeBaseId)
+  if (!base) return emptyState('知识库不可用', '它可能已被删除，请返回知识库列表重新选择。', '返回我的知识库', () => { state.knowledgeBaseView = 'libraries'; renderShell() })
+  const workspace = libraryDocumentWorkspace()
+  const archived = base.status === 'archived'
+  const mountStatus = state.mountContext.sessionId
+    ? mountView(base, 'session', state.mountContext.sessionId)
+    : state.mountContext.projectId ? mountView(base, 'project', state.mountContext.projectId) : null
+  return element('section', { class: 'library-detail', 'aria-labelledby': 'library-detail-title' },
+    element('header', { class: 'library-detail-header' },
+      actionButton('我的知识库', () => { void closeKnowledgeBaseDetail() }, 'ghost small library-detail-back', { 'aria-label': '返回我的知识库' }),
+      element('div', { class: 'library-detail-identity' },
+        element('span', { class: 'base-symbol', 'aria-hidden': 'true' }, base.name.trim().slice(0, 1).toLocaleUpperCase() || 'K'),
+        element('div', {},
+          element('div', { class: 'library-detail-title-line' },
+            element('h2', { id: 'library-detail-title' }, base.name),
+            badge(archived ? '已归档' : '可用', archived ? '' : 'success'),
+            mountStatus ? badge(mountStatus.statusLabel, mountStatus.statusVariant) : badge('未选择挂载范围'),
+          ),
+          element('p', {}, base.description || '通用知识库，尚未设置匹配描述。'),
+        ),
+      ),
+      element('div', { class: 'library-detail-actions' },
+        archived ? actionButton('恢复知识库', () => confirmRestoreKnowledgeBase(base), 'small') : actionButton('编辑知识库', () => openKnowledgeBaseEditor(base), 'small'),
+        !archived ? actionButton('+ 新建文档', () => { void startBlankDocument(workspace, base.id) }, 'primary small') : null,
+      ),
+    ),
+    archived ? element('div', { class: 'library-detail-notice', role: 'status' }, '这个知识库已经归档。文档仍可阅读，但恢复知识库后才能新建或修改。') : null,
+    state.libraryDetail.error
+      ? errorView(state.libraryDetail.error, () => { void openKnowledgeBaseDocuments(base) })
+      : renderDocumentWorkspace(workspace, { heading: base.name, singleBase: true }),
+  )
+}
+
 async function openGlobalWritebackModelEditor() {
   await loadModelCatalog()
   const custom = element('input', { type: 'checkbox', checked: Boolean(state.service.writebackProvider && state.service.writebackModel) })
@@ -866,12 +1021,7 @@ function renderKnowledgeBaseCard(base) {
       base.extractionInstructions ? element('span', {}, element('strong', {}, '提取规则'), '已设置') : null,
     ),
     element('div', { class: 'base-card-actions' },
-      actionButton('查看知识', () => {
-        state.entryFilters.knowledgeBaseId = base.id
-        state.documentView.knowledgeBaseId = base.id
-        state.documentView.documentId = ''
-        void navigate('entries')
-      }, 'ghost small'),
+      actionButton('查看知识', () => { void openKnowledgeBaseDocuments(base) }, 'ghost small', { 'data-open-knowledge-base': base.id }),
       archived ? actionButton('恢复', () => confirmRestoreKnowledgeBase(base), 'small') : actionButton('编辑', () => openKnowledgeBaseEditor(base), 'small'),
       archived ? actionButton('永久删除', () => confirmDeleteKnowledgeBase(base), 'danger small') : null,
       !archived && base.id !== 'default' ? actionButton('归档', () => confirmArchiveKnowledgeBase(base), 'danger small') : null,
@@ -1027,23 +1177,30 @@ function compactEmpty(message) {
 }
 
 function renderEntries() {
-  const view = state.documentView
+  return renderDocumentWorkspace(sessionDocumentWorkspace(), { heading: '知识目录' })
+}
+
+function renderDocumentWorkspace(workspace, options = {}) {
+  const view = workspace.view
   const query = view.query.trim().toLocaleLowerCase()
-  const activeBases = documentKnowledgeBases()
+  const activeBases = documentWorkspaceBases(workspace)
+  const workspaceDocuments = documentWorkspaceDocuments(workspace)
+  const readOnly = documentWorkspaceReadOnly(workspace)
   const selectedBase = activeBases.find(base => base.id === view.knowledgeBaseId)
   const search = element('input', {
     class: 'note-tree-search', type: 'search', value: view.query, placeholder: '搜索文档', 'aria-label': '搜索知识库文档',
+    'data-document-scope': workspace.kind,
     onInput: (event) => {
       view.query = event.target.value
       renderShell()
-      const input = document.querySelector('.note-tree-search')
+      const input = document.querySelector(`.note-tree-search[data-document-scope="${workspace.kind}"]`)
       input?.focus()
       input?.setSelectionRange(input.value.length, input.value.length)
     },
   })
   const tree = activeBases.map(base => {
     const expanded = view.expandedBases.has(base.id) || Boolean(query)
-    const documents = state.documents.filter(document => document.knowledgeBaseId === base.id
+    const documents = workspaceDocuments.filter(document => document.knowledgeBaseId === base.id
       && (!query || [document.title, document.relPath, document.content].some(value => value.toLocaleLowerCase().includes(query))))
     return element('section', { class: 'note-tree-group', 'data-expanded': String(expanded) },
       element('button', {
@@ -1062,48 +1219,50 @@ function renderEntries() {
       expanded ? element('div', { class: 'note-tree-documents', role: 'group', 'aria-label': `${base.name}文档` },
         documents.map(document => element('button', {
           type: 'button', class: 'note-tree-document', 'aria-current': document.id === view.documentId ? 'page' : undefined,
-          onClick: () => { void selectDocument(document.id) },
+          onClick: () => { void selectDocument(workspace, document.id) },
         }, element('span', { class: 'tree-document-icon', 'aria-hidden': 'true' }), element('span', { class: 'tree-document-copy' },
           element('strong', {}, document.title), element('small', {}, document.relPath)),
         document.documentState !== 'open' ? badge(DOCUMENT_STATE_LABELS[document.documentState] || '已结束', 'success') : null)),
-        !query ? element('button', { type: 'button', class: 'note-tree-new', onClick: () => { void startBlankDocument(base.id) } },
+        !query && !readOnly ? element('button', { type: 'button', class: 'note-tree-new', onClick: () => { void startBlankDocument(workspace, base.id) } },
           element('span', { 'aria-hidden': 'true' }, '+'), '新建文档') : null,
       ) : null,
     )
   })
   return element('section', {
-    class: 'note-workspace', 'aria-labelledby': 'documents-heading',
+    class: `note-workspace note-workspace--${workspace.kind}`, 'aria-labelledby': `${workspace.kind}-documents-heading`,
     'data-tree-open': String(view.treeOpen),
   },
     element('aside', { class: 'note-tree-panel', 'aria-label': '知识目录' },
       element('header', { class: 'note-tree-header' },
-        element('div', {}, element('h2', { id: 'documents-heading' }, '知识目录'), element('span', {}, `${state.documents.length} 篇文档`)),
-        actionButton('+', () => { void startBlankDocument(view.knowledgeBaseId || activeBases[0]?.id) }, 'ghost note-add-button', { 'aria-label': '新建文档', title: '新建文档' }),
+        element('div', {}, element('h2', { id: `${workspace.kind}-documents-heading` }, options.heading || '知识目录'), element('span', {}, `${workspaceDocuments.length} 篇文档`)),
+        !readOnly ? actionButton('+', () => { void startBlankDocument(workspace, view.knowledgeBaseId || activeBases[0]?.id) }, 'ghost note-add-button', { 'aria-label': '新建文档', title: '新建文档' }) : null,
       ),
       element('div', { class: 'note-tree-search-wrap' }, interfaceIcon('search', 'search-symbol'), search),
-      element('nav', { class: 'note-tree', 'data-scroll-key': 'note-tree' }, tree.length ? tree : element('div', { class: 'note-tree-empty' }, state.mountContext.sessionId ? '当前会话未挂载知识库' : '还没有知识库')),
-      element('footer', { class: 'note-tree-footer' }, actionButton('新建知识库', () => openKnowledgeBaseEditor(), 'ghost small')),
+      element('nav', { class: 'note-tree', 'data-scroll-key': `${workspace.kind}-note-tree` }, tree.length ? tree : element('div', { class: 'note-tree-empty' }, workspace.kind === 'session' && state.mountContext.sessionId ? '当前会话未挂载知识库' : '还没有知识库')),
+      workspace.kind === 'session' ? element('footer', { class: 'note-tree-footer' }, actionButton('新建知识库', () => openKnowledgeBaseEditor(), 'ghost small')) : null,
     ),
     view.treeOpen ? element('button', {
       type: 'button', class: 'note-tree-scrim', 'aria-label': '关闭知识目录',
       onClick: () => { view.treeOpen = false; renderShell() },
     }) : null,
-    renderNoteEditor(view.editor, selectedBase),
+    renderNoteEditor(workspace, view.editor, selectedBase),
   )
 }
 
-function renderNoteEditor(editor, base) {
+function renderNoteEditor(workspace, editor, base) {
+  const view = workspace.view
+  const readOnly = documentWorkspaceReadOnly(workspace)
   if (!editor) return element('main', { class: 'note-editor note-editor-empty' },
     element('div', { class: 'note-empty-content' },
       element('span', { class: 'empty-document-mark', 'aria-hidden': 'true' }),
       element('h3', {}, '选择或新建一篇文档'),
-      element('p', {}, '文档保存后会立即参与当前知识库的搜索与召回。'),
-      actionButton('新建文档', () => { void startBlankDocument(state.documentView.knowledgeBaseId || state.knowledgeBases.find(item => item.status === 'active')?.id) }, 'primary'),
+      element('p', {}, readOnly ? '这个知识库已归档，当前只能阅读已有文档。' : '文档保存后会立即参与当前知识库的搜索与召回。'),
+      !readOnly ? actionButton('新建文档', () => { void startBlankDocument(workspace, view.knowledgeBaseId || state.knowledgeBases.find(item => item.status === 'active')?.id) }, 'primary') : null,
     ))
   const saveShortcut = event => {
     if ((event.metaKey || event.ctrlKey) && event.key.toLocaleLowerCase() === 's') {
       event.preventDefault()
-      void saveDocumentEditor().then(saved => { if (saved) renderShell() })
+      void saveDocumentEditor(workspace).then(saved => { if (saved) renderShell() })
     }
   }
   const update = (key, value) => {
@@ -1122,27 +1281,27 @@ function renderNoteEditor(editor, base) {
   })
   body.value = editor.body
   const finalized = !editor.isNew && editor.documentState !== 'open'
-  const mode = finalized ? 'preview' : state.documentView.mode === 'edit' ? 'edit' : 'preview'
+  const mode = finalized || readOnly ? 'preview' : view.mode === 'edit' ? 'edit' : 'preview'
   if (mode === 'edit') window.requestAnimationFrame(() => resizeDocumentEditor(body))
   return element('main', { class: 'note-editor', 'aria-label': '文档编辑器' },
     element('header', { class: 'note-editor-toolbar' },
       element('div', { class: 'note-breadcrumb' },
         element('span', {}, base?.name || '知识库'),
         element('span', { 'aria-hidden': 'true' }, '/'),
-        element('strong', {}, editor.isNew ? '新文档' : state.documents.find(item => item.id === editor.id)?.relPath || editor.title)),
+        element('strong', {}, editor.isNew ? '新文档' : documentWorkspaceDocuments(workspace).find(item => item.id === editor.id)?.relPath || editor.title)),
       element('div', { class: 'note-editor-actions' },
-        finalized ? badge(DOCUMENT_STATE_LABELS[editor.documentState] || '已结束', 'success') : element('div', { class: 'note-mode-switch', role: 'tablist', 'aria-label': '文档视图' }, [
+        finalized ? badge(DOCUMENT_STATE_LABELS[editor.documentState] || '已结束', 'success') : readOnly ? badge('只读') : element('div', { class: 'note-mode-switch', role: 'tablist', 'aria-label': '文档视图' }, [
           ['edit', '编辑'],
           ['preview', '预览'],
         ].map(([value, label]) => element('button', {
           type: 'button', role: 'tab', 'aria-selected': String(mode === value),
-          onClick: () => switchDocumentMode(value),
+          onClick: () => switchDocumentMode(workspace, value),
         }, label))),
         element('span', { class: 'editor-save-status', role: 'status' }, editor.saveState),
-        finalized ? actionButton('重新打开', () => reopenDocument(editor), 'small') : null,
-        !editor.isNew && !finalized ? actionButton('标记结束', () => openFinalizeDocument(editor), 'small') : null,
-        !editor.isNew && !finalized ? actionButton('删除', () => confirmDeleteDocument(editor), 'ghost small') : null,
-        !finalized ? actionButton(editor.isNew ? '创建文档' : '保存', () => { void saveDocumentEditor().then(saved => { if (saved) renderShell() }) }, 'primary small') : null,
+        finalized && !readOnly ? actionButton('重新打开', () => reopenDocument(workspace, editor), 'small') : null,
+        !readOnly && !editor.isNew && !finalized ? actionButton('标记结束', () => openFinalizeDocument(workspace, editor), 'small') : null,
+        !readOnly && !editor.isNew && !finalized ? actionButton('删除', () => confirmDeleteDocument(workspace, editor), 'ghost small') : null,
+        !readOnly && !finalized ? actionButton(editor.isNew ? '创建文档' : '保存', () => { void saveDocumentEditor(workspace).then(saved => { if (saved) renderShell() }) }, 'primary small') : null,
       ),
     ),
     element('div', { class: 'note-editor-scroll', 'data-scroll-key': 'note-editor' },
@@ -1163,20 +1322,20 @@ function renderNoteEditor(editor, base) {
       ),
     ),
     element('footer', { class: 'note-inspector' },
-      finalized ? element('span', { class: 'note-format-hint' }, '只读封存 · 重新打开后才能编辑') : element('label', {}, element('span', {}, '类型'), element('select', {
+      finalized || readOnly ? element('span', { class: 'note-format-hint' }, readOnly ? '知识库已归档 · 只读' : '只读封存 · 重新打开后才能编辑') : element('label', {}, element('span', {}, '类型'), element('select', {
         class: 'note-meta-select', onChange: event => update('type', event.target.value),
       }, TYPES.map(type => element('option', { value: type, selected: type === editor.type }, TYPE_LABELS[type])))),
-      finalized ? null : element('label', { class: 'note-tags-field' }, element('span', {}, '标签'), element('input', {
+      finalized || readOnly ? null : element('label', { class: 'note-tags-field' }, element('span', {}, '标签'), element('input', {
         value: editor.tagsText, placeholder: '用逗号分隔', onInput: event => update('tagsText', event.target.value),
       })),
-      !finalized ? element('span', { class: 'note-format-hint' }, mode === 'edit' ? 'Markdown · Ctrl/⌘ S 保存' : 'Markdown 预览') : null,
+      !finalized && !readOnly ? element('span', { class: 'note-format-hint' }, mode === 'edit' ? 'Markdown · Ctrl/⌘ S 保存' : 'Markdown 预览') : null,
     ),
   )
 }
 
-function switchDocumentMode(mode) {
+function switchDocumentMode(workspace, mode) {
   if (mode !== 'edit' && mode !== 'preview') return
-  state.documentView.mode = mode
+  workspace.view.mode = mode
   renderShell()
   if (mode === 'edit') window.requestAnimationFrame(() => document.querySelector('.note-body-editor')?.focus())
 }
@@ -1193,7 +1352,7 @@ function resizeDocumentEditor(editor) {
   editor.style.height = `${Math.max(420, editor.scrollHeight)}px`
 }
 
-function openFinalizeDocument(editor) {
+function openFinalizeDocument(workspace, editor) {
   const form = element('form', { class: 'form-grid' })
   const stateField = selectField('结束状态', [
     { value: 'resolved', label: '已解决 — 问题已有最终结论' },
@@ -1216,9 +1375,9 @@ function openFinalizeDocument(editor) {
         method: 'POST',
         body: { state: stateField.input.value, note: note.input.value.trim() },
       })
-      state.documentView.editor = { ...saved, tagsText: saved.tags.join(', '), dirty: false, isNew: false, saveState: '已封存' }
-      state.documentView.mode = 'preview'
-      state.documents = await api('documents')
+      workspace.view.editor = { ...saved, tagsText: saved.tags.join(', '), dirty: false, isNew: false, saveState: '已封存' }
+      workspace.view.mode = 'preview'
+      await reloadDocumentWorkspace(workspace)
       renderShell()
       showToast(stateField.input.value === 'resolved' ? '文档已标记为已解决并封存。' : '文档已标记为收集完成并封存。')
       return true
@@ -1226,32 +1385,34 @@ function openFinalizeDocument(editor) {
   })
 }
 
-function reopenDocument(editor) {
+function reopenDocument(workspace, editor) {
   openConfirm({
     title: `重新打开“${editor.title}”？`,
     message: '重新打开后，人工编辑、AI 回写和候选审核将恢复。',
     confirmLabel: '确认重新打开',
     onConfirm: async () => {
       const saved = await api(`documents/${encodeURIComponent(editor.id)}/reopen`, { method: 'POST' })
-      state.documentView.editor = { ...saved, tagsText: saved.tags.join(', '), dirty: false, isNew: false, saveState: '已重新打开' }
-      state.documents = await api('documents')
+      workspace.view.editor = { ...saved, tagsText: saved.tags.join(', '), dirty: false, isNew: false, saveState: '已重新打开' }
+      await reloadDocumentWorkspace(workspace)
       renderShell()
       showToast('文档已重新打开。')
     },
   })
 }
 
-function confirmDeleteDocument(editor) {
+function confirmDeleteDocument(workspace, editor) {
   openConfirm({
     title: `删除“${editor.title}”？`,
     message: '文档和对应的召回知识会被永久删除，此操作无法撤销。',
     confirmLabel: '永久删除', danger: true,
     onConfirm: async () => {
       await api(`entries/${encodeURIComponent(editor.id)}`, { method: 'DELETE' })
-      state.documentView.documentId = ''
-      state.documentView.editor = null
+      workspace.view.documentId = ''
+      workspace.view.editor = null
       state.stats = null
-      await loadDocuments()
+      await reloadDocumentWorkspace(workspace)
+      selectDefaultDocument(workspace)
+      if (workspace.view.documentId) await loadDocumentEditor(workspace, workspace.view.documentId)
       renderShell()
       showToast('文档已删除。')
     },
@@ -1644,6 +1805,12 @@ function confirmDeleteKnowledgeBase(base) {
         state.documentView.knowledgeBaseId = ''
         state.documentView.documentId = ''
       }
+      if (state.libraryDetail.knowledgeBaseId === base.id) {
+        state.libraryDetail.knowledgeBaseId = ''
+        state.libraryDetail.documents = []
+        state.libraryDetail.view = createDocumentViewState()
+        state.knowledgeBaseView = 'libraries'
+      }
       if (state.entryFilters.knowledgeBaseId === base.id) state.entryFilters.knowledgeBaseId = ''
       showToast('知识库及其全部关联数据已永久删除。')
       await navigate('bases')
@@ -1654,8 +1821,9 @@ function confirmDeleteKnowledgeBase(base) {
 }
 
 function openEntryEditor(entry, candidate) {
+  const activeWorkspace = activeDocumentWorkspace()
   const source = candidate?.draft || entry || {
-    knowledgeBaseId: state.documentView.knowledgeBaseId || undefined,
+    knowledgeBaseId: activeWorkspace?.view.knowledgeBaseId || undefined,
     title: '', body: '', type: 'fact', tags: [], scope: { kind: 'global' }, confidence: .8,
   }
   const form = element('form', { class: 'form-grid' })
@@ -1942,5 +2110,4 @@ function friendlyError(error) {
   return error.message || '操作失败，请稍后重试。'
 }
 
-installHostThemeBridge()
-void boot()
+void installHostThemeBridge().then(() => boot())