dsh-vscode-mode 0.6.0 → 0.8.0

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

@@ -10,12 +10,34 @@
 import {
   pathOfModel, syncDoc, closeDoc, findDefinition, findReferences,
   fetchDocumentSymbols, fetchHover, fetchSemanticTokens,
+  fetchCompletions, resolveCompletion, fetchSignatureHelp,
   targetOpenPath, lspStatusFor, refreshStatus,
   lspUriToAbs,
 } from './lspClient.js'
-import { LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES } from '../../../shared/lsp.js'
+import {
+  LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES,
+  LSP_COMPLETION_KIND_NAMES, LSP_INSERT_TEXT_FORMAT_SNIPPET,
+} from '../../../shared/lsp.js'
 
 const LSP_LANGS = ['lua', 'csharp']
+
+/**
+ * 补全触发字符（按语言）。
+ *
+ * 取 EmmyLua / DotRush 声明字符的**交集**且去掉噪声项：`"` `'` `\` `/` `#` 等在多语言里
+ * 过于聒噪（每次输入都弹列表打扰手写），故只保留「成员访问 + 调用 + 索引」三类主场景。
+ * @author ddj 2026年09月22号
+ */
+const COMPLETION_TRIGGERS = {
+  lua: ['.', ':', '(', '['],
+  csharp: ['.', ':', '(', '[', '<', '@'],
+}
+
+/** 签名帮助触发字符（与 LSP 服务器声明的 triggerCharacters 对齐）。 */
+const SIGNATURE_TRIGGERS = ['(', ',']
+
+/** 签名参数/签名文档上浮窗渲染的兜底最大长度（防超长 doc 撑爆浮窗）。 */
+const MAX_DOC_LENGTH = 4000
 const SEMANTIC_LEGEND = {
   tokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
   tokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS],
@@ -100,6 +122,19 @@ export function registerLspProviders(monaco) {
   disposables.push(() => window.removeEventListener('edrv:lsp-redetect', onRedetect))
 
   // —— 数据 provider ——
+  // 补全/签名帮助是本轮新增能力，注册前各自探能力：vendored Monaco 若缺某一 API
+  // （换了构建/被裁剪），只跳过该 provider，不能让整套 LSP（跳转/hover/语义高亮）一起挂掉。
+  // ⚠️ 必须**逐个压入**注销器：按语言注册会返回数组，整组压入会让 disposeLspProviders
+  // 既不是 function 也没有 .dispose → 静默跳过不注销 → 重载后补全 provider 叠加（重复候补）。
+  const withCapability = (register) => {
+    try {
+      const disposer = register()
+      if (Array.isArray(disposer)) disposables.push(...disposer.filter(Boolean))
+      else if (disposer) disposables.push(disposer)
+    } catch (error) {
+      /* 单个能力注册失败不影响其余 provider */
+    }
+  }
   disposables.push(
     // 原生跳转（peek 参考文献列表点击 / 原生 go to definition 等）的 edrv:// 打开兜底：
     // 目标 uri 由本插件自己定义（edrv:// 工作区相对路径），Monaco 无法自行加载，
@@ -163,6 +198,33 @@ export function registerLspProviders(monaco) {
       releaseDocumentSemanticTokens: () => {},
     }),
   )
