dsh-vscode-mode 0.14.6 → 0.14.8

package/src/svnExplorerCache.ts

@@ -0,0 +1,304 @@
+/** Host-only scoped SVN index and single-flight invalidation queue. @author ddj 2026年10月10号 */
+import type { SvnChangeEntry, SvnItemStatus } from './shared/svn.js'
+import { SVN_FOLDER_STATUS_RANK } from './shared/svn.js'
+import { explorerMarkOf, localStatusOf } from './shared/svnExplorer.js'
+import type { SvnExplorerIndex } from './shared/svnExplorer.js'
+import { EXPLORER_CAP } from './svnExplorer.js'
+
+export interface ExplorerScan { entries: SvnChangeEntry[]; truncated: boolean; roots?: readonly string[] }
+export type ExplorerScanner = (paths: readonly string[], signal: AbortSignal) => Promise<ExplorerScan>
+export interface ExplorerChange { paths?: readonly string[]; full?: boolean; event?: string }
+export interface ExplorerState {
+  revision: number; generation: number; observedGeneration: number; confirmedAt: number; complete: boolean
+  refreshing: boolean; scanMs: number; error: string
+}
+type StatusCounts = Map<SvnItemStatus, number>
+const QUIET_MS = 300
+const MAX_WAIT_MS = 1000
+const EVENT_CAP = 512
+
+// --region Path sets and normalization
+/** @public @author ddj 2026年10月10号 @param path Validated relative path. @param windows Case-insensitive platform. @returns Canonical lookup key, preserving row spelling separately. */
+export function explorerKey(path: string, windows = process.platform === 'win32'): string {
+  const normalized = path.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/+$/, '')
+  return windows ? normalized.toLowerCase() : normalized
+}
+/** @private @author ddj 2026年10月10号 @param path Canonical descendant. @param root Canonical subtree. @returns Segment-bound membership including root. */
+function within(path: string, root: string): boolean { return !root || path === root || path.startsWith(root + '/') }
+/** @private @author ddj 2026年10月10号 @param path Canonical entry. @returns Ancestors excluding virtual scope root. */
+function ancestors(path: string): string[] {
+  const parents: string[] = []
+  let parent = path
+  while (parent.includes('/')) { parent = parent.slice(0, parent.lastIndexOf('/')); parents.push(parent) }
+  return parents
+}
+/** @public @author ddj 2026年10月10号 @param paths Changed paths. @param windows Platform matching. @returns Minimal parent subtree set; empty root means full scan. */
+export function scanRootsOf(paths: readonly string[], windows = process.platform === 'win32'): string[] {
+  const roots: string[] = []
+  for (const raw of paths) {
+    const path = explorerKey(raw, windows)
+    const parent = path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : ''
+    if (roots.some((root) => within(parent, root))) continue
+    for (let i = roots.length - 1; i >= 0; i--) if (within(roots[i], parent)) roots.splice(i, 1)
+    roots.push(parent)
+  }
+  return roots
+}
+// --endregion
+
+// --region Incremental subtree index
+/** @public @author ddj 2026年10月10号 Retains authoritative entries and decrementable ancestor counts; no client-wide payload. */
+export class ExplorerIndex {
+  readonly index: SvnExplorerIndex = { entries: new Map(), folders: new Map(), truncated: false }
+  private readonly counts = new Map<string, StatusCounts>()
+  private readonly children = new Map<string, Set<string>>()
+  /** @public @author ddj 2026年10月10号 @param windows Case-insensitive lookup mode. */
+  constructor(private readonly windows = process.platform === 'win32') {}
+
+  /** @private @author ddj 2026年10月10号 @param entry Entry contribution. @param delta Add or remove. Updates strongest status after downgrade. */
+  private contribute(entry: SvnChangeEntry, delta: number): void {
+    const status = localStatusOf(entry)
+    if (status === 'normal' || status === 'ignored' || status === 'external') return
+    for (const parent of ancestors(entry.path)) {
+      const counts = this.counts.get(parent) ?? new Map<SvnItemStatus, number>()
+      const next = (counts.get(status) ?? 0) + delta
+      if (next > 0) counts.set(status, next)
+      else counts.delete(status)
+      if (!counts.size) { this.counts.delete(parent); this.index.folders.delete(parent); continue }
+      this.counts.set(parent, counts)
+      let strongest: SvnItemStatus = 'normal'
+      let count = 0
+      for (const [item, n] of counts) {
+        count += n
+        if ((SVN_FOLDER_STATUS_RANK[item] ?? 0) > (SVN_FOLDER_STATUS_RANK[strongest] ?? 0)) strongest = item
+      }
+      this.index.folders.set(parent, { status: strongest, count })
+    }
+  }
+
+  /** @private @author ddj 2026年10月10号 @param path Canonical entry. Build direct child membership, including implicit ancestors. */
+  private link(path: string): void {
+    let child = path
+    while (child) {
+      const parent = child.includes('/') ? child.slice(0, child.lastIndexOf('/')) : ''
+      const siblings = this.children.get(parent) ?? new Set<string>()
+      siblings.add(child); this.children.set(parent, siblings)
+      child = parent
+    }
+  }
+  /** @private @author ddj 2026年10月10号 @param path Removed entry. Prune only empty implicit ancestors; retained siblings remain indexed. */
+  private unlink(path: string): void {
+    let child = path
+    while (child && !this.index.entries.has(child) && !this.children.get(child)?.size) {
+      const parent = child.includes('/') ? child.slice(0, child.lastIndexOf('/')) : ''
+      this.children.delete(child)
+      const siblings = this.children.get(parent)
+      siblings?.delete(child)
+      if (!siblings?.size) this.children.delete(parent)
+      child = parent
+    }
+  }
+  /** @private @author ddj 2026年10月10号 @param roots Subtree membership roots. @returns Retained affected entries only; no whole-index iteration for local replacement. */
+  private members(roots: readonly string[]): string[] {
+    const result = new Set<string>(), pending = [...roots], visited = new Set<string>()
+    while (pending.length) {
+      const path = pending.pop()!
+      if (visited.has(path)) continue
+      visited.add(path)
+      if (this.index.entries.has(path)) result.add(path)
+      for (const child of this.children.get(path) ?? []) pending.push(child)
+    }
+    return [...result]
+  }
+
+  /** @public @author ddj 2026年10月10号 @param roots Replaced session-relative subtrees. @param result Complete or bounded scan. @throws Capacity mismatch on partial replacement; caller must full-calibrate. */
+  replace(roots: readonly string[], result: ExplorerScan): void {
+    const keys = roots.map((root) => explorerKey(root, this.windows))
+    const full = keys.includes('')
+    const incoming = new Map<string, SvnChangeEntry>()
+    for (const entry of result.entries) {
+      const path = explorerKey(entry.path, this.windows)
+      if (keys.some((root) => within(path, root))) incoming.set(path, { ...entry, path })
+    }
+    const removed = full ? [] : this.members(keys)
+    if (!full && (result.truncated || this.index.entries.size - removed.length + incoming.size > EXPLORER_CAP)) {
+      throw new Error('局部 SVN 状态不完整，需要全量校准')
+    }
+    if (full) this.clear()
+    else for (const path of removed) {
+      this.contribute(this.index.entries.get(path)!, -1)
+      this.index.entries.delete(path)
+      this.unlink(path)
+    }
+    for (const [path, entry] of incoming) { this.index.entries.set(path, entry); this.link(path); this.contribute(entry, 1) }
+    if (full) this.index.truncated = result.truncated
+  }
+
+  /** @public @author ddj 2026年10月10号 Release retained entries and aggregation counters. */
+  clear(): void { this.index.entries.clear(); this.index.folders.clear(); this.counts.clear(); this.children.clear() }
+
+  /** @public @author ddj 2026年10月10号 @param path Display row spelling. @param isDir Directory row. @returns Exact/ancestor mark and dirty descendant count. */
+  mark(path: string, isDir: boolean) {
+    const key = explorerKey(path, this.windows)
+    return { mark: explorerMarkOf(this.index, key, isDir), count: isDir ? this.index.folders.get(key)?.count ?? 0 : 0 }
+  }
+}
+// --endregion
+
+// --region Scoped ownership
+/** @public @author ddj 2026年10月10号 Two retained scope indexes; active work is never evicted to satisfy a new reader. */
+export class ExplorerScopes {
+  private readonly scopes = new Map<string, ExplorerQueue>()
+  /** @public @author ddj 2026年10月10号 @param key Canonical root/session key. @param scan Scanner bound to this scope. @param now Clock. @param windows Matching. @returns Shared owner; refuses new scopes if all retained owners are busy. */
+  get(key: string, scan: ExplorerScanner, now = Date.now, windows = process.platform === 'win32'): ExplorerQueue {
+    const existing = this.scopes.get(key)
+    if (existing) { this.scopes.delete(key); this.scopes.set(key, existing); return existing }
+    if (this.scopes.size >= 2) {
+      const idle = [...this.scopes].find(([, queue]) => queue.idle())
+      if (!idle) throw new Error('SVN 状态扫描繁忙，请稍后重试')
+      idle[1].dispose()
+      this.scopes.delete(idle[0])
+    }
+    const queue = new ExplorerQueue(scan, now, windows)
+    this.scopes.set(key, queue)
+    return queue
+  }
+  /** @public @author ddj 2026年10月10号 Release all scoped work and retained state. */
+  dispose(): void { for (const queue of this.scopes.values()) queue.dispose(); this.scopes.clear() }
+}
+// --endregion
+
+// --region Single-flight dirty queue
+/** @public @author ddj 2026年10月10号 Coalesces generations without swallowing changes arriving during a scan. */
+export class ExplorerQueue {
+  readonly data: ExplorerIndex
+  private generation = 0
+  private observed = 0
+  private revision = 0
+  private confirmedAt = 0
+  private scanMs = 0
+  private error = ''
+  private fullDirty = false
+  private readonly dirty = new Set<string>()
+  private active: readonly string[] | null = null
+  private timer: ReturnType<typeof setTimeout> | null = null
+  private pendingSince: number | null = null
+  private lastEventAt = 0
+  private controller: AbortController | null = null
+  private flight: Promise<void> | null = null
+  private stopped = false
+  private readonly events = new Set<string>()
+  private staleRoots: readonly string[] | null = null
+
+  /** @public @author ddj 2026年10月10号 @param scan Managed scoped scan. @param now Injectable clock. @param windows Canonical path matching. */
+  constructor(private readonly scan: ExplorerScanner, private readonly now = Date.now, private readonly windows = process.platform === 'win32') {
+    this.data = new ExplorerIndex(windows)
+  }
+
+  /** @public @author ddj 2026年10月10号 @param change Path/full invalidation and idempotency token. @returns Whether a new change was registered. */
+  invalidate(change: ExplorerChange = { full: true }): boolean {
+    if (this.stopped || (change.event && this.events.has(change.event))) return false
+    if (change.event) {
+      this.events.add(change.event)
+      if (this.events.size > EVENT_CAP) this.events.delete(this.events.values().next().value!)
+    }
+    this.generation++
+    this.staleRoots = null
+    this.lastEventAt = this.now()
+    if (this.pendingSince === null) this.pendingSince = this.lastEventAt
+    if (change.full || !change.paths?.length || !this.confirmedAt || this.data.index.truncated) this.fullDirty = true
+    for (const path of change.paths ?? []) this.dirty.add(explorerKey(path, this.windows))
+    if (this.dirty.size > 256 || scanRootsOf([...this.dirty], this.windows).length > 32) this.fullDirty = true
+    if (this.fullDirty) this.dirty.clear()
+    this.schedule()
+    return true
+  }
+
+  /** @private @author ddj 2026年10月10号 Tail debounce has a hard max wait; active scans retain one merged follow-up batch. */
+  private schedule(): void {
+    if (this.stopped || this.active || this.pendingSince === null) return
+    if (this.timer) clearTimeout(this.timer)
+    const delay = Math.max(0, Math.min(this.lastEventAt + QUIET_MS, this.pendingSince + MAX_WAIT_MS) - this.now())
+    this.timer = setTimeout(() => { this.timer = null; this.launch() }, delay)
+  }
+
+  /** @private @author ddj 2026年10月10号 Starts one scan, snapshots generation and dirtiness before yielding. */
+  private launch(): void {
+    if (this.stopped || this.active || this.pendingSince === null) return
+    const roots = this.fullDirty ? [''] : scanRootsOf([...this.dirty], this.windows)
+    const generation = this.generation
+    this.fullDirty = false
+    this.dirty.clear()
+    this.pendingSince = null
+    this.active = roots
+    this.staleRoots = null
+    this.controller = new AbortController()
+    this.flight = this.run(roots, generation, this.controller.signal)
+  }
+
+  /** @private @author ddj 2026年10月10号 @param roots Scan subtrees. @param generation Captured invalidation generation. @param signal Owner disposal. Applies known evidence but never confirms newer dirty paths. */
+  private async run(roots: readonly string[], generation: number, signal: AbortSignal): Promise<void> {
+    const started = this.now()
+    try {
+      const result = await this.scan(roots, signal)
+      if (this.stopped) return
+      this.data.replace(result.roots ?? roots, result)
+      this.observed = generation
+      this.revision++
+      this.error = ''
+      if (generation === this.generation && !result.truncated) this.confirmedAt = this.now()
+    } catch (failure) {
+      if (this.stopped) return
+      this.error = String(failure)
+      // A failed subtree must not keep green evidence. Retry only on a later read/event, not a spin loop.
+      this.fullDirty = true
+    } finally {
+      this.scanMs = Math.max(0, this.now() - started)
+      this.active = null
+      this.staleRoots = null
+      this.controller = null
+      this.flight = null
+      this.schedule()
+    }
+  }
+
+  /** @public @author ddj 2026年10月10号 @param path Display row. @param isDir Directory membership. @returns Whether evidence intersects active/queued changes or incomplete state. */
+  stale(path: string, isDir: boolean): boolean {
+    if (!this.confirmedAt || this.fullDirty || this.data.index.truncated) return true
+    const key = explorerKey(path, this.windows)
+    const roots = this.staleRoots ??= [...(this.active ?? []), ...scanRootsOf([...this.dirty], this.windows)]
+    return roots.some((root) => within(key, root) || (isDir && within(root, key)))
+  }
+
+  /** @public @author ddj 2026年10月10号 @returns Lightweight scope metadata; freshness is independent of cache TTL. */
+  state(): ExplorerState {
+    return { revision: this.revision, generation: this.generation, observedGeneration: this.observed, confirmedAt: this.confirmedAt,
+      complete: this.confirmedAt > 0 && !this.data.index.truncated && !this.fullDirty && !this.active && !this.dirty.size,
+      refreshing: this.active !== null || this.timer !== null, scanMs: this.scanMs, error: this.error }
+  }
+
+  /** @public @author ddj 2026年10月10号 @returns First-load confirmation; warm callers project immediately with stale flags. */
+  async initial(): Promise<void> {
+    if (this.stopped) throw new Error('SVN 状态调度已释放')
+    if (this.confirmedAt || this.revision || this.error) return
+    if (this.pendingSince === null && !this.active) this.invalidate({ full: true })
+    if (this.timer) { clearTimeout(this.timer); this.timer = null }
+    this.launch()
+    await this.flight
+  }
+
+  /** @public @author ddj 2026年10月10号 @returns Whether an owner may evict this scope without killing shared work. */
+  idle(): boolean { return !this.active && !this.timer }
+
+  /** @public @author ddj 2026年10月10号 Abort owned scans and timers; late completions cannot restore state. */
+  dispose(): void {
+    this.stopped = true
+    if (this.timer) clearTimeout(this.timer)
+    this.timer = null
+    this.controller?.abort(new Error('SVN 状态调度已释放'))
+    this.dirty.clear()
+    this.events.clear()
+    this.data.clear()
+  }
+}
+// --endregion

