dsh-vscode-mode 0.5.2 → 0.6.0

package/src/search/ripgrep.ts

@@ -15,7 +15,12 @@ const STDOUT_CAP = 4 << 20
 const STDERR_CAP = 64 << 10
 const GRACE_MS = 20_000
 
-/** 默认排除目录（文件/内容搜索共用，导出供 provider 复用）。 */
+/**
+ * 默认排除目录（文件/内容搜索共用，导出供 provider 复用）。
+ * 语义为**大小写敏感**的路径段匹配：`build` 只排除小写构建产物目录，
+ * 不得用 `--glob-case-insensitive` 之类的全局开关，「Module/Build」这类
+ * 源码目录（如 IslandSplash 的 Module/Build/Logic）必须保持可搜索。
+ */
 export const EXCLUDES = [
   'node_modules', '.git', '.tmp', '.cache', 'dist', 'build', 'vendor',
   'coverage', '__pycache__', '.pnpm-store', '.npm-cache', '.codegraph', '.workbuddy',
@@ -52,15 +57,32 @@ interface SearchSubprocess {
 }
 
 /**
- * 将 query 转成 rg 的字面 glob。
- * @author ddj 2026年08月24号
- * @param query 已规范化 query
+ * 将查询文本转成大小写不敏感的 rg 正选 glob。
+ * 逐字符把有大小写的字母展开成 `[aA]` 字符类，**不用**大小写不敏感开关：
+ * ① 全局 `--glob-case-insensitive` 会把 `-g/--glob` 全部当成 `--iglob`，
+ *    连带让 `!**\/build/**` 大小写不敏感，从而排除 `Module/Build/` 这类源码目录
+ *    （Ctrl+P 搜 BuildLogic 恒「无匹配文件」）；
+ * ② 把查询词改用 `--iglob` 也不行——rg 的正选 glob 会覆盖全部黑名单 glob，
+ *    node_modules/.git 等排除项集体失效。
+ * 字符类方案同时满足「查询不区分大小写」且「排除项保持大小写敏感」。
+ * @author ddj 2026年08月24号 / 2026年09月20号
+ * @param query 已规范化查询文本
  * @returns 安全 glob
  */
 export function queryGlob(query: string): string {
   const value = pathText(query)
-  const escaped = value.replace(/[\*?\[\]{}!]/g, (char) => '\\' + char)
-  return '**/*' + escaped + '*'
+  let body = ''
+  for (const char of value) {
+    const lower = char.toLowerCase()
+    const upper = char.toUpperCase()
+    // 有大小写之分的字符（单字符映射，避开 ß→SS 这类长度变化）→ 字符类
+    if (lower !== upper && lower.length === 1 && upper.length === 1) {
+      body += '[' + lower + upper + ']'
+      continue
+    }
+    body += /[\*?\[\]{}!]/.test(char) ? '\\' + char : char
+  }
+  return '**/*' + body + '*'
 }
 
 /**
@@ -159,6 +181,24 @@ export function rgExitFailure(code: number | null | undefined, stderrText: strin
   return { kind: 'hard', message: 'ripgrep 退出码：' + String(code) + (detail ? '（' + detail + '）' : '') }
 }
 
+/**
+ * 构造文件搜索 rg argv（查询 glob 大小写不敏感，排除 glob 大小写敏感）。
+ * 大小写不敏感**只能**靠 queryGlob 的字符类实现：全局 `--glob-case-insensitive`
+ * 会波及排除项（误排除 `Module/Build/`），查询词用 `--iglob` 又会覆盖全部黑名单 glob。
+ * @author ddj 2026年09月20号
+ * @param binary rg 可执行文件路径
+ * @param root 搜索根目录
+ * @param query 已规范化查询文本
+ * @returns 完整 argv（末位为根目录）
+ */
+export function filesArgv(binary: string, root: string, query: string): string[] {
+  const argv = [binary, '--no-config', '--files', '--hidden', '--no-ignore', '--glob', queryGlob(query)]
+  for (const excluded of EXCLUDES) argv.push('--glob', '!**/' + excluded + '/**')
+  for (const excluded of FILE_EXCLUDES) argv.push('--glob', '!' + excluded)
+  argv.push('--', root)
+  return argv
+}
+
 /**
  * 使用打包 ripgrep 搜索工作区文件。
  * @author ddj 2026年08月24号
@@ -172,12 +212,8 @@ export async function searchRipgrep(input: WorkspaceSearchInput): Promise<Worksp
   if (!binary) throw new Error('ripgrep 不可用')
   const root = input.root ?? await searchRoot(input.ctx, input.session)
   const query = prepareQuery(input.query)
-  const argv = [binary, '--no-config', '--files', '--hidden', '--no-ignore', '--glob-case-insensitive', '--glob', queryGlob(query.text)]
-  for (const excluded of EXCLUDES) argv.push('--glob', '!**/' + excluded + '/**')
-  for (const excluded of FILE_EXCLUDES) argv.push('--glob', '!' + excluded)
-  argv.push('--', root)
   const handle = sub.spawn({
-    argv,
+    argv: filesArgv(binary, root, query.text),
     cwd: root,
     stdio: { stdin: 'ignore', stdout: { maxBytes: STDOUT_CAP }, stderr: { maxBytes: STDERR_CAP } },
     graceMs: GRACE_MS,
@@ -202,6 +238,86 @@ export async function searchRipgrep(input: WorkspaceSearchInput): Promise<Worksp
   return { ...parsed, source: 'ripgrep' }
 }
 
+/**
+ * 构造 chunkname 定向查找的 rg argv。
+ * 与 {@link filesArgv} 同源（同样的排除 glob 与大小写口径），差异只在查询 glob 由
+ * chunkname 推导：chunkname 可能带 chunk 前缀（`@`）与无扩展名 stem，故先剥 `@`、
+ * 取 basename、去掉扩展名后作为片段匹配，仍走 {@link queryGlob} 的字符类方案
+ * ——避免 `--glob-case-insensitive` 波及排除项（见 queryGlob 注释）。
+ * @author ddj 2026年09月21号
+ * @param binary rg 可执行文件路径
+ * @param root 搜索根目录
+ * @param chunk 适配器上报的 chunkname
+ * @returns 完整 argv（末位为根目录）；chunk 为空时返回 null
+ */
+export function chunkFilesArgv(binary: string, root: string, chunk: string): string[] | null {
+  const clean = normalizeChunk(chunk)
+  if (!clean) return null
+  const argv = [binary, '--no-config', '--files', '--hidden', '--no-ignore', '--glob', queryGlob(clean)]
+  for (const excluded of EXCLUDES) argv.push('--glob', '!**/' + excluded + '/**')
+  for (const excluded of FILE_EXCLUDES) argv.push('--glob', '!' + excluded)
+  argv.push('--', root)
+  return argv
+}
+
+/**
+ * chunkname → 用于片段匹配的纯文件名片段。
+ * 剥 `@` 前缀、统一分隔符、取 basename、去掉扩展名（xLua chunkname 惯例不含扩展名），
+ * 使 `GuideSystemMgr` 能命中 `GuideSystemMgr.lua`。
+ * @author ddj 2026年09月21号
+ * @param chunk 适配器上报的 chunkname
+ * @returns 纯片段（空输入返回空串）
+ */
+export function normalizeChunk(chunk: string): string {
+  const text = String(chunk ?? '').replace(/^@/, '').replaceAll('\\', '/').trim()
+  if (!text) return ''
+  const base = text.split('/').pop() ?? ''
+  return base.replace(/\.[^.]+$/, '')
+}
+
+/**
+ * 按 chunkname 定向查找工作区文件（DAP findFile 反向匹配专用）。
+ *
+ * 为什么不用工作区全量文件索引：22 万文件的 Unity 工程里，全量枚举按到达序截断，
+ * `Assets/Scripts/Lua/**` 会被 `GameData`/`Entitas` 等目录挤出配额，导致断点命中后
+ * 无法定位源文件（实测前 6000 条中 .lua 数为 0）。此处改为让 rg 在遍历时过滤，
+ * 命中规模与工作区总规模无关（实测同一工作区 0.37s 返回正确结果）。
+ * @author ddj 2026年09月21号
+ * @param ctx DSH 上下文
+ * @param root 工作区根（subprocess 可访问路径）
+ * @param chunk 适配器上报的 chunkname
+ * @param maxResults 候选上限
+ * @returns 绝对路径候选（任何失败都返回空数组，不抛错）
+ */
+export async function findFilesByChunk(ctx: Ctx, root: string, chunk: string, maxResults = 50): Promise<string[]> {
+  const sub = ctx.get('subprocess') as SearchSubprocess | undefined
+  const binary = ripgrepPath()
+  if (!sub || !binary || !root) return []
+  const argv = chunkFilesArgv(binary, root, chunk)
+  if (!argv) return []
+  let handle: SearchHandle
+  try {
+    handle = sub.spawn({
+      argv,
+      cwd: root,
+      stdio: { stdin: 'ignore', stdout: { maxBytes: STDOUT_CAP }, stderr: { maxBytes: STDERR_CAP } },
+      graceMs: GRACE_MS,
+    })
+  } catch (error) {
+    return []
+  }
+  let code: number | null | undefined
+  try {
+    const outcome = await handle.done
+    code = outcome.exitCode ?? outcome.code
+  } catch (error) {
+    return []
+  }
+  // 0=有命中 1=无命中 2=部分不可访问（已收集结果仍有效）：其余视为失败
+  if (code !== 0 && code !== 1 && code !== 2) return []
+  return parseOutput(handle, maxResults).files
+}
+
 /**
  * 构造 ripgrep provider。
  * @author ddj 2026年08月24号

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/editorLimit.ts

@@ -0,0 +1,46 @@
+/**
+ * dsh-vscode-mode shared — 编辑器页签数量上限的常量与归一化（host 与 client 双面契约）。
+ *
+ * 纯数据模块：host（settings schema 默认值）与 client（淘汰判定）共用，禁止 import
+ * 浏览器 API 或 Node API。
+ *
+ * ⚠️ 与 sidebarMinWidth 的关键差异：**0 是合法值**，语义为「不限制页签数量」，
+ * 因此归一化时不能像 normalizeSidebarMinWidth 那样把 0 当作非法输入回退默认值。
+ *
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 页签数量上限默认值（对齐 VS Code workbench.editor.limit 默认 10）。 */
+export const EDITOR_LIMIT_DEFAULT = 10
+/** 上限允许下界：0 = 不限制（关闭上限功能）。 */
+export const EDITOR_LIMIT_FLOOR = 0
+/** 上限允许上界（防呆：远超屏幕可容纳数量的上限无意义）。 */
+export const EDITOR_LIMIT_CEIL = 50
+
+/**
+ * 归一化页签数量上限。
+ *
+ * 规则：`0` 合法保留（不限制）；非数字/非有限/负数 → 回退默认；其余取整后夹到
+ * `[EDITOR_LIMIT_FLOOR, EDITOR_LIMIT_CEIL]`。
+ * 数字字符串（设置文档/输入框可能给字符串）按数字解析，与 sidebarMin 口径一致。
+ *
+ * ⚠️ 只接受「真数字」与「非空数字字符串」：不得用裸 `Number(value)` 判值——
+ * `Number(null)`、`Number([])`、`Number(false)`、`Number('')` 全是 0，会被误判成
+ * 「不限制」；而缺失/损坏的设置必须回退默认（否则一个坏值就永久关掉上限）。
+ *
+ * @author ddj 2026年09月18号
+ * @param value 原始值（设置文档或输入框来的任意 JSON 值）
+ * @returns 合法上限（0 = 不限制）
+ */
+export function normalizeMaxOpenEditors(value: unknown): number {
+  let n: number
+  if (typeof value === 'number') {
+    n = value
+  } else if (typeof value === 'string' && value.trim() !== '') {
+    n = Number(value)
+  } else {
+    return EDITOR_LIMIT_DEFAULT
+  }
+  if (!Number.isFinite(n) || n < 0) return EDITOR_LIMIT_DEFAULT
+  return Math.max(EDITOR_LIMIT_FLOOR, Math.min(EDITOR_LIMIT_CEIL, Math.round(n)))
+}

package/src/shared/keybindings.ts

@@ -14,6 +14,9 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   'edrv.quickOpen': 'Ctrl+P',
   'edrv.toggleSidebar': 'Ctrl+B',
   'edrv.searchInFiles': 'Ctrl+Shift+F',
+  // Markdown 预览切换：VS Code 同款 (Ctrl+K V 为分栏，此处取单键 Ctrl+Shift+V)。
+  // 仅当活动文件是 .md 时才吞键，其余情况放行给浏览器/输入框（保留「粘贴为纯文本」语义）。
+  'edrv.toggleMarkdownPreview': 'Ctrl+Shift+V',
   'edrv.navigateBack': 'Alt+ArrowLeft|Ctrl+Alt+-',
   'edrv.navigateForward': 'Alt+ArrowRight|Ctrl+Shift+-',
   // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）
@@ -28,6 +31,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 精确路由。 */
@@ -298,6 +300,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
@@ -398,7 +418,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 +429,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}。 */