+
+  // 新增能力走 withCapability（能力缺失只跳过自身，不影响上面已注册的 provider），
+  // 且必须在 disposables.push(...) **之外**调用 —— 放进参数列表会压入 undefined 占位。
+  // 补全：`obj.` 弹出成员列表（EmmyLua 经 ---@class/---@field 注释索引提供字段）。
+  // 逐语言注册以分别给触发字符；resolveCompletionItem 惰性取文档（列表阶段不带）。
+  withCapability(() => LSP_LANGS.map((lang) => completionsFor(monaco, lang)))
+  withCapability(() => monaco.languages.registerSignatureHelpProvider(LSP_LANGS, {
+    signatureHelpTriggerCharacters: SIGNATURE_TRIGGERS,
+    signatureHelpRetriggerCharacters: SIGNATURE_TRIGGERS,
+    provideSignatureHelp: async (model, position, token, context) => {
+      const path = pathOfModel(model)
+      if (!path) return null
+      // 取消（继续输入/移光标）时不再弹，避免过期签名覆盖新位置
+      if (token?.isCancellationRequested) return null
+      const help = await fetchSignatureHelp(path, model.getValue(), position)
+      if (!help || !help.signatures.length) return null
+      return {
+        value: {
+          signatures: help.signatures.map(toMonacoSignature),
+          activeSignature: help.activeSignature,
+          activeParameter: help.activeParameter,
+        },
+        dispose: () => {},
+      }
+    },
+  }))
+
   // 注销器落 window：window.monaco 跨插件重载存活，模块级 registered 会复位，
   // 只判 registered 会在重载后重复注册全部 LSP provider（见 disposeLspProviders）。
   if (host) host[LSP_PROVIDERS_GLOBAL] = true