package/src/svnStatusStream.ts

@@ -0,0 +1,135 @@
+/** Bounded SVN XML framing; retain statuses, never the entire verbose document. @author ddj 2026年10月09号 */
+import { StringDecoder } from 'node:string_decoder'
+import type { Readable } from 'node:stream'
+import { attrOf } from './svnXml.js'
+import type { SvnChangeEntry } from './shared/svn.js'
+
+export interface StatusPipe {
+  stdout?: Readable | null
+  done: Promise<{ exitCode?: number | null; code?: number | null }>
+  terminate?: () => unknown
+  collected?: { stderr?: { readFrom: (offset: number) => { text: string } } }
+}
+
+/** @public @author ddj 2026年10月09号 @param handle Managed pipe process. @param parse Status semantics. @param cap Entry bound. @param timeout Deadline. @returns EOF-validated statuses. @throws CLI, timeout or framing failure; never retries with inherit. */
+export async function readStatusPipe(handle: StatusPipe, parse: StatusParser, cap: number, timeout: number, signal?: AbortSignal) {
+  const reader = new SvnStatusReader(parse, cap)
+  /** @private @author ddj 2026年10月09号 Consume raw chunks through stream EOF, not just direct process exit. */
+  async function consume(): Promise<void> {
+    if (!handle.stdout) throw new Error('SVN 状态管道不可用，未确认正常状态')
+    for await (const chunk of handle.stdout) reader.push(chunk)
+  }
+  let timer: ReturnType<typeof setTimeout> | undefined
+  const expired = new Promise<never>((_, reject) => {
+    timer = setTimeout(() => reject(new Error('读取 SVN 图标状态超时')), timeout)
+    timer.unref?.()
+  })
+  let abort: (() => void) | undefined
+  const cancelled = new Promise<never>((_, reject) => {
+    abort = () => reject(signal?.reason ?? new Error('SVN 状态扫描已取消'))
+    if (signal?.aborted) abort()
+    else signal?.addEventListener('abort', abort, { once: true })
+  })
+  try {
+    const [outcome] = await Promise.race([Promise.all([handle.done, consume()]), expired, cancelled])
+    if ((outcome.exitCode ?? outcome.code) !== 0) throw new Error(handle.collected?.stderr?.readFrom(0).text || 'SVN 状态命令失败')
+    return reader.finish()
+  } catch (error) {
+    // Keep managed teardown observable but do not mask the original failure.
+    try { await handle.terminate?.() } catch { /* Preserve CLI/stream failure. */ }
+    throw error
+  } finally {
+    if (timer) clearTimeout(timer)
+    if (abort) signal?.removeEventListener('abort', abort)
+  }
+}
+
+type StatusParser = (xml: string, cap: number) => { entries: SvnChangeEntry[]; truncated: boolean }
+const TAG_CAP = 64 * 1024
+const STREAM_CAP = 512 * 1024 * 1024
+
+/** @public @author ddj 2026年10月09号 Validates framing through EOF, including entries beyond the retained cap. */
+export class SvnStatusReader {
+  private readonly decoder = new StringDecoder('utf8')
+  private buffer = ''
+  private bytes = 0
+  private readonly stack: string[] = []
+  private opened = false
+  private closed = false
+  private entry = ''
+  private changelist = ''
+  private readonly entries: SvnChangeEntry[] = []
+  private truncated = false
+
+  /** @public @author ddj 2026年10月09号 @param parse Existing status semantics. @param cap Retained entry bound. */
+  constructor(private readonly parse: StatusParser, private readonly cap: number) {}
+
+  /** @public @author ddj 2026年10月09号 @param chunk Raw pipe chunk. @throws Byte/tag limits or invalid framing. */
+  push(chunk: Buffer | string): void {
+    this.bytes += Buffer.byteLength(chunk)
+    if (this.bytes > STREAM_CAP) throw new Error('SVN 状态流超过 512 MiB 安全上限')
+    this.feed(typeof chunk === 'string' ? chunk : this.decoder.write(chunk))
+  }
+
+  /** @private @author ddj 2026年10月09号 @param text Decoded chunk. Process each complete tag once; partial tags stay bounded. */
+  private feed(text: string): void {
+    this.buffer += text
+    let cursor = 0
+    while (cursor < this.buffer.length) {
+      const start = this.buffer.indexOf('<', cursor)
+      const end = start < 0 ? -1 : this.buffer.indexOf('>', start)
+      const tail = start < 0 ? this.buffer.length : start
+      if (!this.stack.length && this.buffer.slice(cursor, tail).trim()) this.invalid()
+      if (end < 0) { cursor = tail; break }
+      if (end - start > TAG_CAP) this.invalid()
+      this.tag(this.buffer.slice(start, end + 1))
+      cursor = end + 1
+    }
+    this.buffer = this.buffer.slice(cursor)
+    if (this.buffer.length > TAG_CAP) this.invalid()
+  }
+
+  /** @private @author ddj 2026年10月09号 @param token Complete XML tag. Validate nesting and capture only entry/wc-status attributes. */
+  private tag(token: string): void {
+    if (token.startsWith('<?xml ') && !this.opened && !this.stack.length) return
+    const match = /^<(\/?)([\w-]+)\b([^>]*?)(\/?)>$/.exec(token)
+    if (!match || this.closed) this.invalid()
+    const [, closing, name, attrs, self] = match!
+    if (closing) {
+      if (this.stack.pop() !== name) this.invalid()
+      if (name === 'entry') this.saveEntry()
+      if (name === 'changelist') this.changelist = ''
+      if (name === 'status') this.closed = true
+      return
+    }
+    if (!this.stack.length) {
+      if (name !== 'status' || this.opened || self) this.invalid()
+      this.opened = true
+    }
+    if (name === 'changelist') this.changelist = attrOf(attrs, 'name')
+    if (name === 'entry') this.entry = token.replace(/\/>$/, '>')
+    if (name === 'wc-status' && this.entry) this.entry += '<wc-status' + attrs + '/>'
+    if (!self) this.stack.push(name)
+    else if (name === 'entry') this.saveEntry()
+  }
+
+  /** @private @author ddj 2026年10月09号 Preserve existing property/tree-conflict/path semantics and bounded statuses. */
+  private saveEntry(): void {
+    const result = this.parse(this.entry + '</entry>', 1)
+    this.entry = ''
+    for (const entry of result.entries) {
+      if (this.entries.length >= this.cap) { this.truncated = true; continue }
+      this.entries.push(this.changelist ? { ...entry, changelist: this.changelist } : entry)
+    }
+  }
+
+  /** @private @author ddj 2026年10月09号 @throws Invalid/missing/truncated XML; never produces a clean snapshot. */
+  private invalid(): never { throw new Error('SVN 状态输出为空或不完整，未确认正常状态') }
+
+  /** @public @author ddj 2026年10月09号 @returns Confirmed snapshot only after complete stream EOF. @throws Invalid framing. */
+  finish(): { entries: SvnChangeEntry[]; truncated: boolean } {
+    this.feed(this.decoder.end())
+    if (!this.opened || !this.closed || this.stack.length || this.buffer.trim()) this.invalid()
+    return { entries: this.entries, truncated: this.truncated }
+  }
+}

