dsh-vscode-mode 0.13.1 → 0.14.1

package/README.md

@@ -424,23 +424,52 @@ 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 或其他命名
 profile 请替换为实际目标，不要把示例目录当成当前运行 profile。升级前可阅读
-[0.13.0 发布与迁移说明](docs/release-0.13.0.md)。
+[0.14.1 适配与发布说明](docs/release-0.14.1.md)。
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.13.1
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.14.1
 
 # ② npm 注册表（发布到 npm 后）
-dsh plugin --profile web add dsh-vscode-mode
+dsh plugin --profile web add dsh-vscode-mode@0.14.1
 
-# ③ GitHub Release tgz 直装
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.13.1/dsh-vscode-mode-0.13.1.tgz
+# ③ GitHub Release tgz 直装（Release asset 可用后）
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.14.1/dsh-vscode-mode-0.14.1.tgz
 ```
 
+> **DSH 0.2.0-rc.1 安装修复**：`0.14.1` 仅精确放行此 DSH 版本；旧版
+> `0.14.0` 仍会被其 peer 门禁拒绝，其他 0.2 版本须另行适配。Tag 推送后需等
+> GitHub Actions 发布完成，npm 还须确认该版本可查询；在产物未就绪时，可依
+> [0.14.1 适配与发布说明](docs/release-0.14.1.md) 构建并安装本地包。若添加 bundle 后尚未激活，
+> 在方便时重启目标 DSH Host 并刷新原页面（本次 Web profile 已即时挂载）。
+>
 > `dsh plugin ...` 是 pnpm 转发器：git 安装会克隆仓库、执行该包 `prepare` 脚本
 > （tsdown 双面构建）后安装，再按 `dsh.bundle` 声明自动加入 profile 的 bundles
 > 层。若 pnpm 提示构建脚本需批准，把 key 加到
@@ -768,6 +797,19 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.14.1**：**DSH Web 0.2.0-rc.1 安装兼容**——六项 DSH peer 精确加入
+  `=0.2.0-rc.1`，保留已有 0.1.x 范围，继续拒绝其他未经适配的 0.2 版本；
+  版本线报告单列 rc.1。已完成 Web 安装、挂载与编辑器基础冒烟，完整功能和
+  Desktop 等其他平台尚未逐项验收。详见 [0.14.1 适配与发布说明](docs/release-0.14.1.md)。
+- **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()`；官方入口不可用时