dsh-vscode-mode 0.7.0 → 0.8.0

package/locale/en.json

@@ -0,0 +1,4 @@
+{
+  "title": "VSCodeMode",
+  "description": "VSCode-like coding on DSH: Monaco editor with tabs and QuickOpen, command palette, agent edit review, SVN integration, and LSP smartness."
+}

package/locale/zh.json

@@ -0,0 +1,4 @@
+{
+  "title": "VSCodeMode",
+  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（页签/QuickOpen/状态栏）、命令栏、Agent 编辑差异审查、SVN 集成与 LSP 智能。"
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
+  "icon": "assets/icon.svg",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -35,6 +36,7 @@
   "files": [
     "lib",
     "assets",
+    "locale",
     "skills",
     "src",
     "unity",

package/src/client/compat.ts

@@ -10,21 +10,97 @@ export const PLUGIN_NAME = 'dsh-vscode-mode'
 /** 外部侧栏插件名（dsh-web-ui-all 家族的文件打开能力提供方）。 */
 export const SIDEBAR_PLUGIN = 'dsh-better-sidebar'
 
-/** 设置 scope 的跨组件上下文形状（与官方 settingsScope 绑定的最小面）。 */
+/** 设置值的已知业务字段（各设置桥透传的 namespace 内容）。 */
+export interface SettingsValueLike {
+  fileOpenTool?: unknown
+  keybindings?: Record<string, string>
+  sidebarMinWidth?: unknown
+  maxOpenEditors?: unknown
+  /** 原生打开范围（逗号分隔后缀；0.1.7 批次新增，旧版 undefined → 默认集）。 */
+  nativeOpenExts?: unknown
+}
+
+/** 设置 scope 的跨组件上下文形状（与设置桥绑定的最小面：settingsScope / configForms 适配后同形）。 */
 export interface SettingsScopeLike {
-  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown; keybindings?: Record<string, string>; sidebarMinWidth?: unknown; maxOpenEditors?: unknown }; writable?: boolean }
+  getSnapshot: () => { status?: string; value?: SettingsValueLike; writable?: boolean }
   subscribe: (listener: () => void) => () => void
   set: (field: string, value: unknown) => Promise<void>
 }
 