package/unity/com.dsh.editor/Editor/DshCodeEditor.cs

@@ -15,8 +15,13 @@ namespace Dsh.EditorIntegration
     {
         private const string EditorName = "DSH 文件编辑";
         private const string VirtualPath = "dsh-editor://vscode-mode";
-        private const string DshVersion = "0.3.0";
+        private const string DshVersion = "0.3.1";
         internal const string VersionText = DshVersion;
+        private const string TargetAuto = "auto";
+        private const string TargetWeb = "web";
+        private const string TargetDesktop = "desktop";
+        private static readonly string[] TargetLabels = { "自动", "DSH Web", "DSH 桌面端" };
+        private static readonly string[] TargetValues = { TargetAuto, TargetWeb, TargetDesktop };
 
         /// <summary>Register this editor without changing the user's selection. @author ddj 2026-09-28</summary>
         static DshCodeEditor()
@@ -57,7 +62,13 @@ namespace Dsh.EditorIntegration
             string selected = EditorPrefs.GetString(key, string.Empty);
             string value = EditorGUILayout.TextField("DSH 桥接配置", selected);
             if (value != selected) EditorPrefs.SetString(key, value.Trim());
-            EditorGUILayout.HelpBox("留空时自动读取本项目 UserSettings/dsh-editor.ini；没有安装提示时使用 DSH_HOME 中的旧 shell 配置。填写绝对路径可覆盖自动选择。请求须收到 ACK 才确认成功。", MessageType.Info);
+            string targetKey = TargetKey();
+            string current = EditorPrefs.GetString(targetKey, TargetAuto);
+            int picked = System.Array.IndexOf(TargetValues, current);
+            if (picked < 0) picked = 0;
+            int chosen = EditorGUILayout.Popup("打开目标", picked, TargetLabels);
+            if (TargetValues[chosen] != current) EditorPrefs.SetString(targetKey, TargetValues[chosen]);
+            EditorGUILayout.HelpBox("留空时自动读取本项目 UserSettings/dsh-editor.ini；没有安装提示时使用 DSH_HOME 中的旧 shell 配置。填写绝对路径可覆盖自动选择。打开目标选择 DSH 桌面端或 DSH Web 时优先使用对应 profile 的独立 bridge。请求须收到 ACK 才确认成功。", MessageType.Info);
             if (GUILayout.Button("测试：在 DSH 中打开当前项目")) BeginOpen(ProjectRoot(), 0, 0);
         }
 
