dsh-vscode-mode 0.4.6 → 0.5.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.4.6",
-  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
+  "version": "0.5.1",
+  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -45,12 +45,12 @@
     "@vscode/ripgrep": "^1.18.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
     "cordis": ">=4.0.0-rc <5",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",

package/src/client/ai/inlineProvider.ts

@@ -38,6 +38,17 @@ let inFlight = null
 let debounceTimer = null
 const cache = new Map()
 
+/**
+ * 补全 provider 注销器的全局挂点名。
+ *
+ * 为什么挂 window 而不是只靠模块级 registered：DSH 0.1.6-alpha.2 起支持插件运行时
+ * 卸载/重载，而 `window.monaco` 由 loader 注入后**跨重载存活**，模块级状态却会随
+ * bundle 重新求值而复位 —— 只判 registered 会在每次重载后再注册一次 provider，
+ * 导致同一编辑器出现重复补全。故注销器落 window，重载时命中即跳过注册。
+ * @author ddj 2026年09月18号
+ */
+const AI_INLINE_GLOBAL = '__edrvAiInlineDisposer__'
+
 /** 上次开关状态（configUpdate 后经事件刷新，关闭时立即静默）。 */
 let enabled = false
 
@@ -96,8 +107,15 @@ function diffPending(editor) {
  */
 export function registerAiInline(monaco) {
   if (registered || !monaco?.languages?.registerInlineCompletionsProvider) return
+  // 跨重载守卫：上一代 bundle 注册的 provider 仍挂在存活的 window.monaco 上，
+  // 此时直接认领为「已注册」，避免重复注册（注销器在首次注册时已落 window）。
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  if (host && host[AI_INLINE_GLOBAL]) {
+    registered = true
+    return
+  }
   registered = true
-  monaco.languages.registerInlineCompletionsProvider('*', {
+  const inlineDisposer = monaco.languages.registerInlineCompletionsProvider('*', {
     async provideInlineCompletions(model, position, context, token) {
       const t0 = Date.now()
       if (!enabled || token?.isCancellationRequested) return { items: [] }
@@ -166,6 +184,29 @@ export function registerAiInline(monaco) {
     },
     freeInlineCompletions() { /* 无资源需释放 */ },
   })
+  if (host) host[AI_INLINE_GLOBAL] = inlineDisposer
+}
+
+/**
+ * 卸载 AI 内联补全：注销 provider 并复位模块状态（插件重载/卸载时调用）。
+ *
+ * 复位 registered 让重装后能重新注册；清 window 挂点避免新实例被旧注销器误判为「已注册」。
+ * 同时作废在飞请求与去抖定时器，防止卸载后仍有回调写状态。
+ * @author ddj 2026年09月18号
+ */
+export function disposeAiInline() {
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  const inlineDisposer = host ? host[AI_INLINE_GLOBAL] : undefined
+  if (inlineDisposer && typeof inlineDisposer.dispose === 'function') {
+    try { inlineDisposer.dispose() } catch { /* 已注销 */ }
+  }
+  if (host) delete host[AI_INLINE_GLOBAL]
+  registered = false
+  seq += 1 // 作废在飞响应
+  if (debounceTimer) { clearTimeout(debounceTimer); debounceTimer = null }
+  if (inFlight) { try { inFlight.abort() } catch { /* 已结束 */ } inFlight = null }
+  cache.clear()
+  monacoRef = null
 }
 
 /** 缓存写入（超限整体清空，LRU 简化）。 */

package/src/client/index.ts

@@ -40,6 +40,7 @@ import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
 import { createSearchPanel } from './sidebar/panels/index.js'
 import { createRulesPanel } from './sidebar/panels/index.js'
+import { createSvnPanel } from './sidebar/panels/index.js'
 import { createTreeMenuRegistry } from './sidebar/contextMenu.js'
 import { createDefaultFileMenuItems } from './sidebar/menuItems.js'
 import { createOutlinePanel } from './outline/index.js'
@@ -50,7 +51,10 @@ import { createCommandBridge } from './commandBridge.js'
 import { REGISTRY_GLOBAL } from './commandGlobals.js'
 import { sidebarMinApply } from './sidebarMin.js'
 import { log } from './log.js'
-import { setupLsp, setSession } from './monaco/lsp/index.js'
+import { setupLsp, setSession, disposeLsp } from './monaco/lsp/index.js'
+import { disposeSnippets } from './snippets/provider.js'
+import { disposeAiInline } from './ai/inlineProvider.js'
+import { readSessionScope, subscribeScope } from './sessionScope.js'
 import type { CompatAdapter } from '../shared/compat.js'
 
 // ⚠️ inject 只列必需服务：webUiSettings 是 @linxin666/dsh-client-ui-web-ui-settings 提供的
@@ -104,52 +108,48 @@ export function apply(ctx: any): void {
   // 外部深链落地：Windows 右键菜单 / Unity 外部编辑器 → 浏览器 URL 参数 → 打开规则路由
   setupExtOpen(ctx)
 
-  // Monaco 加载时机：不再 DSH 启动即预热，改为进入会话界面（sessions.list.current 出现）后再后台加载，
+  // Monaco 加载时机：不再 DSH 启动即预热，改为进入会话界面（当前会话出现）后再后台加载，
   // 用户点开「文件编辑」页签即用；空闲时仍由 EditorView 挂载兜底加载。
   // 模块级 promise 去重，重复触发只首次真正加载；requestIdleCallback 让出会话首屏带宽，缺省回退延时调度；
   // 预热失败静默吞掉（loader 失败会重置 promise，页签打开时仍走原有加载/重试路径）。
-  const monacoList = sessions?.list
-  if (typeof window !== 'undefined' && monacoList && typeof monacoList.subscribe === 'function') {
-    const list = monacoList as { getSnapshot: () => { current?: unknown }; subscribe: (listener: () => void) => () => void }
+  //
+  // 会话取值经 readSessionScope 收敛（跨版本三级链，见 sessionScope.ts）：
+  // DSH 0.1.6-alpha.2 随多实例共存移除了 sessions.list.current，旧版则没有 uiSession；
+  // 原先直读 list.getSnapshot().current 在新版恒为 undefined，会让预热/LSP 同步/编辑 Tab 恢复静默失效。
+  // 会话切换 → LSP 文档归属更新 + 状态刷新（原先为两条订阅，取值源一致，此处合流为一条）。
+  if (typeof window !== 'undefined') {
     const schedulePreload = () => {
       const preload = () => loadMonaco(() => {}).then((m: unknown) => setupLsp(m)).catch(() => {})
       if (typeof window.requestIdleCallback === 'function') window.requestIdleCallback(preload, { timeout: 2000 })
       else schedule(preload, 300)
     }
-    const onSessionEnter = () => {
-      const current = list.getSnapshot()?.current
-      if (!current) return
-      setSession(current)
+    let preloadedFor: string | undefined
+    const onScopeChange = () => {
+      const scope = readSessionScope(ctx)
+      // 传 undefined = 清除绑定（保留原 LSP 同步语义：无当前会话时不残留旧归属）
+      setSession(scope.sessionId)
+      if (!scope.sessionId || scope.sessionId === preloadedFor) return
+      preloadedFor = scope.sessionId
       schedulePreload()
     }
-    ctx.effect(() => list.subscribe(onSessionEnter), 'vscode-mode: monaco session trigger')
-    onSessionEnter()
-  }
-  // 会话切换 → LSP 文档归属更新 + 状态刷新
-  if (monacoList && typeof monacoList.subscribe === 'function') {
-    const list = monacoList as { getSnapshot: () => { current?: string }; subscribe: (listener: () => void) => () => void }
-    ctx.effect(() => list.subscribe(() => {
-      setSession(list.getSnapshot()?.current)
-    }), 'vscode-mode: lsp session sync')
+    ctx.effect(() => subscribeScope(ctx, onScopeChange), 'vscode-mode: monaco session trigger')
+    onScopeChange()
   }
   // 会话切换 → 编辑 Tab 跨会话自动恢复：上一会话编辑区激活时，新会话自动展开并激活
   //（官方停靠面按会话隔离，新会话默认收起；先试 openTabIn 直写新会话面，未 adopt 走有界重试）。
-  // 注意：首次打开某会话时通知早于 current 字段落定，故通知只调度延迟任务，执行时再读最新快照
-  if (monacoList && typeof monacoList.subscribe === 'function') {
-    const list = monacoList as { getSnapshot: () => { current?: string }; subscribe: (listener: () => void) => () => void }
-    ctx.effect(() => {
-      let lastCurrent = list.getSnapshot?.()?.current
-      const check = () => {
-        const current = list.getSnapshot?.()?.current
-        if (!current || current === lastCurrent) return
-        lastCurrent = current
-        if (!isEditorTabActive() || officialService === undefined) return
-        try { officialService.service.openTabIn?.(current, OFFICIAL_TAB_KIND, {}) } catch { /* 未 adopt 等 seat 就绪走重试 */ }
-        restoreEditorTab(officialService.service, schedule)
-      }
-      return list.subscribe(() => schedule(check, 0))
-    }, 'vscode-mode: editor tab restore')
-  }
+  // 注意：首次打开某会话时通知早于会话字段落定，故通知只调度延迟任务，执行时再读最新作用域
+  ctx.effect(() => {
+    let lastCurrent = readSessionScope(ctx).sessionId
+    const check = () => {
+      const current = readSessionScope(ctx).sessionId
+      if (!current || current === lastCurrent) return
+      lastCurrent = current
+      if (!isEditorTabActive() || officialService === undefined) return
+      try { officialService.service.openTabIn?.(current, OFFICIAL_TAB_KIND, {}) } catch { /* 未 adopt 等 seat 就绪走重试 */ }
+      restoreEditorTab(officialService.service, schedule)
+    }
+    return subscribeScope(ctx, () => schedule(check, 0))
+  }, 'vscode-mode: editor tab restore')
   const originalOpenPath = workspaces?.openPath
   const binder = pickSettingsBinder(ctx)
   const settings = binder.scope
@@ -158,13 +158,8 @@ export function apply(ctx: any): void {
   let remoteOpenInstalled = false
   /** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter；统一走插件日志器）。 */
   const routeLogger = (message: string): void => log.warn(message)
-  /** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd。 */
-  const openContext = (): FileOpenContext => {
-    const current = sessions?.list?.getSnapshot?.()
-    const sessionId = current?.current
-    const summary = sessionId ? current?.byId?.[sessionId] : undefined
-    return { sessionId, cwd: summary?.cwd } as FileOpenContext
-  }
+  /** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd（跨版本取值链）。 */
+  const openContext = (): FileOpenContext => readSessionScope(ctx) as FileOpenContext
   /** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
   let sideService = detectSidebarService(ctx)
   /** 可选探测官方右侧 Sidebar（DSH 0.1.5-alpha.1+；探测命中 ≡ 版本判定，不进 inject 同上）。 */
@@ -196,6 +191,8 @@ export function apply(ctx: any): void {
   ctx.effect(() => sidebarPanels.register(createSearchPanel()), 'vscode-mode: sidebar panel search')
   // 规则面板：活动栏「规则」页签（Codebuddy 规则管理形态：用户/项目规则 + 启用开关，host 注入生效）
   ctx.effect(() => sidebarPanels.register(createRulesPanel()), 'vscode-mode: sidebar panel rules')
+  // SVN 变更面板：活动栏「SVN 变更」页签（工作副本状态列表；visible 守卫使非 SVN 工作区不出现）
+  ctx.effect(() => sidebarPanels.register(createSvnPanel()), 'vscode-mode: sidebar panel svn')
   // 文件右键菜单项注册表（对外 provide，供本插件/第三方注册；内置「在文件浏览器中打开」）
   const fileMenuItems = createTreeMenuRegistry()
   ctx.provide('edrvFileContextMenuItems', fileMenuItems)
@@ -378,10 +375,9 @@ export function apply(ctx: any): void {
         service: sideService as NonNullable<typeof sideService>,
         renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions })),
         activeSession: () => {
-          const snapshot = sessions?.list?.getSnapshot?.() as { current?: string; byId?: Record<string, { cwd?: string }> } | undefined
-          const sessionId = snapshot?.current
-          if (!sessionId) return undefined
-          return { sessionId, cwd: snapshot?.byId?.[sessionId]?.cwd }
+          const scope = readSessionScope(ctx)
+          if (!scope.sessionId) return undefined
+          return { sessionId: scope.sessionId, cwd: scope.cwd }
         },
         registerLegacyFallback: registerLegacyTab,
       }), 'vscode-mode: sidebar editor tab')
@@ -442,4 +438,13 @@ export function apply(ctx: any): void {
     order: 30,
     label: 'VSCodeMode',
   }, () => React.createElement(SettingsContext.Provider, { value: settings }, React.createElement(McpSettings, { openerRegistry: registry, compatSummary })))
+
+  // 卸载收尾（G4，DSH 0.1.6-alpha.2 起支持运行时卸载/重载）：
+  // 注销挂在存活的 window.monaco 上的全部 Monaco provider 并复位模块状态。
+  // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。
+  ctx.effect(() => () => {
+    try { disposeSnippets() } catch { /* 卸载异常不得阻断其余清理 */ }
+    try { disposeAiInline() } catch { /* 同上 */ }
+    try { disposeLsp() } catch { /* 同上 */ }
+  }, 'vscode-mode: monaco providers teardown')
 }

package/src/client/monaco/lsp/index.ts

@@ -5,20 +5,33 @@
  * setSession(id)：会话切换时同步（provider 与文档同步共用）。
  * 作者 ddj 2026-08-27
  */
-import { registerLspProviders, hideReferencesOverlay } from './providers.js'
+import { registerLspProviders, disposeLspProviders, hideReferencesOverlay } from './providers.js'
 import { setLspSession, refreshStatus, lspStatusFor, onLspProgress, bindLspSession } from './lspClient.js'
 
 let monacoRef = null
 let sessionBound = false
+/** 会话广播取消订阅函数（卸载时调用；落 window 以便跨重载清理上一代监听）。 */
+let sessionUnbind = null
+
+/** 会话广播订阅标记的全局挂点名（跨插件重载认领；见 disposeLsp）。 */
+const LSP_SESSION_GLOBAL = '__edrvLspSessionUnbind__'
 
 /** Monaco 加载后装配（幂等；重复调用仅刷新会话）。 */
 export function setupLsp(monaco) {
   monacoRef = monaco
   registerLspProviders(monaco)
-  // 会话广播订阅只装一次（与 Monaco 是否已加载无关）
+  // 会话广播订阅只装一次：跨重载时上一代已订阅（取消函数落 window，模块级状态会复位），
+  // 只判 sessionBound 会重复订阅 → 同一 LSP 会话事件被处理多次。
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  if (host && typeof host[LSP_SESSION_GLOBAL] === 'function') {
+    sessionBound = true
+    sessionUnbind = host[LSP_SESSION_GLOBAL]
+    return
+  }
   if (!sessionBound) {
     sessionBound = true
-    bindLspSession()
+    sessionUnbind = bindLspSession()
+    if (host) host[LSP_SESSION_GLOBAL] = sessionUnbind
   }
 }
 
@@ -33,4 +46,21 @@ export function disposeLspOverlay() {
   hideReferencesOverlay()
 }
 
+/**
+ * 卸载 LSP 装配（插件重载/卸载时调用）：注销全部 provider、解绑会话广播并复位标记。
+ * @author ddj 2026年09月18号
+ */
+export function disposeLsp() {
+  disposeLspProviders()
+  const unbind = sessionUnbind
+  if (typeof unbind === 'function') {
+    try { unbind() } catch { /* 已解绑 */ }
+  }
+  sessionUnbind = null
+  sessionBound = false
+  monacoRef = null
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  if (host) delete host[LSP_SESSION_GLOBAL]
+}
+
 export { lspStatusFor, refreshStatus, onLspProgress }

package/src/client/monaco/lsp/lspClient.ts

@@ -54,7 +54,9 @@ export function setLspSession(id) {
 /**
  * 订阅窗口会话广播（幂等）：EditorView 是 sessionId 的权威来源，挂载与会话切换时广播。
  * 独立于服务订阅，避免服务形状变化时 LSP 整体失联。
- * @author ddj 2026年09月11号
+ *
+ * 返回值是可重入的取消订阅函数；调用方应保存并在卸载时调用（否则重载后会累积监听）。
+ * @author ddj 2026年09月11号 / 2026年09月18号
  * @returns 取消订阅函数
  */
 export function bindLspSession() {

package/src/client/monaco/lsp/providers.ts

@@ -23,14 +23,48 @@ const SEMANTIC_LEGEND = {
 let registered = false
 const disposables = []
 
+/** LSP provider 注册标记的全局挂点名（跨插件重载认领；见 disposeLspProviders）。 */
+const LSP_PROVIDERS_GLOBAL = '__edrvLspProvidersRegistered__'
+
 /** 目标文件打开并定位（复用现有 openFileAt 的 edrv:open-editor 事件通道）。 */
-function openAt(path, line, column) {
-  window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: { path, line, column } }))
+function openAt(path, target) {
+  window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: Object.assign({ path }, target) }))
+}
+
+/**
+ * 解析 Monaco opener 第三参（目标位置）为 1-based 区间。
+ *
+ * 为什么要兼容多形态：Monaco 经官方桥 `registerEditorOpener` 传出的是
+ * `options.selection`（Range，含 getStartPosition）或其**降级形态**裸
+ * `{ lineNumber, column }`（官方桥在 Range 缺 endLineNumber/endColumn 时降级），
+ * 另有 `editor.action.goToLocations` 完全不传 options（第三参 undefined）。
+ * 三种形态都出现过，逐形态取值并对缺字段兜底，避免落点退化成第 1 行。
+ * @author ddj 2026年09月17号
+ * @param selectionOrPosition opener 第三参（Range / 裸位置 / undefined）
+ * @returns 1-based 目标区间（end 缺省等于 start，且保证 end >= start）
+ */
+export function navTargetOf(selectionOrPosition) {
+  const src = selectionOrPosition ?? {}
+  const start = typeof src.getStartPosition === 'function' ? src.getStartPosition() : src
+  const end = typeof src.getEndPosition === 'function' ? src.getEndPosition() : null
+  const line = Math.max(1, start?.lineNumber ?? 1)
+  const column = Math.max(1, start?.column ?? 1)
+  const rawEndLine = end?.lineNumber ?? src.endLineNumber
+  const rawEndColumn = end?.column ?? src.endColumn
+  const endLine = Math.max(line, rawEndLine != null ? Math.max(1, rawEndLine) : line)
+  const endColumn = rawEndColumn != null ? Math.max(1, rawEndColumn) : undefined
+  return endColumn === undefined ? { line, column, endLine } : { line, column, endLine, endColumn }
 }
 
 /** 注册全部 Monaco LSP provider 与文档跟踪（幂等）。 */
 export function registerLspProviders(monaco) {
   if (registered) return
+  // 跨重载守卫：window.monaco 存活的上一代已注册过整套 provider（标记落 window）
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  if (host && host[LSP_PROVIDERS_GLOBAL]) {
+    registered = true
+    return
+  }
   registered = true
 
   // —— 文档跟踪：model 生命周期 → host 文档同步（含未保存编辑）——
@@ -74,10 +108,7 @@ export function registerLspProviders(monaco) {
       openCodeEditor: (source, resource, selectionOrPosition) => {
         const path = lspUriToAbs(resource)
         if (!path) return false
-        const start = selectionOrPosition?.getStartPosition?.() ?? selectionOrPosition
-        const line = Math.max(1, start?.lineNumber ?? 1)
-        const column = Math.max(1, start?.column ?? 1)
-        openAt(path, line, column)
+        openAt(path, navTargetOf(selectionOrPosition))
         return true
       },
     }),