+/** DSH 0.1.7+ configForms 服务最小面（0.1.6 无此服务，探测必须可降级）。 */
+interface ConfigFormsService {
+  get?: (entryId: string) => unknown
+}
+
+/** DSH 0.1.7+ 单个 ConfigForm 最小面（适配 SettingsScopeLike 所需子集）。 */
+interface ConfigFormLike {
+  getSnapshot: () => { status?: string; value?: unknown; writable?: boolean }
+  subscribe: (listener: () => void) => () => void
+  set: (field: string, value: unknown) => Promise<unknown>
+}
+
+/**
+ * 形状守卫：判断 configForms.get 返回值是否具备适配所需的最小面。
+ * @author ddj 2026年09月22号
+ * @param form configForms.get(entryId) 的返回值
+ * @returns 是否为可用 ConfigForm
+ */
+function isConfigForm(form: unknown): form is ConfigFormLike {
+  if (!form || typeof form !== 'object') return false
+  const candidate = form as Partial<ConfigFormLike>
+  return typeof candidate.getSnapshot === 'function'
+    && typeof candidate.subscribe === 'function'
+    && typeof candidate.set === 'function'
+}
+
 /**
- * 设置桥三级优先：webUiSettings（linxin666 兼容桥）→ settingsScope（官方）→ 无。
+ * 将 DSH 0.1.7 ConfigForm 适配为既有 SettingsScopeLike（调用方零改动）。
+ * status/value/writable 直接透传（'ready'|'loading'|'unavailable' 与既有 status 词汇一致）；
+ * set 丢弃返回的 boolean（避免给未 catch 的既有调用方新增拒绝；form.set 自身 reject 仍传导）。
+ * @author ddj 2026年09月22号
+ * @param form configForms.get(PLUGIN_NAME) 返回的表单
+ * @returns 适配后的设置 scope
+ */
+function adaptConfigForm(form: ConfigFormLike): SettingsScopeLike {
+  return {
+    getSnapshot: () => {
+      const snap = form.getSnapshot()
+      return { status: snap.status, value: snap.value as SettingsValueLike | undefined, writable: snap.writable }
+    },
+    subscribe: (listener) => form.subscribe(listener),
+    set: async (field, value) => { await form.set(field, value) },
+  }
+}
+
+/**
+ * 探测 DSH 0.1.7+ configForms 官方新设置桥（entryId = PLUGIN_NAME）。
+ * 0.1.6 无该服务、ctx.get/表单 get 抛错或形状不符时返回 undefined，交由原两级桥降级。
+ * @author ddj 2026年09月22号
+ * @param ctx 客户端服务上下文
+ * @returns 适配后的设置 scope 或 undefined
+ */
+function bindConfigForm(ctx: { get: (name: string) => unknown }): SettingsScopeLike | undefined {
+  try {
+    const forms = ctx.get('configForms') as ConfigFormsService | undefined
+    const form = forms?.get?.(PLUGIN_NAME)
+    if (!isConfigForm(form)) return undefined
+    return adaptConfigForm(form)
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 设置桥优先序：configForms（DSH 0.1.7+ 官方新桥）→ webUiSettings（linxin666 兼容桥，
+ * 旧版现网优先级不变）→ settingsScope（DSH 0.1.6 官方旧桥）→ 无。
  * 桥绑定抛错时降级到下一级，不让单个桥异常拖垮设置装配。
- * @author ddj 2026年08月24号
+ * @author ddj 2026年08月24号（2026年09月22号 增补 configForms 桥）
  * @param ctx 客户端服务上下文
  * @returns 激活的桥名称与绑定 scope
  */
 export function pickSettingsBinder(ctx: { get: (name: string) => unknown }): { service: string; scope: SettingsScopeLike | undefined } {
+  const configForm = bindConfigForm(ctx)
+  if (configForm) return { service: 'configForms', scope: configForm }
   for (const service of ['webUiSettings', 'settingsScope']) {
     try {
       const binder = ctx.get(service) as { bind?: (spec: { namespace: string }) => SettingsScopeLike } | undefined
@@ -37,6 +113,60 @@ export function pickSettingsBinder(ctx: { get: (name: string) => unknown }): { s
   return { service: 'none', scope: undefined }
 }
 
+/** 设置桥形状（探测 + 晚到有界重试 + 就绪通知；调用方按需取用）。 */
+export interface SettingsBridge {
+  scope: () => SettingsScopeLike | undefined
+  service: () => string
+  whenReady: (listener: () => void) => () => void
+}
+
+/**
+ * 设置桥装配（带晚到有界重试）：设置桥服务一律不进 inject（0.1.6 settingsScope /
+ * 0.1.7 configForms 互斥，写死任一桥名都会在另一版本停等），因此提供方可能晚于本插件
+ * apply 就绪——构造时探测一次，未命中则按 schedule 节奏有界重试，命中即通知 whenReady
+ * 订阅者（重挂设置同步 effect）；重试用尽保持未就绪（与旧行为一致，不无限轮询）。
+ * @author ddj 2026年09月22号
+ * @param ctx 客户端服务上下文
+ * @param options schedule 注入（缺省不重试=旧行为）；attempts/intervalMs 重试节奏
+ * @returns 设置桥
+ */
+export function settingsBridge(
+  ctx: { get: (name: string) => unknown },
+  options?: { schedule?: (fn: () => void, ms: number) => void; attempts?: number; intervalMs?: number },
+): SettingsBridge {
+  let hit = pickSettingsBinder(ctx)
+  let attemptsLeft = options?.attempts ?? 0
+  const interval = options?.intervalMs ?? 2000
+  const waiters: Array<() => void> = []
+  const notify = (): void => {
+    for (const listener of waiters.splice(0)) {
+      try { listener() } catch { /* 单个订阅者异常不拖垮其余 */ }
+    }
+  }
+  const retry = (): void => {
+    if (hit.scope || attemptsLeft <= 0 || !options?.schedule) return
+    attemptsLeft -= 1
+    options.schedule(() => {
+      hit = pickSettingsBinder(ctx)
+      if (hit.scope) { notify(); return }
+      retry()
+    }, interval)
+  }
+  retry()
+  return {
+    scope: () => hit.scope,
+    service: () => hit.service,
+    whenReady: (listener) => {
+      if (hit.scope) { listener(); return () => {} }
+      waiters.push(listener)
+      return () => {
+        const at = waiters.indexOf(listener)
+        if (at >= 0) waiters.splice(at, 1)
+      }
+    },
+  }
+}
+
 /** slot 注册描述（对齐 ctx.slots.register 的形状）。 */
 export interface SlotSpec {
   name: string

package/src/client/imagePreview.ts

@@ -1,6 +1,7 @@
 /**
- * dsh-vscode-mode client — 图片文件判定与 data URL 组装（编辑区图片预览面板用）。
- * 纯函数、无 DOM 依赖，便于单测；MIME 表收敛在 shared/rpc.ts（host base64 响应同源）。
+ * dsh-vscode-mode client — 图片文件判定、data URL 组装与缩放纯逻辑（编辑区图片预览面板用）。
+ * 纯函数、无 DOM 依赖，便于单测；MIME 表收敛在 shared/rpc.ts（host base64 响应同源）；
+ * 缩放：步进/clamp 为纯函数，页签记忆为模块级 Map（会话+路径键，EditorView 卸载清空、不持久化）。
  * @author ddj 2026年09月08号
  */
 import { IMAGE_MIME } from '../shared/rpc.js'
@@ -43,3 +44,76 @@ export function isSvgPath(path: string): boolean {
 export function dataUrlOf(base64: string, mime: string): string {
   return 'data:' + (mime || 'application/octet-stream') + ';base64,' + base64
 }
+
+/** 图片缩放下限（25%，低于此档不再缩小）。 */
+export const ZOOM_MIN = 0.25
+
+/** 图片缩放上限（400%，高于此档不再放大）。 */
+export const ZOOM_MAX = 4
+
+/** 图片缩放步进（10%/档，−/＋ 按钮每点一次的变化量）。 */
+export const ZOOM_STEP = 0.1
+
+/** 页签缩放记忆表：键 = zoomKeyOf(会话, 路径)，值 = 显式缩放或 null（适应宽度）。 */
+const zoomMem: Map<string, number | null> = new Map()
+
+/**
+ * 图片缩放收敛：clamp 到 25%–400% 并按整百分比取整（消除浮点步进噪声）。
+ * @author ddj 2026年09月22号
+ * @param zoom 目标缩放（非有限数值按 100% 处理）
+ * @returns 收敛后的缩放比例
+ */
+export function clampZoom(zoom: number): number {
+  const value = Number.isFinite(zoom) ? zoom : 1
+  return Math.round(Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, value)) * 100) / 100
+}
+
+/**
+ * 图片缩放步进：按 10%/档变化并 clamp（dir 为负即缩小，其余按放大处理）。
+ * @author ddj 2026年09月22号
+ * @param base 起始缩放（适应宽度态由调用方实测当前渲染缩放传入）
+ * @param dir 方向：< 0 缩小，≥ 0 放大
+ * @returns 步进后的缩放比例
+ */
+export function zoomStepOf(base: number, dir: number): number {
+  return clampZoom(base + (dir < 0 ? -ZOOM_STEP : ZOOM_STEP))
+}
+
+/**
+ * 页签缩放记忆键（会话 + 路径；NUL 分隔，防止两段拼接撞键）。
+ * @author ddj 2026年09月22号
+ * @param sessionId 会话 id
+ * @param path 图片路径
+ * @returns 记忆键
+ */
+export function zoomKeyOf(sessionId: string | null | undefined, path: string | null | undefined): string {
+  return String(sessionId ?? '') + '\u0000' + String(path ?? '')
+}
+
+/**
+ * 写入页签缩放记忆（null = 适应宽度；会话级生命周期，不进 localStorage）。
+ * @author ddj 2026年09月22号
+ * @param key zoomKeyOf 产出的记忆键
+ * @param zoom 记忆缩放（null = 适应宽度）
+ */
+export function rememberZoom(key: string, zoom: number | null): void {
+  zoomMem.set(key, zoom)
+}
+
+/**
+ * 读取页签缩放记忆（无记忆返回 null，调用方按初始适应宽度处理）。
+ * @author ddj 2026年09月22号
+ * @param key zoomKeyOf 产出的记忆键
+ * @returns 记忆缩放或 null
+ */
+export function recallZoom(key: string): number | null {
+  return zoomMem.get(key) ?? null
+}
+
+/**
+ * 清空全部页签缩放记忆（EditorView 卸载时调用）。
+ * @author ddj 2026年09月22号
+ */
+export function clearZoomMem(): void {
+  zoomMem.clear()
+}

package/src/client/index.ts

@@ -29,9 +29,10 @@ import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter
 import { patchRemoteOpen, probeRemoteOpen } from './remoteOpenRouter.js'
 import { setupExtOpen } from './externalOpen.js'
 import { SettingsContext } from './settingsContext.js'
-import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat.js'
+import { SIDEBAR_PLUGIN, registerSlotSafely, settingsBridge } from './compat.js'
 import { detectSidebarService, installSideEditor, setEnsureSideEditor, SIDEBAR_INSTALL_CMD } from './sidebarBridge.js'
-import { detectOfficial, installOfficial, registerOfficialFileClaim, OFFICIAL_TAB_KIND, OFFICIAL_TAB_TITLE, isEditorTabActive, restoreEditorTab } from './officialSidebar.js'
+import { detectOfficial, installOfficial, registerOfficialFileClaim, OFFICIAL_TAB_KIND, OFFICIAL_TAB_TITLE, isEditorTabActive, restoreEditorTab, buildFileAddress } from './officialSidebar.js'
+import { setNativeCsv, setNativeOpenHandler, resetNativeOpen } from './nativeOpenStore.js'
 import { SideEditorTab } from './ui/SideEditorTab.js'
 import { OfficialSideTab } from './ui/OfficialSideTab.js'
 import { createClaimRouter } from './ui/ClaimRouter.js'
@@ -64,7 +65,9 @@ import type { CompatAdapter } from '../shared/compat.js'
 // ⚠️ inject 只列必需服务：webUiSettings 是 @linxin666/dsh-client-ui-web-ui-settings 提供的
 // 可选兼容桥（非官方服务），列入 inject 会让未装该桥的部署启动时 entry 永久 pending，
 // web boot 直接失败（'1 entry did not activate'）。兼容层用 ctx.get 运行时探测 + 降级，不靠 inject。
-export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'conversation', 'settingsScope']
+// 设置桥服务同理不进 inject（DSH 0.1.7 移除 settingsScope、新增 configForms，0.1.6 反之；
+// 写死任一桥名都会在另一版本停等）——设置桥由 compat.pickSettingsBinder 运行时探测三级降级。
+export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'conversation']
 
 /** 指令桥装配幂等标记（同一 document 重复 apply 只装配一次，避免重复键位监听）。 */
 let commandsMounted = false
@@ -155,8 +158,9 @@ export function apply(ctx: any): void {
     return subscribeScope(ctx, () => schedule(check, 0))
   }, 'vscode-mode: editor tab restore')
   const originalOpenPath = workspaces?.openPath
-  const binder = pickSettingsBinder(ctx)
-  const settings = binder.scope
+  // 设置桥：服务不进 inject（0.1.6 settingsScope / 0.1.7 configForms 桥名互斥，写死任一
+  // 都会在另一版本停等）→ compat.settingsBridge 探测 + 晚到 15×2s 有界重试，命中后重挂同步
+  const bridge = settingsBridge(ctx, { schedule, attempts: 15, intervalMs: 2000 })
   let selected = autoValue('auto')
   /** 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）是否已安装（compatSummary 展示用）。 */
   let remoteOpenInstalled = false
@@ -175,7 +179,7 @@ export function apply(ctx: any): void {
 
   /** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
   const compatSummary = (): CompatAdapter[] => [
-    { name: '设置桥', active: settings !== undefined, note: settings !== undefined ? '使用 ' + binder.service + ' 桥' : '未绑定设置服务（fileOpenTool 持久化不可用）' },
+    { name: '设置桥', active: bridge.scope() !== undefined, note: bridge.scope() !== undefined ? '使用 ' + bridge.service() + ' 桥' : '未绑定设置服务（fileOpenTool 持久化不可用，晚到重试窗口内自愈）' },
     { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开（0.1.2 及更早 DSH 的对话文件链接主路径）' },
     { name: '会话文件链接路由（remote.session.openWorkspacePath）', active: remoteOpenInstalled, note: '0.1.3+ 对话文件引用/产物打开优先走插件打开器，失败回退系统打开' },
     { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
@@ -241,35 +245,47 @@ export function apply(ctx: any): void {
       claimDisposer = null
     }
   }
-  ctx.effect(() => {
-    if (!settings) return undefined
-    const sync = (): void => {
-      const snapshot = settings.getSnapshot()
-      if (snapshot.status === 'loading') return
-      selected = autoValue(snapshot.value?.fileOpenTool)
-      syncFileClaim()
-      window.dispatchEvent(new CustomEvent('edrv:file-open-tool-change', { detail: { value: selected } }))
-    }
-    sync()
-    return settings.subscribe(sync)
-  }, 'vscode-mode: file opener setting sync')
-  // 快捷键配置同步：设置提交后立即刷新键位匹配（编辑器/QuickOpen 按事件时读取）
-  // 同一订阅里顺带同步侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
-  // 以及页签上限（maxOpenEditors）→ 派发 edrv:max-open-editors 通知编辑器复算淘汰
-  ctx.effect(() => {
-    if (!settings) return undefined
-    const sync = (): void => {
-      const snapshot = settings.getSnapshot()
-      if (snapshot.status === 'loading') return
-      keybindingsApply(snapshot.value?.keybindings)
-      const minW = sidebarMinApply(snapshot.value?.sidebarMinWidth)
-      window.dispatchEvent(new CustomEvent('edrv:sidebar-min-width', { detail: { value: minW } }))
-      const limit = editorLimitApply(snapshot.value?.maxOpenEditors)
-      window.dispatchEvent(new CustomEvent('edrv:max-open-editors', { detail: { value: limit } }))
-    }
-    sync()
-    return settings.subscribe(sync)
-  }, 'vscode-mode: keybindings setting sync')
+  // 设置同步（fileOpenTool / 快捷键 / 侧宽 / 页签上限）：桥可能晚于本插件 apply 就绪
+  // （设置桥服务不进 inject），首次命中即挂两条 effect；晚到经 bridge.whenReady 重挂一次
+  // （settingsBridge 15×2s 有界重试内命中才会触发，用尽后保持旧行为不轮询）。
+  let settingsSyncMounted = false
+  const mountSettingsSyncs = (): void => {
+    if (settingsSyncMounted) return
+    const scope = bridge.scope()
+    if (!scope) return
+    settingsSyncMounted = true
+    ctx.effect(() => {
+      const sync = (): void => {
+        const snapshot = scope.getSnapshot()
+        if (snapshot.status === 'loading') return
+        selected = autoValue(snapshot.value?.fileOpenTool)
+        syncFileClaim()
+        window.dispatchEvent(new CustomEvent('edrv:file-open-tool-change', { detail: { value: selected } }))
+      }
+      sync()
+      return scope.subscribe(sync)
+    }, 'vscode-mode: file opener setting sync')
+    // 快捷键配置同步：设置提交后立即刷新键位匹配（编辑器/QuickOpen 按事件时读取）
+    // 同一订阅里顺带同步侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
+    // 以及页签上限（maxOpenEditors）→ 派发 edrv:max-open-editors 通知编辑器复算淘汰
+    ctx.effect(() => {
+      const sync = (): void => {
+        const snapshot = scope.getSnapshot()
+        if (snapshot.status === 'loading') return
+        keybindingsApply(snapshot.value?.keybindings)
+        const minW = sidebarMinApply(snapshot.value?.sidebarMinWidth)
+        window.dispatchEvent(new CustomEvent('edrv:sidebar-min-width', { detail: { value: minW } }))
+        const limit = editorLimitApply(snapshot.value?.maxOpenEditors)
+        window.dispatchEvent(new CustomEvent('edrv:max-open-editors', { detail: { value: limit } }))
+        // 原生打开范围同拍推送（nativeOpenStore 解析缓存；旧版无该字段 → 保持默认集）
+        setNativeCsv(snapshot.value?.nativeOpenExts)
+      }
+      sync()
+      return scope.subscribe(sync)
+    }, 'vscode-mode: keybindings setting sync')
+  }
+  mountSettingsSyncs()
+  if (!settingsSyncMounted) ctx.effect(() => bridge.whenReady(mountSettingsSyncs), 'vscode-mode: settings bridge wait')
   if (workspaces?.openPath) {
     ctx.effect(() => installOpenPathRouter({
       workspaces,
@@ -371,6 +387,17 @@ export function apply(ctx: any): void {
     // 官方打开器（下拉「官方侧边栏」选项，动态出现；openResource 能力缺失时跳过）+ 按当前设置同步 file 地址认领
     if (typeof official.service.openResource === 'function') {
       ctx.effect(() => registry.register(officialSidebarOpener(official.service)), 'vscode-mode: official sidebar opener')
+      // 原生打开 handler：文件树 openFile 命中 nativeOpenExts 时经 openResource 落官方渲染器
+      //（claim 的 canOpen 同步让位该范围，否则地址又被认领转发回本插件）；形态撤下时解绑
+      ctx.effect(() => {
+        setNativeOpenHandler((path) => {
+          const scope = readSessionScope(ctx)
+          if (!scope.sessionId) return false
+          official.service.openResource?.(buildFileAddress(path, scope.sessionId))
+          return typeof official.service.openResource === 'function'
+        })
+        return () => setNativeOpenHandler(null)
+      }, 'vscode-mode: native open handler')
     }
     syncFileClaim()
   }
@@ -449,7 +476,7 @@ export function apply(ctx: any): void {
     id: 'vscode-mode',
     order: 30,
     label: 'VSCodeMode',
-  }, () => React.createElement(SettingsContext.Provider, { value: settings }, React.createElement(McpSettings, { openerRegistry: registry, compatSummary })))
+  }, () => React.createElement(SettingsContext.Provider, { value: bridge.scope() }, React.createElement(McpSettings, { openerRegistry: registry, compatSummary })))
 
   // 卸载收尾（G4，DSH 0.1.6-alpha.2 起支持运行时卸载/重载）：
   // 注销挂在存活的 window.monaco 上的全部 Monaco provider 并复位模块状态。
@@ -459,5 +486,7 @@ export function apply(ctx: any): void {
     try { disposeLaunchJson() } catch { /* 同上 */ }
     try { disposeAiInline() } catch { /* 同上 */ }
     try { disposeLsp() } catch { /* 同上 */ }
+    // 原生打开范围复位回默认集（handler 解绑已由其自身 ctx.effect disposer 承担）
+    try { resetNativeOpen() } catch { /* 同上 */ }
   }, 'vscode-mode: monaco providers teardown')
 }

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

