dsh-vscode-mode 0.5.3 → 0.7.0

package/src/shared/dap.ts

@@ -0,0 +1,262 @@
+/**
+ * dsh-vscode-mode — 调试（DAP）双面契约：调试会话状态、事件投影视图、调试配置与
+ * edrv.dap.* RPC 载荷。纯类型与纯函数，禁 node/react（同 shared 纯度规则）。
+ * 适配器 = 用户已装扩展清单 contributes.debuggers 声明的 DAP 适配器（通用，不限定语言）。
+ * 作者 ddj 2026年09月29号 / 2026年09月21号
+ */
+
+/** 调试会话相位。 */
+export type DapPhase = 'idle' | 'starting' | 'waiting' | 'running' | 'paused' | 'terminated'
+
+/** 系统进程条目（进程枚举投影视图）。 */
+export interface DapProcessInfo {
+  pid: number
+  /** 窗口标题（processName 匹配目标，与 VS Code 扩展语义一致）。 */
+  title: string
+  /** 可执行文件完整路径。 */
+  path: string
+  /** 路径 basename（如 Unity.exe）。 */
+  name: string
+}
+
+/** 调试配置（launch.json configuration 投影视图 + raw 原样透传）。 */
+export interface DapDebugConfig {
+  /** 配置名（工具条下拉显示）。 */
+  name: string
+  /** 适配器类型（= 扩展清单 contributes.debuggers.type，如 emmylua_attach / coreclr / unity）。 */
+  type: string
+  /** DAP request：attach | launch（缺省 launch；emmylua_attach 旧配置缺 request 时按 attach 兼容）。 */
+  request?: string
+  /** 进程名（标题或文件名包含匹配；attach 型按它自动选 pid）。 */
+  processName?: string
+  /** 直接指定 pid（>0 时跳过进程枚举）。 */
+  pid?: number
+  /** 附加目标 pid（coreclr/unity 等适配器的 launch.json processId 字段）。 */
+  processId?: number
+  /** emmylua_new 型：目标 emmy_core 监听地址。 */
+  host?: string
+  port?: number
+  /** 源码根目录列表（chunkname → 文件映射辅助）。 */
+  sourcePaths?: string[]
+  /** 源码扩展名（emmylua 用；通用适配器按声明 languages 推导）。 */
+  ext?: string[]
+  /** 附加时捕获 Unity 日志（emmy_tool -capture-log）。 */
+  captureLog?: boolean
+  /** launch.json 原始配置（attach/launch 请求参数原样透传，含全部未识别字段，变量已替换）。 */
+  raw?: Record<string, unknown>
+}
+
+/** launch.json「添加配置」下拉条目（扩展清单 configurationSnippets / initialConfigurations 投影）。 */
+export interface DapConfigSnippet {
+  /** 下拉显示名（%nls% 占位符已解析）。 */
+  label: string
+  /** 条目说明（%nls% 占位符已解析；无则空）。 */
+  description?: string
+  /** 适配器类型（= body.type，缺失时由清单条目补齐）。 */
+  type: string
+  /** 片段主体 JSON 文本（对象；%nls% 已解析，插入方按目标文件缩进重排）。 */
+  bodyText: string
+  /** 适配器可用性（与工具条同源 debuggerDecls 裁决；false = 下拉过滤不给插入；缺省 = 老 host 未标注，按可用处理）。 */
+  available?: boolean
+  /** 不可用原因（available=false 时给出，如「适配器入口不存在」）。 */
+  reason?: string
+}
+
+/** 调试事件投影视图（host 缓冲、客户端 poll 拉增量）。 */
+export interface DapEventView {
+  /** 事件游标（单调递增，poll since 用）。 */
+  seq: number
+  kind: 'output' | 'stopped' | 'continued' | 'terminated'
+  /** output 文本 / stopped 原因。 */
+  text?: string
+  reason?: string
+}
+
+/** 调用栈帧视图（file 已归一为工作区相对路径，空串=未能映射）。 */
+export interface DapFrameView {
+  id: number
+  name: string
+  file: string
+  rawFile: string
+  line: number
+}
+
+/** 作用域视图（Variables=局部+upvalue / ENV）。 */
+export interface DapScopeView {
+  name: string
+  ref: number
+  hint?: string
+}
+
+/** 变量视图（ref>0 表示可继续展开）。 */
+export interface DapVariableView {
+  name: string
+  value: string
+  type?: string
+  ref: number
+}
+
+/** 停帧首栈视图（命中断点时驱动文件跳转与行高亮）。 */
+export interface DapTopFrame {
+  file: string
+  rawFile: string
+  line: number
+  name: string
+}
+
+/** 调试会话状态视图（poll 返回，客户端渲染依据）。 */
+export interface DapStateView {
+  phase: DapPhase
+  configName?: string
+  configType?: string
+  pid?: number
+  error?: string
+  topFrame?: DapTopFrame | null
+}
+
+/** poll 增量结果。 */
+export interface DapPollResult {
+  state: DapStateView
+  events: DapEventView[]
+  nextSeq: number
+}
+
+/** 断点输入（path 相对工作区根，'/' 分隔；host 负责转绝对路径给适配器）。 */
+export interface DapBreakpointInput {
+  path: string
+  line: number
+  condition?: string
+  hitCondition?: string
+  logMessage?: string
+}
+
+/** 调试控制动作（edrv.dap.command）。 */
+export type DapAction = 'continue' | 'next' | 'stepIn' | 'stepOut' | 'pause' | 'disconnect'
+
+/** 全部合法动作（运行时校验用）。 */
+export const DAP_ACTIONS: readonly DapAction[] = ['continue', 'next', 'stepIn', 'stepOut', 'pause', 'disconnect']
+
+/** 调试配置文件（工作区相对路径；插件专属，与 VS Code 的 .vscode/launch.json 互不干扰）。 */
+export const DAP_LAUNCH_REL = '.dsh/launch.json'
+
+/** 旧共用配置路径（仅首读迁移源：复制到 DAP_LAUNCH_REL 后不再读取，永不回写）。 */
+export const DAP_LEGACY_LAUNCH_REL = '.vscode/launch.json'
+
+/** 断点确认结果（适配器真实回执；适配器可能挪行或判不可验证）。 */
+export interface DapBreakpointAck {
+  line: number
+  verified: boolean
+  /** 适配器说明（如「该行无可执行代码」）。 */
+  message?: string
+}
+
+/** 配置来源。 */
+export type DapConfigSource = 'launchjson' | 'settings' | 'none'
+
+/** 调试适配器声明（扩展清单 contributes.debuggers 条目投影视图）。 */
+export interface DapAdapterDecl {
+  /** 调试类型（launch.json type 匹配键，= initialize.adapterID）。 */
+  type: string
+  /** 显示名（下拉与错误提示用）。 */
+  label: string
+  /** 来源扩展 id（publisher.name）。 */
+  extensionId: string
+  /** 来源扩展根目录（emmylua 兼容 shim 的 extensionPath 来源）。 */
+  extensionPath: string
+  /** 适配器入口绝对路径（已按平台解析 program/windows.program）。 */
+  program: string
+  /** 清单声明的启动参数（如 clrdbg 的 --interpreter=vscode）。 */
+  args: string[]
+  /** 运行时：'node' = 用 node 跑 js 入口；空 = 直接 spawn program。 */
+  runtime?: string
+  /** 声明语言（如 ['lua'] / ['csharp']）。 */
+  languages: string[]
+  /** 该适配器可下断点的文件扩展名（小写、带点；空 = 不限）。 */
+  exts: string[]
+  /** 入口是否真实存在（DotRush 等按需下载的适配器可能缺失）。 */
+  available: boolean
+  /** 不可用原因（available=false 时给出）。 */
+  reason?: string
+}
+
+/** 下发客户端的适配器可用性视图（edrv.dap.configs.adapters 元素）。 */
+export interface DapAdapterInfo {
+  type: string
+  label: string
+  available: boolean
+  reason?: string
+}
+
+/**
+ * chunkname 与候选文件的 basename 匹配（纯函数，可单测）。
+ * 适配器 findFileReq 的 file 是 Lua chunkname（可能带 @ 前缀/相对点路径/反斜杠，
+ * 且常常不含 .lua 扩展名——xLua 惯例）；匹配口径：剥 @、统一分隔符后，
+ * 完整相对路径相等 / basename 相等 / basename 去扩展名 stem 相等（大小写不敏感）。
+ * @author ddj 2026年09月29号
+ * @param chunk 适配器上报的 chunkname
+ * @param relPath 候选文件工作区相对路径（'/' 分隔）
+ * @returns 是否命中
+ */
+export function chunkMatchesFile(chunk: string, relPath: string): boolean {
+  const clean = String(chunk || '').replace(/^@/, '').replace(/\\/g, '/')
+  const rel = String(relPath || '').replace(/\\/g, '/')
+  if (!clean || !rel) return false
+  if (clean === rel) return true
+  const chunkBase = (clean.split('/').pop() ?? '').toLowerCase()
+  const fileBase = (rel.split('/').pop() ?? '').toLowerCase()
+  if (!chunkBase || !fileBase) return false
+  if (chunkBase === fileBase) return true
+  return chunkBase === fileBase.replace(/\.[^.]+$/, '')
+}
+
+/**
+ * 配置 → DAP request 类型：显式 request 优先；emmylua_attach 旧配置缺 request 时按 attach 兼容。
+ * @author ddj 2026年09月21号
+ * @param config 调试配置（取 type/request 两字段）
+ * @returns 'attach' | 'launch'
+ */
+export function requestOfConfig(config: Pick<DapDebugConfig, 'type' | 'request'>): 'attach' | 'launch' {
+  if (config.request === 'attach' || config.request === 'launch') return config.request
+  return config.type === 'emmylua_attach' ? 'attach' : 'launch'
+}
+
+/**
+ * 是否应发送 configurationDone（DAP 标准握手收尾：断点下发完 → configurationDone → 目标开跑）。
+ * 仅当适配器在 initialize 响应声明 supportsConfigurationDoneRequest 时发送；
+ * emmylua 适配器未声明该能力（实测响应体仅 5 个 supports* 字段）→ 不发，Lua 行为不变。
+ * @author ddj 2026年09月21号
+ * @param caps initialize 响应 body（capabilities）
+ */
+export function needsConfigurationDone(caps: Record<string, unknown> | null | undefined): boolean {
+  return caps?.supportsConfigurationDoneRequest === true
+}
+
+/**
+ * stopped 事件 body → 当前线程 id：多线程适配器（coreclr 等）取真实 threadId，
+ * 缺省/非法回退 1（单线程适配器 emmylua 语义不变）。
+ * @author ddj 2026年09月21号
+ * @param body stopped 事件 body
+ */
+export function threadIdOfStopped(body: Record<string, unknown>): number {
+  const id = body.threadId
+  return typeof id === 'number' && Number.isInteger(id) && id > 0 ? id : 1
+}
+
+/**
+ * setBreakpoints 响应 body → 断点回执（DAP 顺序与请求一致；缺行回退请求行）。
+ * 适配器会把断点挪到最近可绑定行并给出 verified/message——必须消费而非造假回执。
+ * @author ddj 2026年09月21号
+ * @param body setBreakpoints 响应 body（breakpoints 数组）
+ * @param items 本次请求的断点（回退基准）
+ */
+export function bpAcksOfResponse(body: unknown, items: DapBreakpointInput[]): DapBreakpointAck[] {
+  const list = (body as { breakpoints?: unknown } | null)?.breakpoints
+  if (!Array.isArray(list)) return items.map((it) => ({ line: it.line, verified: true }))
+  return list.map((item, i) => {
+    const b = (item ?? {}) as Record<string, unknown>
+    const line = typeof b.line === 'number' && b.line >= 1 ? b.line : items[i]?.line ?? 0
+    const ack: DapBreakpointAck = { line, verified: b.verified === true }
+    if (typeof b.message === 'string' && b.message) ack.message = b.message
+    return ack
+  })
+}