@@ -273,6 +335,188 @@ export async function runFindReferences(ed) {
  */
 export function hideReferencesOverlay() {}
 
+/**
+ * 构造某语言的补全 provider（触发字符按语言区分）。
+ *
+ * 为什么有 documentPath 传递：Monaco 调 `resolveCompletionItem(item, token)` 时**不传 model**
+ * （实测 vendored 0.42 构建：`provider.resolveCompletionItem(this.completion, token)`），
+ * 因此路径必须在列表阶段随候选项带上，否则 resolve 阶段无处得知该查哪个文档。
+ * @author ddj 2026年09月22号
+ * @param monaco Monaco 实例
+ * @param lang 语言 id
+ * @returns provider 注销器
+ */
+function completionsFor(monaco, lang) {
+  return monaco.languages.registerCompletionItemProvider(lang, {
+    triggerCharacters: COMPLETION_TRIGGERS[lang] ?? ['.', ':'],
+    provideCompletionItems: async (model, position, context, token) => {
+      const path = pathOfModel(model)
+      if (!path) return { suggestions: [] }
+      const list = await fetchCompletions(path, model.getValue(), position, toLspContext(context))
+      if (!list || !list.items.length || token?.isCancellationRequested) return { suggestions: [] }
+      const word = model.getWordUntilPosition(position)
+      const fallback = {
+        startLineNumber: position.lineNumber,
+        endLineNumber: position.lineNumber,
+        startColumn: word.startColumn,
+        endColumn: word.endColumn,
+      }
+      return {
+        suggestions: list.items.map((item) => toMonoSuggestion(monaco, item, fallback, path)),
+        incomplete: list.incomplete === true,
+      }
+    },
+    resolveCompletionItem: async (item, token) => {
+      const raw = item?.__edrvRaw
+      const path = item?.__edrvPath
+      if (!raw || !path || token?.isCancellationRequested) return item
+      const resolved = await resolveCompletion(path, raw).catch(() => null)
+      if (!resolved) return item
+      return mergeResolved(monaco, item, resolved)
+    },
+  })
+}
+
+/**
+ * Monaco 补全上下文 → LSP CompletionContext。
+ *
+ * ⚠️ 两侧 triggerKind **编号不同，必须换算**（实测 vendored 0.42 与 LSP 3.17 规范）：
+ *   Monaco：0=Invoke, 1=TriggerCharacter, 2=TriggerForIncompleteCompletions
+ *   LSP  ：1=Invoked, 2=TriggerCharacter, 3=TriggerForIncomplete
+ * 恒差 1。直传会把「按字符触发」谎报成 Invoked，服务器据此可能不返回成员补全
+ * （部分服务器严格按 triggerKind 决定是否给 table 成员）。
+ * @author ddj 2026年09月22号
+ * @param context Monaco 上下文（可能缺字段）
+ * @returns LSP 上下文；无触发信息时 undefined（不占载荷）
+ */
+export function toLspContext(context) {
+  const kind = context?.triggerKind
+  if (typeof kind !== 'number' && !context?.triggerCharacter) return undefined
+  // 换算到 LSP 编号空间并夹到合法区间 [1,3]；未给 kind 时按 LSP Invoked(1) 处理
+  const lspKind = typeof kind === 'number' ? Math.min(3, Math.max(1, kind + 1)) : 1
+  const out = { triggerKind: lspKind }
+  if (typeof context?.triggerCharacter === 'string') out.triggerCharacter = context.triggerCharacter
+  return out
+}
+
+/**
+ * LSP 补全项 → Monaco suggestion。
+ * @author ddj 2026年09月22号
+ * @param monaco Monaco 实例（取枚举）
+ * @param item host 归一化补全项
+ * @param fallback 无 textEdit 时的词范围
+ * @param path 工作区相对路径（resolve 阶段回传用）
+ * @returns Monaco suggestion
+ */
+function toMonoSuggestion(monaco, item, fallback, path) {
+  const kindName = LSP_COMPLETION_KIND_NAMES[item.kind ?? 0]
+  const kinds = monaco.languages.CompletionItemKind ?? {}
+  const asSnippet = monaco.languages.CompletionItemInsertTextRule?.InsertAsSnippet
+  const suggestion = {
+    label: item.label,
+    kind: kindName && typeof kinds[kindName] === 'number' ? kinds[kindName] : (kinds.Text ?? 0),
+    insertText: textOfCompletion(item),
+    range: rangeOfCompletion(monaco, item, fallback),
+    // 非协议字段：仅本插件读取（resolve 需要文档路径与原始条目），Monaco 忽略
+    __edrvRaw: item,
+    __edrvPath: path,
+  }
+  if (item.detail) suggestion.detail = item.detail
+  if (item.documentation) suggestion.documentation = { value: clip(item.documentation) }
+  if (item.filterText) suggestion.filterText = item.filterText
+  if (item.sortText) suggestion.sortText = item.sortText
+  if (item.preselect === true) suggestion.preselect = true
+  if (item.commitCharacters) suggestion.commitCharacters = item.commitCharacters
+  if (item.deprecated === true) suggestion.tags = [monaco.languages.CompletionItemTag?.Deprecated ?? 1]
+  if (item.additionalTextEdits) suggestion.additionalTextEdits = item.additionalTextEdits.map((edit) => toMonoEdit(monaco, edit))
+  // 片段展开：LSP insertTextFormat=2 交给 Monaco 解析 ${1:占位} 语法
+  if (item.insertTextFormat === LSP_INSERT_TEXT_FORMAT_SNIPPET && typeof asSnippet === 'number') {
+    suggestion.insertTextRules = asSnippet
+  }
+  return suggestion
+}
+
+/**
+ * 取补全插入文本：`textEdit.newText` 优先于 `insertText`（协议规定 textEdit 生效时以它为准）。
+ * @author ddj 2026年09月22号
+ */
+function textOfCompletion(item) {
+  if (item.textEdit?.newText) return item.textEdit.newText
+  return item.insertText ?? item.label
+}
+
+/**
+ * 取补全替换范围（Monaco 1-based）：单 range 或 insert/replace 双 range 两种形态都映射。
+ * 无 textEdit 时回落词范围 —— 缺范围会让 Monaco 用默认范围替换，可能吃掉已输入前缀。
+ * @author ddj 2026年09月22号
+ */
+function rangeOfCompletion(monaco, item, fallback) {
+  const edit = item.textEdit
+  if (!edit) return fallback
+  if (edit.range) return toMonoRange(monaco, edit.range)
+  if (edit.insert && edit.replace) {
+    return { insert: toMonoRange(monaco, edit.insert), replace: toMonoRange(monaco, edit.replace) }
+  }
+  return fallback
+}
+
+/** LSP Range（0-based）→ Monaco Range（1-based）。 */
+function toMonoRange(monaco, range) {
+  const s = (p) => ({ lineNumber: Math.max(1, (p?.line ?? 0) + 1), column: Math.max(1, (p?.character ?? 0) + 1) })
+  const start = s(range?.start)
+  const end = s(range?.end)
+  return new monaco.Range(start.lineNumber, start.column, end.lineNumber, end.column)
+}
+
+/** LSP TextEdit → Monaco IEditOperation（additionalTextEdits 用）。 */
+function toMonoEdit(monaco, edit) {
+  return { range: toMonoRange(monaco, edit.range), text: edit.newText }
+}
+
+/**
+ * 把 resolve 结果合并进已展示的候选项（保留列表阶段的 range/kind 等 Monaco 侧字段）。
+ * @author ddj 2026年09月22号
+ * @param monaco Monaco 实例
+ * @param suggestion 原候选项
+ * @param resolved resolve 后的归一化条目
+ * @returns 合并后的候选项
+ */
+function mergeResolved(monaco, suggestion, resolved) {
+  const merged = { ...suggestion, __edrvRaw: resolved }
+  if (resolved.detail) merged.detail = resolved.detail
+  if (resolved.documentation) merged.documentation = { value: clip(resolved.documentation) }
+  if (resolved.additionalTextEdits) merged.additionalTextEdits = resolved.additionalTextEdits.map((edit) => toMonoEdit(monaco, edit))
+  return merged
+}
+
+/** 文档裁剪：超长 doc（少数服务器返回整段源码）会撑爆浮窗，截断并标注。 */
+function clip(text) {
+  const value = String(text ?? '')
+  if (value.length <= MAX_DOC_LENGTH) return value
+  return value.slice(0, MAX_DOC_LENGTH) + '\n\n…（内容过长已截断）'
+}
+
+/**
+ * LSP 签名 → Monaco SignatureInformation。
+ * 参数 label 的 `[start, end]` 元组形态**必须**转成 `[start, end]` 数组，
+ * 否则 Monaco 按字符串渲染成 `42,57` 这种字面文本（该浮窗会显示成乱码式参数）。
+ * @author ddj 2026年09月22号
+ * @param signature host 归一化签名
+ * @returns Monaco 签名
+ */
+function toMonoSignature(signature) {
+  const out = {
+    label: signature.label,
+    parameters: (signature.parameters ?? []).map((param) => {
+      const info = { label: Array.isArray(param.label) ? [param.label[0], param.label[1]] : param.label }
+      if (param.documentation) info.documentation = { value: clip(param.documentation) }
+      return info
+    }),
+  }
+  if (signature.documentation) out.documentation = { value: clip(signature.documentation) }
+  return out
+}
+
 /** 编辑器状态栏提示（复用 EditorView 的 status 通道）。 */
 function setStatus(text) {
   window.dispatchEvent(new CustomEvent('edrv:status', { detail: { text } }))

package/src/client/nativeOpenStore.ts

@@ -0,0 +1,91 @@
+/**
+ * dsh-vscode-mode client — 原生打开范围的运行时状态（设置值缓存 + 官方打开 handler）。
+ * 职责：
+ * 1. 缓存设置字段 `nativeOpenExts` 的解析结果（mountSettingsSyncs 的 keybindings 同步
+ *    块每拍推送；旧版设置无该字段 → 保持默认集，与 deferToOfficial 同源 shared 事实源）；
+ * 2. 持有「原生打开」执行 handler（index.ts 装配时注册 sidebarRight.openResource 包装），
+ *    EditorView 的 openFile 链路命中判定时调用，失败回退现状打开。
+ * 单例模块级状态：值变更经 CustomEvent 广播（跨组件按需订阅；消费方多为每调用读缓存）。
+ * @author ddj 2026年09月22号
+ */
+import { DEFAULT_NATIVE_CSV, DEFAULT_NATIVE_EXT, inNativeOpen, parseExtCsv } from '../shared/nativeOpen.js'
+
+/** 设置值变化广播事件名（mountSettingsSyncs 推送时派发；幂等值不派发）。 */
+export const NATIVE_OPEN_EVENT = 'edrv:native-open-exts-change'
+
+/** 当前设置串（设置页回显 / 诊断用）。 */
+let csv = DEFAULT_NATIVE_CSV
+/** 解析后的后缀集合（热路径读取，避免每次点击 split）。 */
+let exts: ReadonlySet<string> = new Set(DEFAULT_NATIVE_EXT)
+/** 官方原生打开 handler（index.ts 装配注册；返回 false/缺失 = 回退现状打开）。 */
+let handler: ((path: string) => boolean) | null = null
+
+/**
+ * 读当前原生打开设置串。
+ * @author ddj 2026年09月22号
+ * @returns 逗号分隔后缀串
+ */
+export function nativeCsv(): string {
+  return csv
+}
+
+/**
+ * 该路径是否命中用户配置的原生打开范围（不含 deferToOfficial 默认让位语义——
+ * 那部分由调用方自行取并，保持两判定各司其职）。
+ * @author ddj 2026年09月22号
+ * @param path 文件路径
+ * @returns 是否命中
+ */
+export function inNativePath(path: unknown): boolean {
+  return inNativeOpen(path, exts)
+}
+
+/**
+ * 推送设置值（mountSettingsSyncs 每拍调用）：解析为集合，值变化才更新并广播。
+ * 非法/空输入 → 回落默认集（与 host schema default 同源）。
+ * @author ddj 2026年09月22号
+ * @param value 设置原值（unknown，兼容旧版 undefined）
+ */
+export function setNativeCsv(value: unknown): void {
+  const next = typeof value === 'string' && value.trim() ? value : DEFAULT_NATIVE_CSV
+  if (next === csv) return
+  csv = next
+  exts = parseExtCsv(next)
+  if (exts.size === 0) exts = new Set(DEFAULT_NATIVE_EXT)
+  try {
+    window.dispatchEvent(new CustomEvent(NATIVE_OPEN_EVENT, { detail: { value: csv } }))
+  } catch {
+    /* 无 window 环境（测试）：仅内存更新 */
+  }
+}
+
+/**
+ * 注册原生打开执行 handler（index.ts 在官方 sidebarRight.openResource 可用时注册）。
+ * @author ddj 2026年09月22号
+ * @param fn handler（返回是否已原生打开成功）；null 解除
+ */
+export function setNativeOpenHandler(fn: ((path: string) => boolean) | null): void {
+  handler = fn
+}
+
+/**
+ * 尝试原生打开（EditorView openFile 链路命中判定时调用）。
+ * @author ddj 2026年09月22号
+ * @param path 文件路径
+ * @returns true=已走官方原生打开；false=handler 缺失或失败（调用方回退现状）
+ */
+export function tryNativeOpen(path: string): boolean {
+  if (!handler) return false
+  try {
+    return handler(path) === true
+  } catch {
+    return false
+  }
+}
+
+/** 复位（卸载/测试隔离用：回默认集、解绑 handler）。 */
+export function resetNativeOpen(): void {
+  csv = DEFAULT_NATIVE_CSV
+  exts = new Set(DEFAULT_NATIVE_EXT)
+  handler = null
+}

package/src/client/officialSidebar.ts

@@ -11,6 +11,12 @@
 
 import { log } from './log.js'
 import { setEnsureSideEditor } from './sidebarBridge.js'
+import { OFFICE_EXT, BLIND_EXT, suffixOf } from '../shared/nativeOpen.js'
+import { inNativePath } from './nativeOpenStore.js'
+
+// 让位清单与 CSV/TSV 决策（可编辑性优先，同 avif 例外）已抽至双面契约 shared/nativeOpen.ts
+//（host 的 Config schema 默认原生打开范围与本模块共用同一事实源）；此处 re-export 保持旧 import 路径。
+export { OFFICE_EXT, BLIND_EXT }
 
 /** 官方 Tab 类型注册表服务名（ctx.get 用；不进 inject——旧版 DSH 无此包，inject 会停等）。 */
 export const OFFICIAL_TABS_SERVICE = 'sidebarRightTabs'
@@ -33,55 +39,14 @@ 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/**`，回落官方预览/提示。
+ * 注：用户经设置 nativeOpenExts 追加的范围不走本函数，由 claim 的 canOpen 与
+ * 文件树 openFile 叠加 nativeOpenStore 判定（见 registerOfficialFileClaim）。
  * @author ddj 2026年09月18号
  * @param path 文件路径（工作区相对或绝对）
  * @returns 是否让位官方
@@ -374,11 +339,12 @@ export function registerOfficialFileClaim(options: {
       kind: OFFICIAL_FILE_KIND,
       patterns: [OFFICIAL_FILE_PATTERN],
       priority: 'extension',
-      // 畸形/解码失败地址否决 + Office/不可预览后缀让位官方：回落官方查看器，不产生白屏 Tab
+      // 畸形/解码失败地址否决 + Office/不可预览后缀让位官方 + 用户配置的原生打开范围
+      //（nativeOpenExts）同步让位——否则认领会把 openResource 又转发回本插件（原生打开失效）
       canOpen: (address: string) => {
         const parsed = parseOfficialFileAddress(address)
         if (parsed === null) return false
-        return !deferToOfficial(parsed.path)
+        return !deferToOfficial(parsed.path) && !inNativePath(parsed.path)
       },
       title: (address: string) => officialFileTitle(address),
     })

package/src/client/openWithDialog.ts

@@ -0,0 +1,66 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 「打开方式…」选择弹窗（资源管理器右键、文件目标专属）。
+ * 列出 fileOpeners 注册表中当前可用的打开器（本插件/官方侧栏/系统等），
+ * 选中即调用该打开器 open()；复用 ModalShell 视觉，Esc/遮罩/取消 = 不打开。
+ * 作者 ddj 2026年09月22号
+ */
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+import { availableOpeners, isAvailable } from './fileOpeners.js'
+import { ModalShell } from './ui/ModalShell.js'
+
+/** 打开器列表行样式（列表为一次性选择器，不进 editor.css 的常驻样式表）。 */
+const ITEM_STYLE = {
+  display: 'flex', flexDirection: 'column', gap: 2, width: '100%', textAlign: 'left',
+  padding: '8px 10px', marginBottom: 6, borderRadius: 6, cursor: 'pointer',
+}
+
+/** 打开器选择卡片（ModalShell 内容）。 */
+function OpenWithCard({ openers, onPick, onCancel }) {
+  return React.createElement(React.Fragment, null,
+    React.createElement('h3', null, '打开方式…'),
+    openers.map((opener) => React.createElement('button', {
+      key: opener.id,
+      style: ITEM_STYLE,
+      title: opener.description || opener.label,
+      onClick: () => onPick(opener),
+    },
+      React.createElement('span', null, opener.label),
+      opener.description ? React.createElement('span', { style: { fontSize: 12, opacity: 0.7 } }, opener.description) : null)),
+    React.createElement('div', { className: 'vsm-mcp-dialog-actions' },
+      React.createElement('button', { onClick: onCancel }, '取消')))
+}
+
+/**
+ * 弹出打开器选择弹窗；选中后立即以该打开器打开目标文件。
+ * @author ddj 2026年09月22号
+ * @param registry 文件打开器注册表
+ * @param context 打开上下文（会话/工作区）
+ * @param path 目标文件（工作区相对）
+ * @param onDone 结果回调（opened = 实际使用的打开器；null = 取消/未打开），反馈文案由调用方接线
+ */
+export function openWithDialog(registry, context, path, onDone) {
+  const openers = availableOpeners(registry)
+  if (!openers.length) {
+    onDone?.(null)
+    return
+  }
+  const host = document.createElement('div')
+  document.body.appendChild(host)
+  const root = createRoot(host)
+  const close = () => {
+    root.unmount()
+    host.remove()
+  }
+  const pick = (opener) => {
+    close()
+    if (!isAvailable(opener)) {
+      onDone?.(null)
+      return
+    }
+    Promise.resolve(opener.open(path, context)).then(() => onDone?.(opener)).catch(() => onDone?.(null))
+  }
+  root.render(React.createElement(ModalShell, { onClose: () => { close(); onDone?.(null) } },
+    React.createElement(OpenWithCard, { openers, onPick: pick, onCancel: () => { close(); onDone?.(null) } })))
+}

package/src/client/outline/index.ts

@@ -5,7 +5,7 @@
  * 作者 ddj 2026-08-27
  */
 import React from 'react'
-import { IconCodeOutline16 } from '@deepseek-ai/dsh-client-ui-primitives'
+import { IconCodeOutline16 } from '../ui/icons.js'
 import { OutlinePanel } from './OutlinePanel.js'
 import type { SidebarPanelDef, SidebarCtx } from '../sidebar/types.js'
 

package/src/client/pdf/pdfPanel.ts

@@ -28,6 +28,7 @@ export function createPdfPanel(deps) {
 
   let stage = null
   let pageLabel = null
+  let zoomLabel = null
   let eventBus = null
   let busAbort = null
   let editorTypes = null
@@ -52,6 +53,15 @@ export function createPdfPanel(deps) {
     pageLabel.textContent = pdfViewer.currentPageNumber + ' / ' + pdfViewer.pagesCount
   }
 
+  /**
+   * 缩放百分比指示更新（scalechanging/pagesinit 事件；与图片预览的 x% 文本同款对齐）。
+   * @author ddj 2026年09月22号
+   */
+  const updateZoomLabel = () => {
+    if (!zoomLabel || !(pdfViewer && pdfViewer.currentScale > 0)) return
+    zoomLabel.textContent = Math.round(pdfViewer.currentScale * 100) + '%'
+  }
+
   /** 编辑模式按钮高亮同步（annotationeditormodechanged 事件；evt.mode 为枚举数值）。 */
   const syncModeButtons = (mode) => {
     if (!modeButtons || !editorTypes) return
@@ -136,8 +146,13 @@ export function createPdfPanel(deps) {
     pageLabel.textContent = '…'
     bar.appendChild(pageLabel)
     mkBtn('▶', '下一页', () => { if (pdfViewer) pdfViewer.currentPageNumber = Math.min(pdfViewer.pagesCount, pdfViewer.currentPageNumber + 1) })
+    // 缩放语义与图片预览对齐（0.1.7 官方统一缩放）：初始 page-width、edrv-pill 步进按钮与百分比指示同款
     mkBtn('−', '缩小', () => { try { pdfViewer.decreaseScale() } catch { /* 缩放失败忽略 */ } }, 'edrv-pill edrv-pill-ghost edrv-pdf-zoom')
     mkBtn('＋', '放大', () => { try { pdfViewer.increaseScale() } catch { /* 缩放失败忽略 */ } }, 'edrv-pill edrv-pill-ghost edrv-pdf-zoom')
+    zoomLabel = document.createElement('span')
+    zoomLabel.className = 'edrv-pdf-page'
+    zoomLabel.textContent = '…'
+    bar.appendChild(zoomLabel)
     bar.appendChild(document.createElement('span')).className = 'edrv-pdf-sep'
     const modes = {}
     modes.freetext = mkBtn('✎ 文本框', '插入文本框注释', () => applyMode('freetext'))
@@ -190,9 +205,11 @@ export function createPdfPanel(deps) {
       })
       linkService.setViewer(pdfViewer)
       onBus('pagechanging', updatePageLabel)
+      onBus('scalechanging', updateZoomLabel)
       onBus('pagesinit', () => {
         try { pdfViewer.currentScaleValue = 'page-width' } catch { /* 初始缩放失败用默认值 */ }
         updatePageLabel()
+        updateZoomLabel()
       })
       onBus('annotationeditormodechanged', (evt) => syncModeButtons(evt?.mode))
 
@@ -233,6 +250,7 @@ export function createPdfPanel(deps) {
     pdfDocument = null
     loadingTask = null
     modeButtons = null
+    zoomLabel = null
   }
 
   return { mount, destroy, savePdf, isDirty }

package/src/client/searchSeed.ts

@@ -62,3 +62,39 @@ export function takeSearchSeed(): string {
 export function clearSearchSeed(): void {
   pendingSeed = null
 }
+
+// --region 目录过滤种子（「在文件夹中查找…」：SearchPanel 消费后置 include 过滤）
+
+/** 待消费的目录过滤种子（'' = 无）。 */
+let pendingScope: string | null = null
+
+/**
+ * 写入待消费的目录过滤种子（空目录等价于清除）。
+ * @author ddj 2026年09月22号
+ * @param dir 目标目录（工作区相对；空 = 根 = 不限定目录）
+ */
+export function setSearchScope(dir: unknown): void {
+  const text = String(dir ?? '').trim().replace(/\\/g, '/').replace(/\/+$/, '')
+  pendingScope = text ? text : null
+}
+
+/**
+ * 取走待消费的目录过滤种子（取后即清空，与 query 种子同一一次性消费语义）。
+ * @author ddj 2026年09月22号
+ * @returns 目录相对路径；无待消费种子返回空串
+ */
+export function takeSearchScope(): string {
+  const scope = pendingScope
+  pendingScope = null
+  return scope ?? ''
+}
+
+/**
+ * 清空待消费的目录过滤种子（测试隔离用）。
+ * @author ddj 2026年09月22号
+ */
+export function clearSearchScope(): void {
+  pendingScope = null
+}
+
+// --endregion

package/src/client/settingsContext.ts

@@ -1,7 +1,8 @@
 /**
  * dsh-vscode-mode client — 设置 scope 的跨组件上下文。
- * 绑定逻辑（webUiSettings 兼容桥 → 官方 settingsScope 降级）统一由 compat 层提供。
- * 作者 ddj 2026年08月24号
+ * 绑定逻辑（configForms 0.1.7+ → webUiSettings 兼容桥 → 官方 settingsScope 降级，
+ * 带晚到有界重试）统一由 compat 层提供。
+ * 作者 ddj 2026年08月24号 / 2026年09月22号
  */
 import React from 'react'
 import { pickSettingsBinder, type SettingsScopeLike } from './compat.js'
@@ -11,8 +12,9 @@ export type { SettingsScopeLike }
 export const SettingsContext = React.createContext<SettingsScopeLike | undefined>(undefined)
 
 /**
- * 从 Cordis 服务绑定 VSCodeMode 设置 scope（兼容桥优先，官方次之）。
- * @author ddj 2026年08月24号
+ * 从 Cordis 服务绑定 VSCodeMode 设置 scope（四级桥：configForms/webUiSettings/settingsScope/无）。
+ * 每次调用重新探测——设置提供方晚到时后续渲染自然拿到新桥（自愈）。
+ * @author ddj 2026年08月24号（2026年09月22号 增补 configForms 级）
  * @param ctx 客户端服务上下文
  * @returns 设置 scope 或 undefined
  */