Introduction

In the DeepSeek Harness (DSH) web profile, after a session is archived, it often needs to be re-found, content confirmed, and restored to its original workspace. Existing approaches typically only offer the archiving action; entry points for viewing, previewing, and restoring archived sessions are incomplete.

uwu9039/dsh-unarchive is an independent third-party plugin for DSH designed to provide lists, previews, and recovery for archived sessions, along with optional confirmation before archiving. It is introduced below by function, installation, usage, and notes.

What is it

dsh-unarchive can be understood as DSH’s “Archived Session Recycle Bin”.

  • Repository: uwu9039/dsh-unarchive
  • License: MIT
  • Maintainer: uwu9039
  • Relationship with DeepSeek: Independent third-party plugin, no affiliation with DeepSeek

This plugin targets the DSH web plugin scenario. The target version and profile provided in the documentation are as follows:

DSH 0.1.0-rc.6
profile web

It is not compatible with the headless UI.

Core Features

Archive List

The plugin provides a floating button in the bottom right corner. Clicking it opens a floating panel. Archived sessions are grouped by workspace, and sorted in descending order by creation time within each group.

The panel displays an empty state and the total count, and supports both Chinese and English interfaces.

Content Preview

In the archive list, you can expand the session header and recent messages inline.

Preview rules are as follows:

  • Single item content does not exceed 200 characters
  • Only extracts text blocks
  • Does not display tool parameters or attachments

Single Restore

A single session in the list can be restored.

The restoration process has the following characteristics:

  • Idempotent
  • Existence check
  • Serial write

After restoration, the sidebar immediately returns to the original position in the original workspace without requiring a page refresh, and supports multi-tab synchronization.

Batch Restore

When the archive list contains at least 2 items, “Batch Restore” can be used.

This operation prompts for confirmation within the panel and restores them one by one. Failed items will not cause a full rollback.

Archive Re-confirmation

Archive re-confirmation is disabled by default.

When enabled, before right-clicking to archive from the sidebar, a confirmation dialog will appear first. The dialog can be closed via Esc, clicking the backdrop, or Cancel.

The documentation states that this capability wraps the following interface and adopts a fail-open behavior:

workspaces.archiveSession

Settings

The “Settings” tab in the plugin panel provides the following configuration options:

confirmOnArchive
showButton
previewEnabled

Settings take effect immediately and are persisted to a local file:

~/.dsh/unarchive/settings.json

Installation and Enablement

Installation

You can install the plugin first using the command provided in the documentation:

dsh plugin --profile web add dsh-unarchive

This step adds the dsh-unarchive plugin under the DSH web profile.

Local Pack Installation

If using local packaged artifacts, the example provided in the documentation is to run npm pack first and then install the generated .tgz file:

npm pack
dsh plugin --profile web add dsh-unarchive-0.1.8.tgz

The .tgz filename in this example comes from the documentation; for actual use of local artifacts, please refer to the actual packaging result.

Entry Point to Enable

After installation, the plugin provides a floating button in the bottom right corner. By clicking this button to open the floating panel, you can view, preview, and restore archived sessions.

Typical Usage

The following explains common usage by operation steps.

Open Archive Panel

  1. Click the floating button in the bottom right corner.
  2. Open the archived sessions floating panel.
  3. View archived sessions grouped by workspace.

Preview and Restore

  1. Select an archived session in the panel.
  2. Expand the content preview inline.
  3. Confirm the session header and recent messages.
  4. Restore the single session.

If there are multiple archived sessions in the list, you can also perform a batch restore within the panel. This operation will first prompt for re-confirmation and then restore them one by one.

Modify Settings

  1. Open the “Settings” tab in the panel.
  2. Modify the following configuration options:
confirmOnArchive
showButton
previewEnabled
  1. Settings take effect immediately after saving.

Settings are persisted to:

~/.dsh/unarchive/settings.json

Enable Archive Re-confirmation

After enabling confirmOnArchive:

  1. Right-click to archive from the sidebar.
  2. The plugin pops up a confirmation dialog first.
  3. Archiving continues only after confirming.

If Esc, clicking the backdrop, or Cancel is pressed, the archive will not proceed.

Applicable Scenarios and Notes

This plugin is suitable for scenarios using the DSH web profile where archived sessions need to be frequently handled, for example:

  • Need to find a session after accidental archiving
  • Want to view the session header and recent messages before restoring
  • Need to restore the session back to its original workspace
  • Wish to add an extra confirmation before archiving to reduce accidental operations

Please note the following boundaries:

  • Not compatible with headless UI
  • Does not perform deletion or clearing of archives
  • Does not perform archive content search
  • Does not perform “Restore and Open”
  • Does not display tool parameters or attachments
  • If a dependency is missing, the corresponding functionality degrades without blocking native archiving

After uninstallation, the documentation states that only the settings file remains:

~/.dsh/unarchive/settings.json

The rest of the content is cleaned up and restored by the plugin.

In addition, the plugin runs with the permissions of the current DSH process and will access local settings paths and invoke DSH plugin capabilities. You should check the source code, license, and dependencies before installation.

Source Address

It has been verified that the documentation does not provide a confirmed directory page address. The repository address is as follows:

https://github.com/uwu9039/dsh-unarchive