dsh-knowhub 0.8.8 → 0.9.0

package/README.md

@@ -2,6 +2,8 @@
 
 > DSH 的全局知识中心与项目长期记忆。把项目知识与长期记忆沉淀成可检索、可审核、可追溯、可备份的知识库，并在 DSH 会话中按工作区作用域自动注入或按需检索。
 
+版本变化见 [CHANGELOG](CHANGELOG.md)；0.9 规划草案见 [ROADMAP-0.9-draft](ROADMAP-0.9-draft.md)。
+
 ## 界面预览
 
 ![知枢知识中心：Repo Wiki 列表与阅读器](https://raw.githubusercontent.com/Mw-HbCK/dsh-knowhub/main/assets/knowhub-panel.png)

package/lib/client/index.js

@@ -88,7 +88,7 @@ const styles = {
         lineHeight: '20px', cursor: 'pointer',
     },
     danger: {
-        display: 'inline-flex', alignItems: 'center', height: '26px', padding: '0 10px', borderRadius: '13px',
+        display: 'inline-flex', alignItems: 'center', height: '26px', padding: '0 10px', borderRadius: '14px',
         border: '1px solid color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent)',
         background: 'transparent', color: 'var(--dsw-alias-state-error-primary)', fontSize: '12px', cursor: 'pointer',
     },
@@ -103,8 +103,15 @@ const styles = {
     },
     success: {
         margin: '0 0 14px', padding: '10px 12px', borderRadius: '10px',
-        background: 'var(--dsw-specific-sidebar-fill)', border: '1px solid var(--dsw-alias-border-l3)',
-        color: 'var(--dsw-alias-label-secondary)', fontSize: '12px', whiteSpace: 'pre-wrap', lineHeight: '19px',
+        background: 'color-mix(in srgb, var(--dsw-alias-state-success-primary) 10%, transparent)',
+        border: '1px solid color-mix(in srgb, var(--dsw-alias-state-success-primary) 35%, transparent)',
+        color: 'var(--dsw-alias-state-success-label)', fontSize: '12px', whiteSpace: 'pre-wrap', lineHeight: '19px',
+    },
+    warn: {
+        margin: '0 0 14px', padding: '10px 12px', borderRadius: '10px',
+        background: 'color-mix(in srgb, var(--dsw-alias-state-warn-primary) 10%, transparent)',
+        border: '1px solid color-mix(in srgb, var(--dsw-alias-state-warn-primary) 35%, transparent)',
+        color: 'var(--dsw-alias-state-warn-label)', fontSize: '12px', whiteSpace: 'pre-wrap', lineHeight: '19px',
     },
     body: { display: 'flex', flexDirection: 'column', minWidth: 0 },
     card: {
@@ -207,7 +214,7 @@ Object.assign(styles, {
         display: 'inline-flex', alignItems: 'center', gap: '6px', cursor: 'pointer',
     },
     countBadge: {
-        minWidth: '18px', height: '18px', padding: '0 5px', borderRadius: '9px',
+        minWidth: '18px', height: '18px', padding: '0 5px', borderRadius: '999px',
         background: 'color-mix(in srgb, var(--dsw-alias-state-warn-primary) 22%, transparent)',
         color: 'var(--dsw-alias-state-warn-label)', fontSize: '11px',
         display: 'inline-flex', alignItems: 'center', justifyContent: 'center',
@@ -285,16 +292,6 @@ Object.assign(styles, {
     },
     overlayScroll: { flex: 1, minHeight: 0, overflow: 'auto', padding: '18px clamp(16px,3vw,40px) 48px' },
     overlayInner: { maxWidth: '960px', margin: '0 auto' },
-    modalBackdrop: {
-        position: 'fixed', inset: 0, zIndex: 60, display: 'flex', alignItems: 'center', justifyContent: 'center',
-        padding: '24px', background: 'rgba(0,0,0,0.42)',
-    },
-    modalCard: {
-        width: 'min(640px, calc(100vw - 48px))', maxHeight: '84vh', overflow: 'hidden',
-        display: 'flex', flexDirection: 'column', minHeight: 0,
-        background: 'var(--dsw-alias-bg-layer-1)', border: '1px solid var(--dsw-alias-border-l2)',
-        borderRadius: '12px', boxShadow: '0 24px 60px rgba(0,0,0,0.35)',
-    },
 });
 Object.assign(styles, {
     mdBody: { fontSize: '14px', lineHeight: '24px', color: 'var(--dsw-alias-label-primary)', wordBreak: 'break-word' },
@@ -340,7 +337,7 @@ Object.assign(styles, {
     dialogFootHint: { flex: 1, minWidth: 0, fontSize: '11px', lineHeight: '16px', color: 'var(--dsw-alias-label-tertiary)' },
     dialogLabel: { display: 'block', marginBottom: '6px', fontSize: '12px', fontWeight: 500, color: 'var(--dsw-alias-label-secondary)' },
     dialogInput: {
-        width: '100%', boxSizing: 'border-box', height: '34px', padding: '0 10px', borderRadius: '8px',
+        width: '100%', boxSizing: 'border-box', height: '32px', padding: '0 10px', borderRadius: '8px',
         border: '1px solid var(--dsw-alias-border-l2)', background: 'var(--dsw-alias-bg-base)',
         color: 'var(--dsw-alias-label-primary)', fontSize: '13px', lineHeight: '20px', outline: 'none',
     },
@@ -634,7 +631,7 @@ function ConfirmHost() {
     const confirmStyle = pending.danger
         ? { ...styles.primary, border: '1px solid var(--dsw-alias-state-error-primary)', background: 'var(--dsw-alias-state-error-primary)' }
         : styles.primary;
-    return h(Modal, { onClose: () => settleConfirm(false), maxWidth: '440px' }, h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, pending.title ?? '确认操作'))), h('div', { style: styles.dialogBody }, h('div', { style: styles.confirmBody }, pending.text)), h('div', { style: styles.dialogFoot }, h('div', { style: styles.dialogFootHint }, 'Esc 取消 · Enter 确认'), h('div', { style: { display: 'flex', gap: '8px' } }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => settleConfirm(false) }, pending.cancelText ?? '取消'), h('button', { type: 'button', style: confirmStyle, className: pending.danger ? '' : 'kh-primary', onClick: () => settleConfirm(true) }, pending.confirmText ?? '确认')))));
+    return h(Modal, { onClose: () => settleConfirm(false), maxWidth: '440px' }, h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, pending.title ?? '确认操作'))), h('div', { style: styles.dialogBody, className: 'kh-scroll' }, h('div', { style: styles.confirmBody }, pending.text)), h('div', { style: styles.dialogFoot }, h('div', { style: styles.dialogFootHint }, 'Esc 取消 · Enter 确认'), h('div', { style: { display: 'flex', gap: '8px' } }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => settleConfirm(false) }, pending.cancelText ?? '取消'), h('button', { type: 'button', style: confirmStyle, className: pending.danger ? '' : 'kh-primary', onClick: () => settleConfirm(true) }, pending.confirmText ?? '确认')))));
 }
 // ---------- 知识库 ----------
 function CreateKbForm(props) {
@@ -708,7 +705,7 @@ function CreateKbForm(props) {
         key: item.value,
         style: { ...(strategy === item.value ? styles.choiceActive : styles.choice), flex: '1 1 100%' },
     }, h('input', { type: 'radio', name: 'kb-strategy', checked: strategy === item.value, onChange: () => setStrategy(item.value) }), h('div', { style: { minWidth: 0 } }, h('div', { style: styles.choiceTitle }, item.label), h('div', { style: styles.choiceDesc }, item.desc))));
-    return h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '创建知识库'), h('div', { style: styles.dialogSub }, '创建只保存配置并建立空知识库；不会立即扫描仓库，也不会自动调用模型。')), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: onCancel }, '✕')), h('div', { style: styles.dialogBody }, h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '名称', h('span', { style: styles.labelRequired }, '＊')), h('input', {
+    return h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '创建知识库'), h('div', { style: styles.dialogSub }, '创建只保存配置并建立空知识库；不会立即扫描仓库，也不会自动调用模型。')), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: onCancel }, '✕')), h('div', { style: styles.dialogBody, className: 'kh-scroll' }, h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '名称', h('span', { style: styles.labelRequired }, '＊')), h('input', {
         style: styles.dialogInput, value: name, maxLength: 80, placeholder: '例如：知枢 KnowHub 项目知识库',
         onChange: (event) => { setName(event.target.value); if (touched)
             setErrors(validate()); },
@@ -804,7 +801,7 @@ function EditKbForm(props) {
         key: item.value,
         style: { ...(strategy === item.value ? styles.choiceActive : styles.choice), flex: '1 1 100%' },
     }, h('input', { type: 'radio', name: 'edit-kb-strategy', checked: strategy === item.value, onChange: () => setStrategy(item.value) }), h('div', { style: { minWidth: 0 } }, h('div', { style: styles.choiceTitle }, item.label), h('div', { style: styles.choiceDesc }, item.desc))));
