# [Bug] Sidebar history sessions and workspaces completely lost, and current session has no corresponding entry (Data loss risk)

[beishanhai]

[Bug] Sidebar history sessions and workspaces completely lost, and current session has no corresponding entry (Data loss risk)

🐛 Description

While using DSH, a severe state loss issue occurred:

1. Sidebar completely empty: All historical session records disappeared, leaving only the "New Session" and "Settings" buttons.
2. No corresponding entry for the current session: Even if a conversation can be opened or re-entered, there is no corresponding highlighted entry for it in the left sidebar.
3. Workspaces lost: Original workspace configurations and environmental states have all disappeared.
4. Refreshing the page or restarting the application does not recover them. Suspected local data reset or migration failure.

🖥️ Environment

• DSH Version: v0.1.7-rc.1 (Modify as needed, e.g., v0.1.5-rc.2 / v0.1.7-alpha.2)
• Runtime: Web / DSH Desktop (Community desktop client, please specify the project) / Running from source
• OS: macOS / Windows / Linux (Please specify version)
• Browser: Chrome / Edge / Firefox (If Web, please specify version)
• Installation Method: Global npm / npx / Built from source / Desktop client installer

🔁 Steps to Reproduce

1. Open DSH, normally create and save multiple sessions, and perform operations within their corresponding workspaces.
2. Normally exit, refresh the page, or update/restart the application.
3. Reopen DSH, and find that the sidebar history list is completely empty.
4. Try to create or resume a session, the sidebar still shows no corresponding entry.
5. Check workspaces, and find that original workspace configurations and context are all lost.

🎯 Expected Behavior

1. The sidebar should normally display all historical session records.
2. The currently opened session should have a corresponding highlighted entry in the left sidebar.
3. Workspace configurations and historical states should remain intact.

❌ Actual Behavior

1. The sidebar is completely empty, and all historical records are gone.
2. Opening any session shows no corresponding entry in the sidebar.
3. Original workspace configurations and states are lost, making it impossible to continue previous context.

🛠️ Troubleshooting Steps Taken

• Refresh page / Restart software (Ineffective)
• Check local ~/.dsh directory data files:
  • ~/.dsh/sessions/ or ~/.dsh/profiles/ (Confirm whether session data files still physically exist)
  • ~/.dsh/workspaces/ (Confirm whether workspace data is lost)
  • Please note the result here: Files still exist / Files are lost / Files exist but cannot be parsed
• Disable all third-party plugins (e.g., DSH-better-sidebar) and restart
• Check browser console (F12) or terminal for error messages (e.g., database connection failure, JSON parse error)
• Try creating a new Profile and logging in again

📝 Additional Context

Note: Recent DSH upstream has many breaking changes (e.g., profile format migration). This issue not only involves UI rendering but is also accompanied by severe loss of session records and workspace data. It is suspected that database migration failed during version upgrade, or old Profile parsing crashes caused the frontend to forcefully reset local state. Since this involves core data loss, we hope the official team can prioritize investigating data loading and persistence logic and provide a data recovery solution.

[PerryLink]

先说一句要紧的：你的数据大概率没丢——而且"整块都空了"这条线索很关键

0. 你那份报告的模板没填

正文里还留着占位符：DSH Version: v0.1.7-rc.1 (Modify as needed...)、Runtime: Web / DSH Desktop (please specify the project) / ...、Browser: Chrome / Edge / Firefox (If Web, please specify version)。

（你写的 v0.1.7-rc.1 是真实存在的版本，而且目前是最新的一个；npm 上的 next 就指向它。所以这句可以留作依据，不过还是麻烦贴一下 dsh --version 的实际输出，因为上面那些占位符没填的话，我没法确认你到底是哪一版、哪种安装方式。）

1. 所有状态都在一个目录下，先确认你找的是同一个目录

DSH 的用户数据根目录由 DSH_HOME 决定，缺省是 ~/.dsh（packages/util/home-paths/src/index.ts）：

/** Directory name for the default DeepSeek Harness home under the OS home. */
export const DSH_HOME_DIR_NAME = '.dsh'
/** Environment variable that overrides the default DeepSeek Harness home. */
export const DSH_HOME_ENV = 'DSH_HOME'

在这个根下面：存储根是 $DSH_HOME/storages（packages/bundle/base/cordis.patch.yml:171 → root: !!js dshHomePath('storages')），工作区注册表就在这个存储里；会话日志在 $DSH_HOME/sessions/<编码后的工作目录>/session-<id>/session.jsonl*。

