Introduction

In the official DeepSeek Harness version, once a session is archived, it disappears from all grouping views, and there is no entry to view or restore it. In other words, the only current “existing practice” is: archive implies disappearance, and accidentally archived sessions cannot be found again.

dsh-restore-archived-sessions fills this gap: it lists all archived sessions on a single settings page, displays basic information, and supports one-click restoration.

What is this

One-sentence positioning: View and restore archived sessions in Harness. The project is maintained by le-soleil-se-couche, licensed under MIT, and listed in the “Memory” category on the directory page (package keywords: session-management, archive-restore).

First, clarify the delivery form, as this directly determines the installation method:

  1. It is not a standalone plugin that can be installed via dsh plugin add, but a custom Harness prebuilt host/client replacement package. dist/ replaces dsh-workspace, dsh-host-apiproxy, and three client bundles under the sibling package layout.
  2. The reason for this is that the restoration functionality relies on the Harness mainline workspace.unarchiveSession RPC, which does not exist in older official Harness versions. Therefore, the project is delivered as a “patch package + installation script”.

Core Features

Verified capabilities include six items:

  • List all archived sessions centrally on the settings page
  • Display session title, workspace it belongs to (or “Unassigned”), and last activity time
  • Restore: Only moves the session out of archiving; the session returns to its original workspace location
  • Restore and View: Opens the session directly after restoration and automatically closes the settings panel
  • Archive and restore use full snapshot synchronization, maintaining consistent state across multiple tabs
  • Archive set is persisted and remains valid after restarting Harness

Among them, “Restore” and “Restore and View” are two independent actions: the former only changes the archive status, while the latter enters the session directly after restoration.

Installation and Enablement

Installation consists of three steps: clone the repository, run a read-only pre-check, execute the installation only after the pre-check passes, and finally start.

git clone https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions.git
cd dsh-restore-archived-sessions
bash install.sh --check
# Only after the pre-check and isolation verification for the custom host pass:
bash install.sh --install
dsh web --host 127.0.0.1 --port 3080

bash install.sh --check is a read-only pre-check: it exits before creating a backup or overwriting any installation files if it fails. An existing old build on the local machine is an independent candidate; only if its package layout and archive-state anchor pass the pre-check, and synthetic archive/restore verification is performed in an isolated profile, can the installation be evaluated.

bash install.sh --install performs the replacement: the installation script replaces only dsh-workspace, dsh-host-apiproxy, and three client bundles, backing up automatically before installation. After installation, start with dsh web --host 127.0.0.1 --port 3080.

Two prerequisites that cannot be omitted:

  1. Pre-check does not prove source code provenance or complete ABI compatibility, nor does it read/write real archive records.
  2. The release version @deepseek-ai/dsh@0.1.2-rc.1 does not expose the replacement target dsh-host-apiproxy, direct copying is prohibited; the fixed 0.1.3-alpha.1 source code point d347e703908d0406b7a7ef80e3a0e594d86b2215 uses different transport seams like dsh-api-workspace-controller, and this dist/ cannot be treated as a compatible product.

Typical Usage

  1. Archive any session in the session list.
  2. Open the “Settings” in the bottom left.
  3. Enter “Archived Conversations”.
  4. Click “Restore” to only restore the archive; click “Restore and View” to restore and open the session.

After the steps above, the archived session returns to its original workspace location. Archive and restore use full snapshot synchronization, maintaining consistent state across multiple tabs; the archive set is persisted and remains valid after restarting Harness.

Rollback

bash install.sh --rollback

--rollback verifies the backup and exact target paths, does not require the currently pending restore files to pass the archive ABI pre-check—damaged installations are precisely the scenarios requiring a rollback.

Applicable Scenarios and Precautions

Suitable users: People accustomed to using archiving to organize Harness session lists but worry that archived sessions cannot be found again. The prerequisite is that your environment can pass the pre-check and isolation verification.

Pay attention to the following points:

  1. Compatibility scope is limited. The original artifact has only been verified in a custom DeepSeek Harness master source code environment and does not constitute a compatibility commitment for the current release version or any old build on the local machine.
  2. Migration to 0.1.3-alpha.1. If migrating to 0.1.3-alpha.1, you should rebuild the restore interface and workspace.unarchiveSession transport via dsh-api-workspace-controller and dsh-client-ui-workspace from that source code point, preserving the location semantics of the archive set and cross-tab snapshot notifications; claiming compatibility by overriding the release package or removing the restore action will not work.
  3. Permissions and Auditing. This patch package runs with the permissions of the current dsh process. Before installation, check the source code and license (this project is MIT).
  4. DSH’s philosophy is “everything is a plugin”, but packages involving host/client replacement, like this one, have higher installation barriers and risks than ordinary plugins. Follow the order: “pre-check first, then isolation verification, and finally installation”.

Note: The community directory mentioned in the text (skillhub.cn) is an independent site with no official affiliation with DeepSeek / Hypothesis.

Conclusion

What dsh-restore-archived-sessions does is not complicated: providing a centralized entry point to view and restore sessions in Harness that “disappear upon archiving”. Since it is delivered as a replacement package, pre-check, backup, and rollback are part of the usage process; just follow the order in the documentation.

  • Directory page: https://www.skillhub.cn/plugins/le-soleil-se-couche/dsh-restore-archived-sessions
  • GitHub: https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions