Introduction

DSH (DeepSeek Harness) supports session archiving, but after archiving, sessions exit the active list. If you need to re-read the full conversation, restore it to the sidebar, or clean this archived record later, you need a supplementary entry point.

dsh-archived-sessions is a DSH plugin for viewing, restoring, and deleting archived sessions in DSH. It adds an “Archived Sessions” page to the settings panel, making the archived list searchable, readable, and restorable.

What is this

  • Maintainer: Jiangdl0220
  • GitHub Repository: https://github.com/Jiangdl0220/dsh-archived-sessions
  • npm Package Name: @jiangdaoli/dsh-archived-sessions
  • License: MIT License
  • Runtime Environment: Desktop and Web compatible

This plugin solves the problem of “missing recovery entry for archived sessions” in DSH: first view the archived records, then restore or delete them as needed.

Core Features

Archived List

The archived list displays the following information:

  • Session title
  • Workspace
  • Message count
  • Last active time

The list supports refresh. Starting from v0.3.0, it features pagination with 10 items per page and supports instant search and filtering by title or workspace.

Read-Only Conversation View

After clicking a session, a read-only conversation flow can be popped up to view the complete conversation content:

  • Grouped by turns.
  • Collapses reasoning, tool calls, command execution, and other processes.
  • Markdown rendering supports headings, unordered/ordered lists, blockquotes, links, code blocks, and horizontally scrollable tables.
  • Tool executions are displayed in terminal cards showing the tool name, status dot, $ command line, and expandable output.

If logs have sequence gaps causing corruption, the session will display a “Log Corrupted” marker, showing parseable content when opened.

Restoring Archived Sessions

v0.2.0+ supports restoring archived sessions. After restoration, the session is unarchived and returns to its original position in the sidebar active list.

Restoration requires a two-step confirmation. This operation writes to the archivedSessionIds in the workspace storage domain; the session data itself is not touched.

Deleting Archived Records

Deletion also requires a two-step confirmation. This only removes the archived record from the list; the session data remains on disk.

DSH itself does not have a session deletion API, so deletion here does not delete session data.

Installation and Activation

dsh plugin must specify --profile to indicate the runtime environment where the plugin is to be installed.

Install to DSH Desktop:

dsh plugin --profile desktop add @jiangdaoli/dsh-archived-sessions

Install to Web environment:

dsh plugin --profile web add @jiangdaoli/dsh-archived-sessions

After installation, restart DSH and view it in “Settings → Archived Sessions”.

Note: Please install the package above from npm. The GitHub repository only contains source code; build artifacts are generated by CI, so installing directly from the repository will result in missing files. If you need to install from source, run the following first:

pnpm install && pnpm build

Typical Usage

Perform installation first, then view, restore, or delete:

  1. Install the plugin and restart DSH.
  2. Open “Settings → Archived Sessions”.
  3. Search by title or workspace in the list to find the target session.
  4. Click the session to view the read-only conversation flow organized by turns, and expand tool execution output if necessary.
  5. If you want to continue using this session, perform restore; the session will return to the sidebar active list.
  6. If you only want to remove this archived record, perform delete; the session data on disk remains.

Applicable Scenarios and Notes

Suitable for the following situations:

  • You have archived DSH sessions and need to review the full conversation later.
  • You want to restore a specific archived session to the sidebar active list.
  • You want to clean up unnecessary archived records from the list without clearing disk data.

Pre-installation notes: The plugin runs with the permissions of the current dsh process, so you should check the source code and license before installing. The license for this repository is MIT License. Since the plugin reads, restores, or deletes archived records, it is recommended to install it only in a trusted DSH environment and confirm that the target runtime environment is the correct --profile.

Links

  • Plugin Directory: https://www.skillhub.cn/plugins/Jiangdl0220/dsh-archived-sessions
  • GitHub: https://github.com/Jiangdl0220/dsh-archived-sessions