⇒ "侧边栏空了 + 工作区也没了 + 重启不恢复"这个组合，最像的解释是：现在跑的这份 dsh 用的不是同一个 home。 请按顺序确认：

1. DSH_HOME 是否被设置了（在你启动 dsh 的那个环境里查，不只是你随手开的终端里）——一旦设置，它会覆盖 ~/.dsh。
2. 启动方式有没有变：全局 npm 装的 / npx / 桌面客户端。docs/architecture.md:53 明确写着桌面端拥有保留的 $DSH_HOME/profiles/desktop，而且 "CLI and Desktop share product data" ——但如果你的启动方式变了、或换了个用户账户，~ 就不是同一个。
3. 是不是换了 OS 用户、换了机器、或者从 WSL 切到原生（反之亦然）——这几种情况 ~ 都不一样。

2. 先证明数据还在（这一步最重要）

直接去看那个根目录：

echo "DSH_HOME=${DSH_HOME:-<unset, so ~/.dsh>}"
ls -la ~/.dsh/                       # sessions/ storages/ profiles/ ...
ls -la ~/.dsh/sessions/ | head       # 每个会话一个目录

如果 ~/.dsh/sessions/ 下面的会话目录还在、且里面的 session.jsonl* 非空，那么对话内容没丢，这只是一个"列不出来"的问题——绝对不要清空或重装去"修复"它。

3. 如果数据确实在同一个 home 里，按这个顺序查

1. 归档过滤器：侧边栏有归档筛选（代码里是 ArchivedFilter = 'default' | 'show' | 'only'），default 会把已归档的会话藏起来。先打开"视图选项"把归档显示出来，看是不是它们被归档了。
2. 列表请求有没有失败：打开浏览器开发者工具 → Network，看会话列表那个请求的返回码与响应体。如果是 gateway/internal 之类的错误，那就是"列不出来"而不是"没有"，磁盘上是好的。我见过同族的错误在界面上表现为红色横幅（例如 历史加载失败: ...）——你那边有没有类似的横幅？
3. 只有工作区注册表丢了：如果 storages 里的工作区记录没了，会话不会消失，而是会落到"未分组"桶里（tree.ts 把不属于任何 workspace 的会话归到 UNGROUPED_KEY）。所以**"连未分组里也没有"**才指向更上游的问题——这一点值得你确认一下：侧边栏是"什么都没有"，还是"有会话但不分组了"？

4. 麻烦你补这几条（有了我就能给准确结论）

1. dsh --version 的实际输出；以及是 dsh web 还是桌面客户端。
2. 操作系统与版本、浏览器版本（模板里那三项）。
3. echo $DSH_HOME（在启动 dsh 的那个环境里）＋ ls ~/.dsh/sessions/ | wc -l。
4. 开发者工具里会话列表请求的返回码/响应体，以及界面上有没有红色错误横幅。

我不太愿意在没有这些信息的情况下猜"数据被重置了"——从代码看，列表是从磁盘状态推出来的投影，所以"显示为空"和"数据没了"是两件需要分开证实的事，而前者远比后者常见。

[beishanhai]

[已解决] 侧边栏会话记录与工作区全部消失：前端 localStorage 状态损坏导致组件崩溃

📌 问题描述

在使用 DSH 时，左侧边栏的历史会话记录和工作区列表突然全部消失，界面显示为空白。重启 DSH、刷新页面均无法恢复。但经检查，本地磁盘 ~/.dsh 目录下的 sessions/ 和 workspace.json 等数据文件完好无损，说明数据并未丢失，问题出在前端渲染层。

🖥️ 环境信息

• DSH 版本：v0.1.7-rc.1
• 操作系统：Windows
• 浏览器：Microsoft Edge（Chromium 内核）
• 安装方式：本地启动（通过 PowerShell 运行 dsh web）
  补充的信息：

Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.

