dsh-vscode-mode 0.7.0 → 0.9.0

package/src/client/addToConversation.ts

@@ -264,6 +264,138 @@ export interface CtxLike {
   get: (name: string) => unknown
 }
 
+/** 新建会话结果（ok=false 供调用方降级回当前对话注入）。 */
+export interface DraftSessionResult {
+  ok: boolean
+  /** 新会话 id（ok=true 时存在；投递命令按它内嵌）。 */
+  id?: string
+}
+
+/** apiproxy wire 端点（POST /api/<method>；浏览器同源 fetch 自带 cookie 鉴权；实证 401=未鉴权而非 404）。 */
+const SESSION_CREATE_PATH = '/api/session/create'
+/** apiproxy wire 端点：发送任务（session/prompt；点击即发送方案）。 */
+const SESSION_PROMPT_PATH = '/api/session/prompt'
+
+/** mint RPC 请求 id（RpcId 品牌类型运行时即普通字符串）。 */
+function mintRpcId(): string {
+  try {
+    return globalThis.crypto?.randomUUID?.() ?? ('rpc-' + Date.now())
+  } catch {
+    return 'rpc-' + Date.now()
+  }
+}
+
+/**
+ * RPC 返回解析（照官方 dsh-client-runtime 调用形态：`const { result } = await api.sessions.create(...)`）。
+ * 官方 api.sessions 面返回**信封** `{ rpcId, result: RpcResult }`——须解 .result；
+ * 兼容裸 RpcResult 形态（个别补丁面直接回 {ok, value}）。
+ * @author ddj 2026年09月23号
+ * @param res 信封或裸 RpcResult
+ * @returns 归一后的 { ok, value }
+ */
+function rpcOk(res: unknown): { ok: boolean; value?: unknown } {
+  const envelope = (res as { result?: unknown } | null)?.result
+  const r = (envelope ?? res) as { ok?: boolean; value?: unknown } | null
+  return { ok: r?.ok === true, value: r?.value }
+}
+
+/**
+ * wire 直调 session/create（主路径）：ClientRequest 信封 → ServerResponse.result（RpcResult 形态）。
+ * 契约以当前安装版 dsh-host-apiproxy 为准（api/sessions.d.ts「Method signatures are the
+ * source of truth」）：`create({cwd}) → {sessionId}`；信封 = `{type:'client-request', rpcId,
+ * method, payload}` → `{result: {ok:true, value:{sessionId}} | {ok:false, error}}`。
+ * @author ddj 2026年09月23号
+ * @param cwd 新会话工作区目录
+ * @returns 新会话 id（失败空串）
+ */
+async function apiSessionCreate(cwd: string | undefined): Promise<string> {
+  const res = await fetch(SESSION_CREATE_PATH, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      type: 'client-request',
+      rpcId: mintRpcId(),
+      method: 'session/create',
+      payload: cwd ? { cwd } : {},
+    }),
+  })
+  const json = await res.json().catch(() => null) as { result?: { ok?: boolean; value?: { sessionId?: unknown } } } | null
+  const id = json?.result?.value?.sessionId
+  return json?.result?.ok === true && typeof id === 'string' ? id : ''
+}
+
+/**
+ * wire 直发 session/prompt（点击即发送方案）：任务文本投给目标会话 agent。
+ * 契约 = 当前安装树 SessionsApi.prompt：`{sessionId, mode:'queue', content:[{type:'text',text}]}`。
+ * 发送成功会话即有内容 → 不再被 blank 隐藏（列表可见）。
+ * @author ddj 2026年09月23号
+ * @param sessionId 目标会话 id（新会话）
+ * @param text 任务文本
+ * @returns 是否受理
+ */
+export async function apiSessionPrompt(sessionId: string, text: string): Promise<boolean> {
+  try {
+    const res = await fetch(SESSION_PROMPT_PATH, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        type: 'client-request',
+        rpcId: mintRpcId(),
+        method: 'session/prompt',
+        payload: { sessionId, mode: 'queue', content: [{ type: 'text', text }] },
+      }),
+    })
+    const json = await res.json().catch(() => null) as { result?: { ok?: boolean } } | null
+    return json?.result?.ok === true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 新建独立会话承载旁路任务（02-deep-session-prompt：深度分析不污染当前对话）。
+ * 主路径 = apiproxy wire 直调（不依赖 service 面形态猜测）；回落 remote.session.create
+ * 与旧 sessions.create 两代 service 面（宽松解析）。任一步不符返回 ok:false，调用方降级。
+ * @author ddj 2026年09月23号
+ * @param ctx 客户端服务上下文（remote.session + sessions，仅回落用）
+ * @param cwd 新会话工作区目录（与当前会话同工作区）
+ * @returns 新会话结果（含 id）
+ */
+export async function newDraftSession(ctx: CtxLike, cwd: string | undefined): Promise<DraftSessionResult> {
+  // 主路径：wire 直调
+  try {
+    const id = await apiSessionCreate(cwd)
+    if (id) return { ok: true, id }
+  } catch { /* wire 不可用：回落 service 面 */ }
+  try {
+    // 回落 1：remote.session service 面（官方返回信封 {rpcId, result}，见 rpcOk；实参双形态兼容）
+    const remote = ctx.get('remote.session') as {
+      create?: (req: unknown) => Promise<unknown>
+    } | undefined
+    if (typeof remote?.create === 'function') {
+      const payload = cwd ? { cwd } : {}
+      for (const arg of [payload, { rpcId: mintRpcId(), payload }]) {
+        const r = rpcOk(await remote.create(arg))
+        const id = r.value as { sessionId?: unknown } | undefined
+        if (r.ok && typeof id?.sessionId === 'string') return { ok: true, id: id.sessionId }
+      }
+    }
+    // 回落 2：旧版 client store 形态（id / {id} / {sessionId} / {session:{id}} 四解）
+    const sessions = ctx.get('sessions') as { create?: (opts?: { cwd?: string }) => unknown } | undefined
+    if (typeof sessions?.create === 'function') {
+      const created = await sessions.create(cwd ? { cwd } : undefined)
+      const id = typeof created === 'string' && created ? created
+        : typeof (created as { id?: unknown } | null)?.id === 'string' ? (created as { id: string }).id
+        : typeof (created as { sessionId?: unknown } | null)?.sessionId === 'string' ? (created as { sessionId: string }).sessionId
+        : typeof (created as { session?: { id?: unknown } } | null)?.session?.id === 'string'
+          ? (created as { session: { id: string } }).session.id
+          : ''
+      if (id) return { ok: true, id }
+    }
+  } catch { /* 全部失败：调用方降级 */ }
+  return { ok: false }
+}
+
 /** 注入器产物：给 EditorView 用的动作集合。 */
 export interface AddToConversation {
   /** 追加文件/文件夹引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
@@ -273,6 +405,12 @@ export interface AddToConversation {
     range?: RefRange,
     appearance?: RefAppearance,
   ): Promise<AddOutcome>
+  /** 追加纯文本（AI 深度分析任务等长文本注入；插到当前光标，失败不整篇重建）。 */
+  appendText(sessionId: string | undefined, text: string): Promise<AddOutcome>
+  /** 新建独立会话并切换（旁路任务隔离；失败 ok:false 供降级回当前对话）。 */
+  startDraftSession(cwd?: string): Promise<DraftSessionResult>
+  /** 发送任务给目标会话 agent（点击即发送；失败 false 供降级）。 */
+  sendTask(sessionId: string | undefined, text: string): Promise<boolean>
 }
 
 /**
@@ -392,5 +530,69 @@ export function createAddToConversation(ctx: CtxLike): AddToConversation {
     return 'failed'
   }
 
-  return { appendReference }
+  /**
+   * 追加纯文本（AI 深度分析任务注入）：走官方 plain-text 通道插到当前光标。
+   * 失败语义与 appendReference 一致：宁可不写也不整篇重建（保护既有 chip）。
+   * @author ddj 2026年09月23号
+   * @param sessionId 会话 id
+   * @param text 待注入文本
+   * @returns 注入结果（ok / unavailable / failed）
+   */
+  const appendText: AddToConversation['appendText'] = async (sessionId, text) => {
+    const input = inputFor(ctx, sessionId)
+    if (!input) return 'unavailable'
+    const cur = draftCursor(input)
+    if (!cur) return 'unavailable'
+    const at = insertOffsetOf(caretOf(input), detectEndOf(cur))
+    const span: TokenSpanLike = { start: at, end: at, draftRev: cur.draftRev }
+    return safeInsertText(input, text, span) ? 'ok' : 'failed'
+  }
+
+  /**
+   * 新建独立会话（02-deep-session-prompt：旁路任务不污染当前对话）。
+   * 闭包持有真服务 ctx（面板 SidebarCtx 无 .get，会话操作必须经此门面）；
+   * 创建后尽力 `sessions.open(id)` 切换视图（缺失不致命，草稿仍可写入）。
+   * @author ddj 2026年09月23号
+   * @param cwd 新会话工作区目录（与当前会话同工作区）
+   * @returns 新会话结果（失败供降级）
+   */
+  const startDraftSession: AddToConversation['startDraftSession'] = async (cwd) => {
+    const result = await newDraftSession(ctx, cwd)
+    if (result.ok && result.id) {
+      // 尽力切换到新会话（缺失/异常不影响结果——仅视图不切换）
+      try {
+        const sessions = ctx.get('sessions') as { open?: (id: string) => void } | undefined
+        sessions?.open?.(result.id)
+      } catch { /* 切换失败仅视图停留 */ }
+    }
+    return result
+  }
+
+  /**
+   * 发送任务给目标会话 agent（点击即发送方案：任务落地会话即非 blank，列表可见）。
+   * 主路径 wire 直发 session/prompt；回落 remote.session.prompt service 面。
+   * @author ddj 2026年09月23号
+   * @param sessionId 目标会话 id
+   * @param text 任务文本
+   * @returns 是否受理
+   */
+  const sendTask: AddToConversation['sendTask'] = async (sessionId, text) => {
+    if (!sessionId) return false
+    try {
+      if (await apiSessionPrompt(sessionId, text)) return true
+    } catch { /* 回落 service 面 */ }
+    try {
+      const remote = ctx.get('remote.session') as { prompt?: (req: unknown) => Promise<unknown> } | undefined
+      if (typeof remote?.prompt === 'function') {
+        // 官方 api.sessions.prompt(request) 返回信封（rpcOk 解 .result）；实参双形态兼容
+        const payload = { sessionId, mode: 'queue', content: [{ type: 'text', text }] }
+        for (const arg of [payload, { rpcId: mintRpcId(), payload }]) {
+          if (rpcOk(await remote.prompt(arg)).ok) return true
+        }
+      }
+    } catch { /* 全失败 */ }
+    return false
+  }
+
+  return { appendReference, appendText, startDraftSession, sendTask }
 }

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')
 }