@@ -134,7 +145,8 @@ namespace Dsh.EditorIntegration
         private static void BeginOpen(string path, int line, int column)
         {
             string config = EditorPrefs.GetString(ConfigKey(), string.Empty);
-            var worker = new DshOpenWorker(config, path, line, column, ProjectRoot(), LegacyConfig());
+            string target = EditorPrefs.GetString(TargetKey(), TargetAuto);
+            var worker = new DshOpenWorker(config, path, line, column, ProjectRoot(), LegacyConfig(), target);
             var thread = new Thread(worker.Run) { IsBackground = true };
             thread.Start();
         }
@@ -143,6 +155,10 @@ namespace Dsh.EditorIntegration
         /// <returns>Project-local editor preference key.</returns>
         private static string ConfigKey() { return "DshEditor.Config." + ProjectRoot(); }
 
+        /// <summary>Derive a project-specific open-target preference key. @author ddj 2026-10-12</summary>
+        /// <returns>Project-local open-target preference key.</returns>
+        private static string TargetKey() { return "DshEditor.Target." + ProjectRoot(); }
+
         /// <summary>Read the project's installed profile hint on the worker. @author ddj 2026-09-28</summary>
         /// <param name="root">Project root captured on the main thread.</param><param name="fallback">Legacy shell INI.</param>
         /// <returns>The hinted absolute INI, or legacy path only when the hint is absent.</returns>
