[Bug] 过期的 dsh.workspace.view.v5 会让整个侧边栏浏览器留白（会话历史"消失"）

[HissekiWriting]

[Bug] 过期的 dsh.workspace.view.v5 会让整个侧边栏浏览器留白（会话历史"消失"）

Environment

• dsh 0.1.5-rc.1（dsh web，Windows 11，Chrome/Edge）
• 浏览器 localStorage 中存在旧版本写入的 dsh.workspace.view.v5
• 复现无需任何服务端改动；Host 数据完好（session/list 正常返回，workspace/follow 正常下发 baseline）

Summary

浏览器里若存着结构过期的 dsh.workspace.view.v5（缺少 groupExpansion / sessionOrderByAccount 等字段），sidebar.workspaces 的组件会在渲染时抛 TypeError，被插槽的错误边界吞掉，结果是整块侧边栏浏览器直接消失——只剩「新会话」按钮和「设置」，连「工作区」标题、搜索框都没有。用户会误以为对话历史丢失。

Reproduction

1. 打开 dsh web 的 GUI，按 F12 打开 Console。

2. 写入一个旧结构的状态：

   localStorage.setItem('dsh.workspace.view.v5', JSON.stringify({ groupBy: 'workspace', orderBy: 'updated' }))

3. 刷新页面。

Current behavior

侧边栏只剩 新会话 | 设置，sidebar.workspaces 区域整块留白。Console：

TypeError: Cannot convert undefined or null to object
    at Object.entries (<anonymous>)
    at SessionTree (.../dsh-client-ui-workspace/client.js...)
error: slot entry crashed in 'sidebar.workspaces': TypeError: Cannot convert undefined or null to object

之后再刷新也无法恢复，必须显式清理该 localStorage 键。清理后立即恢复正常：

localStorage.removeItem('dsh.workspace.view.v5')
// 刷新后侧边栏恢复：新会话 | 工作区 | <工作区…> | 设置，Console 无报错

Expected behavior

持久化状态过期或字段缺失时，侧边栏应以默认值正常渲染（工作区分组、全部折叠），而不是整块消失；至少应给出可见的错误提示而不是留白。

Root cause

1. packages/client/store/src/index.ts:154（attachPersistence）恢复时是整体替换，不补默认值、不校验、无 schema 版本：

   api.setState(devFreeze(JSON.parse(raw) as T), true)

2. packages/client/ui-workspace 假定这些字段一定存在：

   • src/client/rows/WorkspaceBrowser.tsx:239 Object.entries(groupExpansion)
   • src/client/stores.ts:83,86（retainAccountKeys）Object.entries(d.groupExpansion) / Object.entries(d.sessionOrderByAccount)

3. packages/client/ui-renderer/src/client/scoped-slots.tsx:334-338（SlotErrorBoundary）捕获后渲染空 div（data-slot-error="sidebar.workspaces"），所以表现为"整块消失"。

触发条件的现实性：同一个 dsh.workspace.view.v5 键下状态结构变过——retainAccountKeys 至今仍在删除一个历史字段 sessionUpdatedAtByAccount（stores.ts:89），说明该键在不同版本间承载过不同字段集；旧版本写入的状态被新版本读到就会缺字段。

Impact

升级后部分用户的侧边栏浏览器会永久不可用，直到手动清 localStorage；由于会话列表一起消失，很容易被判定为"对话历史丢失"。

Suggested fix

• 给 client store 的持久化恢复加 schema/version 与迁移，或至少与 init() 浅合并（{ ...init, ...parsed }）并校验 JSON；
• 状态结构变化时提升 persist key（v5 → v6）而不是沿用同键；
• ui-workspace 侧对 groupExpansion / sessionOrderByAccount 兜底默认值。

Workaround

F12 → Console → localStorage.removeItem('dsh.workspace.view.v5') → 刷新。

[sunhaolin]

独立复现确认：本问题在 0.1.5-rc.2 上依然存在，且与平台无关。

Environment（补充数据点）

• @deepseek-ai/dsh: 0.1.5-rc.2（dsh-client-ui-workspace / dsh-web-frontend / dsh-api-session-controller 同为 0.1.5-rc.2）
• macOS 26.4.1 (build 25E253), arm64；Node v22.20.0
• Chromium 内核浏览器（Edge / Chrome 153）
• 启动方式：npx @deepseek-ai/dsh web

也就是说：从 rc.1 到 rc.2 未修复，且不限于 Windows / Chrome。

补充：Host 侧证据（出问题时同机采集）

用于排除服务端因素，经 RPC 直接调用（POST /api/<namespace>/<method>，{type:"client-request",rpcId,method,payload:{args:{}}}）：

• workspace/follow 的 baseline 完整：2 个工作区、出事工作区下 4 个 sessionIds 齐全、archivedSessionIds: []
• session/list 返回全部 5 个会话，blank 均为 false，projections.values.title 齐全
• /plugins/??…（全部客户端插件合并包）返回 200，11,091,135 bytes

结论与你一致：Host 完全正常，纯粹是浏览器侧持久化状态导致的前端崩溃。

两个可以补充的观察

1. 这个坏状态不会自我修复，所以「必须手动清 localStorage」是必然的，而不是偶然：

retainAccountKeys 在给 d.groupExpansion 赋值之前就抛异常；而 store 的持久化走 JSON.stringify，会丢弃值为 undefined 的字段。于是坏 blob 被原样保留，每次加载重新触发同一个崩溃。

2. 水合的「整份替换」语义，即你建议的 { ...init, ...parsed } 那处的现状：

function Tc(t, r) {                 // t = store, r = localStorage key
    const i = localStorage.getItem(r);
    i !== null && t.setState(M6(JSON.parse(i)), !0);   // M6 仅做深冻结
}

水合后的 state 就是持久化 JSON 本身，init() 的默认值完全不参与 —— 这正是「旧 blob 缺字段 → 直接变成 undefined → Object.entries 抛错」而不是被默认值兜住的原因。

备注

#7005（"dsh没办法新开会话……后端成功请求了，但是侧边栏看不到，也没有开始的界面"）症状相同，但正文基本为空（无复现信息）。若排查看得出同因，或可一并关联处理。