DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

SunspotAlgo /

SunspotAlgo/dsh-archive-pro

Verified

Archive manager pro for DeepSeek Harness: search, filter, sort, multi-select, unarchive, and permanently delete archived sessions.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@ce11d617

dsh-archive-pro

English | 简体中文

Bulk management for archived DeepSeek Harness sessions: search, filter, sort, multi-select, unarchive, and permanently delete — all from Settings → Archive manager pro.

Archive manager pro settings section

The problem

DeepSeek Harness ships with an archive feature but nothing to maintain it. Archiving a few dozen sessions leaves you with a flat, unsorted list: no search, no filters, no multi-select, and no way to reclaim disk space except clicking sessions one at a time. Archives keep their logs on disk forever, so the cost of that gap grows quietly.

This plugin adds the maintenance layer the archive list is missing.

Features

Capability Detail
Keyword search Matches session title and session ID
Workspace filter One workspace, or sessions that never belonged to one
Log-state filter Logs still on disk vs. leftover markers whose logs are gone
Age filter Archived more than 7 / 30 / 90 days ago
Sorting Created time, on-disk size, title — each in both directions
Multi-select Checkbox per row, Shift-click to select a contiguous range
Select visible Operates on the filtered set only, never sessions the filters hide
Batch unarchive Return many sessions to their workspace sidebar at once
Batch delete Permanent, with running tasks stopped and caches cleared
Purge visible Clear the whole filtered list, skipping pinned sessions by default
Live stats Matched count, combined size, selected count and selected size

On-disk size is read from the real session log directory, so the heaviest archives are easy to target first.

Install

From the DSH app: Settings → Plugins → Install, then search for dsh-archive-pro.

Or from a terminal:

dsh plugin --profile web add dsh-archive-pro

The package is published on npm as dsh-archive-pro.

After installing, open Settings → Archive manager pro.

What permanent deletion does

Deleting an archived session is a controlled teardown, not just a directory removal:

  1. Stops any task still running inside that session.
  2. Closes the log writer and detaches the session from memory.
  3. Removes the session log directory, the archive marker, and the projection cache.
  4. Writes a deletion receipt so a late snapshot or cache write cannot resurrect the session.

Deletion cannot be undone. Unarchive remains available for as long as a session is only archived.

Safety

  • Everything runs locally. No telemetry, no uploads, no network requests.
  • Deletion receipts live in ~/.dsh/storages/archive-manager-deleted.json and contain session IDs only — never session content.
  • Every destructive action opens a confirmation dialog naming the count and combined size first.
  • Esc dismisses any confirmation dialog.
  • Pinned sessions are skipped by Purge visible unless you turn that safeguard off.

Requirements

  • DeepSeek Harness desktop app (engines.dsh: >=0.2.1)
  • Node.js ≥ 22 (bundled with DSH)
  • Zero runtime dependencies

How it fits into DSH

package.json declares both halves of a DSH bundle:

"dsh": {
  "bundle": { "patch": "./cordis.patch.yml" },
  "client": { "platform": "web", "inject": [ ... ] }
}
  • Host half (lib/index.js) injects webServer, storageDomain, workspaceRegistry, sessionPersistence, sessions, and agents, then mounts five routes under /dsh-archive-pro/*.
  • Client half (client/client.js) is a zero-build classic script loaded through window.__ModuleLoader__.load, registering a settings.section plus an optional native context-menu item.
  • All session teardown is delegated to lib/session-lifecycle.js, which cancels agents, awaits idle/dispose, closes persistence writers, and clears memoized entries.

Repository layout

lib/index.js               Host entry: mounts routes, wires deletion reconciliation
lib/routes.js              list, restore, delete, batch-delete, batch-restore
lib/session-lifecycle.js   Safe session / agent / writer teardown
client/client.js           Settings section + context menu (zero-build CJS module)
locale/zh.json             Chinese market metadata
locale/en.json             English market metadata
docs/DETAIL.md             English detail page (single feature image)
docs/DETAIL.zh.md          Chinese detail page (single feature image)
docs/preview.svg           Feature image, outlined to vector paths
icon.svg                   Plugin icon (36×36, self-contained)
cordis.patch.yml           Bundle patch inserting the plugin

Development

There is no build step. Edit the files, install the directory as a bundle, then reload the DSH window.

# syntax check
node --check lib/index.js
node --check lib/routes.js
node --check client/client.js

To install a local checkout while iterating:

dsh plugin --profile web add file:D:/path/to/dsh-archive-pro

Note that a locally linked directory bypasses the files whitelist, so node_modules and scratch folders can still be picked up — keep the checkout clean.

License

MIT. See LICENSE.

The session teardown logic grows out of dsh-archive-manager-plus; this plugin adds filtering, sorting, multi-select, and batch operations on top of it.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit ce11d6176dde

Community comments

No comments yet. Be the first to write one.