In DeepSeek Harness (DSH), archived sessions are usually just log files in the filesystem. Viewing, restoring, or completely deleting them in the UI typically requires direct filesystem operations or relying on DSH’s built-in behavior, which is not always intuitive or safe. The dsh-archived-sessions plugin solves this problem by providing a unified entry point in the DSH settings page, enabling listing, previewing, restoring, and permanently deleting archived sessions.

What It Is

This is a Memory-category DSH plugin maintained by developer Zalpha263 and licensed under MIT. It is designed to address the operational inconvenience faced by DSH users when managing large numbers of archived sessions, providing a complete interface-based workflow.

Core Features

The plugin provides the following four core actions:

  1. List View: The list loads quickly and directly displays the session title, original workspace, and last active time (absolute timestamp). Message counts are tallied in the background and cached; repeatedly opening the list does not reparse logs, avoiding lag.
  2. Content Preview: Click the “Preview” button to view the first 6 messages in the session (user/assistant messages) and which tools were called.
  3. Restore Session: Click “Restore to Workspace” to remove the archive record, return the session to its original workspace location, and refresh the sidebar immediately.
  4. Permanent Delete: Clean up the log file, workspace ownership, and archive record in one step. Before deletion, you must enter the session title to confirm (to prevent accidental deletion); the system intercepts archives with child sessions; after deletion, it verifies that the log has indeed disappeared, preventing the session from “resurrecting.”

Installation and Enabling

Before installing, ensure pnpm is installed and DSH version is 0.1.5-rc.2 or a compatible 0.1.x release.

Use the release build (pinned commit, most stable) to install:

dsh plugin --profile web add github:Zalpha263/dsh-archived-sessions#<40位commit>

After installation, restart DSH. After that, if only UI (Client) changes are involved, refresh the page (Ctrl+F5); Host-side changes require restarting DSH.

Typical Usage

  1. Entry Point: Open DSH settings and locate the “Archived Sessions” menu.
  2. View: In the list, view basic session information; message counts are cached and refresh very fast.
  3. Preview: Click “Preview” on a card to quickly view the first 6 messages and tool call records.
  4. Restore: Click “Restore to Workspace”; the session immediately returns to its original location, and the sidebar updates automatically.
  5. Delete:
    • Click the delete button and enter a confirmation value (title, workspace directory name, session ID, or the title displayed in the UI are all acceptable).
    • If the session has child sessions, the system will first ask for a choice: “Delete parent session only” or “Delete along with N child sessions.”
    • The system automatically intercepts running sessions (deleting them will rewrite the logs) and marks them as “Cannot delete · still running.” You can delete them again only after restarting DSH.

Applicable Scenarios and Notes

  • Environment Dependency: The plugin requires DSH 0.1.5-rc.2 or later.
  • Permissions and Security: The plugin runs with the permissions of the current DSH process. Review the source code and license before installing.
  • Deletion Limitation: If an archived session was opened during the current run, deleting it directly may cause the log to be rewritten, appearing as though it “was deleted but came back.” The UI marks it as “Cannot delete · still running,” after which it can be deleted normally after restarting DSH.
  • Child Session Handling: Deleting a parent session with child sessions does not corrupt the child session logs. Deletion includes a second confirmation, allowing you to delete only the parent session or delete the child-session tree as well (child sessions that are still running will be skipped).

By encapsulating low-level filesystem operations, the plugin provides DSH users with a safe and efficient way to manage archived sessions. For more details, refer to its GitHub repository.