-    return h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '编辑知识库配置'), h('div', { style: styles.dialogSub }, '只改配置，不会重新扫描仓库，也不会改动已有知识与版本历史。')), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: onCancel }, '✕')), h('div', { style: styles.dialogBody }, h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '名称', h('span', { style: styles.labelRequired }, '＊')), h('input', {
+    return h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '编辑知识库配置'), h('div', { style: styles.dialogSub }, '只改配置，不会重新扫描仓库，也不会改动已有知识与版本历史。')), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: onCancel }, '✕')), h('div', { style: styles.dialogBody, className: 'kh-scroll' }, h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '名称', h('span', { style: styles.labelRequired }, '＊')), h('input', {
         style: styles.dialogInput, value: name, maxLength: 80, placeholder: '例如：知枢 KnowHub 项目知识库',
         onChange: (event) => setName(event.target.value),
     }), h('div', { style: styles.dialogCounter }, nameLength + ' / 50')), h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '生效范围（创建后不可修改）'), h('div', { style: styles.hint }, (kb.scope === 'user' ? '用户级：跨工作区共享' : '工作区级：仅当前项目可见') + (kb.workspacePath ? '；绑定工作区：' + kb.workspacePath : ''))), h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '知识处理模型', h('span', { style: styles.labelRequired }, '＊')), (models ?? []).length === 0
@@ -856,7 +853,7 @@ function AddDocForm(props) {
             setBusy(false);
         }
     };
