Preface

The philosophy of DeepSeek Harness (DSH) is “everything is a plugin,” where capabilities not covered by the host are handled by plugins. There is a typical gap in the Web profile: once a session is archived, it disappears from workspace grouping, search, and all interfaces, while harness itself does not provide an entry point to view or restore these sessions. Archiving becomes a one-way operation, making it impossible to recover accidentally archived sessions, and there is no way to confirm what was discussed in a specific archived session.

The dsh-session-archive introduced below fills this gap: it adds an entry in the sidebar, lists the globally archived sessions in the registry, and supports preview, restore (unarchive), and delete.

Overview

dsh-session-archive (package name @kiligzzz/dsh-session-archive) is a DeepSeek Harness Web plugin maintained by kiligzzz. Current version 0.1.3, MIT license, source code is publicly available on GitHub.

One-sentence positioning: Displays globally archived sessions from the registry in the sidebar, supporting preview, restore, and delete. The archived state itself is persisted in ~/.dsh/storages/workspace.json in the workspace area, and the plugin reads and writes exactly this archived set.

Core Features

Sidebar Entry and Grouping Panel

The plugin adds an “Archived Sessions” button at the bottom of the sidebar; it is also available when the sidebar is collapsed to an icon rail. Clicking opens a panel with a fixed width and size:

  • Grouped by their associated workspace directories; ungrouped items are listed last; groups are collapsible, and each group has a count badge.
  • Each row displays compact relative time (Just now / 5m / 3h / 2d), and hovering shows the absolute local time; sorted by time in descending order within the group, with the newest on top.
  • At the top is a real-time title search; typing immediately filters sessions across all groups.

Read-only Preview

Clicking the session title opens a preview modal. Content is rendered from disk logs, listing all actual user questions in that session, excluding content injected by the system. The preview is a purely observational operation and does not affect the archive status; you can view the content first before deciding whether to restore or delete.

Restore and Delete

Restore: Removes the session ID from the persistent archive set. The operation is idempotent, and writes are serialized through the workspace-registry write chain. After completion, the session returns to its original group.

Delete: The trash button triggers a confirmation modal. After confirmation, the archive record is permanently removed, the workspace tracking is unlinked, and the log directory on disk is deleted. Active sessions are strictly rejected for deletion.

Host Service API

The plugin also exposes a workspaceArchive service to adjacent host plugins, providing four methods:

list()
preview(sessionId)
restore(sessionId)
deleteSession(sessionId)

Other host plugins can read or operate on archived sessions based on this interface.

Installation and Activation

Prerequisites: DeepSeek Harness Web profile must be available (i.e., the dsh command is available, and pnpm is in the PATH).

Install:

dsh plugin --profile web add https://github.com/kiligzzz/dsh-session-archive

After installation, restart the Web profile (both host and browser bundle scan plugins at startup), then refresh the page. If the bundle ID appears in __DSH_BOOT__ and an entry sidebar.footer.action appears at the bottom of the sidebar, the plugin is active.

If you want to install based on a local checkout, for example, if you have modified the code:

pnpm --dir <repo-path> install   # Only needed when rebuilding (dev dependency esbuild)
pnpm --dir <repo-path> run build # Optional, lib/ build artifacts are already committed
dsh plugin --profile web add "$PWD"

Uninstall:

dsh plugin --profile web remove @kiligzzz/dsh-session-archive

Regarding dependencies, the plugin declares as peer dependencies the dsh-related packages (@deepseek-ai/dsh-* with ^0.1.0-rc.7 || ^0.1.1-rc.1), cordis (^4.0.0-rc.7 || ^4.0.0), and react (^18.2.0), among which @deepseek-ai/dsh-host-webserver is an optional peer dependency.

Typical Usage Flow

Taking the example of recovering a mistakenly archived session:

  1. Click the “Archived Sessions” entry at the bottom of the sidebar to open the panel.
  2. Enter keywords in the search box to locate the target session across groups.
  3. When unsure of the content, click the title to open the read-only preview and confirm if it is the one you are looking for.
  4. Click Restore to remove the session from the archive set and return it to its original group.
  5. Confirm if the session is no longer needed, then proceed with deletion and secondary confirmation.

After the above steps, archived sessions change from “only hidden” to ordinary data that can be viewed, recovered, or cleaned up.

Applicable Scenarios and Notes

Suitable scenarios:

  • Daily use of the DSH Web profile, wanting to reconfirm content after archiving sessions, or recovering mistakenly archived sessions.
  • Confirming content in disk logs before deciding whether to delete old sessions.
  • Other host plugins needing to read or write archived sessions can reuse the workspaceArchive interface.

Notes:

  • Deletion is a permanent operation: it removes archive records, unlinks workspace tracking, and deletes the log directory on disk; active sessions are rejected.
  • The plugin runs with the permissions of the current dsh process; the scope of what can be read/write is your DSH workspace area. Before installing any third-party plugin, it is recommended to check the source code and license; the source code for this plugin is public on GitHub, licensed under MIT.

Summary

The problem dsh-session-archive solves is very specific: making archived sessions listable, previewable, restorable, and deletable, filling the missing entry point in the harness in this regard. If you are using the DSH Web profile and have archived sessions, you can install it and give it a try.

  • Community Plugin Directory Page: https://www.skillhub.cn/plugins/kiligzzz/dsh-session-archive
  • GitHub Repository: https://github.com/kiligzzz/dsh-session-archive

The community directory is an independently maintained site with no official affiliation to DeepSeek or Huanfang; plugin information is subject to the repository.