归档会话抽屉feverZHONG/dsh-liya-archives

dsh-liya-archives · 归档会话抽屉（莉娅版）

抄改自 chou109/dsh-archives（MIT）。
社区礼仪：保留原作者版权声明与本改造说明，任何分发请保留 LICENSE 全文。

DSH Web 侧边栏底部的归档会话抽屉：把被归档后「消失」的会话找回来。

DSH 会话归档后只从侧边栏隐藏，日志和数据都还在磁盘上，但界面没有任何恢复入口。
本插件在侧边栏底部加一个「已归档 (n)」按钮，列出全部归档会话、按工作区分组，一键操作：

| 操作 | 效果 |
|:-----|:-----|
| 点击会话行 | 恢复并打开（取消归档 → 等集合同步 → 打开，实时生效） |
| ⿻ 按钮 | 复制为新会话并打开（原会话保留在已归档） |
| ↻ 按钮 | 仅移回侧边栏，不打开 |

与原版（chou109/dsh-archives）的差异

| 项 | 原版 | 莉娅版 |
|:---|:-----|:-------|
| 包名 / bundle id / 槽位 id / locale NS | dsh-archives | dsh-liya-archives |
| host 路由 | POST /archives/unarchive | POST /liya-archives/unarchive |
| 列表 key | 渲染有 React key 警告 | 已补 key 修复 |

功能与 UI 语义（按工作区分组折叠、展开状态记忆、中英双语文案、点面板外关闭、rail 收起模式、无归档自动隐藏）与原版一致。

结构

dsh-liya-archives/
package.json        # name 必须等于 bundle id 和加载器 name
cordis.patch.yml    # 挂载条目（insert → web profile）
index.js            # host 半：POST /liya-archives/unarchive
client.js           # browser 半：sidebar.footer.action 槽位 UI
LICENSE             # MIT（含原版与改造版权声明）
tests/              # 冒烟测试（host + client，无外部依赖）

自检与打包

冒烟测试（host + client，无外部依赖，用 DSH profile 的真实依赖跑）
$env:DSH_PROFILE_NODE_MODULES = ""
node tests/host-test.mjs
node tests/smoke-test.cjs

打包（产物为可分发 tgz）
pnpm pack

安装到 DSH

dsh plugin --profile web add

dsh 请替换为阁下 DSH 安装对应的 CLI 调用方式。

装完重启 WebUI（client 半生效需要），侧边栏底部出现「已归档 (n)」；
没有任何归档会话时按钮自动隐藏——先归档一个会话再验证。

数据契约

- 归档集合：$DSH_HOME/storages/workspace.json → global.archivedSessionIds
- 取消归档走 workspace registry 自身写路径（enqueueOperation → setState），
经 domain/changed → host/archived-sessions-changed 帧实时同步所有标签页
- 直接 open() 归档会话会被运行时清除选中（框架设计）——所以「恢复」必须先取消归档、等集合同步再打开

已知限制

- 面板是固定定位浮层，与 Cordis 插件面板同时打开会重叠
- 针对 dsh 0.1.0-rc.5/rc.6 开发验证；升级 DSH 后若槽位/服务名变更需适配