dsh-vscode-mode 0.5.2 → 0.6.0

package/README.md

@@ -36,10 +36,21 @@
   官方文本查看器；畸形地址自动回落官方查看器。
 - **文件页签**：脏点 / 关闭 / 「+」打开 / 右键菜单 / 固定（📌 排最前、隐藏 ×、
   随工作区持久化；**固定 = 保护**，批量关闭永不误关固定页签）。
+- **页签数量上限**（通用设置 `maxOpenEditors`，默认 10，**0 = 不限制**）：超限时自动
+  关闭**最久未使用**的页签；固定页签与当前活动页签受保护，脏页签在关闭前静默落盘。
+- **页签栏滚轮横滚**：页签栏溢出（出现水平滚动条）时，鼠标滚轮（含触控板纵向手势）
+  直接横向滚动页签栏；不溢出时不接管，`Shift+滚轮` 沿用浏览器原生横滚。
 - **页签右键菜单**（对齐 VS Code）：添加到对话 / 关闭·关闭其他·关闭右侧·关闭已
   保存·全部关闭（`Ctrl+F4` 关当前）/ 复制路径·复制相对路径 / 在文件资源管理器
   （视图）中显示。关闭前未保存页签静默落盘；浏览器无法实现的条目（向右拆分 /
   新窗口）不提供。
+- **工作区搜索填充**：编辑器有选中时按 `Ctrl+Shift+F`，选中文本自动填入搜索框并
+  立即搜索（多行选区取首行；填入后全选，便于直接改写）。
+- **Markdown 预览**（v0.5.3）：打开 `.md` / `.markdown` 后，工具栏「预览」按钮、
+  `Ctrl+Shift+V` 或命令栏「切换 Markdown 预览」切入 GFM 渲染（标题/列表/表格/代码块/
+  引用/KaTeX），「以源码打开」切回编辑。渲染走官方 `MarkdownText` 原语，零新增依赖、
+  自动跟随 DSH 主题；旧版 DSH 缺该原语时降级为纯文本预览。活动文件不是 Markdown 时
+  不吞 `Ctrl+Shift+V`（保留「粘贴为纯文本」）。
 - **Monaco Editor**：语法高亮 / 行号 / `Ctrl+F` / `Ctrl+G` / `Ctrl+S` /
   700ms 防抖自动保存；顶部工具栏显示 路径 / 语言 / Ln,Col / 保存状态，提供
   差异 / 侧边栏 / 刷新入口。
@@ -57,9 +68,9 @@
   全局键位派发、Monaco 右键菜单——新增能力只需追加一条命令定义。
 - **开放注册表**：`window.__edrvCommands__` 暴露 `register()` 注册命令、
   `addRuntimeKeybinding()` 绑运行时键位（不落设置 schema）。
-- **开箱 19 条命令**：保存 / 快速打开 / 在文件浏览器中打开 / 显示所有命令 /
-  切换侧边栏 / 工作区搜索 / 后退·前进 / 上下页签 / 关闭当前页签 / 上下编辑行 /
-  转到定义 / 查找引用 / 触发 AI 补全 / 配置代码片段 / 插入代码片段 /
+- **开箱 20 条命令**：保存 / 快速打开 / 在文件浏览器中打开 / 显示所有命令 /
+  切换侧边栏 / 工作区搜索 / 切换 Markdown 预览 / 后退·前进 / 上下页签 / 关闭当前页签 /
+  上下编辑行 / 转到定义 / 查找引用 / 触发 AI 补全 / 配置代码片段 / 插入代码片段 /
   选中内容加为引用。
 
 ### 3. 代码片段（v0.3.0，VS Code 兼容）
@@ -341,19 +352,60 @@ TortoiseSVN（`TortoiseProc.exe`）仅作 Windows 过渡增强：自研能力覆
 
 > 说明：`plans/`（含对标蓝图与实测结论）为本地开发资料，不入库。
 