@@ -130,6 +161,29 @@ export function registerLspProviders(monaco) {
       releaseDocumentSemanticTokens: () => {},
     }),
   )
+  // 注销器落 window：window.monaco 跨插件重载存活，模块级 registered 会复位，
+  // 只判 registered 会在重载后重复注册全部 LSP provider（见 disposeLspProviders）。
+  if (host) host[LSP_PROVIDERS_GLOBAL] = true
+}
+
+/**
+ * 卸载 LSP provider 集合：注销全部注册并复位状态（插件重载/卸载时调用）。
+ *
+ * 必须存在的原因：DSH 0.1.6-alpha.2 起支持插件运行时卸载/重载，而 `window.monaco`
+ * 由 loader 注入后**跨重载存活**；模块级 `registered`/`disposables` 却随 bundle 重新
+ * 求值清空 —— 不注销则每次重载都重复叠加一整套 provider（跳转/hover/语义高亮翻倍）。
+ * @author ddj 2026年09月18号
+ */
+export function disposeLspProviders() {
+  for (const dispose of disposables.splice(0)) {
+    try {
+      if (typeof dispose === 'function') dispose()
+      else if (dispose && typeof dispose.dispose === 'function') dispose.dispose()
+    } catch { /* 单个注销异常不影响其余清理 */ }
+  }
+  registered = false
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  if (host) delete host[LSP_PROVIDERS_GLOBAL]
 }
 
 /** LSP SymbolInfo（host 归一化后）→ Monaco DocumentSymbol。 */

