dsh-vscode-mode 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "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",
@@ -45,12 +45,13 @@
     "@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",
+    "@deepseek-ai/schemastery": ">=3.18.0 <4",
     "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

@@ -51,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 提供的
@@ -105,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
@@ -159,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 同上）。 */
@@ -381,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')
@@ -445,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,6 +23,9 @@ const SEMANTIC_LEGEND = {
 let registered = false
 const disposables = []
 
+/** LSP provider 注册标记的全局挂点名（跨插件重载认领；见 disposeLspProviders）。 */
+const LSP_PROVIDERS_GLOBAL = '__edrvLspProvidersRegistered__'
+
 /** 目标文件打开并定位（复用现有 openFileAt 的 edrv:open-editor 事件通道）。 */
 function openAt(path, target) {
   window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: Object.assign({ path }, target) }))
@@ -56,6 +59,12 @@ export function navTargetOf(selectionOrPosition) {
 /** 注册全部 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 文档同步（含未保存编辑）——
@@ -152,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/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/sessionScope.ts

@@ -0,0 +1,183 @@
+/**
+ * dsh-vscode-mode client — 会话作用域解析（跨 DSH 版本适配）。
+ *
+ * 背景：DSH 0.1.6-alpha.2 随「客户端 Session 多实例共存」移除了 `sessions.list`
+ * 快照的 `current` / `currentAddress` 字段（alpha.1 及更早仍发布 `current`）。
+ * 官方替代面是 `ctx.uiSession.current`（`HostObservable<StandardSourceBinding>`，
+ * 其 `key` 即当前会话 id；绑定行由官方 ui-session 依 retainInfo.mainView 推出）。
+ *
+ * 本模块把「当前会话」收敛为单一三级取值链，并附可订阅的变更通知：
+ *   1. `uiSession.current.key`（0.1.6-alpha.2+ 权威）
+ *   2. `sessions.list.current`（rc 线 / 0.1.6-alpha.1 及更早）
+ *   3. `sessions.list.byId` 中 `retainedBy.mainView > 0` 的首行（新版兜底，与官方同判据）
+ *   4. 槽位注入的 sessionId（最后兜底）
+ *
+ * 约束：`uiSession` 不进 `inject`（旧版 DSH 无此服务，进 inject 会让插件停等），
+ * 一律 `ctx.get` 可选探测；任一来源缺失/异常都降级，不抛错、不阻断其他两级。
+ * 取值纯逻辑（pickSessionScope 等）可在 node 环境单测。
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 解析出的会话作用域：sessionId 可能缺失；cwd 仅在 list 快照可读时给出。 */
+export interface SessionScope {
+  sessionId?: string
+  cwd?: string
+}
+
+/** 取值链的候选来源（三者都可缺失，缺失即跳过该级）。 */
+export interface ScopeSources {
+  /** `ctx.uiSession.current` 快照（0.1.6-alpha.2+ 权威来源；binding.key = sessionId）。 */
+  uiSession?: unknown
+  /** `ctx.sessions.list` 快照（旧版含 `current`；新版只有 `ids`/`byId`）。 */
+  list?: unknown
+  /** 槽位注入的 sessionId（前几级都拿不到时的最后兜底）。 */
+  fallbackSessionId?: unknown
+}
+
+/** 对象窄化（非对象返回 undefined，供后续安全取字段）。 */
+function asRecord(value: unknown): Record<string, unknown> | undefined {
+  return value && typeof value === 'object' ? (value as Record<string, unknown>) : undefined
+}
+
+/** 非空字符串取值（其他类型一律视为缺失）。 */
+function strOf(value: unknown): string | undefined {
+  return typeof value === 'string' && value ? value : undefined
+}
+
+/**
+ * 从 `uiSession.current` 快照读出 sessionId。
+ * 兼容两种形态：绑定源本身（`{ key }`）与其包裹形态（`{ value: { key } }`）——
+ * 官方 `createBindingSource` 的 `getSnapshot()` 返回绑定值本身，但跨版本包裹层存在差异，
+ * 故两者都尝试。
+ * @author ddj 2026年09月18号
+ * @param snapshot `uiSession.current` 的 `getSnapshot()` 结果（任意形状）
+ * @returns sessionId，或 undefined
+ */
+export function uiSessionIdOf(snapshot: unknown): string | undefined {
+  const binding = asRecord(snapshot)
+  if (!binding) return undefined
+  return strOf(binding.key) ?? strOf(asRecord(binding.value)?.key)
+}
+
+/**
+ * 从 `sessions.list` 快照读出 sessionId。
+ * 先取旧版 `current`；缺失时回退 `byId` 中 `retainedBy.mainView > 0` 的首行
+ * （与官方 ui-session 的 publishMain 同判据，故新版行为与官方视图一致）。
+ * @author ddj 2026年09月18号
+ * @param list `sessions.list` 的 `getSnapshot()` 结果（任意形状）
+ * @returns sessionId，或 undefined
+ */
+export function listSessionId(list: unknown): string | undefined {
+  const snap = asRecord(list)
+  if (!snap) return undefined
+  const current = strOf(snap.current)
+  if (current) return current
+  const byId = asRecord(snap.byId)
+  if (!byId) return undefined
+  for (const [id, row] of Object.entries(byId)) {
+    const mainView = asRecord(asRecord(row)?.retainedBy)?.mainView
+    if (typeof mainView === 'number' && mainView > 0) return id
+  }
+  return undefined
+}
+
+/**
+ * 三级取值链（纯函数）：决定当前会话 id 与其 cwd。
+ * 优先级 uiSession > list.current > list.byId.retainedBy > fallback。
+ * @author ddj 2026年09月18号
+ * @param sources 候选来源集合
+ * @returns 会话作用域（字段缺失即省略该键，不写 undefined 占位）
+ */
+export function pickSessionScope(sources: ScopeSources): SessionScope {
+  const sessionId = uiSessionIdOf(sources.uiSession)
+    ?? listSessionId(sources.list)
+    ?? strOf(sources.fallbackSessionId)
+  if (!sessionId) return {}
+  const byId = asRecord(asRecord(sources.list)?.byId)
+  const cwd = strOf(asRecord(byId?.[sessionId])?.cwd)
+  return cwd ? { sessionId, cwd } : { sessionId }
+}
+
+/** 读 `ctx.get(name)`（缺失/异常返回 undefined，不抛错）。 */
+function safeGet(ctx: { get: (name: string) => unknown }, name: string): unknown {
+  try {
+    return ctx.get(name)
+  } catch {
+    return undefined
+  }
+}
+
+/** 取 `uiSession.current` 快照（服务或订阅面缺失时返回 undefined）。 */
+function uiCurrentSnapshot(ctx: { get: (name: string) => unknown }): unknown {
+  const uiSession = asRecord(safeGet(ctx, 'uiSession'))
+  const current = asRecord(uiSession?.current)
+  const getSnapshot = current?.getSnapshot
+  if (typeof getSnapshot !== 'function') return undefined
+  try {
+    return (getSnapshot as () => unknown).call(current)
+  } catch {
+    return undefined
+  }
+}
+
+/** 取 `sessions.list` 快照（服务缺失时返回 undefined）。 */
+function listSnapshot(ctx: { get: (name: string) => unknown }): unknown {
+  const sessions = asRecord(safeGet(ctx, 'sessions'))
+  const list = asRecord(sessions?.list)
+  const getSnapshot = list?.getSnapshot
+  if (typeof getSnapshot !== 'function') return undefined
+  try {
+    return (getSnapshot as () => unknown).call(list)
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 读当前会话作用域（服务面取值 + 三级链）。
+ * @author ddj 2026年09月18号
+ * @param ctx 客户端根上下文（只需 `get`）
+ * @param fallbackSessionId 槽位注入的 sessionId（可选）
+ * @returns 会话作用域
+ */
+export function readSessionScope(ctx: { get: (name: string) => unknown }, fallbackSessionId?: unknown): SessionScope {
+  return pickSessionScope({
+    uiSession: uiCurrentSnapshot(ctx),
+    list: listSnapshot(ctx),
+    fallbackSessionId,
+  })
+}
+
+/**
+ * 订阅会话切换（同时挂 `uiSession.current` 与新/旧 `sessions.list`）。
+ * 旧版无 `uiSession`，新版 `list` 不再变（切会话只动 uiSession），故两条都要挂；
+ * 回调可能因两条源先后触发而重复，调用方按上一次 sessionId 自行去重。
+ * @author ddj 2026年09月18号
+ * @param ctx 客户端根上下文（只需 `get`）
+ * @param listener 变更回调
+ * @returns 取消订阅函数（幂等）
+ */
+export function subscribeScope(ctx: { get: (name: string) => unknown }, listener: () => void): () => void {
+  const disposers: Array<() => void> = []
+  const attach = (owner: unknown): void => {
+    const subscribe = asRecord(owner)?.subscribe
+    if (typeof subscribe !== 'function') return
+    try {
+      const disposer = (subscribe as (fn: () => void) => unknown).call(owner, listener)
+      if (typeof disposer === 'function') disposers.push(disposer as () => void)
+    } catch {
+      /* 订阅面异常：放弃该源，不影响其他源 */
+    }
+  }
+  attach(asRecord(asRecord(safeGet(ctx, 'uiSession'))?.current))
+  attach(asRecord(asRecord(safeGet(ctx, 'sessions'))?.list))
+  return () => {
+    for (const disposer of disposers.splice(0)) {
+      try {
+        disposer()
+      } catch {
+        /* 卸载异常不影响其余清理 */
+      }
+    }
+  }
+}