package/src/shared/fsNames.ts

@@ -0,0 +1,115 @@
+/**
+ * dsh-vscode-mode shared — 文件操作名称/路径校验（纯函数，可单测）。
+ * 新建/重命名输入护栏（客户端弹窗校验与 host 端二次校验共用一份）：
+ * 空名、绝对路径、盘符、'.'/'..' 路径段、空路径段、控制字符、超长一律拒绝；
+ * 新建允许 a/b.c 嵌套段（对齐 VS Code「新建文件…」输入语义），重命名仅允许单个名称段。
+ * 作者 ddj 2026年09月22号
+ */
+
+/** 单个名称段最大长度（防误贴超长串直接打到文件系统）。 */
+export const NAME_MAX = 255
+
+/**
+ * 路径归一：去首尾空白 + 反斜杠转 '/'（Windows 输入等价处理）。
+ * @author ddj 2026年09月22号
+ * @param raw 原始输入
+ * @returns 归一后的字符串
+ */
+function normPath(raw: unknown): string {
+  return String(raw ?? '').trim().replace(/\\/g, '/')
+}
+
+/**
+ * 单个名称段的通用违规检查（两套校验共用）。
+ * @author ddj 2026年09月22号
+ * @param seg 名称段
+ * @returns 错误文案；null = 通过
+ */
+function checkSegment(seg: string): string | null {
+  if (!seg) return '名称包含空路径段'
+  if (seg === '.' || seg === '..') return '名称不能包含 . 或 .. 路径段'
+  if (seg.length > NAME_MAX) return '名称过长（单段超过 ' + NAME_MAX + ' 字符）'
+  if (/[\0-\x1f]/.test(seg)) return '名称包含非法控制字符'
+  return null
+}
+
+/**
+ * 校验新建文件/文件夹的相对路径（允许 a/b.c 嵌套段）。
+ * @author ddj 2026年09月22号
+ * @param raw 用户输入的名称或相对路径
+ * @returns 错误文案；null = 校验通过
+ */
+export function checkNewName(raw: unknown): string | null {
+  const text = normPath(raw)
+  if (!text) return '名称不能为空'
+  if (text.startsWith('/')) return '名称不能是绝对路径'
+  if (/^[a-zA-Z]:/.test(text)) return '名称不能带盘符'
+  for (const seg of text.split('/')) {
+    const bad = checkSegment(seg)
+    if (bad) return bad
+  }
+  return null
+}
+
+/**
+ * 校验重命名的新名称（仅单个名称段，不接受路径）。
+ * @author ddj 2026年09月22号
+ * @param raw 用户输入的新名称
+ * @returns 错误文案；null = 校验通过
+ */
+export function checkRenameName(raw: unknown): string | null {
+  const text = normPath(raw)
+  if (!text) return '名称不能为空'
+  if (text.includes('/')) return '新名称不能包含路径分隔符'
+  return checkSegment(text)
+}
+
+/**
+ * 拼接工作区相对路径（dir 为空 = 根；name 新建时可含多段）。
+ * @author ddj 2026年09月22号
+ * @param dir 目标目录（工作区相对）
+ * @param name 名称
+ * @returns 拼接后的相对路径
+ */
+export function joinRelPath(dir: string, name: string): string {
+  const base = normPath(dir).replace(/\/+$/, '')
+  const add = normPath(name).replace(/^\/+/, '')
+  return base ? base + '/' + add : add
+}
+
+/**
+ * 取相对路径的父目录（顶层条目返回空串 = 根）。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @returns 父目录相对路径
+ */
+export function parentRelOf(path: string): string {
+  const parts = normPath(path).split('/').filter(Boolean)
+  parts.pop()
+  return parts.join('/')
+}
+
+/**
+ * 取相对路径的名称段（末段）。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @returns 末段名称
+ */
+export function baseNameOf(path: string): string {
+  const parts = normPath(path).split('/').filter(Boolean)
+  return parts.pop() ?? ''
+}
+
+/**
+ * other 是否为 base 本身或其内部路径（复制/移动「不能以自身或其子目录为目标」护栏）。
+ * @author ddj 2026年09月22号
+ * @param base 基准相对路径（源）
+ * @param other 待判定相对路径（目标目录）
+ * @returns 是否为自身或子路径
+ */
+export function isSubPath(base: string, other: string): boolean {
+  const b = normPath(base).replace(/\/+$/, '')
+  const o = normPath(other).replace(/\/+$/, '')
+  if (!b) return false
+  return o === b || o.startsWith(b + '/')
+}