@@ -171,6 +171,52 @@ export async function fetchHover(path, text, position) {
   return res.hover || null
 }
 
+/**
+ * 查询补全列表（列表阶段不带 documentation，由 resolve 补全）。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @param text 文档全文（未保存内容必须进服务器，否则按旧文本解析）
+ * @param position Monaco 位置（1-based）
+ * @param context LSP CompletionContext（触发类型/触发字符）
+ * @returns { items, incomplete }；失败或空时 null
+ */
+export async function fetchCompletions(path, text, position, context) {
+  await syncDoc(path, text, true)
+  const args = { path, position: monoToLsp(position.lineNumber, position.column) }
+  if (context) args.context = context
+  const res = await queryLsp('查询补全', 'edrv.lsp.completion', args)
+  if (!res || !res.completions) return null
+  return res.completions
+}
+
+/**
+ * 惰性补全单个候选项（completionItem/resolve）。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @param item host 归一化的补全项（含 data）
+ * @returns 补全后的条目；失败时回落原条目
+ */
+export async function resolveCompletion(path, item) {
+  const res = await queryLsp('解析补全', 'edrv.lsp.resolveCompletion', { path, item })
+  if (!res || !res.item) return item
+  return res.item
+}
+
+/**
+ * 查询签名帮助。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @param text 文档全文
+ * @param position Monaco 位置（1-based）
+ * @returns 归一化签名帮助；无签名时 null
+ */
+export async function fetchSignatureHelp(path, text, position) {
+  await syncDoc(path, text, true)
+  const res = await queryLsp('查询签名', 'edrv.lsp.signatureHelp', { path, position: monoToLsp(position.lineNumber, position.column) })
+  if (!res) return null
+  return res.signatureHelp || null
+}
+
 /** 查询当前文档的 semantic tokens（host 已归一化 legend 与 delta data）。 */
 export async function fetchSemanticTokens(path, text) {
   await syncDoc(path, text, true)