PS C:\Users\Deepmoon> echo "DSH_HOME=${DSH_HOME:-<unset, so ~/.dsh>}"
DSH_HOME=
PS C:\Users\Deepmoon> # 1. 查看当前 dsh 的准确版本
PS C:\Users\Deepmoon> dsh --version
0.1.7-rc.1
PS C:\Users\Deepmoon>
PS C:\Users\Deepmoon> # 2. 查看 DSH_HOME 环境变量是否被修改过
PS C:\Users\Deepmoon> echo "DSH_HOME=${DSH_HOME:-<unset, so ~/.dsh>}"
DSH_HOME=
PS C:\Users\Deepmoon> # 1. 查看 DSH 版本
PS C:\Users\Deepmoon> dsh --version
0.1.7-rc.1
PS C:\Users\Deepmoon>
PS C:\Users\Deepmoon> # 2. 查看环境变量 DSH_HOME 是否被修改（如果输出为空，说明没改过）
PS C:\Users\Deepmoon> echo $env:DSH_HOME
PS C:\Users\Deepmoon>
PS C:\Users\Deepmoon> # 3. 查看默认用户目录下的 .dsh 文件夹内容
PS C:\Users\Deepmoon> dir $env:USERPROFILE\.dsh\


    目录: C:\Users\Deepmoon\.dsh


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2026/8/15     19:35                .agent-presets
d-----         2026/8/16     21:32                attachments
d-----         2026/9/23     23:57                llm-deepseek
d-----         2026/9/12     23:44                prices
d-----         2026/9/23     23:49                profiles
d-----         2026/8/23     22:28                runtimes
d-----         2026/9/17     15:29                sessions
d-----         2026/9/24      8:59                storages
-a----         2026/8/14     19:03             37 .anonymous-user-id
-a----         2026/9/14     13:25            408 .credentials.yaml
-a----         2026/9/23     23:48           1564 settings.yaml
-a----         2026/9/18      0:58           1533 settings.yaml.imported

PS C:\Users\Deepmoon> # 4. 查看 sessions（会话记录）目录下的内容
PS C:\Users\Deepmoon> dir $env:USERPROFILE\.dsh\sessions\

    目录: C:\Users\Deepmoon\.dsh\sessions


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2026/8/20     22:04                --C-Users-Deepmoon-Desktop-cherck-third_test--
……
d-----         2026/8/17     20:48                --D-app-deepseek_HARNESS-plugs_contorl-clean--

PS C:\Users\Deepmoon> # 5. 统计有多少个会话文件夹
PS C:\Users\Deepmoon> (Get-ChildItem $env:USERPROFILE\.dsh\sessions\).Count
43
PS C:\Users\Deepmoon> # 6. 查看会话文件夹里的具体文件（验证 session.jsonl 是否真的存在）
PS C:\Users\Deepmoon> dir $env:USERPROFILE\.dsh\sessions\*\

    目录: C:\Users\Deepmoon\.dsh\sessions


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2026/8/20     22:04                --C-Users-Deepmoon-Desktop-cherck-third_test--
d-----         2026/8/20     22:52                --C-Users-Deepmoon-Desktop-third_test--
……
d-----         2026/9/24      8:59                --D-app-deepseek_HARNESS-plugs_contorl--

中间有些信息省略了，重要信息都有

🔍 排查过程与无效尝试

在定位到根本原因之前，曾尝试过以下方法，但均未能解决问题：

1. 检查本地数据目录：确认 ~/.dsh/sessions/ 下的会话目录及 session.jsonl 文件均存在，workspace.json 内容完整且包含所有工作区与会话 ID。
2. 清理投影缓存：将 ~/.dsh/storages/session_projcache.json 及同名文件夹重命名为 .bak，重启后问题依旧。
3. 禁用第三方插件：将所有第三方插件禁用后重启，侧边栏仍然空白。
4. 二分法隔离会话文件：未发现单个会话文件损坏导致整体崩溃的迹象。

以上尝试均无效，说明问题不在磁盘数据或插件，而在于浏览器端的状态存储。

🎯 根本原因分析

打开浏览器开发者工具（F12），在 Console 中发现了以下关键报错：

TypeError: Cannot convert undefined or null to object
    at Object.entries (<anonymous>)
    at retainAccountKeys (client.js:218:1)
    at index-BKQ_L1z6.js:56:69359
    ...
slot entry crashed in 'sidebar.workspaces': TypeError: Cannot convert undefined or null to object
    at Object.entries (<anonymous>)
    at retainAccountKeys (client.js:218:1)   
    ...

为了避免此类单点故障再次导致严重的 UI 崩溃和用户恐慌，提出以下改进建议，供团队参考评估：

增加防御性编程，避免单点崩溃

涉及代码：client.js:218 中的 retainAccountKeys 函数。

当 state.groupExpansion、state.sessionOrderByAccount 或 state.sessionUpdatedAtByAccount 为 undefined 或 null 时，直接调用 Object.entries() 会导致组件崩溃。