@@ -171,10 +187,48 @@ namespace Dsh.EditorIntegration
         /// <summary>Honor custom DSH_HOME for legacy installations. @author ddj 2026-09-28</summary>
         /// <returns>Legacy installed shell INI path, without filesystem IO.</returns>
         private static string LegacyConfig()
+        {
+            return Path.Combine(Path.Combine(Path.Combine(Home(), "dsh-vscode-mode"), "shell"), "dsh-open.ini");
+        }
+
+        /// <summary>Resolve the user DSH home honoring DSH_HOME. @author ddj 2026-10-12</summary>
+        /// <returns>Absolute user DSH home directory.</returns>
+        internal static string Home()
         {
             string home = Environment.GetEnvironmentVariable("DSH_HOME");
             if (string.IsNullOrEmpty(home)) home = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".dsh");
-            return Path.Combine(Path.Combine(Path.Combine(home, "dsh-vscode-mode"), "shell"), "dsh-open.ini");
+            return home;
+        }
+
+        /// <summary>Find the first profile bridge whose mode matches a requested target. @author ddj 2026-10-12</summary>
+        /// <param name="mode">Target mode (web or desktop) stored in the bridge INI.</param>
+        /// <returns>Absolute matching bridge INI path, or null when no profile provides it.</returns>
+        internal static string FindBridge(string mode)
+        {
+            string profiles = Path.Combine(Home(), "profiles");
+            if (!Directory.Exists(profiles)) return null;
+            foreach (string profile in Directory.GetDirectories(profiles))
+            {
+                string ini = Path.Combine(Path.Combine(Path.Combine(profile, "dsh-vscode-mode"), "bridge"), "dsh-open.ini");
+                if (!File.Exists(ini) || ModeOf(ini) != mode) continue;
+                return Path.GetFullPath(ini);
+            }
+            return null;
+        }
+
+        /// <summary>Read the mode value of a bridge INI without guessing a profile. @author ddj 2026-10-12</summary>
+        /// <param name="ini">Absolute bridge INI path.</param><returns>mode value, or empty when absent.</returns>
+        private static string ModeOf(string ini)
+        {
+            foreach (string text in File.ReadAllLines(ini))
+            {
+                int equal = text.IndexOf('=');
+                if (equal < 0) continue;
+                string key = text.Substring(0, equal).Trim();
+                if (!string.Equals(key, "mode", StringComparison.OrdinalIgnoreCase)) continue;
+                return text.Substring(equal + 1).Trim();
+            }
+            return string.Empty;
         }
 
         /// <summary>Resolve asset paths from the Unity project root. @author ddj 2026-09-28</summary>

