workspace-groups-remote/CHANGELOG.md

6.2 KiB
Raw Blame History

更新日志

未发布 — 文件夹管理安全性与一致性修复(2026-11-07)

针对「工作区内的文件夹管理」扫描发现的 10 类问题做的一次集中修复。本次只改本插件, 未触碰核心 workspace.json / session 存储;lib/ 已重新构建,Source map 不再随包发布。

数据完整性(高危)

  • 读取 workspace-groups.folders.json 失败(EACCES / EISDIR / JSON 损坏)现在返回 HTTP 500, 不再伪装成「空文档」;客户端 loadFolders 改为 ok:false 并禁用全部编辑,杜绝「读失败 → 下次 PUT 写回空文档 → 所有工作区文件夹永久清空」。
  • 新增基于文件内容的 revision(sha256 前 16 位)+ ETag / If-Match 乐观并发:PUT 不匹配返回 409 并携带服务端最新文档;宿主侧 read→compare→write 串行化,客户端写操作排队、失败回滚、 409 自动重载。多窗口不再静默互相覆盖。
  • 未知 schema 版本只报告 schemaWarning 并禁用编辑,绝不降级写回 v1。
  • PUT body 上限从 64KB 提到 1MB(合法文档上限约 92KB 曾永远 413);保存请求去掉 keepalive 并加 15 秒超时,避免大文档被静默截断。

路径与远程判定

  • canonicalPath 增加 NFC 归一与词法 . / .. 折叠;isAbsoluteFolderPath 改为按路径拼写判定, 宿主与客户端共用同一函数,不再因 process.platform 漂移而丢弃跨平台 sidecar 条目。
  • defaultRemoteMirrorBase 硬编码 ~/.dsh/remote-workspaces 的问题改为显式诊断: $DSH_HOME 与硬编码根不一致时 GET 返回 remoteBaseWarning 并在界面显示。
  • 宿主写校验现在强制 kind:'remote' 的 member.path 必须位于镜像根内,并拒绝 .. 段; 镜像归属不再只靠浏览器自觉。
  • subfolderOf 用浏览器返回的绝对 resolved 路径比较(~ 别名由 openFoldersFor 先解析), 分隔符归一;云端输入框改为显式「本项目子目录 / 独立云端工作区」二选一,消除一个输入框两种语义。

会话与孤儿工作区

  • 创建会话前必须等文件夹 overlay 落盘成功;原生工作区创建失败可补偿注销,远程文件夹创建有 pending 复用,避免重复建镜像。
  • addMember 同路径重注册时保留 root;isDefaultWorkspace 改为路径判据优先; 跨 entry 拒绝「member.workspaceId 同时是 owner」,宽容读会丢弃这类旧数据。
  • parseFolderEntry 允许缺 folders 字段(不再连带丢掉 members),remoteSubpath 与 joinSubpath 对绝对/盘符/UNC 输入的判定统一;joinSubpath 额外拒绝 C:foo。

侧栏文件夹行

  • 一个项目只占一行。此前工作区挂上额外文件夹后,每个文件夹都会变成一条带自己会话列表的行; 云端工作区的路径是本地镜像目录,于是侧栏出现 wmvl31c7ilkuc 这种内部 id,项目自身的 会话又被藏进那一行,看起来像「一个项目套在它自己里面」。
  • 现在不再渲染文件夹行:工作区自己的目录和所有额外文件夹共用同一个会话列表,全部列在 工作区标题下面。文件夹仍然可以在工作区的「⋯ → 管理文件夹」里增删、设根、打开, 只是不再各自分裂出一套会话。
  • 工作区没有额外文件夹时,节点形状与引入文件夹功能之前完全一致。

测试与工程

  • 新增 tests/folders-cas.test.ts、tests/folders-persist.test.ts、tests/remote-paths.test.ts 覆盖上述回归点;tsc -p tsconfig.json / tsconfig.client.json 与 290 个 vitest 用例全部通过。
  • tsdown.config.ts 关闭客户端 sourcemap,lib/client.js.map(内嵌完整源码)已从构建产物移除; .gitignore 补 *.map / *.tsbuildinfo / dist/ / coverage/ / tools/_tmp/,并取消对 docs/ 的忽略,把 remote-ssh-integration-plan.md 纳入版本控制。
  • 工作区根目录新增 README 说明目录职责;dsh-workspace-groups-0.4.2/ 与 tools/ 各加说明, 标明 0.4.2 是有意保留的重建基线,不可删除。未删除/移动任何既有目录或文件。

仍未处理(需另行确认)

  • lib/ 里历史遗留的其它 37 个 tracked 文件是构建产物,未做 git rm --cached;若要改为 构建时再生成,需要同步调整发布流程。
  • iggfeed.yaml 与 tools/fetch_clash_sub.py 含本机代理地址/订阅 URL,仅在工作区 README 中提示, 未改动。
  • remote-ssh 2.4.40 的远程子目录会话限制、SSH 能力完整内置、会话拆分仍是 docs/remote-ssh-integration-plan.md 与任务板里的独立待办,本次未动。

1.0.0 — 2026-10-28

首个本地稳定版本,包名 workspace-groups-local。基于原项目扩展,保留原 MIT 许可证与版权声明。

功能

  • 工作区分组:颜色、图标、置顶、折叠动画、拖拽归组与排序。
  • 分组行新增工作区入口,创建后自动归组并展开。
  • 会话标签:固定、拖拽排序、中键关闭、右键菜单、双击重命名。
  • 多文件夹与默认根目录配置。
  • 移除侧栏花朵的连线,保留花朵标记。

SSH 兼容与修复

  • 顶部与分组新增工作区入口复用已注册的自包含目录选择窗口,包括 remote-ssh 的本地/远程窗口。
  • 未注册选择窗口时,回退 DSH 原生本地目录选择器;不强制依赖 SSH 插件。
  • 统一创建文件夹入口:本地使用 DSH API,远程使用 SSH 插件接口;远程失败禁止回退本地写入。
  • 停止复制子目录 SSH 标记,旧标记不自动删除。
  • 对需要额外渲染器上下文的第三方选择窗口明确报错,不静默丢弃其上下文。

验证与限制

  • 类型检查、构建及纯逻辑/模拟接口回归测试通过。
  • 用户已确认本次界面改动可用;未完成卸载 SSH 插件的独立环境测试及所有真实服务器组合测试。
  • remote-ssh 2.4.40 的远程子目录会话路由不一致:暂时阻止从这些子目录新建会话,可在注册的远程工作区根启动。
  • 本次仅本地 Git 提交与版本标记;未发布 npm、GitHub Release 或插件市场。公开发布前需设置自己的仓库元数据并完成安装验证。