@swxs/archive-restore

Readme

# @swxs/archive-restore

DSH Web 客户端插件：查看已归档会话，并一键恢复到原位置。

## 功能

安装后，Web 客户端侧边栏底部会出现 **「归档」** 入口，点击打开归档面板。

| 功能 | 说明 |
|---|---|
| **查看归档列表** | 展示所有已归档会话的标题、原工作区（或未分组）、归档顺序（`#N`） |
| **搜索与过滤** | 按标题、原工作区名、Session ID 前缀搜索；按工作区 chip 过滤 |
| **恢复原位置** | 点击行尾 ↻ 取消归档，会话回到归档前的位置（席位保留） |
| **安全保护** | 进行中的 live 会话拒绝恢复；仅修改归档记账，不触碰会话日志 |

## 安装

### 从 npm 安装（发布后）

```bash
dsh plugin --profile web add <url>
```

安装完成后重启 DSH Web 客户端（或重新加载 web profile），侧边栏底部应出现「归档」按钮。

## 卸载

```bash
dsh plugin --profile web remove @swxs/archive-restore
```

卸载后重启 DSH Web 客户端。卸载不会删除已归档的会话数据。

## 使用

1. 在 DSH Web 客户端侧边栏底部点击 **「归档」**。
2. 在归档面板中浏览、搜索或按工作区 chip 过滤会话。
3. 将鼠标悬停在某一行，点击行尾的 **↻** 恢复图标，会话立即恢复到原位置。
4. 恢复成功后，该行自动从列表消失，侧边栏工作区视图同步刷新。

列表按**最近归档优先**排序；`#N` 表示全局归档先后顺序（不因倒序展示而重编）。

## License

[MIT](LICENSE)