package/src/client/navHighlight.ts

@@ -0,0 +1,96 @@
+/**
+ * dsh-vscode-mode client — 跳转目标高亮区间推导（纯函数，不依赖 monaco/DOM）。
+ *
+ * 背景：Monaco 原生跳转在 resolve 出定义后会把选区 `collapseToStart` 再交给 opener，
+ * 于是插件拿到的是**零宽区间**（start === end）。零宽 range 挂装饰渲染不出任何可见
+ * 高亮（实测 Ctrl+点击枚举成员后 `.edrv-nav-target` 存在但无视觉效果）。因此必须把
+ * 零宽识别为「无区间」，并逐级回落：opener 区间 → 光标处单词 → 整行。
+ * 抽成纯函数便于单测（EditorView 是 React 组件，node 侧不可直接引入）。
+ * 作者 ddj 2026-09-17
+ */
+
+/** 推导所需的最小 model 能力（Monaco ITextModel 子集，测试可桩）。 */
+export interface NavFlashModel {
+  getLineCount(): number
+  getLineMaxColumn(lineNumber: number): number
+  /**
+   * Monaco 实返 `{ word, startColumn, endColumn }` —— **不含** startLineNumber/endLineNumber。
+   * 类型里把行号标为可选，正是为了强制调用方用当前行补齐（曾因直接透传 undefined
+   * 行号产出非法装饰区间，装饰已挂但渲染不出任何高亮）。
+   */
+  getWordAtPosition(pos: { lineNumber: number; column: number }):
+    | {
+        word?: string
+        startColumn: number
+        endColumn: number
+        startLineNumber?: number
+        endLineNumber?: number
+      }
+    | null
+}
+
+/** 跳转目标（1-based；endLine/endColumn 缺省表示未提供区间）。 */
+export interface NavFlashTarget {
+  line?: number
+  column?: number
+  endLine?: number | null
+  endColumn?: number | null
+}
+
+/** 高亮区间（Monaco IRange 形状，1-based）。 */
+export interface NavFlashRange {
+  startLineNumber: number
+  startColumn: number
+  endLineNumber: number
+  endColumn: number
+}
+
+/**
+ * 推导跳转目标的高亮区间。
+ *
+ * 逐级回落：① opener 提供的**非零宽**区间（原样夹到文档范围）；
+ * ② 光标处单词（LSP 折叠选区的常态，高亮标识符本身最易辨认）；
+ * ③ 整行（符号位置无单词可取时的兜底，保证一定可见）。
+ * @author ddj 2026年09月17号
+ * @param model 文本模型（或等价桩）
+ * @param target 跳转目标
+ * @returns 可渲染的高亮区间；model 不可用时返回 null
+ */
+export function navFlashRangeOf(model: NavFlashModel | null | undefined, target: NavFlashTarget | null | undefined): NavFlashRange | null {
+  if (!model || !target) return null
+  const lineCount = model.getLineCount()
+  if (!Number.isFinite(lineCount) || lineCount < 1) return null
+  const startLine = Math.max(1, Math.min(lineCount, Math.floor(target.line ?? 1) || 1))
+  const startColumn = Math.min(Math.max(1, Math.floor(target.column ?? 1) || 1), model.getLineMaxColumn(startLine))
+
+  const endLineRaw = target.endLine == null ? null : Math.floor(target.endLine)
+  const endColumnRaw = target.endColumn == null ? null : Math.floor(target.endColumn)
+  // 零宽（start === end）与缺字段一并视为「无区间」：零宽装饰不可见，必须回落
+  const hasRange = endLineRaw != null && endColumnRaw != null &&
+    (endLineRaw > startLine || endColumnRaw > startColumn)
+  if (hasRange) {
+    const endLineNumber = Math.max(startLine, Math.min(lineCount, endLineRaw))
+    const endColumn = Math.max(1, Math.min(model.getLineMaxColumn(endLineNumber), endColumnRaw))
+    return { startLineNumber: startLine, startColumn, endLineNumber, endColumn }
+  }
+
+  const word = model.getWordAtPosition({ lineNumber: startLine, column: startColumn })
+  if (word && word.endColumn > word.startColumn) {
+    // ⚠️ Monaco getWordAtPosition 不返回行号，必须用当前行补齐；直接透传 undefined
+    // 会产出 startLineNumber=undefined 的非法区间——装饰挂上了却渲染不出高亮（实测踩坑）。
+    const wordStartLine = word.startLineNumber ?? startLine
+    const wordEndLine = word.endLineNumber ?? startLine
+    return {
+      startLineNumber: wordStartLine,
+      startColumn: word.startColumn,
+      endLineNumber: wordEndLine,
+      endColumn: word.endColumn,
+    }
+  }
+  return {
+    startLineNumber: startLine,
+    startColumn: 1,
+    endLineNumber: startLine,
+    endColumn: model.getLineMaxColumn(startLine),
+  }
+}

