dsh-vscode-mode 0.5.3 → 0.7.0

package/src/client/dap/launchInsert.ts

@@ -0,0 +1,229 @@
+/**
+ * dsh-vscode-mode client — launch.json「添加配置」插入定位与插入文本构造（纯函数，node 可测）。
+ * 插入语义对齐 VS Code「添加配置」：光标落在 `"configurations": [` 下一行行首
+ * （单行数组落在 `[ 后），新配置插到数组开头；插入文本自带缩进与尾逗号，按纯文本插入
+ * （不用 Monaco snippet 语法——${file}/${workspaceFolder} 是 DAP 运行期变量，必须原样落盘）。
+ * needComma/缩进从「光标之后的结构」探测：键入过滤词不污染判断（词本身在光标前已被越过）。
+ * 作者 ddj 2026年09月22号
+ */
+import { DAP_LAUNCH_REL } from '../../shared/dap.js'
+
+/** launch.json 键行（容忍单行 `{"configurations": [` 形态；match[0] 恒以 `[ 结尾）。 */
+const CONFIG_KEY_RE = /^\s*\{?\s*"configurations"\s*:\s*\[/
+
+/** 调试配置文件路径判定（由共享 DAP_LAUNCH_REL 动态构造防漂移；工作区相对与绝对路径同口径）。 */
+export const LAUNCH_JSON_RE = new RegExp(
+  '(^|\\/)' + DAP_LAUNCH_REL.split('/').map((seg) => seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('\\/') + '$',
+  'i',
+)
+
+/** 编辑器光标位置（1-based，Monaco 口径）。 */
+interface CursorPos {
+  lineNumber: number
+  column: number
+}
+
+/** 数组插入定位结果。 */
+export interface ConfigInsertPos {
+  /** 插入起始行（1-based；多行数组 = "configurations" 行的下一行）。 */
+  line: number
+  /** 插入起始列（1-based；多行数组 = 1，单行数组 = `[ 后一列）。 */
+  column: number
+  /** 新元素行缩进字符串。 */
+  indent: string
+  /** 缩进单元字符串（'  ' / '    ' / '\t'，body 重排用）。 */
+  unit: string
+  /** 插入点后已有元素 → 新元素后需补逗号。 */
+  needComma: boolean
+  /** 单行数组（光标在 configurations 行内）→ 插入文本首尾自带换行/收尾缩进。 */
+  inline: boolean
+  /** configurations 行缩进（inline 收尾对齐 `]` 用）。 */
+  cfgIndent: string
+}
+
+/**
+ * 定位 launch.json configurations 数组的插入点。
+ * @author ddj 2026年09月22号
+ * @param text launch.json 全文（JSONC）
+ * @param cursor 可选当前光标（补全触发时传入；needComma/缩进从光标后探测，忽略键入的过滤词）
+ * @returns 插入定位；无 configurations 数组返回 null
+ */
+export function findArrayPos(text: string, cursor?: CursorPos): ConfigInsertPos | null {
+  const lines = text.split('\n')
+  const keyLine = lines.findIndex((line) => CONFIG_KEY_RE.test(line))
+  if (keyLine < 0) return null
+  const cfgLine = lines[keyLine]
+  const match = CONFIG_KEY_RE.exec(cfgLine)
+  if (!match) return null
+  const bracketIdx = match.index + match[0].length - 1
+  const cfgIndent = /^[ \t]*/.exec(cfgLine)?.[0] ?? ''
+  const lineStarts = lineStartOffsets(lines)
+  const eof = keyLine + 1 >= lines.length
+  const keyRest = text.slice(lineStarts[keyLine] + bracketIdx + 1, lineStarts[keyLine] + cfgLine.length)
+  const inline = eof || firstSignificant(keyRest, 0) !== null
+  const scanFrom = resolveScanFrom(lineStarts, lines, cursor, inline, keyLine, bracketIdx)
+  const sig = firstSignificant(text, scanFrom)
+  const hasContent = sig !== null && sig.char !== ']'
+  const elemIndent = sig !== null && !inline ? trailingWsBefore(text, lineStarts, sig.index) : ''
+  const unit = unitOf(cfgIndent, inline ? '' : elemIndent)
+  const indent = hasContent && elemIndent ? elemIndent : cfgIndent + unit
+  if (inline) {
+    return {
+      line: keyLine + 1,
+      column: bracketIdx + 2,
+      indent,
+      unit,
+      needComma: hasContent,
+      inline: true,
+      cfgIndent,
+    }
+  }
+  return {
+    line: keyLine + 2,
+    column: 1,
+    indent,
+    unit,
+    needComma: hasContent,
+    inline: false,
+    cfgIndent,
+  }
+}
+
+/**
+ * 构造插入文本（body 按目标 unit 重排缩进；多行数组首行带 indent、尾随逗号换行；
+ * 单行数组首尾补换行并回填 cfgIndent，让原 `] 落到对齐列）。
+ * @author ddj 2026年09月22号
+ * @param pos 插入定位
+ * @param bodyText 片段主体 JSON 文本（host 已 nls 解析，2 空格缩进）
+ * @returns 插入到 (line, column) 的完整文本
+ */
+export function buildInsertText(pos: ConfigInsertPos, bodyText: string): string {
+  const body = reindentBody(bodyText, pos.unit)
+  const indented = body.split('\n').map((line) => pos.indent + line).join('\n')
+  const head = pos.inline ? '\n' : ''
+  const tail = (pos.needComma ? ',' : '') + '\n' + (pos.inline ? pos.cfgIndent : '')
+  return head + indented + tail
+}
+
+/** 首个有效字符（跳过空白与 // /* 注释；null = 到扫描尾）。 */
+interface SigChar {
+  /** 字符在全文（或扫描段）中的偏移。 */
+  index: number
+  /** 字符本身。 */
+  char: string
+}
+
+function firstSignificant(text: string, from: number): SigChar | null {
+  let i = Math.max(0, from)
+  const n = text.length
+  while (i < n) {
+    const ch = text[i]
+    if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r') {
+      i += 1
+      continue
+    }
+    if (ch === '/' && text[i + 1] === '/') {
+      while (i < n && text[i] !== '\n') i += 1
+      continue
+    }
+    if (ch === '/' && text[i + 1] === '*') {
+      i += 2
+      while (i + 1 < n && !(text[i] === '*' && text[i + 1] === '/')) i += 1
+      i = Math.min(i + 2, n)
+      continue
+    }
+    return { index: i, char: ch }
+  }
+  return null
+}
+
+/** 解析结构扫描起点：有光标（且未越界）从光标起——键入的过滤词在光标前被越过；否则从插入点起。 */
+function resolveScanFrom(
+  lineStarts: number[],
+  lines: string[],
+  cursor: CursorPos | undefined,
+  inline: boolean,
+  keyLine: number,
+  bracketIdx: number,
+): number {
+  const defaultFrom = inline
+    ? lineStarts[keyLine] + bracketIdx + 1
+    : lineStarts[keyLine + 1] ?? textLen(lineStarts, lines)
+  if (!cursor) return defaultFrom
+  const lineIdx = cursor.lineNumber - 1
+  if (!Number.isInteger(lineIdx) || lineIdx < 0 || lineIdx >= lines.length) return defaultFrom
+  const column = Number.isFinite(cursor.column) && cursor.column >= 1 ? Math.floor(cursor.column) : 1
+  return lineStarts[lineIdx] + column - 1
+}
+
+/** 全文长度（末行起始 + 末行长度；越界兜底 0）。 */
+function textLen(lineStarts: number[], lines: string[]): number {
+  const last = lines.length - 1
+  return last >= 0 ? (lineStarts[last] ?? 0) + lines[last].length : 0
+}
+
+/** 每行起始偏移（含第 0 行 = 0）。 */
+function lineStartOffsets(lines: string[]): number[] {
+  const starts: number[] = []
+  let offset = 0
+  for (const line of lines) {
+    starts.push(offset)
+    offset += line.length + 1
+  }
+  return starts
+}
+
+/** 偏移 → 行下标（二分；越界取末行）。 */
+function lineIndexOf(lineStarts: number[], offset: number): number {
+  let lo = 0
+  let hi = lineStarts.length - 1
+  while (lo < hi) {
+    const mid = Math.ceil((lo + hi) / 2)
+    if (lineStarts[mid] <= offset) lo = mid
+    else hi = mid - 1
+  }
+  return lo
+}
+
+/** 目标偏移前、其所在行内的末尾空白串（= 该处真实缩进；"Em    {" 取 "    " 排除过滤词）。 */
+function trailingWsBefore(text: string, lineStarts: number[], offset: number): string {
+  const lineStart = lineStarts[lineIndexOf(lineStarts, offset)] ?? 0
+  const prefix = text.slice(lineStart, Math.max(lineStart, offset))
+  return /[\t ]*$/.exec(prefix)?.[0] ?? ''
+}
+
+/**
+ * 探测缩进单元：元素行相对 configurations 行的增量优先，回退 configurations 行自身宽度。
+ * @author ddj 2026年09月22号
+ * @param cfgIndent configurations 行缩进
+ * @param elemIndent 首个元素前的真实缩进（无元素线索传空串）
+ * @returns 缩进单元字符串（缺省 2 空格）
+ */
+function unitOf(cfgIndent: string, elemIndent: string): string {
+  if (elemIndent && elemIndent.startsWith(cfgIndent)) {
+    const unit = elemIndent.slice(cfgIndent.length)
+    if (unit && unit.length <= 8 && /^[\t ]+$/.test(unit)) return unit
+  }
+  if (cfgIndent.includes('\t')) return '\t'
+  if (cfgIndent && /^ +$/.test(cfgIndent) && cfgIndent.length <= 8) return cfgIndent
+  return '  '
+}
+
+/**
+ * body 文本按目标 unit 重排缩进（2 空格基准 → 目标单元）。
+ * @author ddj 2026年09月22号
+ * @param bodyText JSON.stringify 产物（2 空格缩进）
+ * @param unit 目标缩进单元
+ * @returns 重排后文本
+ */
+function reindentBody(bodyText: string, unit: string): string {
+  if (unit === '  ') return bodyText
+  return bodyText
+    .split('\n')
+    .map((line) => {
+      const spaces = /^[ ]*/.exec(line)?.[0].length ?? 0
+      const depth = Math.floor(spaces / 2)
+      return unit.repeat(depth) + line.slice(spaces)
+    })
+    .join('\n')
+}

package/src/client/dap/launchSnippetProvider.ts

@@ -0,0 +1,206 @@
+/**
+ * dsh-vscode-mode client — launch.json「添加配置」Monaco 补全 provider。
+ * 仅插件专属 `.dsh/launch.json`（DAP_LAUNCH_REL）且光标位于 configurations 数组插入点
+ * （或其后键入过滤词）时出条目；
+ * insertText = buildInsertText（纯文本插入，不用 InsertAsSnippet——${file}/${workspaceFolder}
+ * 是 DAP 运行期变量，snippet 语法会展开吞掉它们）。
+ * 数据源 host edrv.dap.snippets，模块级缓存 + TTL，失败静默降级空表；
+ * window 挂注销器防热重载重复注册（与 snippets/provider 同模式）。
+ * 作者 ddj 2026年09月22号
+ */
+import { rpc } from '../rpc.js'
+import { pathOfModel } from '../monaco/lsp/lspClient.js'
+import { buildInsertText, findArrayPos, LAUNCH_JSON_RE } from './launchInsert.js'
+import type { DapConfigSnippet } from '../../shared/dap.js'
+
+/** 条目缓存 TTL（毫秒）：扩展清单级数据，本地小表。 */
+const CACHE_TTL_MS = 10_000
+
+/** provider 注销器全局挂点名（跨 bundle 重载存活，见 snippets/provider 同名说明）。 */
+const PROVIDER_GLOBAL = '__edrvLaunchCfgProvider__'
+
+/** 编辑器光标位置（1-based）。 */
+interface SuggestPos {
+  lineNumber: number
+  column: number
+}
+
+/** 最小 model 形状（仅声明用到的链）。 */
+interface CompletionModel {
+  getValue(): string
+  uri: { scheme?: string; path?: string }
+  getWordUntilPosition(position: SuggestPos): { startColumn: number; endColumn: number }
+}
+
+/** 补全条目（本模块消费的子集）。 */
+interface CompletionItemLike {
+  label: string
+  insertText: string
+  filterText: string
+  detail: string
+  sortText: string
+  documentation?: string
+  kind?: number
+}
+
+/** 最小 monaco.languages 形状。 */
+interface MonacoLanguagesLike {
+  registerCompletionItemProvider?: (
+    selector: string,
+    provider: { provideCompletionItems(model: CompletionModel, position: SuggestPos): Promise<{ suggestions: CompletionItemLike[] }> },
+  ) => { dispose(): void }
+  CompletionItemKind?: { Snippet?: number }
+}
+
+/** 最小 monaco 形状。 */
+interface MonacoLike {
+  languages?: MonacoLanguagesLike
+}
+
+/** 最小 IDisposable 形状。 */
+interface Disposer {
+  dispose(): void
+}
+
+/** 已加载片段缓存（null = 未加载/已失效）。 */
+let cache: DapConfigSnippet[] | null = null
+let cacheAt = 0
+let pending: Promise<DapConfigSnippet[]> | null = null
+let registered = false
+let disposer: Disposer | null = null
+
+// --region 片段数据
+
+/**
+ * 读取片段（带缓存与在飞去重；失败降级空表，补全静默不打断输入）。
+ * @author ddj 2026年09月22号
+ * @returns 片段列表
+ */
+async function loadSnippets(): Promise<DapConfigSnippet[]> {
+  if (cache && Date.now() - cacheAt < CACHE_TTL_MS) return cache
+  if (pending) return pending
+  pending = rpc('edrv.dap.snippets', {})
+    .then((res) => {
+      cache = res.ok && Array.isArray(res.snippets) ? res.snippets : []
+      cacheAt = Date.now()
+      return cache
+    })
+    .catch(() => {
+      cache = []
+      cacheAt = Date.now()
+      return cache
+    })
+    .finally(() => {
+      pending = null
+    })
+  return pending
+}
+
+/**
+ * 预拉片段（按钮点击时提前发起 RPC，suggest 触发即有数据；调用方据此预检可用条数）。
+ * @author ddj 2026年09月22号
+ * @returns 片段列表（失败空表）
+ */
+export function prefetchSnippets(): Promise<DapConfigSnippet[]> {
+  return loadSnippets()
+}
+
+// --endregion
+
+// --region provider 装配
+
+/**
+ * 注册 launch.json 配置补全 provider（幂等；Monaco 就绪后调用一次）。
+ * @author ddj 2026年09月22号
+ * @param monaco window.monaco
+ */
+export function setupLaunchJson(monaco: MonacoLike): void {
+  if (registered || !monaco?.languages?.registerCompletionItemProvider) return
+  // 跨重载守卫：上一代 bundle 注册的 provider 仍在存活 window.monaco 上（注销器已落 window）
+  const host = typeof window === 'undefined' ? undefined : (window as unknown as Record<string, unknown>)
+  if (host && host[PROVIDER_GLOBAL]) {
+    registered = true
+    return
+  }
+  const snippetKind = monaco.languages.CompletionItemKind?.Snippet
+  const kind = typeof snippetKind === 'number' ? snippetKind : undefined
+  registered = true
+  disposer = monaco.languages.registerCompletionItemProvider('json', {
+    async provideCompletionItems(model, position) {
+      return { suggestions: await suggestionsFor(model, position, kind) }
+    },
+  })
+  // 注销器落 window：跨重载认领（见 PROVIDER_GLOBAL 说明）
+  if (host) host[PROVIDER_GLOBAL] = disposer
+}
+
+/**
+ * 卸载：注销 provider 并复位状态（插件热重载/卸载时调用）。
+ * 兼容上一代 bundle 遗留的 window 注销器（模块级 disposer 为空时仍能清干净）。
+ * @author ddj 2026年09月22号
+ */
+export function disposeLaunchJson(): void {
+  const host = typeof window === 'undefined' ? undefined : (window as unknown as Record<string, unknown>)
+  const target = (disposer && typeof disposer.dispose === 'function' ? disposer : null)
+    ?? (host ? (host[PROVIDER_GLOBAL] as Disposer | undefined) ?? null : null)
+  if (target && typeof target.dispose === 'function') {
+    try {
+      target.dispose()
+    } catch {
+      /* 已注销 */
+    }
+  }
+  if (host) delete host[PROVIDER_GLOBAL]
+  disposer = null
+  registered = false
+  cache = null
+  cacheAt = 0
+  pending = null
+}
+
+// --endregion
+
+// --region 补全计算
+
+/**
+ * 计算当前光标处的配置补全条目（非 launch.json / 非插入点 / 无片段 → 空表）。
+ * 光标门槛：行 = 插入行，且过滤词起点恰为插入列（既挡住误触，又允许键入过滤词）。
+ * @author ddj 2026年09月22号
+ * @param model Monaco 模型
+ * @param position 光标位置
+ * @param kind Snippet 图标 kind（monaco 枚举缺失时 undefined）
+ * @returns 补全条目数组
+ */
+async function suggestionsFor(
+  model: CompletionModel,
+  position: SuggestPos,
+  kind: number | undefined,
+): Promise<CompletionItemLike[]> {
+  const path = pathOfModel(model)
+  if (!path || !LAUNCH_JSON_RE.test(path)) return []
+  const pos = findArrayPos(model.getValue(), position)
+  if (!pos || position.lineNumber !== pos.line) return []
+  const word = model.getWordUntilPosition(position)
+  if (word.startColumn !== pos.column) return []
+  const snippets = await loadSnippets()
+  // 可用性过滤：不可用适配器的模板不给插入（=== false 严格判断；老 host 缺字段按可用）
+  const usable = snippets.filter((snip) => snip.available !== false)
+  if (!usable.length) return []
+  return usable.map((snip, index) => {
+    const item: CompletionItemLike = {
+      label: snip.label,
+      // 纯文本插入（不设 insertTextRules）：DAP 变量 ${file} 等必须原样落盘
+      insertText: buildInsertText(pos, snip.bodyText),
+      filterText: snip.label + ' ' + snip.type + (snip.description ? ' ' + snip.description : ''),
+      detail: snip.description || snip.type,
+      // 空格前缀：词补全的 sortText 是词本身（'.NET' 的 '.' < '0' 会抢排模板前），
+      // 0x20 空格确保配置模板恒排下拉最前并默认高亮
+      sortText: ' ' + String(index).padStart(3, '0'),
+      documentation: snip.bodyText,
+    }
+    if (kind !== undefined) item.kind = kind
+    return item
+  })
+}
+
+// --endregion

package/src/client/dap/modelPath.ts

@@ -0,0 +1,23 @@
+/**
+ * dsh-vscode-mode client — Monaco 编辑器 model 路径归一化（纯函数，可单测）。
+ * 与 EditorView 原 modelPathOf 逐字同逻辑，提取共享防止"编辑器切换断点"与
+ * "调试面板新增断点"两处口径漂移（断点表 key 必须同源）。
+ * 作者 ddj 2026年09月21号
+ */
+
+/** 最小编辑器形状（仅声明用到的 model.uri.path 链）。 */
+export interface EditorPathLike {
+  getModel?: () => { uri?: { path?: string } } | null
+}
+
+/**
+ * 取当前 model 的文件路径（uri.path → 去首斜杠 → decode）。
+ * 无 model / 无 uri.path 时返回 null（调用方降级提示，不产生断点）。
+ * @author ddj 2026年09月21号
+ * @param editor Monaco 编辑器实例（或形状兼容对象）
+ * @returns 归一化路径；不可用时 null
+ */
+export function editorModelPathOf(editor: unknown): string | null {
+  const uriPath = (editor as EditorPathLike | null)?.getModel?.()?.uri?.path
+  return uriPath ? decodeURIComponent(String(uriPath).replace(/^\//, '')) : null
+}

package/src/client/dap/panelSplit.ts

@@ -0,0 +1,105 @@
+/**
+ * dsh-vscode-mode client — 调试面板四段分栏高度（纯函数 + localStorage 持久）。
+ * 对齐 VS Code/CodeBuddy splitview 语义：段间 sash 拖动时相邻两段高度重分配
+ * （拖下 = 上段增高、下段减矮；任一段触到夹取界时拖动量被"吸收"，分隔条停在可行位置）。
+ * 存储：`edrv.dap.split.<scope>` → { variables, watch, stack, breakpoints }。
+ * 作者 ddj 2026年09月21号
+ */
+
+/** 分栏段 key（与 DebugPanel section key 一致）。 */
+export const SPLIT_KEYS = ['variables', 'watch', 'stack', 'breakpoints'] as const
+/** 分栏段 key 类型。 */
+export type SplitKey = (typeof SPLIT_KEYS)[number]
+
+/** 默认高度（沿用重构前各段 max-height 值，改前改后视觉一致）。 */
+export const DEFAULT_HEIGHTS: Record<SplitKey, number> = { variables: 360, watch: 220, stack: 180, breakpoints: 260 }
+/** 单段最小高度（低于此不可再压缩）。 */
+export const MIN_H = 64
+/** 单段最大高度（防无限拖爆面板）。 */
+export const MAX_H = 1200
+
+/** localStorage key 前缀。 */
+const KEY_PREFIX = 'edrv.dap.split.'
+
+/**
+ * 夹取单段高度到 [MIN_H, MAX_H]（非有限数回退最小值）。
+ * @author ddj 2026年09月21号
+ * @param px 目标高度
+ */
+export function clampSectionHeight(px: number): number {
+  if (!Number.isFinite(px)) return MIN_H
+  return Math.min(MAX_H, Math.max(MIN_H, Math.round(px)))
+}
+
+/**
+ * 归一化高度表：非对象/缺 key 回退默认，非法值丢弃（损坏安全）。
+ * @author ddj 2026年09月21号
+ * @param input localStorage 解析结果
+ */
+export function sanitizeHeights(input: unknown): Record<SplitKey, number> {
+  const out: Record<SplitKey, number> = { ...DEFAULT_HEIGHTS }
+  if (!input || typeof input !== 'object' || Array.isArray(input)) return out
+  const data = input as Record<string, unknown>
+  for (const key of SPLIT_KEYS) {
+    const value = data[key]
+    if (typeof value === 'number' && Number.isFinite(value)) out[key] = clampSectionHeight(value)
+  }
+  return out
+}
+
+/**
+ * 相邻两段高度重分配：above += dy、below −= dy，各自夹取；
+ * 一段被夹取吸收的量补给另一段（分隔条停在可行位置，拖动量尽量生效）。
+ * @author ddj 2026年09月21号
+ * @param heights 拖动起点高度表（不修改入参）
+ * @param above 上邻段 key
+ * @param below 下邻段 key
+ * @param dy 拖动位移（>0 向下拖 = 上段增高）
+ * @returns 新高度表
+ */
+export function redistribute(
+  heights: Record<SplitKey, number>,
+  above: SplitKey,
+  below: SplitKey,
+  dy: number,
+): Record<SplitKey, number> {
+  const clean = Math.round(Number.isFinite(dy) ? dy : 0)
+  const next: Record<SplitKey, number> = { ...heights }
+  const startAbove = heights[above] ?? MIN_H
+  const startBelow = heights[below] ?? MIN_H
+  const targetAbove = clampSectionHeight(startAbove + clean)
+  const targetBelow = clampSectionHeight(startBelow - clean)
+  next[above] = targetAbove
+  next[below] = targetBelow
+  // 夹取吸收量：>0 表示该段未能吃满 dy，按原方向补给另一段
+  const lostAbove = startAbove + clean - targetAbove
+  const lostBelow = startBelow - clean - targetBelow
+  if (lostAbove > 0) next[below] = clampSectionHeight(targetBelow + lostAbove)
+  else if (lostBelow > 0) next[above] = clampSectionHeight(targetAbove + lostBelow)
+  return next
+}
+
+/**
+ * 读高度表（缺失/损坏回退默认值）。
+ * @author ddj 2026年09月21号
+ * @param scope 状态作用域
+ */
+export function loadSectionHeights(scope: string): Record<SplitKey, number> {
+  if (!scope) return { ...DEFAULT_HEIGHTS }
+  try {
+    const raw = localStorage.getItem(KEY_PREFIX + scope)
+    return sanitizeHeights(raw ? JSON.parse(raw) : null)
+  } catch {
+    return { ...DEFAULT_HEIGHTS }
+  }
+}
+
+/**
+ * 写高度表（写失败静默；写入前归一化）。
+ * @author ddj 2026年09月21号
+ * @param scope 状态作用域
+ * @param heights 高度表
+ */
+export function saveSectionHeights(scope: string, heights: Record<SplitKey, number>): void {
+  try { localStorage.setItem(KEY_PREFIX + scope, JSON.stringify(sanitizeHeights(heights))) } catch { /* 忽略 */ }
+}

package/src/client/dap/pidPick.ts

@@ -0,0 +1,24 @@
+/**
+ * dsh-vscode-mode client — 附加目标 pid 决策（纯函数，可单测）。
+ * host 侧只对「唯一命中」自动附加；多候选由客户端弹进程选择器（VS Code QuickPick 等价物）。
+ * 作者 ddj 2026年09月29号
+ */
+import type { DapProcessInfo } from '../../shared/dap.js'
+
+/** pid 决策结果。 */
+export type PidPlan =
+  | { kind: 'none'; message: string }
+  | { kind: 'auto'; pid: number }
+  | { kind: 'picker'; items: DapProcessInfo[] }
+
+/**
+ * 由进程列表决策附加方式：0 命中报错；唯一命中直用；多候选交选择器。
+ * @author ddj 2026年09月29号
+ * @param items 已按 processName 过滤的进程列表
+ * @param processName 过滤词（错误文案用）
+ */
+export function resolvePidPlan(items: DapProcessInfo[], processName?: string): PidPlan {
+  if (!items.length) return { kind: 'none', message: '未找到匹配进程：' + (processName || '(空)') }
+  if (items.length === 1) return { kind: 'auto', pid: items[0].pid }
+  return { kind: 'picker', items }
+}