-    return h('div', { style: { ...styles.card, background: 'var(--dsw-alias-bg-layer-1)' } }, h('div', { style: styles.cardTitle }, '新增知识（进入待审核草稿）'), h('div', { style: styles.field }, h('label', { style: styles.label }, '标题'), h('input', { style: styles.input, value: title, onChange: (e) => setTitle(e.target.value) })), h('div', { style: styles.row }, h('div', { style: { ...styles.field, flex: 1 } }, h('label', { style: styles.label }, '类型'), h('select', { style: styles.input, value: kind, onChange: (e) => setKind(e.target.value) }, KINDS.map((item) => h('option', { key: item.value, value: item.value }, item.label)))), h('div', { style: { ...styles.field, flex: 1 } }, h('label', { style: styles.label }, '验证状态'), h('select', { style: styles.input, value: verifyState, onChange: (e) => setVerifyState(e.target.value) }, Object.keys(VERIFY_LABEL).map((key) => h('option', { key, value: key }, VERIFY_LABEL[key])))), h('div', { style: { ...styles.field, flex: 2 } }, h('label', { style: styles.label }, '标签（逗号分隔）'), h('input', { style: styles.input, value: tags, onChange: (e) => setTags(e.target.value) }))), h('div', { style: styles.field }, h('label', { style: styles.label }, '正文（Markdown）'), h('textarea', { style: styles.textarea, value: body, onChange: (e) => setBody(e.target.value) })), error !== null ? h('div', { style: { ...styles.error, margin: '0 0 10px' } }, error) : null, h('div', { style: styles.row }, h('button', { type: 'button', style: busy ? { ...styles.primary, ...styles.buttonDisabled } : styles.primary, disabled: busy, onClick: () => void submit() }, busy ? '保存中…' : '保存草稿'), h('div', { style: { ...styles.hint, alignSelf: 'center' } }, '正文写入 Markdown 文件，元数据与索引写入 SQLite（FTS5 trigram）。')));
+    return h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '新增知识（进入待审核草稿）'), h('div', { style: styles.field }, h('label', { style: styles.label }, '标题'), h('input', { style: styles.input, value: title, onChange: (e) => setTitle(e.target.value) })), h('div', { style: styles.row }, h('div', { style: { ...styles.field, flex: 1 } }, h('label', { style: styles.label }, '类型'), h('select', { style: styles.input, value: kind, onChange: (e) => setKind(e.target.value) }, KINDS.map((item) => h('option', { key: item.value, value: item.value }, item.label)))), h('div', { style: { ...styles.field, flex: 1 } }, h('label', { style: styles.label }, '验证状态'), h('select', { style: styles.input, value: verifyState, onChange: (e) => setVerifyState(e.target.value) }, Object.keys(VERIFY_LABEL).map((key) => h('option', { key, value: key }, VERIFY_LABEL[key])))), h('div', { style: { ...styles.field, flex: 2 } }, h('label', { style: styles.label }, '标签（逗号分隔）'), h('input', { style: styles.input, value: tags, onChange: (e) => setTags(e.target.value) }))), h('div', { style: styles.field }, h('label', { style: styles.label }, '正文（Markdown）'), h('textarea', { style: styles.textarea, value: body, onChange: (e) => setBody(e.target.value) })), error !== null ? h('div', { style: { ...styles.error, margin: '0 0 10px' } }, error) : null, h('div', { style: styles.row }, h('button', { type: 'button', style: busy ? { ...styles.primary, ...styles.buttonDisabled } : styles.primary, disabled: busy, onClick: () => void submit() }, busy ? '保存中…' : '保存草稿'), h('div', { style: { ...styles.hint, alignSelf: 'center' } }, '正文写入 Markdown 文件，元数据与索引写入 SQLite（FTS5 trigram）。')));
 }
 /**
  * 导入 Markdown（知枢导出的 .md 文件或手写 Markdown）：
@@ -909,9 +906,9 @@ function ImportMarkdownForm(props) {
             setBusy(false);
         }
     };
-    const resultBlock = result === null ? null : h('div', { style: { ...styles.card, background: 'var(--dsw-alias-bg-layer-1)' } }, h('div', { style: styles.cardTitle }, '导入结果', h(Badge, { text: '新建 ' + (result.created ?? []).length, style: styles.badgeGreen }), h(Badge, { text: '跳过 ' + (result.skipped ?? []).length }), h(Badge, { text: '失败 ' + (result.failed ?? []).length, style: (result.failed ?? []).length > 0 ? styles.badgeAmber : undefined })), (result.created ?? []).length > 0 ? h('div', { style: styles.hint }, '新建草稿：' + (result.created ?? []).map((item) => item.title).join('、')) : null, (result.skipped ?? []).length > 0 ? h('div', { style: styles.hint }, '跳过：' + (result.skipped ?? []).map((item) => item.title + '（' + item.reason + '）').join('；')) : null, (result.failed ?? []).length > 0 ? h('div', { style: { ...styles.hint, color: 'var(--dsw-alias-state-error-primary)' } }, '失败：' + (result.failed ?? []).map((item) => item.title + '（' + item.message + '）').join('；')) : null, (result.warnings ?? []).length > 0 ? h('div', { style: styles.hint }, '提示：' + (result.warnings ?? []).join('；')) : null, result.parentLinked ? h('div', { style: styles.hint }, '已恢复 ' + result.parentLinked + ' 条父级关系') : null);
-    return h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '导入 Markdown'), h('div', { style: styles.dialogSub }, '导入到「' + String(kbName ?? '') + '」；所有条目先成为草稿，人工审核后才生效。')), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: onCancel }, '✕')), h('div', { style: styles.dialogBody }, h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '选择 .md 文件（可选）'), h('input', { type: 'file', accept: '.md,.markdown,text/markdown', style: { fontSize: '12px' }, onChange: pickFile })), h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, 'Markdown 内容', h('span', { style: styles.labelRequired }, '＊')), h('textarea', {
-        style: { ...styles.textarea, minHeight: '200px', fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace' },
+    const resultBlock = result === null ? null : h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '导入结果', h(Badge, { text: '新建 ' + (result.created ?? []).length, style: styles.badgeGreen }), h(Badge, { text: '跳过 ' + (result.skipped ?? []).length }), h(Badge, { text: '失败 ' + (result.failed ?? []).length, style: (result.failed ?? []).length > 0 ? styles.badgeAmber : undefined })), (result.created ?? []).length > 0 ? h('div', { style: styles.hint }, '新建草稿：' + (result.created ?? []).map((item) => item.title).join('、')) : null, (result.skipped ?? []).length > 0 ? h('div', { style: styles.hint }, '跳过：' + (result.skipped ?? []).map((item) => item.title + '（' + item.reason + '）').join('；')) : null, (result.failed ?? []).length > 0 ? h('div', { style: { ...styles.hint, color: 'var(--dsw-alias-state-error-primary)' } }, '失败：' + (result.failed ?? []).map((item) => item.title + '（' + item.message + '）').join('；')) : null, (result.warnings ?? []).length > 0 ? h('div', { style: styles.hint }, '提示：' + (result.warnings ?? []).join('；')) : null, result.parentLinked ? h('div', { style: styles.hint }, '已恢复 ' + result.parentLinked + ' 条父级关系') : null);
+    return h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '导入 Markdown'), h('div', { style: styles.dialogSub }, '导入到「' + String(kbName ?? '') + '」；所有条目先成为草稿，人工审核后才生效。')), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: onCancel }, '✕')), h('div', { style: styles.dialogBody, className: 'kh-scroll' }, h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, '选择 .md 文件（可选）'), h('input', { type: 'file', accept: '.md,.markdown,text/markdown', style: { fontSize: '12px' }, onChange: pickFile })), h('div', { style: styles.field }, h('label', { style: styles.dialogLabel }, 'Markdown 内容', h('span', { style: styles.labelRequired }, '＊')), h('textarea', {
+        style: { ...styles.textarea, minHeight: '200px', fontFamily: 'var(--ds-font-family-code, ui-monospace, SFMono-Regular, Menlo, monospace)' },
         placeholder: '粘贴知枢导出的 Markdown（含 <!-- knowhub:doc --> 块），或手写 Markdown；没有块时会作为一整篇知识导入。',
         value: content,
         onChange: (event) => setContent(event.target.value),
@@ -1182,12 +1179,12 @@ function KbView(props) {
         }
         return h('div', null, h('div', { style: styles.divider }), h('div', { style: styles.sectionTitle }, '项目初始化与 Repo Wiki'), h('div', { style: styles.hint }, '初始化会用该知识库绑定的模型（' + detail.knowledgeBase.modelProvider + ' / ' + detail.knowledgeBase.modelId + '，策略 ' + detail.knowledgeBase.modelStrategy + '）分析仓库，生成 Wiki 候选草稿；扫描不执行仓库内脚本，自动排除 node_modules、.git、构建产物与密钥文件。'), detail.knowledgeBase.scope === 'user' ? h('div', { style: styles.field, marginTop: '10px' }, h('label', { style: styles.label }, '选择要分析的工作区', h('span', { style: styles.labelRequired }, '*')), h('select', { style: styles.input, value: initWorkspaceId, onChange: (event) => setInitWorkspaceId(event.target.value) }, h('option', { value: '' }, '请选择工作区'), workspaces.map((workspace) => h('option', { key: workspace.id, value: workspace.id }, (workspace.title ?? workspace.path) + '（' + workspace.id + '）')))) : null, h('div', { style: { ...styles.row, marginTop: '10px' } }, h('button', { type: 'button', style: { ...styles.primary, ...(initBusy || activeTask !== null ? styles.buttonDisabled : {}) }, disabled: initBusy || activeTask !== null, onClick: () => void startInitialize() }, activeTask !== null ? '初始化进行中…' : initBusy ? '提交中…' : '开始初始化'), activeTask !== null ? h('button', { type: 'button', style: styles.danger, className: 'kh-danger', onClick: () => void cancelTask(activeTask.id) }, '取消任务') : null, latestTask !== null && latestTask.status === 'failed' ? h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: initBusy, onClick: () => void retryTask(latestTask.id) }, '重试失败任务') : null, h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => { if (detail)
                 void loadTaskData(detail.knowledgeBase.id); } }, '刷新任务状态')), taskError !== null ? h('div', { style: { ...styles.error, margin: '10px 0 0' } }, message(taskError)) : null, tasks.length === 0 ? h('div', { style: styles.hint }, '尚未运行初始化。点击「开始初始化」后，会先建立项目索引，再按选择的模型生成 Wiki 候选。')
-            : tasks.slice(0, 3).map((task) => h('div', { key: task.id, style: { ...styles.card, marginTop: '10px', background: 'var(--dsw-alias-bg-layer-1)' } }, h('div', { style: styles.cardTitle }, (TASK_KIND_LABEL[task.kind] ?? task.kind) + '任务 #' + task.id.slice(-8), h(Badge, { text: TASK_STATUS_LABEL[task.status] ?? task.status, style: task.status === 'failed' ? styles.badgeAmber : styles.badgeGreen }), h('span', { style: styles.hint }, '尝试 ' + (task.attempt ?? 1) + ' 次 · 创建于 ' + new Date(task.createdAt).toLocaleString('zh-CN'))), h('div', { style: styles.progressTrack }, h('div', { style: { ...styles.progressBar, width: String(Math.max(0, Math.min(100, Number(task.progress ?? 0)))) + '%', background: task.status === 'failed' ? 'var(--dsw-alias-state-error-primary)' : 'var(--dsw-alias-state-business-primary)' } })), h('div', { style: { ...styles.meta } }, h('span', null, '进度：' + Number(task.progress ?? 0) + '%'), h('span', null, '阶段：' + (task.stage ?? '—')), task.errorCode ? h('span', null, '错误码：' + task.errorCode) : null, task.errorDetail ? h('span', null, '错误：' + task.errorDetail) : null), task.status === 'failed'
+            : tasks.slice(0, 3).map((task) => h('div', { key: task.id, style: { ...styles.card, marginTop: '10px' } }, h('div', { style: styles.cardTitle }, (TASK_KIND_LABEL[task.kind] ?? task.kind) + '任务 #' + task.id.slice(-8), h(Badge, { text: TASK_STATUS_LABEL[task.status] ?? task.status, style: task.status === 'failed' ? styles.badgeAmber : styles.badgeGreen }), h('span', { style: styles.hint }, '尝试 ' + (task.attempt ?? 1) + ' 次 · 创建于 ' + new Date(task.createdAt).toLocaleString('zh-CN'))), h('div', { style: styles.progressTrack }, h('div', { style: { ...styles.progressBar, width: String(Math.max(0, Math.min(100, Number(task.progress ?? 0)))) + '%', background: task.status === 'failed' ? 'var(--dsw-alias-state-error-primary)' : 'var(--dsw-alias-state-business-primary)' } })), h('div', { style: { ...styles.meta } }, h('span', null, '进度：' + Number(task.progress ?? 0) + '%'), h('span', null, '阶段：' + (task.stage ?? '—')), task.errorCode ? h('span', null, '错误码：' + task.errorCode) : null, task.errorDetail ? h('span', null, '错误：' + task.errorDetail) : null), task.status === 'failed'
                 ? h('div', { style: { ...styles.hint, marginTop: '4px' } }, '提示：模型调用失败时，点右上角「编辑配置」→「测试模型」可直接确认该模型当前能否调通；若提示输出被截断，换一个非推理模型或把「模型使用策略」调高。')
                 : null, task.logs && task.logs.length > 0 ? h('pre', { style: styles.logs }, task.logs.slice(-12).map((item) => '[' + new Date(item.at).toLocaleTimeString('zh-CN') + '] ' + item.level + ' ' + item.message).join('\n')) : null)), h('div', { style: styles.sectionTitle }, '项目索引状态'), indexInfo === null ? h('div', { style: styles.hint }, '还没有索引数据（初始化完成后自动建立）')
             : h('div', { style: styles.meta }, h('span', null, '文件数：' + indexInfo.fileCount), h('span', null, '已哈希：' + (indexInfo.hashedCount ?? 0)), h('span', null, '最近索引：' + (indexInfo.lastIndexedAt ? new Date(indexInfo.lastIndexedAt).toLocaleString('zh-CN') : '—')), indexInfo.byLanguage && indexInfo.byLanguage.length > 0 ? h('span', null, '语言：' + indexInfo.byLanguage.slice(0, 6).map((item) => item.language + ' ' + item.count).join('、')) : null), h('div', { style: styles.sectionTitle }, '模型调用记录（证明实际使用的模型）'), calls.length === 0 ? h('div', { style: styles.hint }, '还没有模型调用记录')
             : h('div', null, calls.slice(0, 10).map((call) => h('div', { key: call.id, style: { ...styles.meta, borderTop: '1px dashed var(--dsw-alias-border-l1)', paddingTop: '6px', marginTop: '0' } }, h('span', null, (call.provider ?? '') + ' / ' + (call.model ?? '')), h('span', null, '用途：' + (call.purpose ?? '—')), h('span', null, 'tokens：' + (call.promptTokens ?? 0) + ' → ' + (call.completionTokens ?? 0)), h('span', null, '耗时：' + (call.latencyMs ?? 0) + 'ms'), call.failureCode ? h('span', { style: { color: 'var(--dsw-alias-state-error-primary)' } }, '失败码：' + call.failureCode) : null))), h('div', { style: styles.divider }), h('div', { style: styles.sectionTitle }, 'Git 变更与增量更新（M4）'), h('div', { style: styles.hint }, '变更检测优先使用只读 Git 命令，不是 Git 仓库或无法执行 git 时自动降级为文件内容哈希比对；只有受影响文档会重新分析，已批准的知识不会被自动覆盖，而是生成「修改候选」进入待审核。'), h('div', { style: styles.meta }, gitState && gitState.checkpoint ? h('span', null, '检查点模式：' + (gitState.checkpoint.mode === 'git' ? 'Git' : '哈希')) : h('span', null, '检查点：尚未运行增量更新'), gitState && gitState.checkpoint && gitState.checkpoint.head ? h('span', null, 'HEAD：' + String(gitState.checkpoint.head).slice(0, 10)) : null, gitState && gitState.git ? h('span', null, 'Git 状态：' + (gitState.git.available ? (gitState.git.isRepo ? '可用（分支 ' + (gitState.git.branch ?? '—') + '，未提交变更 ' + (gitState.git.dirtyCount ?? 0) + ' 项）' : '目录不是 Git 仓库') : '宿主无法执行 git')) : null, gitState && gitState.checkpoint && gitState.checkpoint.lastScanAt ? h('span', null, '最近检测：' + new Date(gitState.checkpoint.lastScanAt).toLocaleString('zh-CN')) : null, changes.length > 0 ? h('span', null, '最近变更：' + changes.length + ' 条') : null), h('div', { style: { ...styles.row, marginTop: '10px' } }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: incBusy || activeTask !== null, onClick: () => void incrementalRequest(true) }, incBusy ? '检测中…' : '检测变更（仅预览）'), h('button', { type: 'button', style: { ...styles.primary, ...(incBusy || activeTask !== null ? styles.buttonDisabled : {}) }, disabled: incBusy || activeTask !== null, onClick: () => void incrementalRequest(false) }, activeTask !== null ? '任务进行中…' : incBusy ? '提交中…' : '开始增量更新'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => { if (detail)
-                void loadTaskData(detail.knowledgeBase.id); } }, '刷新增量状态')), incError !== null ? h('div', { style: { ...styles.error, margin: '10px 0 0' } }, message(incError)) : null, incPlan !== null ? h('div', { style: { ...styles.card, marginTop: '10px', background: 'var(--dsw-alias-bg-layer-1)' } }, h('div', { style: styles.cardTitle }, '变更预览（未写入任何数据）'), h('div', { style: styles.meta }, h('span', null, '模式：' + (incPlan.mode === 'git' ? 'Git' : '哈希')), h('span', null, '基线：' + (incPlan.baseline ? '首次/重置（只建立检查点，不调用模型）' : '已有检查点')), h('span', null, '变更文件：' + incPlan.changeCount), h('span', null, '受影响文档：' + incPlan.affectedCount), h('span', null, '预计模型调用：' + incPlan.plannedModelCalls), incPlan.plan && incPlan.plan.length > 0 ? h('span', null, '计划：' + incPlan.plan.map((item) => item.title + '（' + (item.action === 'stale-proposal' ? '标记过时候选' : item.action === 'update-proposal' ? '修改候选' : '草稿直更') + '）').join('；')) : null), incPlan.structural && incPlan.structural.length > 0 ? h('div', { style: { ...styles.hint, color: 'var(--dsw-alias-state-warn-label)' } }, '结构性变更（需要人工重新检查）：' + incPlan.structural.join('、')) : null, incPlan.unmatchedPaths && incPlan.unmatchedPaths.length > 0 ? h('div', { style: styles.hint }, '未关联任何文档的变更：' + incPlan.unmatchedPaths.slice(0, 8).join('、')) : null, incPlan.changes && incPlan.changes.length > 0 ? h('pre', { style: styles.logs }, incPlan.changes.slice(0, 12).map((item) => (CHANGE_LABEL[item.change] ?? item.change) + '  ' + item.path).join('\n')) : null, incPlan.note ? h('div', { style: styles.hint }, incPlan.note) : null) : null, changes.length > 0 ? h('div', { style: { marginTop: '10px' } }, h('div', { style: styles.hint }, '已记录的变更（来自 file_changes 表）'), h('pre', { style: styles.logs }, changes.slice(0, 10).map((item) => (CHANGE_LABEL[item.change] ?? item.change) + '  ' + item.path + '  [' + item.mode + ']').join('\n'))) : null, recheck.length > 0 ? h('div', { style: { marginTop: '10px' } }, h('div', { style: { ...styles.hint, color: 'var(--dsw-alias-state-warn-label)' } }, '需要重新检查的文档（' + recheck.length + '）'), h('pre', { style: styles.logs }, recheck.slice(0, 10).map((item) => (item.title ?? item.docTitle ?? item.docId) + ' ← ' + item.reason).join('\n'))) : null, h('div', { style: styles.divider }), h('div', { style: styles.sectionTitle }, '知识条目（Markdown + SQLite 索引；草稿需审核后生效）'), h('div', { style: styles.hint }, '共 ' + docsTotal + ' 条，已显示 ' + docs.length + ' 条（每页 50 条）'), docs.length === 0 ? h('div', { style: styles.empty }, '该知识库还没有知识条目') : docs.map((doc) => h('div', { key: doc.id, style: { ...styles.card, marginBottom: '8px' } }, h('div', { style: styles.cardTitle }, doc.title, h(Badge, { text: KIND_LABEL[doc.kind] ?? doc.kind }), h(Badge, { text: DOC_STATUS_LABEL[doc.status] ?? doc.status, style: styles.badgeAmber }), h(Badge, { text: VERIFY_LABEL[doc.verifyState] ?? doc.verifyState })), h('div', { style: styles.snippet }, String(doc.body ?? '').slice(0, 180)), h('div', { style: styles.path }, doc.path))), docsTotal > docs.length
+                void loadTaskData(detail.knowledgeBase.id); } }, '刷新增量状态')), incError !== null ? h('div', { style: { ...styles.error, margin: '10px 0 0' } }, message(incError)) : null, incPlan !== null ? h('div', { style: { ...styles.card, marginTop: '10px' } }, h('div', { style: styles.cardTitle }, '变更预览（未写入任何数据）'), h('div', { style: styles.meta }, h('span', null, '模式：' + (incPlan.mode === 'git' ? 'Git' : '哈希')), h('span', null, '基线：' + (incPlan.baseline ? '首次/重置（只建立检查点，不调用模型）' : '已有检查点')), h('span', null, '变更文件：' + incPlan.changeCount), h('span', null, '受影响文档：' + incPlan.affectedCount), h('span', null, '预计模型调用：' + incPlan.plannedModelCalls), incPlan.plan && incPlan.plan.length > 0 ? h('span', null, '计划：' + incPlan.plan.map((item) => item.title + '（' + (item.action === 'stale-proposal' ? '标记过时候选' : item.action === 'update-proposal' ? '修改候选' : '草稿直更') + '）').join('；')) : null), incPlan.structural && incPlan.structural.length > 0 ? h('div', { style: { ...styles.hint, color: 'var(--dsw-alias-state-warn-label)' } }, '结构性变更（需要人工重新检查）：' + incPlan.structural.join('、')) : null, incPlan.unmatchedPaths && incPlan.unmatchedPaths.length > 0 ? h('div', { style: styles.hint }, '未关联任何文档的变更：' + incPlan.unmatchedPaths.slice(0, 8).join('、')) : null, incPlan.changes && incPlan.changes.length > 0 ? h('pre', { style: styles.logs }, incPlan.changes.slice(0, 12).map((item) => (CHANGE_LABEL[item.change] ?? item.change) + '  ' + item.path).join('\n')) : null, incPlan.note ? h('div', { style: styles.hint }, incPlan.note) : null) : null, changes.length > 0 ? h('div', { style: { marginTop: '10px' } }, h('div', { style: styles.hint }, '已记录的变更（来自 file_changes 表）'), h('pre', { style: styles.logs }, changes.slice(0, 10).map((item) => (CHANGE_LABEL[item.change] ?? item.change) + '  ' + item.path + '  [' + item.mode + ']').join('\n'))) : null, recheck.length > 0 ? h('div', { style: { marginTop: '10px' } }, h('div', { style: { ...styles.hint, color: 'var(--dsw-alias-state-warn-label)' } }, '需要重新检查的文档（' + recheck.length + '）'), h('pre', { style: styles.logs }, recheck.slice(0, 10).map((item) => (item.title ?? item.docTitle ?? item.docId) + ' ← ' + item.reason).join('\n'))) : null, h('div', { style: styles.divider }), h('div', { style: styles.sectionTitle }, '知识条目（Markdown + SQLite 索引；草稿需审核后生效）'), h('div', { style: styles.hint }, '共 ' + docsTotal + ' 条，已显示 ' + docs.length + ' 条（每页 50 条）'), docs.length === 0 ? h('div', { style: styles.empty }, '该知识库还没有知识条目') : docs.map((doc) => h('div', { key: doc.id, style: { ...styles.card, marginBottom: '8px' } }, h('div', { style: styles.cardTitle }, doc.title, h(Badge, { text: KIND_LABEL[doc.kind] ?? doc.kind }), h(Badge, { text: DOC_STATUS_LABEL[doc.status] ?? doc.status, style: styles.badgeAmber }), h(Badge, { text: VERIFY_LABEL[doc.verifyState] ?? doc.verifyState })), h('div', { style: styles.snippet }, String(doc.body ?? '').slice(0, 180)), h('div', { style: styles.path }, doc.path))), docsTotal > docs.length
             ? h('div', { style: { ...styles.row, marginBottom: '8px' } }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: docsLoading, onClick: () => void loadMoreDocs() }, docsLoading ? '加载中…' : '加载更多知识（还剩 ' + (docsTotal - docs.length) + ' 条）'))
             : null, h('div', { style: styles.divider }), showDocForm ? h(AddDocForm, { kbId: detail.knowledgeBase.id, onDone: async () => { setShowDocForm(false); await openDetail(detail.knowledgeBase.id); notify('知识草稿已保存'); await load(); } }) : null, h('div', { style: styles.row }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => setShowDocForm(!showDocForm) }, showDocForm ? '收起新增表单' : '+ 新增知识'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => setDetail(null) }, '返回列表'), h('button', { type: 'button', style: styles.danger, className: 'kh-danger', onClick: () => setPendingDelete({ id: detail.knowledgeBase.id, name: detail.knowledgeBase.name }) }, '删除知识库…')), pendingDelete !== null && pendingDelete.id === detail.knowledgeBase.id ? h('div', { style: { ...styles.card, borderColor: 'color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent)' } }, h('div', { style: styles.cardTitle }, '确认删除「' + pendingDelete.name + '」'), h('div', { style: styles.hint }, '删除配置：只隐藏记录并保留知识文件；删除全部：记录与知识文件一起删除。此操作不可自动撤销（文件删除后不可恢复）。'), h('div', { style: styles.row, marginTop: '10px' }, h('button', { type: 'button', style: styles.danger, className: 'kh-danger', disabled: deleting, onClick: () => void remove(pendingDelete.id, 'config') }, '删除配置（保留文件）'), h('button', { type: 'button', style: styles.danger, className: 'kh-danger', disabled: deleting, onClick: () => void remove(pendingDelete.id, 'all') }, '删除全部数据'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => setPendingDelete(null) }, '取消'))) : null);
     };
@@ -1335,22 +1332,22 @@ Object.assign(styles, {
     diffStat: { display: 'inline-flex', alignItems: 'center', height: '22px', padding: '0 8px', borderRadius: '6px', fontSize: '12px', border: '1px solid var(--dsw-alias-border-l2)', color: 'var(--dsw-alias-label-secondary)' },
     diffStatAdd: { color: 'var(--dsw-alias-state-success-primary)', borderColor: 'color-mix(in srgb, var(--dsw-alias-state-success-primary) 45%, transparent)' },
     diffStatDel: { color: 'var(--dsw-alias-state-error-primary)', borderColor: 'color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent)' },
-    diffPane: { marginTop: '10px', border: '1px solid var(--dsw-alias-border-l2)', borderRadius: '10px', background: 'var(--dsw-alias-bg-l1)', overflow: 'auto', maxHeight: '58vh', fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace', fontSize: '12px', lineHeight: '20px' },
+    diffPane: { marginTop: '10px', border: '1px solid var(--dsw-alias-border-l2)', borderRadius: '10px', background: 'var(--dsw-alias-bg-l1, var(--dsw-alias-bg-layer-1))', overflow: 'auto', maxHeight: '58vh', fontFamily: 'var(--ds-font-family-code, ui-monospace, SFMono-Regular, Menlo, monospace)', fontSize: '12px', lineHeight: '20px' },
     diffRow: { display: 'flex', width: '100%' },
     diffRowAdd: { background: 'color-mix(in srgb, var(--dsw-alias-state-success-primary) 16%, transparent)' },
     diffRowDel: { background: 'color-mix(in srgb, var(--dsw-alias-state-error-primary) 16%, transparent)' },
-    diffRowEmpty: { background: 'color-mix(in srgb, var(--dsw-alias-bg-l2) 55%, transparent)' },
+    diffRowEmpty: { background: 'color-mix(in srgb, var(--dsw-alias-bg-l2, var(--dsw-alias-bg-layer-1)) 55%, transparent)' },
     diffGutter: { flex: '0 0 44px', textAlign: 'right', padding: '0 6px', color: 'var(--dsw-alias-label-tertiary)', userSelect: 'none', whiteSpace: 'nowrap' },
     diffMarkerCell: { flex: '0 0 20px', textAlign: 'center', userSelect: 'none', color: 'var(--dsw-alias-label-secondary)' },
     diffText: { flex: '1 1 auto', minWidth: 0, padding: '0 10px 0 2px', whiteSpace: 'pre-wrap', overflowWrap: 'anywhere', color: 'var(--dsw-alias-label-primary)' },
     diffSplitCol: { flex: '1 1 50%', minWidth: 0 },
     diffSplitLeft: { flex: '1 1 50%', minWidth: 0, borderRight: '1px solid var(--dsw-alias-border-l2)' },
-    diffHead: { display: 'flex', position: 'sticky', top: 0, zIndex: 2, background: 'var(--dsw-alias-bg-l2)', borderBottom: '1px solid var(--dsw-alias-border-l2)', color: 'var(--dsw-alias-label-tertiary)', fontSize: '11px', lineHeight: '22px' },
+    diffHead: { display: 'flex', position: 'sticky', top: 0, zIndex: 2, background: 'var(--dsw-alias-bg-l2, var(--dsw-alias-bg-layer-1))', borderBottom: '1px solid var(--dsw-alias-border-l2)', color: 'var(--dsw-alias-label-tertiary)', fontSize: '11px', lineHeight: '22px' },
     diffHeadCell: { flex: '1 1 auto', padding: '0 10px 0 2px', whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis' },
     diffTextNoWrap: { flex: '1 1 auto', padding: '0 10px 0 2px', whiteSpace: 'pre', wordBreak: 'normal', color: 'var(--dsw-alias-label-primary)' },
-    diffWordAdd: { borderRadius: '3px', background: 'color-mix(in srgb, var(--dsw-alias-state-success-primary) 45%, transparent)' },
-    diffWordDel: { borderRadius: '3px', background: 'color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent)' },
-    diffFoldRow: { display: 'flex', alignItems: 'center', gap: '6px', width: '100%', padding: '2px 10px', border: '0', borderTop: '1px dashed var(--dsw-alias-border-l2)', borderBottom: '1px dashed var(--dsw-alias-border-l2)', background: 'color-mix(in srgb, var(--dsw-alias-bg-l2) 55%, transparent)', color: 'var(--dsw-alias-label-tertiary)', fontSize: '11px', lineHeight: '20px', cursor: 'pointer', textAlign: 'left' },
+    diffWordAdd: { borderRadius: '4px', background: 'color-mix(in srgb, var(--dsw-alias-state-success-primary) 45%, transparent)' },
+    diffWordDel: { borderRadius: '4px', background: 'color-mix(in srgb, var(--dsw-alias-state-error-primary) 45%, transparent)' },
+    diffFoldRow: { display: 'flex', alignItems: 'center', gap: '6px', width: '100%', padding: '2px 10px', border: '0', borderTop: '1px dashed var(--dsw-alias-border-l2)', borderBottom: '1px dashed var(--dsw-alias-border-l2)', background: 'color-mix(in srgb, var(--dsw-alias-bg-l2, var(--dsw-alias-bg-layer-1)) 55%, transparent)', color: 'var(--dsw-alias-label-tertiary)', fontSize: '11px', lineHeight: '20px', cursor: 'pointer', textAlign: 'left' },
     diffChangeBlockActive: { boxShadow: 'inset 2px 0 0 var(--dsw-alias-state-business-primary)' },
 });
 /** 折叠未变内容时上下各保留的上下文行数。 */
