dsh-vscode-mode 0.13.0 → 0.14.0

package/README.md

@@ -65,8 +65,9 @@
 分类 / 当前键位；需要打开文件的命令在空编辑器时自动隐藏。
 
 - **单一数据源**：命令目录（`ui/commandCatalog`）驱动命令栏和官方快捷键目录；
-  设置 →「快捷键」可查看官方目录与编辑插件命令，绑定经 DSH 官方服务保存。旧版 DSH
-  没有该服务时继续使用原有窗口按键派发，旧 `keybindings` 设置仍可生效。
+  键位查看/改绑统一走 DSH 官方快捷键配置（设置 → VSCodeMode → 通用 →
+  「打开官方快捷键配置」，或 `Ctrl+/`），插件不再自建录键界面，绑定由官方服务持久化。
+  旧版 DSH 没有该服务时继续使用原有窗口按键派发，旧 `keybindings` 设置仍可生效。
 - **开放注册表**：`window.__edrvCommands__` 暴露 `register()` 注册命令；插件
   不再提供独立的运行时键位注册，改用 DSH 官方 shortcuts 配置。
 - **开箱 20 条命令**：保存 / 快速打开 / 在文件浏览器中打开 / 显示所有命令 /
@@ -423,6 +424,29 @@ TortoiseSVN（`TortoiseProc.exe`）仅作 Windows 过渡增强：自研能力覆
   `运行到行` = 临时断点 + 继续（命中/手动继续后自动清理，不污染用户断点表）；
   `添加触发的断点...` 当前适配器不支持 → 点击给出明确提示（不做静默失败的假功能）。
 
+### 18. 界面状态记忆（v0.14.0，跨重启）
+
+DSH 每次启动监听随机端口，`http://127.0.0.1:<port>` 就是浏览器 origin，**只写
+`localStorage` 的界面状态换一次启动就全丢**。本版把界面状态镜像到 DSH home，重启后
+自动恢复。
+
+- **记忆项**：打开的页签与活动页签（含固定态）、每个文件的光标与滚动位置（Monaco
+  `saveViewState()`）、侧栏开关/宽度/面板、资源管理器展开与工作区折叠、官方编辑 Tab
+  激活态、Markdown 预览态（按文件）、导航历史（前进/后退）、规则分页、搜索面板、
+  SVN 过滤与折叠、调试面板监视与折叠、DAP 四段分栏高度、断点（按适配器语言）。
+- **存储位置**：`DSH_HOME/dsh-vscode-mode/cache/workspace/<hashOf(cwd)>/ui.v1.json`
+  （工作区私有）与 `cache/user/ui-globals.v1.json`（跨工作区共享，如工作区折叠）。
+  写前合并，同一文件内多工作区/多键互不覆盖；单键超 64 KB 分片上传。
+- **不镜像**：目录条目缓存（`edrv.cache.entries.v2.*`，体积大且可重建）；临时弹窗、
+  未落盘的编辑缓冲不恢复。
+- **恢复语义**：启动时取回镜像回填 `localStorage`，**本地已有值一律保留**（不覆盖
+  当前 origin 的真实状态）；回填完成后广播 `edrv:ui-state-ready`，晚到的界面组件据此
+  重跑恢复。取回失败按 8×800ms 有界重试，重试耗尽则退回纯 `localStorage`（行为与
+  0.14.0 之前一致），不阻断插件加载、不拖慢启动（slot 注册前最多等 600ms）。
+- **自检**：设置页「兼容性」与 RPC `edrv.compat` 可查看运行时报告；镜像读写的时间线记在
+  `DSH_HOME/dsh-vscode-mode/logs/debug.<hashOf(cwd)>.log`（无会话期诊断落在
+  `debug.<hashOf('ui-state')>.log`）。
+
 ## 安装
 
 官方 `dsh plugin` 方式，三选一。下面以 `web` profile 为例；Desktop 或其他命名
