@lemoncat7/dsh-knowledge 1.1.5 → 1.2.0

package/web/app.js

@@ -82,6 +82,10 @@ const state = {
 }
 
 let scrollRestoreFrame = 0
+let navigationController = null
+let navigationRequest = 0
+let navigationSave = Promise.resolve(true)
+let libraryDetailRequest = 0
 
 function installHostThemeBridge() {
   if (window.parent === window) return Promise.resolve()
@@ -242,9 +246,12 @@ function badge(label, variant = '') {
 }
 
 function showToast(message, kind = '') {
-  const toast = element('div', { class: `toast ${kind}`.trim(), role: kind === 'error' ? 'alert' : 'status' }, message)
+  const toast = element('div', { class: `toast ${kind}`.trim(), role: kind === 'error' ? 'alert' : 'status' },
+    element('span', {}, message),
+    kind === 'error' ? actionButton('关闭', () => toast.remove(), 'ghost small toast-close', { 'aria-label': '关闭错误提示' }) : null,
+  )
   toastRegion.append(toast)
-  window.setTimeout(() => toast.remove(), 4200)
+  if (kind !== 'error') window.setTimeout(() => toast.remove(), 4200)
 }
 
 async function api(path, options = {}) {
@@ -342,6 +349,12 @@ function signOut() {
 }
 
 async function navigate(view) {
+  const request = ++navigationRequest
+  navigationSave = navigationSave.then(() => saveBeforeLeavingDocument(), () => saveBeforeLeavingDocument())
+  if (!await navigationSave || request !== navigationRequest) return
+  navigationController?.abort()
+  const controller = new AbortController()
+  navigationController = controller
   const previousView = state.view
   if (view === 'bases' && previousView !== 'bases' && state.knowledgeBaseView === 'detail') {
     state.knowledgeBaseView = 'libraries'
@@ -352,35 +365,51 @@ async function navigate(view) {
   state.error = ''
   renderShell()
   try {
-    if (view === 'overview') await loadOverview()
-    if (view === 'bases') await loadKnowledgeBasesPage()
-    if (view === 'entries') await loadDocuments()
-    if (view === 'candidates') await loadCandidates()
-    if (view === 'tokens') await loadTokens()
+    if (view === 'overview') await loadOverview(controller.signal)
+    if (view === 'bases') await loadKnowledgeBasesPage(controller.signal)
+    if (view === 'entries') await loadDocuments(controller.signal)
+    if (view === 'candidates') await loadCandidates(controller.signal)
+    if (view === 'tokens') await loadTokens(controller.signal)
   } catch (error) {
+    if (controller.signal.aborted) return
     if (error.status === 401 && AUTH_MODE === 'bearer') return signOut()
     state.error = friendlyError(error)
   } finally {
+    if (navigationController !== controller) return
     state.loading = false
     renderShell()
   }
 }
 
-async function refreshStats() {
-  state.stats = await api('stats')
+async function saveBeforeLeavingDocument() {
+  const workspace = activeDocumentWorkspace()
+  const editor = workspace?.view.editor
+  if (!workspace || !editor?.dirty) return true
+  const emptyDraft = editor.isNew && !editor.title.trim() && !editor.body.trim()
+  if (emptyDraft) {
+    workspace.view.editor = null
+    workspace.view.documentId = ''
+    return true
+  }
+  return saveDocumentEditor(workspace)
 }
 
-async function ensureKnowledgeBases(force = false) {
-  if (force || state.knowledgeBases.length === 0) state.knowledgeBases = await api('knowledge-bases')
+async function refreshStats(signal) {
+  state.stats = await api('stats', { signal })
+}
+
+async function ensureKnowledgeBases(force = false, signal) {
+  if (force || state.knowledgeBases.length === 0) state.knowledgeBases = await api('knowledge-bases', { signal })
   return state.knowledgeBases
 }
 
-async function loadKnowledgeBasesPage() {
-  const requests = [api('knowledge-bases'), api('mounts'), api('settings'), api('service')]
+async function loadKnowledgeBasesPage(signal) {
+  const options = { signal }
+  const requests = [api('knowledge-bases', options), api('mounts', options), api('settings', options), api('service', options)]
   if (state.mountContext.sessionId) {
     const params = new URLSearchParams({ sessionId: state.mountContext.sessionId })
     if (state.mountContext.projectId) params.set('projectId', state.mountContext.projectId)
-    requests.push(api(`mounts/resolve?${params}`))
+    requests.push(api(`mounts/resolve?${params}`, options))
   }
   const [bases, mounts, settings, service, resolved = []] = await Promise.all(requests)
   state.knowledgeBases = bases
@@ -388,15 +417,16 @@ async function loadKnowledgeBasesPage() {
   state.settings = settings
   state.service = service
   state.resolvedMounts = resolved
-  await refreshStats()
+  await refreshStats(signal)
 }
 
-async function loadOverview() {
+async function loadOverview(signal) {
+  const options = { signal }
   const [stats, recent, pending, bases] = await Promise.all([
-    api('stats'),
-    api('entries?status=active&limit=6'),
-    api('candidates?status=pending&limit=5'),
-    api('knowledge-bases'),
+    api('stats', options),
+    api('entries?status=active&limit=6', options),
+    api('candidates?status=pending&limit=5', options),
+    api('knowledge-bases', options),
   ])
   state.stats = stats
   state.knowledgeBases = bases
@@ -427,12 +457,13 @@ async function loadEntries(cursor = '') {
   if (!state.stats) await refreshStats()
 }
 
-async function loadDocuments() {
-  const requests = [api('knowledge-bases'), api('documents')]
+async function loadDocuments(signal) {
+  const options = { signal }
+  const requests = [api('knowledge-bases', options), api('documents', options)]
   if (state.mountContext.sessionId) {
     const params = new URLSearchParams({ sessionId: state.mountContext.sessionId })
     if (state.mountContext.projectId) params.set('projectId', state.mountContext.projectId)
-    requests.push(api(`mounts/resolve?${params}`))
+    requests.push(api(`mounts/resolve?${params}`, options))
   }
   const [bases, documents, resolved = []] = await Promise.all(requests)
   state.knowledgeBases = bases
@@ -448,9 +479,9 @@ async function loadDocuments() {
       : documentKnowledgeBases(bases)[0]?.id || ''
   }
   selectDefaultDocument(workspace)
-  if (view.documentId) await loadDocumentEditor(workspace, view.documentId)
+  if (view.documentId) await loadDocumentEditor(workspace, view.documentId, signal)
   else view.editor = null
-  if (!state.stats) await refreshStats()
+  if (!state.stats) await refreshStats(signal)
 }
 
 function documentKnowledgeBases(bases = state.knowledgeBases) {
@@ -496,14 +527,19 @@ function documentWorkspaceReadOnly(workspace) {
 }
 
 async function reloadDocumentWorkspace(workspace) {
+  const libraryBaseId = workspace.kind === 'library' ? state.libraryDetail.knowledgeBaseId : ''
   const documents = workspace.kind === 'library'
-    ? await api(`documents?knowledgeBaseId=${encodeURIComponent(state.libraryDetail.knowledgeBaseId)}`)
+    ? await api(`documents?knowledgeBaseId=${encodeURIComponent(libraryBaseId)}`)
     : await api('documents')
-  if (workspace.kind === 'library') setDocumentWorkspaceDocuments(workspace, documents)
+  if (workspace.kind === 'library') {
+    if (state.libraryDetail.knowledgeBaseId !== libraryBaseId) return false
+    setDocumentWorkspaceDocuments(workspace, documents)
+  }
   else {
     const visibleBaseIds = new Set(documentKnowledgeBases().map(base => base.id))
     setDocumentWorkspaceDocuments(workspace, documents.filter(document => visibleBaseIds.has(document.knowledgeBaseId)))
   }
+  return true
 }
 
 function selectDefaultDocument(workspace) {
@@ -515,8 +551,11 @@ function selectDefaultDocument(workspace) {
   if (view.knowledgeBaseId) view.expandedBases.add(view.knowledgeBaseId)
 }
 
-async function loadDocumentEditor(workspace, id) {
-  const entry = await api(`entries/${encodeURIComponent(id)}`)
+async function loadDocumentEditor(workspace, id, signal) {
+  const revision = (workspace.view.loadRevision || 0) + 1
+  workspace.view.loadRevision = revision
+  const entry = await api(`entries/${encodeURIComponent(id)}`, { signal })
+  if (workspace.view.loadRevision !== revision || workspace.view.documentId !== id) return false
   workspace.view.mode = 'preview'
   workspace.view.editor = {
     ...entry,
@@ -525,6 +564,7 @@ async function loadDocumentEditor(workspace, id) {
     isNew: false,
     saveState: '已保存',
   }
+  return true
 }
 
 function createBlankDocument(workspace, baseId) {
@@ -557,8 +597,7 @@ async function selectDocument(workspace, id) {
   if (editor?.dirty && !emptyDraft && !await saveDocumentEditor(workspace)) return
   workspace.view.documentId = id
   workspace.view.treeOpen = false
-  await loadDocumentEditor(workspace, id)
-  renderShell()
+  if (await loadDocumentEditor(workspace, id)) renderShell()
 }
 
 function editorDraft(editor) {
@@ -615,26 +654,29 @@ function updateEditorSaveState(label) {
   if (node) node.textContent = label
 }
 
-async function loadCandidates() {
+async function loadCandidates(signal) {
   const [candidates] = await Promise.all([
-    api(`candidates?status=${state.candidateStatus}&limit=100`),
-    ensureKnowledgeBases(),
+    api(`candidates?status=${state.candidateStatus}&limit=100`, { signal }),
+    ensureKnowledgeBases(false, signal),
   ])
   state.candidates = candidates
   const targetIds = [...new Set(candidates.map(candidate => candidate.targetId).filter(Boolean))]
   const targets = await Promise.all(targetIds.map(async id => {
-    try { return [id, await api(`entries/${encodeURIComponent(id)}`)] }
-    catch { return [id, null] }
+    try { return [id, await api(`entries/${encodeURIComponent(id)}`, { signal })] }
+    catch (error) {
+      if (signal?.aborted) throw error
+      return [id, null]
+    }
   }))
   state.candidateTargets = new Map(targets)
-  if (!state.stats) await refreshStats()
+  if (!state.stats) await refreshStats(signal)
 }
 
-async function loadTokens() {
-  const [tokens, service] = await Promise.all([api('tokens'), api('service')])
+async function loadTokens(signal) {
+  const [tokens, service] = await Promise.all([api('tokens', { signal }), api('service', { signal })])
   state.tokens = tokens
   state.service = service
-  if (!state.stats) await refreshStats()
+  if (!state.stats) await refreshStats(signal)
 }
 
 function renderShell() {
@@ -660,7 +702,10 @@ function renderShell() {
     element('main', { class: 'main' },
       element('header', { class: 'topbar' },
         element('div', { class: 'topbar-title' },
-          actionButton('☰', () => { state.menuOpen = !state.menuOpen; renderShell() }, 'ghost mobile-menu', { 'aria-label': '打开导航菜单' }),
+          actionButton('☰', () => { state.menuOpen = !state.menuOpen; renderShell() }, 'ghost mobile-menu', {
+            'aria-label': state.menuOpen ? '关闭导航菜单' : '打开导航菜单',
+            'aria-expanded': String(state.menuOpen),
+          }),
           paneToggleButton('main', !state.documentView.sidebarHidden, () => setSidebarHidden(!state.documentView.sidebarHidden), '主导航栏'),
           activeDocumentWorkspace() ? paneToggleButton('library', activeDocumentWorkspace().view.treeOpen, () => {
             const workspace = activeDocumentWorkspace()
@@ -901,6 +946,7 @@ function renderKnowledgeBases() {
 
 async function openKnowledgeBaseDocuments(base) {
   captureScrollPosition()
+  const request = ++libraryDetailRequest
   const detail = state.libraryDetail
   const changingBase = detail.knowledgeBaseId !== base.id
   detail.knowledgeBaseId = base.id
@@ -916,13 +962,15 @@ async function openKnowledgeBaseDocuments(base) {
   renderShell()
   const workspace = libraryDocumentWorkspace()
   try {
-    await reloadDocumentWorkspace(workspace)
+    if (!await reloadDocumentWorkspace(workspace) || request !== libraryDetailRequest) return
     selectDefaultDocument(workspace)
     if (workspace.view.documentId) await loadDocumentEditor(workspace, workspace.view.documentId)
     else workspace.view.editor = null
   } catch (error) {
+    if (request !== libraryDetailRequest) return
     detail.error = friendlyError(error)
   } finally {
+    if (request !== libraryDetailRequest) return
     state.loading = false
     renderShell()
     window.requestAnimationFrame(() => document.querySelector('.library-detail-back')?.focus())
@@ -934,6 +982,7 @@ async function closeKnowledgeBaseDetail() {
   const editor = workspace.view.editor
   const emptyDraft = editor?.isNew && !editor.title.trim() && !editor.body.trim()
   if (editor?.dirty && !emptyDraft && !await saveDocumentEditor(workspace)) return
+  libraryDetailRequest += 1
   const baseId = state.libraryDetail.knowledgeBaseId
   state.knowledgeBaseView = 'libraries'
   state.libraryDetail.error = ''
@@ -998,6 +1047,16 @@ function contextPill(label, value) {
   return element('div', { class: 'context-pill' }, element('strong', {}, label), element('span', { title: value }, value))
 }
 
+function writebackRouteLabel(base) {
+  if (state.service.writebackProvider && state.service.writebackModel) {
+    return `本机覆盖 · ${state.service.writebackProvider} / ${state.service.writebackModel}`
+  }
+  if (base?.writebackProvider && base?.writebackModel) {
+    return `知识库专用 · ${base.writebackProvider} / ${base.writebackModel}`
+  }
+  return '跟随当前会话模型'
+}
+
 function renderKnowledgeBaseCard(base) {
   const archived = base.status === 'archived'
   const visibleTags = base.defaultTags.slice(0, 4)
@@ -1017,7 +1076,7 @@ function renderKnowledgeBaseCard(base) {
     hiddenTagCount ? element('span', { class: 'tag' }, `+${hiddenTagCount}`) : null),
     element('div', { class: 'base-card-meta' },
       element('span', {}, element('strong', {}, '回写策略'), base.writebackPolicy === 'proactive' ? '主动' : '严谨'),
-      element('span', {}, element('strong', {}, '回写模型'), state.service.writebackProvider && state.service.writebackModel ? `本机 · ${state.service.writebackProvider} / ${state.service.writebackModel}` : '跟随当前会话'),
+      element('span', {}, element('strong', {}, '回写模型'), writebackRouteLabel(base)),
       base.extractionInstructions ? element('span', {}, element('strong', {}, '提取规则'), '已设置') : null,
     ),
     element('div', { class: 'base-card-actions' },
@@ -1133,9 +1192,7 @@ function renderMountListRow(base, view, targetKind, targetId) {
       renderShell()
     },
   })
-  const modelLabel = state.service.writebackProvider && state.service.writebackModel
-    ? `本机 · ${state.service.writebackProvider} / ${state.service.writebackModel}`
-    : '跟随当前会话模型'
+  const modelLabel = writebackRouteLabel(base)
   return element('article', { class: `mount-list-row${selected ? ' is-selected' : ''}`, role: 'listitem' },
     element('label', { class: 'mount-select' }, checkbox, element('span', { class: 'visually-hidden' }, `选择 ${base.name}`)),
     element('div', { class: 'mount-list-main' },
@@ -1444,12 +1501,9 @@ function renderCandidates() {
 
 function renderCandidateCard(candidate) {
   const pending = candidate.status === 'pending'
-  const conflictTarget = candidate.action === 'conflict' && candidate.targetId
-    ? state.candidateTargets.get(candidate.targetId)
-    : null
-  const targetDocument = candidate.action === 'create'
-    ? `新文档“${candidate.draft.title}”`
-    : `文档“${candidate.draft.title}”`
+  const target = candidate.targetId ? state.candidateTargets.get(candidate.targetId) : null
+  const targetAvailable = candidate.action === 'create' || Boolean(target)
+  const action = candidatePrimaryAction(candidate)
   return element('article', { class: 'candidate' },
     element('div', { class: 'candidate-header' },
       element('div', {},
@@ -1462,31 +1516,122 @@ function renderCandidateCard(candidate) {
       ),
       badge(STATUS_LABELS[candidate.status], candidate.status === 'approved' ? 'success' : candidate.status === 'rejected' ? 'danger' : 'warning'),
     ),
-    element('div', { class: `candidate-body${candidate.action === 'conflict' ? ' is-conflict' : ''}` },
-      candidate.action === 'conflict'
-        ? element('div', { class: 'candidate-comparison' },
-          element('section', {}, element('strong', {}, '当前知识'), element('pre', {}, conflictTarget?.body || '目标文档不可用，请刷新后重试。')),
-          element('section', {}, element('strong', {}, '候选内容'), element('pre', {}, candidate.draft.body)),
-        )
-        : element('p', { class: 'candidate-content' }, candidate.draft.body),
+    element('div', { class: 'candidate-body' },
+      renderCandidateDiff(candidate, target),
       element('div', { class: 'candidate-reason' },
-        element('strong', {}, '文档变更'),
-        element('span', { class: 'candidate-target' }, `${candidate.action === 'create' ? '创建' : '更新'}${targetDocument}`),
-        element('strong', {}, '模型判断依据'), candidate.reason || '未提供判断说明'),
+        element('section', {},
+          element('strong', {}, '写入位置'),
+          element('span', { class: 'candidate-target' }, candidate.action === 'create'
+            ? `创建“${candidate.draft.title}”`
+            : target ? `合并到“${target.title}”` : `目标 ${candidate.targetId || '不可用'}`),
+        ),
+        renderCandidateMetadataChanges(candidate, target),
+        element('section', {},
+          element('strong', {}, '模型判断依据'),
+          element('p', {}, candidate.reason || '未提供判断说明'),
+        ),
+        candidate.reviewNote ? element('section', {},
+          element('strong', {}, '审核备注'),
+          element('p', {}, candidate.reviewNote),
+        ) : null,
+      ),
     ),
     element('div', { class: 'candidate-footer' },
       element('small', {}, `${scopeLabel(candidate.draft.scope)} · 置信度 ${Math.round(candidate.draft.confidence * 100)}%${candidate.targetId ? ` · 目标 ${candidate.targetId}` : ''} · ${formatDate(candidate.createdAt)}`),
-      pending ? element('div', {},
+      pending ? element('div', { class: 'candidate-actions' },
         actionButton('拒绝', () => reviewCandidate(candidate, 'reject'), 'danger small'),
-        actionButton('编辑并通过', () => openEntryEditor(undefined, candidate), 'small'),
-        candidate.action === 'conflict'
-          ? actionButton('合并追加', () => reviewCandidate(candidate, 'approve', 'merge'), 'primary small')
-          : actionButton('通过', () => reviewCandidate(candidate, 'approve'), 'primary small'),
+        actionButton(action.editLabel, () => openEntryEditor(undefined, candidate), 'small', {
+          disabled: !targetAvailable,
+          title: targetAvailable ? action.editLabel : '目标文档不可用，无法安全编辑合并结果',
+        }),
+        actionButton(action.label, () => reviewCandidate(candidate, 'approve', action.resolution), 'primary small', {
+          disabled: !targetAvailable,
+          title: targetAvailable ? action.label : '目标文档不可用，刷新后再审核',
+        }),
       ) : null,
     ),
   )
 }
 
+function renderCandidateDiff(candidate, target) {
+  if (candidate.action !== 'create' && !target) {
+    return element('section', { class: 'candidate-change candidate-change-unavailable', role: 'alert' },
+      element('strong', {}, '无法生成变更预览'),
+      element('p', {}, '目标文档暂时不可用。为避免盲目覆盖，刷新并确认当前版本后再审核。'),
+    )
+  }
+  const review = window.DshKnowledgeReview.createReviewChange(candidate.action, target?.body || '', candidate.draft.body)
+  const title = candidate.action === 'create' ? '新文档内容' : candidate.action === 'conflict' ? '冲突合并预览' : '文档合并预览'
+  const targetLabel = candidate.action === 'create'
+    ? candidate.draft.title
+    : `${target.title} · 当前版本 ${target.version}`
+  return element('section', { class: `candidate-change is-${candidate.action}`, 'aria-label': title },
+    element('div', { class: 'candidate-change-heading' },
+      element('div', {}, element('strong', {}, title), element('small', {}, targetLabel)),
+      element('div', { class: 'diff-summary', 'aria-label': `新增 ${review.diff.additions} 行，删除 ${review.diff.deletions} 行，未变更 ${review.diff.unchanged} 行` },
+        element('span', { class: 'diff-stat additions' }, `+${review.diff.additions}`),
+        element('span', { class: 'diff-stat deletions' }, `-${review.diff.deletions}`),
+        element('span', { class: 'diff-stat unchanged' }, `${review.diff.unchanged} 未变`),
+      ),
+    ),
+    review.diff.simplified ? element('div', { class: 'diff-notice' }, '文档变更较大，已使用简化差异视图。合并内容不受影响。') : null,
+    element('div', { class: 'diff-viewer', role: 'table', 'aria-label': `${title}逐行差异` },
+      element('div', { class: 'diff-column-headings', role: 'row' },
+        element('span', { role: 'columnheader' }, '旧'),
+        element('span', { role: 'columnheader' }, '新'),
+        element('span', { 'aria-hidden': 'true' }),
+        element('span', { role: 'columnheader' }, '正文'),
+      ),
+      review.displayLines.length
+        ? review.displayLines.map(renderDiffLine)
+        : element('div', { class: 'diff-empty' }, '正文为空，没有可写入的差异。'),
+    ),
+  )
+}
+
+function renderDiffLine(line) {
+  if (line.kind === 'omitted') {
+    return element('div', { class: 'diff-line is-omitted', role: 'row', 'aria-label': `${line.count} 行未变更，已折叠` },
+      element('span', { class: 'diff-line-number', 'aria-hidden': 'true' }),
+      element('span', { class: 'diff-line-number', 'aria-hidden': 'true' }),
+      element('span', { class: 'diff-marker', 'aria-hidden': 'true' }, '…'),
+      element('span', { class: 'diff-omitted-copy' }, `${line.count} 行未变更`),
+    )
+  }
+  const marker = line.kind === 'add' ? '+' : line.kind === 'remove' ? '-' : ' '
+  const label = line.kind === 'add'
+    ? `新增第 ${line.newLine} 行`
+    : line.kind === 'remove' ? `删除原第 ${line.oldLine} 行` : `未变更行 ${line.oldLine}`
+  return element('div', { class: `diff-line is-${line.kind}`, role: 'row', 'aria-label': label },
+    element('span', { class: 'diff-line-number', role: 'cell' }, line.oldLine || ''),
+    element('span', { class: 'diff-line-number', role: 'cell' }, line.newLine || ''),
+    element('span', { class: 'diff-marker', role: 'cell', 'aria-hidden': 'true' }, marker),
+    element('code', { class: 'diff-code', role: 'cell' }, line.text || ' '),
+  )
+}
+
+function renderCandidateMetadataChanges(candidate, target) {
+  if (!target || candidate.action === 'create') return null
+  const changes = []
+  if (target.title !== candidate.draft.title) changes.push(`标题：${target.title} → ${candidate.draft.title}`)
+  const addedTags = candidate.draft.tags.filter(tag => !target.tags.includes(tag))
+  if (addedTags.length) changes.push(`新增标签：${addedTags.join('、')}`)
+  if (candidate.draft.confidence > target.confidence) {
+    changes.push(`置信度：${Math.round(target.confidence * 100)}% → ${Math.round(candidate.draft.confidence * 100)}%`)
+  }
+  if (!changes.length) return null
+  return element('section', { class: 'candidate-metadata' },
+    element('strong', {}, '属性变化'),
+    element('ul', {}, changes.map(change => element('li', {}, change))),
+  )
+}
+
+function candidatePrimaryAction(candidate) {
+  if (candidate.action === 'create') return { label: '写入新文档', editLabel: '编辑后写入' }
+  if (candidate.action === 'conflict') return { label: '确认合并', editLabel: '编辑合并内容', resolution: 'merge' }
+  return { label: '合并到文档', editLabel: '编辑后合并' }
+}
+
 function renderTokens() {
   const apiAddress = new URL(state.service.publicApiPrefix, location.origin).href.replace(/\/$/, '')
   return element('section', { 'aria-labelledby': 'tokens-heading' },
@@ -1569,7 +1714,8 @@ function parseTags(value) {
   return [...new Set(value.split(/[,，]/).map(tag => tag.trim().toLowerCase()).filter(Boolean))]
 }
 
-function openKnowledgeBaseEditor(base) {
+async function openKnowledgeBaseEditor(base) {
+  await loadModelCatalog()
   const source = base || { name: '', description: '', defaultTags: [], extractionInstructions: '', writebackPolicy: 'conservative' }
   const form = element('form', { class: 'form-grid' })
   const name = formField('名称', 'input', source.name, { required: true, maxlength: 100, placeholder: '例如：项目规范' })
@@ -1580,9 +1726,26 @@ function openKnowledgeBaseEditor(base) {
     { value: 'conservative', label: '严谨（高置信度直写）' },
     { value: 'proactive', label: '主动（更积极沉淀）' },
   ], source.writebackPolicy || 'conservative')
+  const dedicatedModel = element('input', {
+    type: 'checkbox',
+    checked: Boolean(source.writebackProvider && source.writebackModel),
+  })
+  const route = modelRouteFields(source.writebackProvider || '', source.writebackModel || '')
+  const routeToggle = element('label', { class: 'check-option span-2' }, dedicatedModel,
+    element('span', {},
+      element('strong', {}, '这个知识库使用专用回写模型'),
+      element('small', {}, '未设置时先使用本机覆盖；本机也未设置时跟随当前会话模型。'),
+    ))
+  const syncRouteAvailability = () => {
+    route.provider.input.disabled = route.model.input.disabled = !dedicatedModel.checked
+    route.provider.input.required = route.model.input.required = dedicatedModel.checked
+  }
+  dedicatedModel.addEventListener('change', syncRouteAvailability)
+  syncRouteAvailability()
   for (const field of [name, description, tags, instructions]) field.wrapper.classList.add('span-2')
   form.append(
     name.wrapper, description.wrapper, tags.wrapper, instructions.wrapper, policy.wrapper,
+    routeToggle, route.provider.wrapper, route.model.wrapper,
   )
   openSheet({
     title: base ? '编辑知识库' : '创建知识库',
@@ -1597,6 +1760,10 @@ function openKnowledgeBaseEditor(base) {
         defaultTags: parseTags(tags.input.value),
         extractionInstructions: instructions.input.value.trim(),
         writebackPolicy: policy.input.value,
+        ...(dedicatedModel.checked ? {
+          writebackProvider: route.provider.input.value,
+          writebackModel: route.model.input.value,
+        } : {}),
       }
       if (base) await api(`knowledge-bases/${encodeURIComponent(base.id)}`, { method: 'PUT', body: { draft } })
       else await api('knowledge-bases', { method: 'POST', body: { draft } })
@@ -1830,7 +1997,11 @@ function confirmDeleteKnowledgeBase(base) {
 
 function openEntryEditor(entry, candidate) {
   const activeWorkspace = activeDocumentWorkspace()
-  const source = candidate?.draft || entry || {
+  const candidateTarget = candidate?.targetId ? state.candidateTargets.get(candidate.targetId) : null
+  const candidateReview = candidate && (candidate.action === 'create' || candidateTarget)
+    ? window.DshKnowledgeReview.createReviewChange(candidate.action, candidateTarget?.body || '', candidate.draft.body)
+    : null
+  const source = candidate ? { ...candidate.draft, body: candidateReview?.after || candidate.draft.body } : entry || {
     knowledgeBaseId: activeWorkspace?.view.knowledgeBaseId || undefined,
     title: '', body: '', type: 'fact', tags: [], scope: { kind: 'global' }, confidence: .8,
   }
@@ -1863,8 +2034,16 @@ function openEntryEditor(entry, candidate) {
   )
   body.wrapper.classList.add('span-2')
   tags.wrapper.classList.add('span-2')
-  const modeTitle = candidate ? '编辑并通过候选' : entry ? '编辑知识文档' : '新建知识文档'
-  const modal = openSheet({ title: modeTitle, description: candidate ? '保存后，这条候选会立即通过并写入知识库。' : '文档保存后会立即参与后续召回。', body: form, primaryLabel: candidate ? '通过并保存' : '保存文档', onPrimary: async () => {
+  const modeTitle = candidate
+    ? candidate.action === 'create' ? '编辑新文档' : '编辑合并内容'
+    : entry ? '编辑知识文档' : '新建知识文档'
+  const candidateDescription = candidate?.action === 'create'
+    ? '确认后将创建文档并立即参与后续召回。'
+    : '正文已载入完整合并预览；保存前可以处理重复内容或冲突。'
+  const primaryLabel = candidate
+    ? candidate.action === 'create' ? '写入新文档' : '保存并合并'
+    : '保存文档'
+  const modal = openSheet({ title: modeTitle, description: candidate ? candidateDescription : '文档保存后会立即参与后续召回。', body: form, primaryLabel, onPrimary: async () => {
     if (!form.reportValidity()) return false
     const draft = {
       knowledgeBaseId: knowledgeBase.input.value,
@@ -1879,7 +2058,7 @@ function openEntryEditor(entry, candidate) {
     })
     else if (entry) await api(`entries/${encodeURIComponent(entry.id)}`, { method: 'PUT', body: { draft } })
     else await api('entries', { method: 'POST', body: { draft } })
-    showToast(candidate ? '候选已通过并写入知识库。' : '知识已保存。')
+    showToast(candidate ? candidate.action === 'create' ? '新文档已写入。' : '候选内容已合并。' : '知识已保存。')
     state.stats = null
     await navigate(candidate ? 'candidates' : state.view)
     return true
@@ -1902,7 +2081,9 @@ function selectField(label, options, value) {
 async function loadModelCatalog() {
   if (state.modelCatalog !== null) return state.modelCatalog
   try {
-    const response = await fetch('/knowledge-control/v1/models', { headers: { accept: 'application/json' } })
+    const response = await fetch('/knowledge-control/v1/models', {
+      headers: { accept: 'application/json', 'x-dsh-knowledge-client': 'management-web' },
+    })
     if (!response.ok) throw new Error(`HTTP ${response.status}`)
     const payload = await response.json()
     state.modelCatalog = Array.isArray(payload.providers) ? payload.providers : []
@@ -1936,10 +2117,19 @@ function modelRouteFields(currentProvider, currentModel) {
 
 async function reviewCandidate(candidate, decision, resolution) {
   const approve = decision === 'approve'
+  const action = candidatePrimaryAction(candidate)
+  const title = approve ? `${action.label}？` : '拒绝这条候选？'
+  const message = !approve
+    ? '拒绝后会保留审核记录，但不会进入知识库。'
+    : candidate.action === 'create'
+      ? '确认后将创建新文档，并立即参与后续对话召回。'
+      : candidate.action === 'conflict'
+        ? '确认后将保留当前文档内容，并把候选内容合入同一文档。'
+        : '确认后将按预览结果合入目标文档；若审核期间文档发生变化，会转为冲突项。'
   openConfirm({
-    title: approve ? '通过这条候选？' : '拒绝这条候选？',
-    message: approve ? '通过后内容会立即写入知识库，并参与后续对话召回。' : '拒绝后会保留审核记录，但不会进入知识库。',
-    confirmLabel: approve ? '确认通过' : '确认拒绝', danger: !approve,
+    title,
+    message,
+    confirmLabel: approve ? action.label : '确认拒绝', danger: !approve,
     onConfirm: async () => {
       const reviewed = await api(`candidates/${encodeURIComponent(candidate.id)}/review`, {
         method: 'POST', body: { decision, ...(resolution ? { resolution } : {}) },
@@ -1950,7 +2140,7 @@ async function reviewCandidate(candidate, decision, resolution) {
         await navigate('candidates')
         return
       }
-      showToast(approve ? '候选已通过。' : '候选已拒绝。')
+      showToast(approve ? candidate.action === 'create' ? '新文档已写入。' : '候选内容已合并。' : '候选已拒绝。')
       state.stats = null
       await navigate('candidates')
     },
@@ -2049,14 +2239,19 @@ function openModal({ title, description = '', body, primaryLabel, primaryVariant
   const backdrop = element('div', { class: `dialog-backdrop${isSheet ? ' sheet-backdrop' : ''}` })
   const dialog = element('section', { class: `dialog${isSheet ? ' sheet' : ''} ${primaryLabel ? '' : 'narrow'}`.trim(), role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': 'dialog-title' })
   let busy = false
-  const close = () => {
+  let formDirty = false
+  const close = (explicit = false) => {
     if (busy) return
+    if (!explicit && formDirty) {
+      showToast('表单有未保存的修改，请先保存，或使用“取消”放弃修改。', 'error')
+      return
+    }
     document.removeEventListener('keydown', onKeyDown)
     backdrop.remove()
     if (previouslyFocused instanceof HTMLElement) previouslyFocused.focus()
   }
-  const closeButton = actionButton('×', close, 'ghost', { 'aria-label': '关闭对话框' })
-  const cancel = actionButton(cancelLabel, close)
+  const closeButton = actionButton('×', () => close(), 'ghost', { 'aria-label': '关闭对话框' })
+  const cancel = actionButton(cancelLabel, () => close(true))
   const primary = primaryLabel ? actionButton(primaryLabel, async () => {
     if (busy) return
     busy = true
@@ -2067,7 +2262,7 @@ function openModal({ title, description = '', body, primaryLabel, primaryVariant
     try {
       const shouldClose = await onPrimary()
       busy = false
-      if (shouldClose !== false) close()
+      if (shouldClose !== false) close(true)
       else { primary.disabled = false; cancel.disabled = false; primary.textContent = original }
     } catch (error) {
       busy = false
@@ -2088,6 +2283,10 @@ function openModal({ title, description = '', body, primaryLabel, primaryVariant
   )
   backdrop.append(dialog)
   backdrop.addEventListener('mousedown', (event) => { if (event.target === backdrop) close() })
+  if (body.matches?.('form') || body.querySelector?.('form')) {
+    body.addEventListener('input', () => { formDirty = true })
+    body.addEventListener('change', () => { formDirty = true })
+  }
   document.body.append(backdrop)
   document.addEventListener('keydown', onKeyDown)
   window.setTimeout(() => (dialog.querySelector('input, textarea, select, button') || dialog).focus(), 0)
@@ -2118,4 +2317,11 @@ function friendlyError(error) {
   return error.message || '操作失败，请稍后重试。'
 }
 
+window.addEventListener('beforeunload', event => {
+  const editor = activeDocumentWorkspace()?.view.editor
+  if (!editor?.dirty) return
+  event.preventDefault()
+  event.returnValue = ''
+})
+
 void installHostThemeBridge().then(() => boot())