工作区分组路径大小写不一致 → 分组成员静默消失、新会话无法入组（日志实锚+恢复配方）

[JakeLi168]

环境

• DSH 0.1.1-rc.2，macOS（APFS 大小写不敏感），桌面壳 + web 双实例共享 ~/.dsh

现象

1. 某工作区分组下的历史会话"集体消失"（实际被归到「未分组」），用户视角近乎数据丢失
2. 在这些分组下点「+」新建会话：会话创建成功（日志都在）但分组里永远看不到
3. 相关会话侧栏标题回退成目录名而不是真实标题

根因（日志 + 源码实锚）

~/.dsh/storages/workspace.json 里工作区记录的 path 与磁盘真实目录名大小写不一致。本机实例（外部编辑账本时写错的典型现场）：

• 记录 …/Deepseek Harness/Tests，磁盘真身 …/Deepseek Harness/tests
• 记录 …/workspace/DSH Projects，磁盘真身 …/Workspace/DSH Projects

应用内部把会话 cwd 与工作区 path 都经 realpath 规范化为磁盘真身大小写后做严格相等比对，于是：

• WorkspaceEntity.sessionIds getter 按 sessionPath(id) === record.path 过滤 → 成员被过滤出分组，每次启动 reportFilteredCandidates 都会打 warn（原文示例）：

  workspace 'fx-ws-test-archive' filtered session 'session-xxx' from membership:
  canonical cwd '/Users/jakeli/Documents/Deepseek Harness/tests' differs from workspace path '/Users/jakeli/Documents/Deepseek Harness/Tests'
  

• attachSession 同样硬校验 → 新会话挂接静默失败（客户端无任何错误提示）

• APFS 默认大小写不敏感，stat() 对任何大小写拼写都成功，整条链路只有注册表比对这一层大小写敏感，且失败仅有一条日志 warn——用户侧表现就是"分组空了/会话丢了/加不进分组"，实际数据都在

本机恢复配方（已验证）

把记录 path 对齐磁盘真身大小写 + 把漏登记的会话 id 补回 sessionIds + 重启持有实例，分组即恢复（4 条老会话带标题归位、新建会话正常入组）。

附带三个相关发现

1. session.create 的 workspaceId 与 cwd 互斥，只带 cwd 创建的会话完全不执行 attach——经 spawn 类工具按 cwd 创建的会话永远留在「未分组」；且部分返回消息会提示"已挂接工作区 X"，易误导（实际未登记）
2. 会话右键菜单只有 重命名/分叉/归档，没有「移动到工作区/分组」；由于分组归属由 cwd 决定，跨目录移动在应用层也确实不可能——但"会话随 cwd 归组"与"用户想按项目手动整理"之间存在缺口
3. 注册表 bootstrap（全量扫盘归账）只在 initialized=false 时跑一次，之后永不重扫——磁盘上已存在的会话不会被自动找回，只能靠创建时入组或手工修账

建议

• 工作区分组匹配对 path 做大小写不敏感比较；或启动时检测记录 path 与磁盘真名的大小写差异，自动对齐并 warn
• 把 reportFilteredCandidates 的过滤情况在客户端可见（比如分组旁一个小标记），用户就不会以为数据丢了
• 考虑提供「移动到分组」入口（对 cwd 匹配的目标分组放开）

[JakeLi168]

补充一条新实证（2026-09-07 复现闭环）：双实例共享 workspace.json 的 last-write-wins 竞争，会静默抹掉另一实例刚挂好的组。

现象：同一天下午在 web 端（3080）创建的 2 个会话，创建时 attachSession 成功、写盘正常；之后壳端（43120）因新建会话触发写盘，用壳的旧内存整文件覆盖，把 web 端挂的 2 个成员从磁盘抹掉。重启后这 2 个会话落入「未分组」；同一时间窗口壳端创建的会话全部存活（对照组铁证：同 cwd、同创建方式、仅实例不同，一活一丢）。

机制链：

• workspace.json 由壳(43120)+web(3080) 双实例共享，storage-json 是「in-memory state is authoritative + 每次写整个文件原子重发布」；
• 实例 A 的 attach 只进 A 的内存；实例 B 任意一次写盘（新会话 attach / 工作区操作）都会用 B 的旧内存覆盖整个文件 → A 的挂组从磁盘消失；
• 重启后按磁盘账本分组 → 会话落「未分组」，且 UI 无「移动到分组」入口，只能手改账本（或补入 sessionIds 后重启双实例）。

另外已给 session.create 的 cwd-only 分支补入口兜底：resolveByPath(cwd) → attachSession（fail-open），de_session spawn 的 cwd-only 会话实测自动入组。但该补丁解决不了双实例覆盖——建议官方为共享域实现 merge-on-write 或单一 writer（文件锁），否则多实例场景下挂组随时可能被静默覆盖。