86 lines
6.2 KiB
Markdown
86 lines
6.2 KiB
Markdown
# 更新日志
|
||
|
||
## 未发布 — 文件夹管理安全性与一致性修复(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 或插件市场。公开发布前需设置自己的仓库元数据并完成安装验证。
|