package/src/client/officialSidebar.ts

@@ -33,6 +33,63 @@ export const OFFICIAL_FILE_TAB_ID = 'dsh-vscode-mode/file'
 /** file 资源类型的 kind（与页类型 edrvEditor 区分：同 kind 只允许一份 extension）。 */
 export const OFFICIAL_FILE_KIND = 'edrvEditorFile'
 
+/**
+ * Office 文档后缀：官方 `dsh-client-ui-sidebar-documentpreview` 的 Office 渲染器
+ * 声明 `doc/docx/xls/xlsx/ppt/pptx`，并在 alpha.2 起提供侧栏 Office 预览。
+ * 本插件让位官方（不认领），否则会把这些文件路由进 Monaco 而丢掉 Office 预览。
+ */
+export const OFFICE_EXT: readonly string[] = ['doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'odt', 'ods', 'odp', 'pages', 'numbers']
+
+/**
+ * 官方「不可预览二进制容器」清单（`UNVIEWABLE_BINARY_EXTENSIONS`，逐项取自
+ * `dsh-client-ui-sidebar-documentpreview/lib/client.js` 的 `UNVIEWABLE_BINARY_EXTENSIONS`）。
+ * 这些后缀官方会给出「无法预览」提示；本插件让位官方，避免把二进制当文本读成乱码。
+ *
+ * ⚠️ 刻意例外：官方清单含 `avif`，但本插件 {@link IMAGE_MIME} 支持 avif 图片预览
+ * （浏览器原生解码），故从本表**移除** `avif` —— 保留本插件的图片预览优于官方的「不可预览」。
+ * @author ddj 2026年09月18号
+ */
+export const BLIND_EXT: readonly string[] = [
+  // 媒体
+  'mp4', 'mov', 'avi', 'mkv', 'webm', 'flv', 'wmv', 'm4v', 'mp3', 'wav', 'flac', 'ogg', 'm4a', 'aac', 'wma', 'opus',
+  // 归档
+  'zip', 'gz', 'tgz', 'bz2', 'xz', 'zst', '7z', 'rar', 'tar', 'jar',
+  // 可执行与库
+  'exe', 'dll', 'so', 'dylib', 'bin', 'o', 'class', 'pyc', 'wasm',
+  // 字体
+  'ttf', 'otf', 'woff', 'woff2', 'eot',
+  // 磁盘映像
+  'dmg', 'iso', 'img',
+  // 数据库与设计文件
+  'sqlite', 'db', 'psd', 'ai', 'sketch', 'tiff', 'tif', 'heic', 'heif',
+]
+
+/** 让位判定用后缀集合（模块级构建一次；小写、无前导点）。 */
+const DEFER_EXT_SET: Set<string> = new Set([...OFFICE_EXT, ...BLIND_EXT])
+
+/**
+ * 取 path 的 basename 后缀（小写、无点）；无后缀/隐藏文件返回 ''。
+ * @author ddj 2026年09月18号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 小写后缀或 ''
+ */
+function suffixOf(path: unknown): string {
+  const base = String(path ?? '').replace(/\\/g, '/').split('/').pop() ?? ''
+  const dot = base.lastIndexOf('.')
+  return dot > 0 ? base.slice(dot + 1).toLowerCase() : ''
+}
+
+/**
+ * 该路径是否应让位官方查看器（Office 文档 + 官方不可预览的二进制容器）。
+ * 命中即不认领 `dsh-resource://file/**`，回落官方预览/提示。
+ * @author ddj 2026年09月18号
+ * @param path 文件路径（工作区相对或绝对）
+ * @returns 是否让位官方
+ */
+export function deferToOfficial(path: unknown): boolean {
+  return DEFER_EXT_SET.has(suffixOf(path))
+}
+
 /** 官方 Tab 打开参数（官方运行时不校验的 JSON，正文经 navigation.params 读回）。 */
 export interface OfficialTabParams {
   openPath?: string
@@ -297,7 +354,10 @@ export function installOfficial(options: {
  * 注册官方 file 资源地址认领（extension 档接管 `dsh-resource://file/**`，
  * 聊天文件链接/文件树打开改落本插件编辑器；注销后官方 textpreview 自动恢复）。
  * 认领与否由「文件链接使用工具」设置驱动（见 fileOpeners.shouldClaimFiles）。
- * @author ddj 2026年09月09号
+ *
+ * 让位规则（DSH 0.1.6-alpha.2 起）：Office 文档与官方「不可预览」二进制容器不认领，
+ * 回落官方查看器（Office 侧栏预览 / 「无法预览」提示），见 {@link deferToOfficial}。
+ * @author ddj 2026年09月09号 / 2026年09月18号
  * @param options 装配参数（探测命中的注册表 + slots + 正文组件）
  * @returns 卸载器（反注册类型与正文）；类型注册抛错返回 null（回落官方查看器）
  */
@@ -314,8 +374,12 @@ export function registerOfficialFileClaim(options: {
       kind: OFFICIAL_FILE_KIND,
       patterns: [OFFICIAL_FILE_PATTERN],
       priority: 'extension',
-      // 畸形/解码失败地址否决：回落官方 textpreview，不产生白屏 Tab
-      canOpen: (address: string) => parseOfficialFileAddress(address) !== null,
+      // 畸形/解码失败地址否决 + Office/不可预览后缀让位官方：回落官方查看器，不产生白屏 Tab
+      canOpen: (address: string) => {
+        const parsed = parseOfficialFileAddress(address)
+        if (parsed === null) return false
+        return !deferToOfficial(parsed.path)
+      },
       title: (address: string) => officialFileTitle(address),
     })
   } catch (error) {

package/src/client/paths.ts

@@ -28,6 +28,8 @@ export const CACHE_KEY = {
   workspaceFold: 'edrv.ws-fold.v1.',
   /** 规则面板 UI 状态（RulesPanel v1：Tab 与项目工作区选择，全局不按会话）。 */
   rules: 'edrv.rules.v1.',
+  /** SVN 变更面板 UI 状态（SvnPanel v1：未版本控制/忽略项显示开关，按作用域隔离）。 */
+  svn: 'edrv.svn.v1.',
 } as const
 
 /** 按前缀拼作用域键（scopeStore 产出作用域；侧边栏/编辑器等需要布局段时自行拼接后传入）。 */