dsh-restore-archived-sessions

Readme

# dsh-restore-archived-sessions

[English](README.en.md)

> 查看并恢复 Harness 中已被归档的会话。

## 运行时兼容性

本仓库是定制 Harness 的 prebuilt host/client 替换包，不是可以经 `dsh plugin add` 安装的
独立插件。`dist/` 会替换 sibling package layout 下的 `dsh-workspace`、
`dsh-host-apiproxy` 和三个 client bundle。发布版 `@deepseek-ai/dsh@0.1.2-rc.1` 不暴露
`dsh-host-apiproxy` 这个替换目标，禁止直接复制。固定的
`0.1.3-alpha.1` 源码点 `d347e703908d0406b7a7ef80e3a0e594d86b2215` 使用
`dsh-api-workspace-controller` 等不同 transport seam，也不能把本 `dist/` 当作兼容产物。

先运行只读预检；失败时它会在创建 backup 或覆盖任意安装文件前退出：

```bash
bash install.sh --check
```

本机已有旧 build 是独立候选：只有其 package layout 与 archive-state anchor 都通过预检，
并在隔离 profile 做过 synthetic archive/restore 验证后，才可评估安装。本预检不证明源码
provenance 或完整 ABI 兼容，也不会读写真实 archive record。

`--rollback` 则验证 backup 与精确目标路径，不要求当前待恢复文件仍通过 archive ABI 预检；
损坏的安装正是需要回滚的场景。

若要迁移到 `0.1.3-alpha.1`，应从该源码点通过 `dsh-api-workspace-controller` 和
`dsh-client-ui-workspace` 重建恢复界面及 `workspace.unarchiveSession` transport；保留 archive
set 的位置语义与跨 tab snapshot 通知，不能靠覆盖发布版 package 或去掉恢复动作来声称兼容。

## 项目简介

DeepSeek Harness 官方版本中，会话归档后会从所有分组视图中消失，且没有查看或恢复入口。
本项目补上这块缺口：已归档会话会集中显示在「设置 → 已归档对话」页面中，可以查看标题、所属工作区和最后活动时间，也可以一键恢复。

## 功能

- 在设置页集中列出所有已归档会话
- 显示会话标题、所属工作区（或“未分组”）和最后活动时间
- **恢复**：仅把会话移出归档，会话回到原工作区位置
- **恢复并查看**：恢复后直接打开会话，并自动关闭设置面板
- 归档与恢复使用完整快照同步，多标签页状态一致
- 归档集合持久化保存，重启 Harness 后仍然有效

![已归档对话](docs/images/archived-sessions.png)

## 安装

> 此功能依赖 Harness 主线的 `workspace.unarchiveSession` RPC，旧版本官方 Harness 没有这个接口。
> 因此本项目以“补丁包 + 安装脚本”的方式交付。

```bash
git clone https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions.git
cd dsh-restore-archived-sessions
bash install.sh --check
# 仅在定制 host 的预检与隔离验证均通过后：bash install.sh --install
dsh web --host 127.0.0.1 --port 3080
```

回滚：

```bash
bash install.sh --rollback
```

## 使用方法

1. 在会话列表中归档任意一个会话。
2. 打开左下角「设置」。
3. 进入「已归档对话」。
4. 点击「恢复」只恢复归档；点击「恢复并查看」则恢复并打开会话。

## 项目结构

```text
.
├── README.md              # 中文说明（默认）
├── README.en.md           # English
├── docs/images/           # 截图
├── dist/                  # 已构建的 Host 与客户端包
└── install.sh             # 安装 / 回滚脚本
```

## 兼容性

- 原始 artifact 曾在定制 DeepSeek Harness `master` 源码环境验证；这不构成对当前发布版或
  本机任何旧 build 的兼容性承诺。
- 安装脚本仅替换 `dsh-workspace`、`dsh-host-apiproxy` 和三个客户端 bundle。
- 安装前自动备份，支持一键回滚。

## 许可

MIT