package/unity/com.dsh.editor/Editor/DshOpenWorker.cs

@@ -16,6 +16,7 @@ namespace Dsh.EditorIntegration
         private readonly string targetPath;
         private readonly string projectRoot;
         private readonly string legacyConfig;
+        private readonly string target;
         private readonly int line;
         private readonly int column;
 
@@ -23,12 +24,14 @@ namespace Dsh.EditorIntegration
         /// <param name="config">Selected INI path.</param><param name="path">Absolute asset or project.</param>
         /// <param name="row">One-based line.</param><param name="col">One-based column.</param>
         /// <param name="root">Project root.</param><param name="fallback">Legacy shell INI path.</param>
-        internal DshOpenWorker(string config, string path, int row, int col, string root, string fallback)
+        /// <param name="mode">Requested target (auto/web/desktop); empty means auto. @author ddj 2026-10-12</param>
+        internal DshOpenWorker(string config, string path, int row, int col, string root, string fallback, string mode)
         {
             configPath = config;
             targetPath = path;
             projectRoot = root;
             legacyConfig = fallback;
+            target = string.IsNullOrEmpty(mode) ? "auto" : mode;
             line = row;
             column = col;
         }
@@ -105,7 +108,15 @@ namespace Dsh.EditorIntegration
         /// <returns>Selected bridge INI path; missing or malformed hints are handled by the caller.</returns>
         internal string SelectConfig()
         {
-            return string.IsNullOrEmpty(configPath) ? DshCodeEditor.DefaultConfig(projectRoot, legacyConfig) : configPath;
+            if (!string.IsNullOrEmpty(configPath)) return configPath;
+            if (target == "web") return DshCodeEditor.FindBridge("web") ?? DshCodeEditor.DefaultConfig(projectRoot, legacyConfig);
+            if (target == "desktop")
+            {
+                string desktop = DshCodeEditor.FindBridge("desktop");
+                if (desktop != null) return desktop;
+                throw new FileNotFoundException("No DSH desktop bridge configuration found. Open the DSH desktop app once, then retry, or set an explicit bridge configuration in External Tools.");
+            }
+            return DshCodeEditor.DefaultConfig(projectRoot, legacyConfig);
         }
 
         /// <summary>Build helper arguments without routing files through a URL. @author ddj 2026-09-28</summary>

package/unity/com.dsh.editor/package.json

@@ -1,7 +1,7 @@
 {
   "name": "com.dsh.editor",
   "displayName": "DSH 文件编辑",
-  "description": "DSH（dsh-vscode-mode）外部脚本编辑器：通过当前用户私有 OPEN REQUEST/ACK 文件队列打开脚本、Console 行列或项目；确认匹配 ACK 后才报告成功，支持官方桌面与所选 Web profile。",
-  "version": "0.3.0",
+  "description": "DSH（dsh-vscode-mode）外部脚本编辑器：通过当前用户私有 OPEN REQUEST/ACK 文件队列打开脚本、Console 行列或项目；确认匹配 ACK 后才报告成功，支持官方桌面与所选 Web profile，可在外部工具面板选择打开目标（自动/DSH Web/DSH 桌面端）。",
+  "version": "0.3.1",
   "unity": "2019.4"
 }