package/src/shared/keybindings.ts

@@ -22,6 +22,8 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）
   'edrv.nextTab': 'Ctrl+Alt+ArrowRight|Ctrl+PageDown',
   'edrv.prevTab': 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp',
+  // 转到行：插件只补键位与命令栏入口，widget 本体转发 Monaco 原生 editor.action.gotoLine（VS Code 同款 Ctrl+G）
+  'edrv.goToLine': 'Ctrl+G',
   // 命令栏（Ctrl+Shift+P 主候选；F1 为 VS Code 同款第二候选）与编辑行导航
   'edrv.showCommands': 'Ctrl+Shift+P|F1',
   'edrv.nextEditorRow': 'Ctrl+Alt+ArrowDown',
@@ -31,6 +33,13 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   // 关闭当前页签：VS Code 同款为 Ctrl+W，但浏览器会截获该键（脚本无法 preventDefault），
   // 故取参考图里的第二候选 Ctrl+F4（Chrome/Edge 默认无行为，可安全拦截）。
   'edrv.closeTab': 'Ctrl+F4',
+  // 调试（VS Code 同款键位；F5 在有调试配置或暂停态才吞键，空闲时放行浏览器刷新）
+  'edrv.debugToggleBreakpoint': 'F9',
+  'edrv.debugStartContinue': 'F5',
+  'edrv.debugStepOver': 'F10',
+  'edrv.debugStepInto': 'F11',
+  'edrv.debugStepOut': 'Shift+F11',
+  'edrv.debugStop': 'Shift+F5',
 }
 
 /**

package/src/shared/rpc.ts

@@ -19,7 +19,9 @@ import type { RuleInfo, RuleProject, RuleRefInput, RuleSaveInput } from './rules
 import type { SnippetEntry, SnippetInfo, SnippetProject, SnippetRefInput, SnippetSaveInput } from './snippets.js'
 import type { LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSymbol } from './lsp.js'
 import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiInlineResult } from './ai.js'
-import type { SvnAction, SvnChangeEntry, SvnDiffRevResult, SvnLogEntry, SvnStatusPayload, SvnUpdateResult } from './svn.js'
+import type { SvnAction, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdateResult } from './svn.js'
+import type { DapAction, DapAdapterInfo, DapBreakpointAck, DapBreakpointInput, DapConfigSnippet, DapConfigSource, DapDebugConfig, DapFrameView, DapPhase, DapPollResult, DapProcessInfo, DapScopeView, DapVariableView } from './dap.js'
+import { DAP_ACTIONS } from './dap.js'
 import type { LoggerLevel } from './logger.js'
 
 /** webServer 精确路由。 */