+### 17. 断点调试（DAP，开发中）
+
+编辑器内断点调试（DAP 桥通用化：适配器由扩展清单 `contributes.debuggers` 驱动，
+不限定语言；Lua 链路复用已装 emmylua 扩展适配器，**零游戏侧改动**）：
+
+- **断点**：编辑器行首点击（或 `F9`）切换断点，红点/灰点（禁用）持久化跨刷新保留；
+  鼠标悬停在行首/行号区时显示**半透明预览红点**并切换为手型光标（对齐 VS Code 的 breakpoint hint）；
+  侧栏「调试」面板断点列表支持启停复选框 / 删除 / 点击跳转（VS Code 断点视图形态）。
+- **断点右键菜单与编辑浮层**（逐条对齐 CodeBuddy / VS Code 内核，文案取自官方中文语言包）：
+  空行 → `添加断点` / `添加条件断点...` / `添加记录点...` / `添加触发的断点...`；
+  已有断点 → `删除 断点`（`Delete`）/ `编辑 断点…` / `禁用断点`（记录点场景名词自动切换为「记录点」）；
+  暂停中额外追加 `运行到行`。「编辑断点…」打开**整宽行内浮层**（View Zone：横跨整个编辑区、
+  把下方内容推开，并高亮目标行）：左侧「模式下拉」（`表达式` / `命中次数` / `日志消息` / `等待断点`）+
+  右侧**单行输入框**，切换模式时各模式内容独立记忆；`Enter` 确认、`Escape` 取消
+  （提示写在输入框占位里）。
+- **启动**：编辑区右上浮动工具条选择配置（读取工作区 `.dsh/launch.json`——插件专属文件，
+  与 VS Code 的 `.vscode/launch.json` 互不干扰，旧共用文件首次读取时自动迁移过来；类型可用性由
+  扩展清单裁决：未发现适配器/入口缺失的类型在下拉置灰并给原因）→ `F5` 启动/继续。
+  `emmylua_attach` 按进程名自动附加（复刻 VS Code 扩展的进程枚举语义：窗口标题/进程名包含匹配，
+  多候选时工具条切进程选择器明确选择）。
+- **命中暂停**：断点命中自动打开对应文件并高亮停帧行；适配器上报 chunkname 由插件工作区
+  索引反向映射为工作区文件（`findFileReq` 反向请求应答）。
+- **四段调试面板**（活动栏「调试」）：调用堆栈（点击跳转）/ 变量（懒展开树，Variables + ENV）/
+  监视（表达式持久化，暂停态求值）/ 断点 + 底部**调试控制台**（REPL 输入表达式即时求值）。
+- **实现**：host 半 DAP 桥（`src/dap/*`）spawn 扩展清单声明的 DAP 适配器（`runtime: node`
+  跑 js 入口 / 无 runtime 直启原生 exe，清单 `args` 随行），事件经缓冲 + 400ms
+  活跃轮询上抛；断点先落 host，适配器就绪（initialized）后全量下发，并按适配器能力位
+  发送 `configurationDone` 收尾握手（emmylua 未声明该能力 → 不发，行为不变）。
+  `.dsh/launch.json` 配置全量透传给适配器（未识别字段原样保留，`${workspaceFolder}`/`${cwd}`
+  已替换；`${command:...}` 为 VS Code 命令占位，启动时明确报错而非假解析）。
+  命中行解析用 Monaco 官方 `getTargetAtClientPoint`（手算需扣 `padding-top`，实测易错行）。
+- **回执与多线程**：断点回执消费适配器真实响应（可能挪行/判不可验证），未验证断点渲染
+  空心红圈（对齐 VS Code）；栈帧 id 用适配器原生值（emmylua 保持栈下标私有语义），
+  stopped 事件携带的真实 threadId 贯穿调用栈/单步/暂停（多线程适配器必需，emmylua 恒 1 不变）；
+  断点按适配器声明语言过滤下发，杜绝跨语言串发。
+- **能力边界**：`emmylua_attach` 仅 Windows（适配器原生限制）；适配器自动探测
+  `~/.vscode/extensions`、`~/.vscode-server/extensions` 与插件扩展目录
+  `~/.dsh/dsh-vscode-mode/extensions`（与 LSP 探测根一致）；求值/查看变量需处于暂停态。
+  `运行到行` = 临时断点 + 继续（命中/手动继续后自动清理，不污染用户断点表）；
+  `添加触发的断点...` 当前适配器不支持 → 点击给出明确提示（不做静默失败的假功能）。
+
 ## 安装
 
 官方 `dsh plugin` 方式，三选一：
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.5.2
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.6.0
 
 # ② npm 注册表（发布到 npm 后）
 dsh plugin --profile web add dsh-vscode-mode
 
 # ③ GitHub Release tgz 直装
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.5.2/dsh-vscode-mode-0.5.2.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.6.0/dsh-vscode-mode-0.6.0.tgz
 ```
 
 > `dsh plugin ...` 是 pnpm 转发器：git 安装会克隆仓库、执行该包 `prepare` 脚本
@@ -406,11 +458,17 @@ bundles 层后重启 DSH 即自动把插件行挂进 loader 树。**不要**再
 | `F12` / `Shift+F12` | 转到定义 / 查找所有引用 |
 | `Ctrl+点击` / `Ctrl+hover` | 引用导航 / 可导航标识符提示 |
 | `Ctrl+B` | 切换文件管理侧边栏 |
+| `Ctrl+Shift+F` | 工作区搜索（有选中则把选中文本填入搜索框） |
+| `Ctrl+Shift+V` | 切换 Markdown 预览（仅活动文件为 .md 时生效） |
 | `Ctrl+F4` | 关闭当前页签 |
 | `Alt+←` / `Alt+→` | 后退 / 前进（跨文件恢复焦点位置） |
 | `Ctrl+Alt+-` / `Ctrl+Shift+-` | 后退 / 前进（同导航历史） |
 | 鼠标侧键 XButton | 后退 / 前进 |
 | `Tab` / `Enter`（补全中） | 展开代码片段 |
+| `F9` | 调试：切换光标行断点 |
+| `F5` | 调试：启动 / 继续 |
+| `F10` / `F11` / `Shift+F11` | 调试：单步跳过 / 步入 / 步出（暂停态） |
+| `Shift+F5` | 调试：停止 |
 
 ### 差异审查流程
 
@@ -640,6 +698,21 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.6.0**：**编辑器内断点调试（DAP）+ SVN 补丁/汇总/导出**——① DAP 桥通用化
+  （适配器由扩展清单 `contributes.debuggers` 驱动，Lua 链路复用 emmylua 适配器、零游戏侧
+  改动）：行首点击/`F9` 断点（悬停预览红点、禁用灰点、跨刷新持久化）、断点右键菜单与
+  **整宽行内编辑浮层**（表达式/命中次数/日志消息/等待断点，模式内容独立记忆）、
+  `.dsh/launch.json` 启动配置（`F5` 启动/继续、`emmylua_attach` 按进程名自动附加与多候选
+  选择）、命中暂停跳转（chunkname 反向映射工作区文件）、活动栏**四段调试面板**
+  （调用堆栈/变量/监视/断点 + 调试控制台 REPL）；② SVN 增强：补丁对话框、汇总对话框、
+  导出（`svnExport`）。
+- **v0.5.3**：**编辑器四项体验增强**——① `Ctrl+Shift+F` 时编辑器有选中则把选中文本
+  自动填入搜索框并立即搜索（多行选区取首行；侧栏原本收起也生效）；② 页签数量上限
+  （通用设置 `maxOpenEditors`，默认 10，**0 = 不限制**），超限自动关闭**最久未使用**的
+  页签，固定页签与活动页签受保护、脏页签关闭前静默落盘；③ 页签栏溢出时鼠标滚轮即可
+  横向滚动（`Shift+滚轮` 沿用浏览器原生横滚，不溢出时不接管）；④ **Markdown 预览**：
+  `.md` / `.markdown` 经工具栏按钮、`Ctrl+Shift+V` 或命令栏切换 GFM 渲染（标题/列表/
+  表格/代码块/KaTeX），复用官方 `MarkdownText` 原语，零新增依赖、自动跟随 DSH 主题。
 - **v0.5.2**：**修复 macOS / npm 安装形态的兼容问题**——① schema 库按候选链解析
   （官方已把 vendored schemastery 改名为 `@deepseek-ai/schemastery`，安装树里没有裸
   `schemastery`），且 `@deepseek-ai/dsh-settings` 缺失不再拖垮整体 → 修复从 npm 安装时