常见问题

现象	原因	解决
改了源码，重启后功能没变	file: 依赖是实体拷贝，DSH 从 node_modules/@local/... 的拷贝加载	跑 node sync-profile.mjs，然后完全退出 DSH 再启动
设置页没有「会话纸篓」卡片	插件未挂载或 bundle 未同步	检查 profile package.json 依赖/bundles 与 pnpm install；同步后重启
删除/恢复后侧边栏归档分组残留一个空条目	平台无移除归档标记的 API，内存里的 archivedSessionIds 保留该 id	重启 DSH 后彻底干净；插件自己的列表不受影响（已按目录存在过滤）
活跃会话展开没有内容	活跃会话的事件日志未完整落盘（关闭时才 flush）	设计如此：只有归档（已关闭）会话能读全文
侧边栏「删除对话」按钮不见了	实验性 DOM 注入：React 重渲染会清除非 React 节点	重新打开该会话的菜单（每次打开都会重新注入）
点「删除对话」提示「无法定位该会话」	标题反查失败（重复标题取第一个，或行标题读取失败）	改用设置页「会话纸篓」卡删除
删除后插件列表仍显示该会话	会话目录删除失败（权限/占用）	检查 ~/.dsh/sessions/<项目>/<id>/ 目录是否还在；手动删除后刷新
卡片提示「无法加载会话列表」	浏览器不是通过本机回环地址访问	桥仅限 loopback；远程访问 DSH 时本插件不可用

实验性功能说明

侧边栏会话菜单注入（「🗑 删除对话」）基于 MutationObserver，是平台菜单无扩展点下的折中方案：

• 会话定位按行标题反查（行 DOM 不携带会话 id），重复标题可能定位到第一个
• 菜单打开期间如果界面重渲染，注入项可能消失（下次打开重新注入）
• 确认框为 DSH 风格（RiskConfirmation），非系统对话框

该功能不稳定属预期，删除始终可回退到设置页卡片操作。