@@ -214,6 +216,12 @@ export interface RpcRequestMap {
   'edrv.searchContent': { sessionId?: string; query: string; matchCase?: boolean; wholeWord?: boolean; regex?: boolean; maxResults?: number; include?: string[]; exclude?: string[] }
   'edrv.listDir': { sessionId?: string; path: string; force?: boolean }
   'edrv.revealInExplorer': { sessionId?: string; path: string }
+  'edrv.fsCreateFile': { sessionId?: string; path: string }
+  'edrv.fsCreateDir': { sessionId?: string; path: string }
+  'edrv.fsRename': { sessionId?: string; path: string; newName: string }
+  'edrv.fsDelete': { sessionId?: string; path: string }
+  'edrv.fsCopy': { sessionId?: string; from: string; toDir: string }
+  'edrv.fsMove': { sessionId?: string; from: string; toDir: string }
   'mcp.list': {}
   'mcp.save': { config: MpcConfig }
   'mcp.remove': { id: string }
@@ -298,6 +306,24 @@ export interface RpcRequestMap {
   'svn.cleanup': { sessionId?: string; removeUnversioned?: boolean; removeIgnored?: boolean }
   'svn.update': { sessionId?: string; path?: string }
   'svn.tortoise': { sessionId?: string; action: SvnAction; path?: string }
+  'svn.patchText': { sessionId?: string; path: string; whitespace?: 'none' | 'b' | 'w'; ignoreEol?: boolean; unified?: number }
+  'svn.diffSum': { sessionId?: string; path?: string; revA: number; revB: number }
+  'svn.remoteStatus': { sessionId?: string; path?: string }
+  'svn.conflictArtifacts': { sessionId?: string; path: string }
+  'svn.diffLocalPair': { sessionId?: string; left: string; right: string }
+  'svn.fileSizes': { sessionId?: string; paths: string[] }
+  'edrv.dap.configs': { workspacePath: string }
+  'edrv.dap.snippets': {}
+  'edrv.dap.processes': { processName?: string }
+  'edrv.dap.start': { config: DapDebugConfig; workspacePath: string; pid?: number }
+  'edrv.dap.stop': {}
+  'edrv.dap.poll': { since: number }
+  'edrv.dap.setBreakpoints': { workspacePath: string; file: string; points: DapBreakpointInput[] }
+  'edrv.dap.stackTrace': {}
+  'edrv.dap.scopes': { frameId: number }
+  'edrv.dap.variables': { ref: number }
+  'edrv.dap.evaluate': { expression: string; frameId?: number }
+  'edrv.dap.command': { action: DapAction }
 }
 
 export type RpcMethod = keyof RpcRequestMap
@@ -325,6 +351,12 @@ export interface RpcOkMap {
   'edrv.searchContent': { matches: SearchContentMatch[]; truncated: boolean; warning?: string }
   'edrv.listDir': { root: string; path: string; entries: TreeEntry[] }
   'edrv.revealInExplorer': { revealed: string }
+  'edrv.fsCreateFile': { path: string }
+  'edrv.fsCreateDir': { path: string }
+  'edrv.fsRename': { from: string; to: string }
+  'edrv.fsDelete': { path: string }
+  'edrv.fsCopy': { from: string; to: string }
+  'edrv.fsMove': { from: string; to: string }
   'mcp.list': { servers: MpcServer[] }
   'mcp.save': { server: MpcServer }
   'mcp.remove': object
@@ -398,7 +430,7 @@ export interface RpcOkMap {
   'snippets.entries': { entries: SnippetEntry[] }
   'svn.status': SvnStatusPayload
   'svn.changes': { wcRoot: string; entries: SvnChangeEntry[]; truncated: boolean }
-  'svn.diffBase': { base: string | null; working: string; reason?: string; error?: string }
+  'svn.diffBase': { base: string | null; working: string; reason?: string; error?: string; binary?: boolean; encodingHint?: boolean }
   'svn.revert': { count: number; summary: string; output: string }
   'svn.add': { count: number; summary: string; output: string }
   'svn.log': { entries: SvnLogEntry[]; truncated: boolean; target: string; limit?: number }
@@ -409,6 +441,24 @@ export interface RpcOkMap {
   'svn.cleanup': { summary: string; output: string }
   'svn.update': SvnUpdateResult
   'svn.tortoise': { launched: string }
+  'svn.patchText': { text: string; truncated: boolean; binary: boolean }
+  'svn.diffSum': { entries: SvnSumEntry[]; truncated: boolean }
+  'svn.remoteStatus': { outdated: SvnRemoteOutdatedEntry[]; againstRev: number | null }
+  'svn.conflictArtifacts': { artifacts: SvnConflictArtifact[] }
+  'svn.diffLocalPair': SvnDiffRevResult
+  'svn.fileSizes': { sizes: Array<{ path: string; size: number | null }> }
+  'edrv.dap.configs': { configs: DapDebugConfig[]; adapters: DapAdapterInfo[]; source: DapConfigSource }
+  'edrv.dap.snippets': { snippets: DapConfigSnippet[] }
+  'edrv.dap.processes': { items: DapProcessInfo[] }
+  'edrv.dap.start': { phase: DapPhase }
+  'edrv.dap.stop': object
+  'edrv.dap.poll': DapPollResult
+  'edrv.dap.setBreakpoints': { breakpoints: DapBreakpointAck[] }
+  'edrv.dap.stackTrace': { frames: DapFrameView[] }
+  'edrv.dap.scopes': { scopes: DapScopeView[] }
+  'edrv.dap.variables': { variables: DapVariableView[] }
+  'edrv.dap.evaluate': { result: string; type?: string; ref: number }
+  'edrv.dap.command': object
 }
 
 /** 统一响应：{ok:true, ...payload} 或 {ok:false, error}。 */

package/src/shared/svn.ts

@@ -189,6 +189,10 @@ export interface SvnDiffRevResult {
   reason?: string
   /** 失败提示（诊断用）。 */
   error?: string
+  /** W2-6 护栏：内容含 NUL 字节（二进制嫌疑），客户端不渲染编辑器。 */
+  binary?: boolean
+  /** W2-6 护栏：嗅探窗含 U+FFFD（可能非 UTF-8），客户端提示乱码风险。 */
+  encodingHint?: boolean
 }
 
 // --endregion
@@ -281,6 +285,31 @@ export interface SvnChangeFilter {
   unversioned?: boolean
   /** 是否显示已被忽略的条目（默认 false）。 */
   ignored?: boolean
+  /**
+   * 名称过滤串（W1-2，纯前端）：`*`/`?` 通配或子串包含，忽略大小写；空/空白 = 不过滤。
+   * 只影响列表展示；「全部加入/全部还原」等批量动作仍按未过滤集合计算（防误伤）。
+   */
+  name?: string
+}
+
+/**
+ * 路径名称过滤匹配（W1-2）：`*` 任意串、`?` 单字符（忽略大小写）；
+ * 无通配符时回落子串包含。非法正则元字符已转义，永不抛错。
+ * @author ddj 2026年09月20号
+ * @param path 条目路径（`/` 分隔）
+ * @param pattern 过滤串（空/空白 = 不过滤）
+ * @returns 是否命中
+ */
+export function changeNameMatch(path: string, pattern: string | undefined): boolean {
+  const query = String(pattern ?? '').trim().toLowerCase()
+  if (!query) return true
+  const target = String(path ?? '').toLowerCase()
+  if (!query.includes('*') && !query.includes('?')) return target.includes(query)
+  const source = query
+    .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+    .replaceAll('*', '.*')
+    .replaceAll('?', '.')
+  return new RegExp('^' + source + '$').test(target)
 }
 
 /**
@@ -297,6 +326,7 @@ export function svnVisibleChanges(
   const showUnversioned = filter.unversioned !== false
   const showIgnored = filter.ignored === true
   return entries.filter((entry) => {
+    if (!changeNameMatch(entry.path, filter.name)) return false
     if (entry.status === 'ignored') return showIgnored
     if (entry.status === 'unversioned') return showUnversioned
     return isSvnChange(entry)
@@ -375,3 +405,120 @@ export const SVN_TORTOISE_LABELS: Record<SvnAction, string> = {
   blame: 'TortoiseSVN 追溯',
   revert: 'TortoiseSVN 还原',
 }
+
+// --region W2 差异管理补全（护栏/目录对比/远端检查/冲突/配对）
+
+/** W2-6 内容护栏嗅探窗（字符数；NUL/U+FFFD 只看前 8K，全量扫描大文本得不偿失）。 */
+export const GUARD_SNIFF_CHARS = 8 * 1024
+
+/** W2-6 内容级护栏标记（host 嗅探 → client 提示）。 */
+export interface SvnContentGuard {
+  /** 嗅探窗含 NUL 字节（二进制嫌疑；M4 实测 svn cat 对二进制原样透传字节）。 */
+  binary?: boolean
+  /** 嗅探窗含 U+FFFD（UTF-8 解码失败替换符；可能非 UTF-8 编码）。 */
+  encodingHint?: boolean
+}
+
+/**
+ * 文本级内容护栏（W2-6，纯函数）：对喂给差异视图/补丁的文本做低成本嗅探。
+ * 二进制锚点取 NUL 字节（比 svn:mime-type 更兜底——mime 缺省的「伪文本」二进制也拦得住）；
+ * 编码提示取 U+FFFD（host fs.readText 按 UTF-8 解码，无效序列会变成替换符）。
+ * @author ddj 2026年09月20号
+ * @param text 待嗅探文本（null/undefined 按空处理）
+ * @returns 护栏标记（干净内容返回空对象）
+ */
+export function contentGuardOf(text: string | null | undefined): SvnContentGuard {
+  if (typeof text !== 'string' || !text) return {}
+  const window = text.slice(0, GUARD_SNIFF_CHARS)
+  if (window.includes('\u0000')) return { binary: true }
+  if (window.includes('\uFFFD')) return { encodingHint: true }
+  return {}
+}
+
+/** W2-5 一对「疑似改名」配对（missing `!` ↔ unversioned `?`）。 */
+export interface SvnRenamePair {
+  /** 原路径（missing 条目）。 */
+  missingPath: string
+  /** 新路径（unversioned 条目）。 */
+  unversionedPath: string
+}
+
+/** 取路径 basename（`/`/`\` 通用；纯函数）。 */
+function baseNameOf(path: string): string {
+  return String(path ?? '').split(/[\\/]/).pop() ?? ''
+}
+
+/**
+ * 疑似改名配对（W2-5，纯函数；M2 定论：status XML 无 copyfrom，只能客户端启发式）。
+ * 配对条件从严：basename 相同 **且** 双侧 size 均已知且相等（size 缺失不配对，防误报）。
+ * @author ddj 2026年09月20号
+ * @param entries 变更清单
+ * @param sizes 路径 → 字节大小（未知为 null/缺失）
+ * @returns 配对数组（每个 missing 至多配一个，先到先得保持输入顺序）
+ */
+export function pairMissingWithUnversioned(
+  entries: readonly SvnChangeEntry[],
+  sizes: Record<string, number | null>,
+): SvnRenamePair[] {
+  const unversioned = entries.filter((entry) => entry.status === 'unversioned')
+  const pairs: SvnRenamePair[] = []
+  for (const missing of entries) {
+    if (missing.status !== 'missing') continue
+    const name = baseNameOf(missing.path)
+    for (const candidate of unversioned) {
+      if (baseNameOf(candidate.path) !== name) continue
+      const a = sizes[missing.path]
+      const b = sizes[candidate.path]
+      if (typeof a !== 'number' || typeof b !== 'number' || a !== b) continue
+      pairs.push({ missingPath: missing.path, unversionedPath: candidate.path })
+      break
+    }
+  }
+  return pairs
+}
+
+/** W2-2 目录对比单条（`svn diff --summarize --xml` 的 `<path>`；M5 实测形态）。 */
+export interface SvnSumEntry {
+  /** 工作副本相对路径（host 已从绝对路径归一）。 */
+  path: string
+  /** 变更动作（svn 词汇：added/deleted/replaced/modified/normal/none）。 */
+  item: string
+  /** 节点类型（file/dir；异常输出回 'none'）。 */
+  kind: string
+  /** 属性变更（none/modified）。 */
+  props: string
+}
+
+/** W2-3 远端落后条目（`svn status -u --xml` 的 repos-status；M3 实测形态）。 */
+export interface SvnRemoteOutdatedEntry {
+  /** 工作副本相对路径。 */
+  path: string
+  /** 远端状态（实测落后文件为 modified；'none' = 远端无变化）。 */
+  item: string
+}
+
+/** W2-2 summarize 动作 → 展示字母（对齐 svn status 首列字母；normal/none 不出徽标）。 */
+export const SVN_SUM_LETTER: Record<string, string> = {
+  added: 'A',
+  deleted: 'D',
+  replaced: 'R',
+  modified: 'M',
+  normal: ' ',
+  none: ' ',
+  'props-deleted': ' ',
+  'props-modified': ' ',
+}
+
+/** W2-4 冲突副本文件（`.mine`/`.working`/`.rN`）。 */
+export interface SvnConflictArtifact {
+  /** 工作副本相对路径。 */
+  path: string
+  /** 文件名（含冲突后缀）。 */
+  name: string
+  /** 种类：mine = 我的（.mine）/ working = 基础工作版（.working）/ rev = 仓库版本（.rN）。 */
+  kind: 'mine' | 'working' | 'rev'
+  /** rev 种类时的修订号。 */
+  rev?: number
+}
+
+// --endregion