@@ -431,13 +455,13 @@ profile 请替换为实际目标，不要把示例目录当成当前运行 profi
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.13.0
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.13.1
 
 # ② 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.13.0/dsh-vscode-mode-0.13.0.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.13.1/dsh-vscode-mode-0.13.1.tgz
 ```
 
 > `dsh plugin ...` 是 pnpm 转发器：git 安装会克隆仓库、执行该包 `prepare` 脚本
@@ -481,7 +505,9 @@ bundles 层后重启 DSH 即自动把插件行挂进 loader 树。**不要**再
 ### 快捷键速查
 
 以下是桌面端常见默认键位；Web / Linux 的浏览器或系统保留键可能不绑定。
-实际生效键位以「设置 → 快捷键」为准；旧版 DSH 无官方 shortcuts 时沿用原有键位。
+实际生效键位以 **DSH 官方快捷键配置**为准：设置 → VSCodeMode → 通用 →「打开官方
+快捷键配置」（或 `Ctrl+/`）。插件命令与官方命令同表展示、由官方统一校验冲突；
+旧版 DSH 无官方 shortcuts 时沿用原有键位。
 
 | 快捷键 | 功能 |
 |---|---|
@@ -526,23 +552,25 @@ bundles 层后重启 DSH 即自动把插件行挂进 loader 树。**不要**再
 
 ## 配置
 
-设置 →「快捷键」页：官方目录总览和插件快捷键录制、逐项恢复；编辑通过官方
-shortcuts 服务持久化（Desktop：`userData/keybindings.json`；Web：
-`localStorage` 的 `dsh.keybindings.v1`）。旧版插件 `keybindings` 配置的单候选自定义值
-按当前平台一次性尝试迁入官方存储；旧配置始终保留供其他平台及人工恢复，
-多候选、冲突、不支持或未绑定的旧值不会被部分迁入或删除。
+键位配置统一走 DSH 官方快捷键：设置 → VSCodeMode → 通用 →「打开官方快捷键配置」
+（等价 `Ctrl+/`；官方入口不可用时按钮就地给出手动打开方式）。录键、冲突校验、
+按平台默认值、恢复默认都在官方弹窗内完成，插件不再自建录键页面。键位持久化由官方
+服务负责（Desktop：`userData/keybindings.json`；Web：`localStorage` 的
+`dsh.keybindings.v1`）。旧版插件 `keybindings` 配置的单候选自定义值按当前平台
+一次性尝试迁入官方存储；旧配置始终保留供其他平台及人工恢复，多候选、冲突、
+不支持或未绑定的旧值不会被部分迁入或删除。
 
 v0.13.0 在 0.12 官方接管的基础上修正真实 `normalized` 绑定与物理 Control/Meta
-的转换；录制先进入官方 recording 状态，并在确认、取消、失败、失焦及卸载等退出
-路径收尾，避免原生快捷键拦截长期停用。首次打开命令面板/QuickOpen 等入口按当前
-会话 scope 路由，不要求编辑器先挂载。Web 工作区搜索使用官方当前平台允许的
-三修饰符组合，最终显示与冲突判断以官方目录为准。
+的转换；首次打开命令面板/QuickOpen 等入口按当前会话 scope 路由，不要求编辑器先挂载。
+Web 工作区搜索使用官方当前平台允许的三修饰符组合，最终显示与冲突判断以官方目录为准。
+v0.13.1 起插件不再自建录键界面（原独立「快捷键」设置页与共享录制模块已移除），
+改由通用页的「打开官方快捷键配置」入口直达官方弹窗。
 
 设置 →「VSCodeMode」页：
 
 | 分区 | 说明 |
 |---|---|
-| 通用 | 编辑器宽度（180–560）等 / 系统集成卡片 / 文件链接使用工具 / 开发形态开关 |
+| 通用 | 编辑器宽度（180–560）等 / 系统集成卡片 / 文件链接使用工具 / 开发形态开关 / 官方快捷键配置入口 |
 | 我的 MCP / 项目 MCP | MCP 服务器可视化管理（stdio / streamable-http） |
 | 性能优化 | 会话盘点 / 移出归档 / 压缩调优 / 侧车摘要指引 |
 | 兼容性 | 兼容性报告（外部插件探测、路由 / 重复装配护栏）、插件技能组装载状态、旧版形态引导 |
@@ -763,6 +791,20 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.14.0**：**界面状态跨 DSH 重启恢复**——DSH 每次启动端口随机，origin 一变
+  `localStorage` 就换了一份空的，插件的页签、光标、侧栏、编辑 Tab 等全部界面状态都
+  随之丢失。本版把界面状态镜像到 DSH home（`cache/workspace/<hash>/ui.v1.json` 与
+  `cache/user/ui-globals.v1.json`，写前合并），新增 RPC `edrv.uiState.get/set`，客户端
+  包装 `localStorage` 写口去抖推送、启动回填并广播 `edrv:ui-state-ready`；同时补上
+  官方编辑 Tab 激活态、Markdown 预览态与导航历史三项记忆。发布前两轮现场复盘修掉两个
+  并存根因：水合冷启动失败即永久放弃（现为 8×800ms 有界重试 + 重试耗尽也广播就绪）、
+  界面在回填前写空初值把存档覆盖掉（现为「水合结束前不写存档 + 迟到回填后重跑恢复」）。
+  详见 [0.14.0 发布说明](docs/release-0.14.0.md)。
+- **v0.13.1**：**快捷键入口收敛到官方弹窗**——移除插件自建的独立「快捷键」设置页
+  （含行内录键编辑器与共享录制模块 `shortcutRecorder.ts`），改在 VSCodeMode → 通用页
+  提供「打开官方快捷键配置」一键跳转（`openOfficialShortcuts()`；官方入口不可用时
+  就地给出手动打开方式）。键位查看、录键、冲突校验与恢复默认全部由 DSH 官方弹窗承担，
+  避免同一套录键逻辑两处维护；0.13.0 的绑定转换修复与 Web 三修饰符默认值不变。
 - **v0.13.0**：**Host 鉴权与 Desktop 适配、项目 MCP 三面隔离、外部打开回执**——
   `/edrv` 路由接入官方认证与有界请求体读取，URL 保留应用子路径并支持 `dsh-app:`；
   项目 MCP 改为每 agent 挂载，隔离工具/资源/指令，新增配置态、未验证状态与实例数；