@@ -2767,7 +2764,7 @@ function SettingsView() {
     }
     const storage = snapshot.storage ?? {};
     const checkbox = (key, label, hintText) => settingsCheckbox(form, patch, key, label, hintText);
-    return h('div', null, error !== null ? ErrorBox({ text: error }) : null, h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '知识库默认设置'), h('div', { style: styles.field }, h('label', { style: styles.label }, '默认模型使用策略（新建知识库时的默认值）'), h('select', { style: styles.input, value: form.defaultStrategy ?? 'balanced', onChange: (event) => patch({ defaultStrategy: event.target.value }) }, STRATEGIES.map((item) => h('option', { key: item.value, value: item.value }, item.label + '（' + item.desc + '）')))), h('div', { style: styles.row }, h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '自动提炼最短字符数（80–4000）'), h('input', { type: 'number', style: styles.input, value: form.distillMinChars ?? 200, onChange: (event) => patch({ distillMinChars: event.target.value }) })), h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '备份保留份数（1–50）'), h('input', { type: 'number', style: styles.input, value: form.backupKeep ?? 10, onChange: (event) => patch({ backupKeep: event.target.value }) }))), checkbox('autoDistill', '开启自动提炼（默认关闭）', '会话 turn 结束时自动提炼长期知识，结果进入待审核队列，不会直接生效。'), checkbox('autoBackup', '恢复/迁移前自动备份（推荐开启）', '执行备份恢复或存储迁移前自动创建一份安全备份。'), h('div', { style: styles.row }, h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '审核人名称（1–40 字，默认系统用户名）'), h('input', { style: styles.input, value: form.reviewerName ?? '', maxLength: 40, onChange: (event) => patch({ reviewerName: event.target.value }) })), h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '自动批准最大差异行数（1–200）'), h('input', { type: 'number', style: styles.input, value: form.autoApproveMaxDiffLines ?? 10, onChange: (event) => patch({ autoApproveMaxDiffLines: event.target.value }) }))), checkbox('autoApprove', '开启自动批准（默认关闭，仅低风险 Wiki 更新）', '只对「已批准 Wiki 的更新候选」生效：基线版本未变、差异行数不超过阈值时自动落库，并写入审核日志标记 auto_approve；其他类型仍必须人工审核。'), h('div', { style: styles.field }, h('label', { style: styles.label }, '额外排除目录（每行一个或逗号分隔，仅目录名）'), h('textarea', { style: styles.textarea, value: form.excludeDirsText ?? '', onChange: (event) => patch({ excludeDirsText: event.target.value }), placeholder: '例如：vendor\nthird_party' }), h('div', { style: styles.hint }, '默认已排除 .git / node_modules / dist / build / 缓存 / 密钥文件等；这里用于补充项目自定义目录。')), h('button', { type: 'button', style: busy === 'save' ? { ...styles.primary, ...styles.buttonDisabled } : styles.primary, disabled: busy !== '', onClick: save }, busy === 'save' ? '保存中…' : '保存设置')), h(SettingsInjectionCard, { form, patch }), h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '存储位置'), h('pre', { style: styles.pre }, '当前数据目录：' + storage.storageRoot + '\n来源：' + (storage.source === 'config' ? '插件配置项' : storage.source === 'pointer' ? '本地位置指针文件' : '默认位置（DSH_HOME）') + (storage.pointerFile ? '\n指针文件：' + storage.pointerFile + (storage.pointerStorageRoot ? '（指向 ' + storage.pointerStorageRoot + '）' : '') : '')), h('div', { style: styles.field }, h('label', { style: styles.label }, '迁移到新目录（绝对路径）'), h('div', { style: styles.row }, h('input', { style: { ...styles.input, flex: '1 1 320px' }, value: target, placeholder: '例如 D:\\KnowHubData', onChange: (event) => setTarget(event.target.value) }), h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: busy !== '', onClick: () => migrate(true) }, busy === 'dry' ? '预检中…' : '预检'), h('button', { type: 'button', style: styles.primary, className: 'kh-primary', disabled: busy !== '', onClick: () => migrate(false) }, busy === 'migrate' ? '迁移中…' : '执行迁移')), h('div', { style: styles.hint }, '迁移会先自动备份、拷贝数据库与知识文件并校验计数，成功后写入位置指针；DSH 重启后生效，失败不会切换位置。'))), h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '备份与恢复', stats !== null ? h('span', { style: styles.badge }, '共 ' + stats.count + ' 份 / ' + formatBytes(stats.totalBytes)) : null), h('div', { style: styles.row, marginBottom: '8px' }, h('input', { style: { ...styles.input, flex: '1 1 260px' }, value: backupNote, placeholder: '备份备注（可选）', onChange: (event) => setBackupNote(event.target.value) }), h('button', { type: 'button', style: styles.primary, className: 'kh-primary', disabled: busy !== '', onClick: createBackup }, busy === 'backup' ? '备份中…' : '立即备份'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: loadBackups }, '刷新列表')), (backups ?? []).length === 0 ? EmptyState({ text: '还没有备份。建议在升级或大改前手动创建一份。' }) : (backups ?? []).map((item) => h('div', { key: item.id, style: { borderTop: '1px solid var(--dsw-alias-border-l1)', padding: '8px 0' } }, h('div', { style: styles.cardTitle }, item.file, item.exists === false ? h('span', { style: styles.badgeAmber }, '文件缺失') : h('span', { style: styles.badgeGreen }, '可恢复')), h('div', { style: styles.meta }, h('span', null, item.kbCount + ' 个库 / ' + item.docCount + ' 条知识'), h('span', null, formatBytes(item.bytes)), h('span', null, formatTime(item.createdAt)), item.note ? h('span', null, item.note) : null), h('div', { style: styles.row, marginTop: '6px' }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: busy !== '' || item.exists === false, onClick: () => openPreview(item) }, busy === 'preview:' + item.id ? '读取中…' : '预览内容'), h('button', { type: 'button', style: styles.button, disabled: busy !== '' || item.exists === false, onClick: () => restore(item) }, '从该备份恢复（合并）'))))), h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '自动提炼记录'), h('div', { style: styles.meta, marginBottom: '6px' }, h('span', null, '自动提炼：' + (form.autoDistill ? '已开启' : '未开启')), h('span', null, '最短字符数：' + form.distillMinChars)), runs.length === 0 ? EmptyState({ text: '还没有提炼记录。开启自动提炼后，会话结束时会自动生成待审核候选。' }) : h('pre', { style: styles.pre }, runs.map((run) => formatTime(run.createdAt) + '  ' + run.status + '  新建 ' + run.createdCount + ' / 跳过 ' + run.skippedCount + '  ' + (run.modelProvider ?? '') + '/' + (run.modelId ?? '') + (run.note ? '  ' + run.note : '')).join('\n'))), preview !== null ? h(Modal, { onClose: () => setPreview(null), maxWidth: '800px' }, h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '备份预览：' + preview.file), h('div', { style: styles.dialogSub }, '创建于 ' + formatTime(preview.createdAt) + ' · 格式 ' + preview.format + ' v' + preview.formatVersion + ' · schema v' + preview.schemaVersion + (preview.note ? ' · ' + preview.note : ''))), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: () => setPreview(null) }, '✕')), h('div', { style: styles.dialogBody }, h('div', { style: styles.meta, marginBottom: '8px' }, h('span', null, '知识库 ' + preview.kbCount + ' 个'), h('span', null, '知识 ' + preview.docCount + ' 条'), h('span', null, '版本 ' + preview.versionCount + ' 条'), h('span', null, formatBytes(preview.bytes))), (preview.kbs ?? []).length === 0 ? EmptyState({ text: '这个备份里没有知识库数据。' }) : (preview.kbs ?? []).map((kb) => h('div', { key: kb.id, style: { ...styles.card, background: 'var(--dsw-alias-bg-layer-1)', marginBottom: '8px' } }, h('div', { style: styles.cardTitle }, kb.name, h(Badge, { text: kb.scope === 'user' ? '用户级' : '工作区级' }), kb.exists ? h(Badge, { text: '当前已存在', style: styles.badgeGreen }) : h(Badge, { text: '当前不存在', style: styles.badgeAmber })), h('div', { style: styles.meta }, h('span', null, '知识 ' + kb.documentCount + ' 条'), h('span', null, '版本 ' + kb.versionCount + ' 条'), h('span', null, '当前库同名知识 ' + kb.overlapCount + ' 条'), (kb.statusBreakdown ?? []).map((item) => h('span', { key: 's-' + item.status }, (DOC_STATUS_LABEL[item.status] ?? item.status) + ' ' + item.count)), (kb.kindBreakdown ?? []).map((item) => h('span', { key: 'k-' + item.kind }, (KIND_LABEL[item.kind] ?? item.kind) + ' ' + item.count))), (kb.sampleTitles ?? []).length > 0 ? h('div', { style: styles.hint }, '包含：' + (kb.sampleTitles ?? []).join('、')) : null, (kb.overlapTitles ?? []).length > 0 ? h('div', { style: styles.hint }, '恢复时只生成待审核候选（不覆盖现有正文）：' + (kb.overlapTitles ?? []).slice(0, 10).join('、')) : null)), h('div', { style: styles.hint }, preview.note2 ?? '')), h('div', { style: styles.dialogFoot }, h('div', { style: styles.hint }, '预览只读，不会写入任何数据。'), h('div', { style: { flex: 1 } }), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => setPreview(null) }, '关闭'), preview.kbs && preview.kbs.length > 0 ? h('button', {
+    return h('div', null, error !== null ? ErrorBox({ text: error }) : null, h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '知识库默认设置'), h('div', { style: styles.field }, h('label', { style: styles.label }, '默认模型使用策略（新建知识库时的默认值）'), h('select', { style: styles.input, value: form.defaultStrategy ?? 'balanced', onChange: (event) => patch({ defaultStrategy: event.target.value }) }, STRATEGIES.map((item) => h('option', { key: item.value, value: item.value }, item.label + '（' + item.desc + '）')))), h('div', { style: styles.row }, h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '自动提炼最短字符数（80–4000）'), h('input', { type: 'number', style: styles.input, value: form.distillMinChars ?? 200, onChange: (event) => patch({ distillMinChars: event.target.value }) })), h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '备份保留份数（1–50）'), h('input', { type: 'number', style: styles.input, value: form.backupKeep ?? 10, onChange: (event) => patch({ backupKeep: event.target.value }) }))), checkbox('autoDistill', '开启自动提炼（默认关闭）', '会话 turn 结束时自动提炼长期知识，结果进入待审核队列，不会直接生效。'), checkbox('autoBackup', '恢复/迁移前自动备份（推荐开启）', '执行备份恢复或存储迁移前自动创建一份安全备份。'), h('div', { style: styles.row }, h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '审核人名称（1–40 字，默认系统用户名）'), h('input', { style: styles.input, value: form.reviewerName ?? '', maxLength: 40, onChange: (event) => patch({ reviewerName: event.target.value }) })), h('div', { style: { ...styles.field, flex: '1 1 160px' } }, h('label', { style: styles.label }, '自动批准最大差异行数（1–200）'), h('input', { type: 'number', style: styles.input, value: form.autoApproveMaxDiffLines ?? 10, onChange: (event) => patch({ autoApproveMaxDiffLines: event.target.value }) }))), checkbox('autoApprove', '开启自动批准（默认关闭，仅低风险 Wiki 更新）', '只对「已批准 Wiki 的更新候选」生效：基线版本未变、差异行数不超过阈值时自动落库，并写入审核日志标记 auto_approve；其他类型仍必须人工审核。'), h('div', { style: styles.field }, h('label', { style: styles.label }, '额外排除目录（每行一个或逗号分隔，仅目录名）'), h('textarea', { style: styles.textarea, value: form.excludeDirsText ?? '', onChange: (event) => patch({ excludeDirsText: event.target.value }), placeholder: '例如：vendor\nthird_party' }), h('div', { style: styles.hint }, '默认已排除 .git / node_modules / dist / build / 缓存 / 密钥文件等；这里用于补充项目自定义目录。')), h('button', { type: 'button', style: busy === 'save' ? { ...styles.primary, ...styles.buttonDisabled } : styles.primary, disabled: busy !== '', onClick: save }, busy === 'save' ? '保存中…' : '保存设置')), h(SettingsInjectionCard, { form, patch }), h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '存储位置'), h('pre', { style: styles.pre }, '当前数据目录：' + storage.storageRoot + '\n来源：' + (storage.source === 'config' ? '插件配置项' : storage.source === 'pointer' ? '本地位置指针文件' : '默认位置（DSH_HOME）') + (storage.pointerFile ? '\n指针文件：' + storage.pointerFile + (storage.pointerStorageRoot ? '（指向 ' + storage.pointerStorageRoot + '）' : '') : '')), h('div', { style: styles.field }, h('label', { style: styles.label }, '迁移到新目录（绝对路径）'), h('div', { style: styles.row }, h('input', { style: { ...styles.input, flex: '1 1 320px' }, value: target, placeholder: '例如 D:\\KnowHubData', onChange: (event) => setTarget(event.target.value) }), h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: busy !== '', onClick: () => migrate(true) }, busy === 'dry' ? '预检中…' : '预检'), h('button', { type: 'button', style: styles.primary, className: 'kh-primary', disabled: busy !== '', onClick: () => migrate(false) }, busy === 'migrate' ? '迁移中…' : '执行迁移')), h('div', { style: styles.hint }, '迁移会先自动备份、拷贝数据库与知识文件并校验计数，成功后写入位置指针；DSH 重启后生效，失败不会切换位置。'))), h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '备份与恢复', stats !== null ? h('span', { style: styles.badge }, '共 ' + stats.count + ' 份 / ' + formatBytes(stats.totalBytes)) : null), h('div', { style: styles.row, marginBottom: '8px' }, h('input', { style: { ...styles.input, flex: '1 1 260px' }, value: backupNote, placeholder: '备份备注（可选）', onChange: (event) => setBackupNote(event.target.value) }), h('button', { type: 'button', style: styles.primary, className: 'kh-primary', disabled: busy !== '', onClick: createBackup }, busy === 'backup' ? '备份中…' : '立即备份'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: loadBackups }, '刷新列表')), (backups ?? []).length === 0 ? EmptyState({ text: '还没有备份。建议在升级或大改前手动创建一份。' }) : (backups ?? []).map((item) => h('div', { key: item.id, style: { borderTop: '1px solid var(--dsw-alias-border-l1)', padding: '8px 0' } }, h('div', { style: styles.cardTitle }, item.file, item.exists === false ? h('span', { style: styles.badgeAmber }, '文件缺失') : h('span', { style: styles.badgeGreen }, '可恢复')), h('div', { style: styles.meta }, h('span', null, item.kbCount + ' 个库 / ' + item.docCount + ' 条知识'), h('span', null, formatBytes(item.bytes)), h('span', null, formatTime(item.createdAt)), item.note ? h('span', null, item.note) : null), h('div', { style: styles.row, marginTop: '6px' }, h('button', { type: 'button', style: styles.button, className: 'kh-hover', disabled: busy !== '' || item.exists === false, onClick: () => openPreview(item) }, busy === 'preview:' + item.id ? '读取中…' : '预览内容'), h('button', { type: 'button', style: styles.button, disabled: busy !== '' || item.exists === false, onClick: () => restore(item) }, '从该备份恢复（合并）'))))), h('div', { style: styles.card }, h('div', { style: styles.cardTitle }, '自动提炼记录'), h('div', { style: styles.meta, marginBottom: '6px' }, h('span', null, '自动提炼：' + (form.autoDistill ? '已开启' : '未开启')), h('span', null, '最短字符数：' + form.distillMinChars)), runs.length === 0 ? EmptyState({ text: '还没有提炼记录。开启自动提炼后，会话结束时会自动生成待审核候选。' }) : h('pre', { style: styles.pre }, runs.map((run) => formatTime(run.createdAt) + '  ' + run.status + '  新建 ' + run.createdCount + ' / 跳过 ' + run.skippedCount + '  ' + (run.modelProvider ?? '') + '/' + (run.modelId ?? '') + (run.note ? '  ' + run.note : '')).join('\n'))), preview !== null ? h(Modal, { onClose: () => setPreview(null), maxWidth: '800px' }, h('div', { style: styles.dialog }, h('div', { style: styles.dialogHead }, h('div', { style: { minWidth: 0 } }, h('div', { style: styles.dialogTitle }, '备份预览：' + preview.file), h('div', { style: styles.dialogSub }, '创建于 ' + formatTime(preview.createdAt) + ' · 格式 ' + preview.format + ' v' + preview.formatVersion + ' · schema v' + preview.schemaVersion + (preview.note ? ' · ' + preview.note : ''))), h('button', { type: 'button', style: styles.dialogClose, className: 'kh-hover', title: '关闭', onClick: () => setPreview(null) }, '✕')), h('div', { style: styles.dialogBody, className: 'kh-scroll' }, h('div', { style: styles.meta, marginBottom: '8px' }, h('span', null, '知识库 ' + preview.kbCount + ' 个'), h('span', null, '知识 ' + preview.docCount + ' 条'), h('span', null, '版本 ' + preview.versionCount + ' 条'), h('span', null, formatBytes(preview.bytes))), (preview.kbs ?? []).length === 0 ? EmptyState({ text: '这个备份里没有知识库数据。' }) : (preview.kbs ?? []).map((kb) => h('div', { key: kb.id, style: { ...styles.card, marginBottom: '8px' } }, h('div', { style: styles.cardTitle }, kb.name, h(Badge, { text: kb.scope === 'user' ? '用户级' : '工作区级' }), kb.exists ? h(Badge, { text: '当前已存在', style: styles.badgeGreen }) : h(Badge, { text: '当前不存在', style: styles.badgeAmber })), h('div', { style: styles.meta }, h('span', null, '知识 ' + kb.documentCount + ' 条'), h('span', null, '版本 ' + kb.versionCount + ' 条'), h('span', null, '当前库同名知识 ' + kb.overlapCount + ' 条'), (kb.statusBreakdown ?? []).map((item) => h('span', { key: 's-' + item.status }, (DOC_STATUS_LABEL[item.status] ?? item.status) + ' ' + item.count)), (kb.kindBreakdown ?? []).map((item) => h('span', { key: 'k-' + item.kind }, (KIND_LABEL[item.kind] ?? item.kind) + ' ' + item.count))), (kb.sampleTitles ?? []).length > 0 ? h('div', { style: styles.hint }, '包含：' + (kb.sampleTitles ?? []).join('、')) : null, (kb.overlapTitles ?? []).length > 0 ? h('div', { style: styles.hint }, '恢复时只生成待审核候选（不覆盖现有正文）：' + (kb.overlapTitles ?? []).slice(0, 10).join('、')) : null)), h('div', { style: styles.hint }, preview.note2 ?? '')), h('div', { style: styles.dialogFoot }, h('div', { style: styles.hint }, '预览只读，不会写入任何数据。'), h('div', { style: { flex: 1 } }), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => setPreview(null) }, '关闭'), preview.kbs && preview.kbs.length > 0 ? h('button', {
         type: 'button', style: styles.button, className: 'kh-hover',
         onClick: () => { const item = (backups ?? []).find((entry) => entry.id === preview.backupId); setPreview(null); if (item)
             restore(item); },
@@ -2800,6 +2797,8 @@ function Page() {
     const [booting, setBooting] = R.useState(false);
     const [reloadKey, setReloadKey] = R.useState(0);
     const [reviewCount, setReviewCount] = R.useState(0);
+    const [versionInfo, setVersionInfo] = R.useState(null);
+    const [dismissedVersionPair, setDismissedVersionPair] = R.useState('');
     R.useEffect(() => {
         let alive = true;
         setBooting(true);
@@ -2836,6 +2835,15 @@ function Page() {
         })();
         return () => { alive = false; };
     }, [reloadKey]);
+    // C-3：启动时轻量查一次版本对比；失败静默（无横幅、无报错），不打断主启动流程。
+    R.useEffect(() => {
+        let alive = true;
+        request('/version').then((value) => { if (alive)
+            setVersionInfo(value); }).catch(() => null);
+        return () => { alive = false; };
+    }, [reloadKey]);
+    const versionPair = versionInfo && versionInfo.mismatch === true ? String(versionInfo.running) + '->' + String(versionInfo.installed) : '';
+    const showVersionBanner = versionPair !== '' && dismissedVersionPair !== versionPair;
     const notify = (text) => { pushToast(text, 'success'); };
     const refreshReviewCount = async () => {
         try {
@@ -2862,7 +2870,9 @@ function Page() {
         key: item.key, type: 'button',
         style: view === '' && tab === item.key ? styles.headerTabActive : styles.headerTab,
         onClick: () => { setTab(item.key); setView(''); },
-    }, item.label))), h('div', { style: styles.headerActions }, booting ? h('span', { style: styles.status }, '读取环境中…') : null, h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => goto('review') }, '待审核', reviewCount > 0 ? h('span', { style: styles.countBadge }, String(reviewCount)) : null), h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => goto('search') }, '检索'), h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => goto('settings') }, '设置'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => { setReloadKey(reloadKey + 1); void refreshReviewCount(); } }, '刷新'))), bootError !== null ? h('div', { style: { ...styles.error, margin: '10px 24px 0' }, role: 'alert' }, bootError) : null, view !== '' ? renderOverlay() : renderTab(), h(ToastHost, null), h(ConfirmHost, null));
+    }, item.label))), h('div', { style: styles.headerActions }, booting ? h('span', { style: styles.status }, '读取环境中…') : null, h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => goto('review') }, '待审核', reviewCount > 0 ? h('span', { style: styles.countBadge }, String(reviewCount)) : null), h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => goto('search') }, '检索'), h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => goto('settings') }, '设置'), h('button', { type: 'button', style: styles.button, className: 'kh-hover', onClick: () => { setReloadKey(reloadKey + 1); void refreshReviewCount(); } }, '刷新'))), 
+    // 横幅槽：常驻容器（无横幅时零高度），保证后面内容区与反馈层的位置恒定。
+    h('div', null, bootError !== null ? h('div', { style: { ...styles.error, margin: '10px 24px 0' }, role: 'alert' }, bootError) : null, showVersionBanner ? h('div', { style: { ...styles.warn, margin: '10px 24px 0', display: 'flex', alignItems: 'flex-start', gap: '12px' }, role: 'alert' }, h('span', { style: { flex: 1 } }, '知枢版本不一致：已安装 ' + versionInfo.installed + '，但当前运行的仍是 ' + versionInfo.running + '。升级只替换了磁盘文件，完全退出并重新打开 DSH 后新版本才生效。'), h('button', { type: 'button', style: styles.linkButton, className: 'kh-hover', onClick: () => setDismissedVersionPair(versionPair) }, '关闭')) : null), view !== '' ? renderOverlay() : renderTab(), h(ToastHost, null), h(ConfirmHost, null));
 }
 /** sidebar.panellist 行图标：自绘 SVG（不依赖 @deepseek-ai/dsh-client-ui-primitives）。 */
 function KnowHubIcon(props) {

package/lib/host/diagnostics.js

@@ -1,21 +1,73 @@
 /** 组装 M0 诊断数据：运行时/工作区/模型/SQLite/存储/工具，全部来自真实调用。 */
-import { promises as fs } from 'node:fs';
+import { promises as fs, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
 import { dshHome, resolveStorageRoot } from './paths.js';
 import { errorMessage } from './http.js';
 import { listWorkspaces, resolveWorkspace } from './workspace.js';
 import { readModelCatalog } from './model.js';
 import { probeSqlite, storageProbe } from './storage.js';
+const PACKAGE_URL = new URL('../../package.json', import.meta.url);
+const FALLBACK_PACKAGE = { name: 'dsh-knowhub', version: '0.0.0' };
+function parsePackage(text) {
+    const parsed = JSON.parse(text);
+    return { name: String(parsed.name ?? 'dsh-knowhub'), version: String(parsed.version ?? '0.0.0') };
+}
 export async function readOwnPackage() {
     try {
-        const url = new URL('../../package.json', import.meta.url);
-        const text = await fs.readFile(url, 'utf8');
-        const parsed = JSON.parse(text);
-        return { name: String(parsed.name ?? 'dsh-knowhub'), version: String(parsed.version ?? '0.0.0') };
+        return parsePackage(await fs.readFile(PACKAGE_URL, 'utf8'));
+    }
+    catch {
+        return { ...FALLBACK_PACKAGE };
+    }
+}
+/** 同步读磁盘 package.json；失败返回 null，把「读不到」与真实版本号区分开。 */
+export function readOwnPackageSync() {
+    try {
+        return parsePackage(readFileSync(fileURLToPath(PACKAGE_URL), 'utf8'));
     }
     catch {
-        return { name: 'dsh-knowhub', version: '0.0.0' };
+        return null;
+    }
+}
+/** 异步读磁盘 package.json；失败返回 null（对比时记为未知，不产生假阳性）。 */
+export async function readInstalledPackage() {
+    try {
+        return parsePackage(await fs.readFile(PACKAGE_URL, 'utf8'));
     }
+    catch {
+        return null;
+    }
+}
+// ---- 运行版本（进程启动时定格）与安装版本（磁盘现读）的对比（C-3） ----
+let runningVersion = null;
+/**
+ * 插件 apply() 启动时调用一次：把当时磁盘上的版本定格为本进程的「运行版本」。
+ * 升级只替换磁盘文件、宿主不重启时，运行版本仍是旧版——正是要提示的情形。
+ * 重复调用不覆盖（进程内版本终身不变）；读取失败时保持 null。
+ */
+export function captureRunningVersion() {
+    if (runningVersion === null) {
+        runningVersion = readOwnPackageSync()?.version ?? null;
+    }
+    return runningVersion;
+}
+export function getRunningVersion() {
+    return runningVersion;
+}
+/** 仅供测试：直接指定运行版本（传 null 表示未捕获/读取失败）。 */
+export function setRunningVersionForTest(version) {
+    runningVersion = version;
+}
+/** 纯对比：只看字符串相等与否（磁盘回滚同样算不一致）；任一侧未知（null）一律不报不一致，宁可不提示也不误报。 */
+export function compareVersions(running, installed) {
+    return { running, installed, mismatch: running !== null && installed !== null && running !== installed };
+}
+/** 组装一次版本对比：运行版本用启动时定格值，安装版本现读磁盘。 */
+export async function buildVersionCheck() {
+    const pkg = await readInstalledPackage();
+    const check = compareVersions(getRunningVersion(), pkg?.version ?? null);
+    return { name: pkg?.name ?? FALLBACK_PACKAGE.name, ...check };
 }
 function dshVersion() {
     try {
@@ -56,9 +108,16 @@ function toolsInfo(ctx) {
 export async function buildDiagnose(ctx, config, input = {}) {
     const section = typeof input.section === 'string' && input.section !== '' ? input.section : 'all';
     const want = (name) => section === 'all' || section === name;
-    const pkg = await readOwnPackage();
+    const versionInfo = await buildVersionCheck();
     const result = {
-        plugin: { name: pkg.name, version: pkg.version, route: '/knowhub/api/*', section },
+        plugin: {
+            name: versionInfo.name,
+            // version 语义为「运行版本」；未捕获到时回退到安装版本，再不行回退 0.0.0（与旧行为一致）。
+            version: versionInfo.running ?? versionInfo.installed ?? FALLBACK_PACKAGE.version,
+            installedVersion: versionInfo.installed,
+            versionMismatch: versionInfo.mismatch,
+            route: '/knowhub/api/*', section,
+        },
     };
     if (want('runtime'))
         result.runtime = runtimeInfo();

package/lib/host/index.js

@@ -11,6 +11,7 @@
  * ctx.inject([name], cb) 的形式——服务就绪时回调，缺失时插件照常加载。
  */
 import { createRouter } from './route.js';
+import { captureRunningVersion } from './diagnostics.js';
 import { registerKnowledgeTools } from './tool.js';
 import { registerContextInjection } from './inject.js';
 import { registerAutoDistill } from './distill.js';
@@ -19,7 +20,9 @@ export const name = 'dsh-knowhub/host';
 export const inject = [];
 export function apply(ctx, config = {}) {
     const cfg = config ?? {};
-    const router = createRouter(ctx, cfg);
+    // C-3：进程刚加载完本版代码，此刻把磁盘版本定格为「运行版本」，供 /version 与诊断对比。
+    const runningVersion = captureRunningVersion();
+    const router = createRouter(ctx, cfg, { runningVersion });
     // HTTP 路由：webServer 就绪时才注册；没有该服务（桌面版）时静默跳过，工具能力不受影响。
     ctx.inject(['webServer'], (webCtx) => {
         webCtx.effect(() => webCtx.webServer.register({

package/lib/host/route.js

@@ -1,6 +1,6 @@
 /** /knowhub HTTP 路由：前缀注册，原生 req/res，统一 {ok,value} / {ok,error} 信封。 */
 import { errorMessage, readBody, writeError, writeOk } from './http.js';
-import { buildDiagnose } from './diagnostics.js';
+import { buildDiagnose, buildVersionCheck, compareVersions, readInstalledPackage } from './diagnostics.js';
 import { listWorkspaces, resolveWorkspace } from './workspace.js';
 import { probeModel, readModelCatalog } from './model.js';
 import { scanProject } from './scan.js';
@@ -29,7 +29,14 @@ async function probeGit(path) {
             : '宿主进程无法执行 git 或目录不是 Git 仓库，增量更新将使用哈希模式',
     };
 }
-export function createRouter(ctx, config) {
+export function createRouter(ctx, config, options = {}) {
+    /** 本路由的版本对比：显式注入了运行版本时用注入值，否则走全局组装（含定格值与包名）。 */
+    const versionCheck = async () => {
+        if (options.runningVersion === undefined)
+            return buildVersionCheck();
+        const pkg = await readInstalledPackage();
+        return compareVersions(options.runningVersion, pkg?.version ?? null);
+    };
     return {
         async handle(req, res) {
             const url = new URL(String(req.url ?? '/'), 'http://knowhub.internal');
@@ -40,6 +47,7 @@ export function createRouter(ctx, config) {
                 if (method === 'GET' && (path === '/ping' || path === '/')) {
                     writeOk(res, { name: 'dsh-knowhub', time: new Date().toISOString(), endpoints: [
                             'GET /knowhub/api/ping',
+                            'GET /knowhub/api/version',
                             'GET /knowhub/api/diagnose?section=all|runtime|storage|workspaces|models|sqlite|tools',
                             'GET /knowhub/api/workspaces?path=',
                             'GET /knowhub/api/models',
@@ -105,6 +113,10 @@ export function createRouter(ctx, config) {
                     writeOk(res, probe);
                     return;
                 }
+                if (method === 'GET' && path === '/version') {
+                    writeOk(res, await versionCheck());
+                    return;
+                }
                 if (method === 'GET' && path === '/diagnose') {
                     const value = await buildDiagnose(ctx, config, {
                         section: url.searchParams.get('section'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-knowhub",
-  "version": "0.8.8",
+  "version": "0.9.0",
   "description": "知枢 KnowHub — DSH 全局知识中心与项目长期记忆：知识库、Repo Wiki、审核与版本、增量更新、检索与上下文注入、自动提炼、备份恢复、中文面板",
   "license": "MIT",
   "type": "module",