dsh-archive-manager

DSH Archive Manager is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.

Features

• Archive a session from the sidebar session menu.
• Search archived chats and filter them by workspace in Settings → Archived.
• Restore a session to its original workspace with Unarchive.
• Permanently delete a confirmed session, its workspace association, archive marker, and projection cache.
• Delete all archived chats after confirmation, including child agents.
• Remove unloaded deleted sessions from connected sidebars immediately.
• Paste one sentence into DSH, Codex, or WorkBuddy and let that agent install the plugin locally.

Screenshots

Open the sidebar session menu and choose Archive session:

Search, filter by project, unarchive, or permanently delete chats in Settings → Archived:

Prerequisites

• A working DeepSeek Harness Web installation with dsh available in PowerShell.
• Examples use the web profile; replace it with the target profile.
• Source installation and development require Node.js 22+ and pnpm. npm installation does not require running pnpm install separately.

Installation

dsh plugin add forwards to pnpm add in the profile directory. Without a version and official registry, a local mirror or minimum-release-age policy can leave you on an older build.

Ask another agent to install it

This plugin runs inside DeepSeek Harness Web. Copy one of the sentences below into DSH, Codex, or WorkBuddy and let that agent install it into your local web profile.

From npm:

Install the latest DSH plugin @michengai/dsh-archive-manager into my local web profile using the official npm registry: dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm archive-manager is mounted, and remind me to restart DSH Web and hard-refresh the browser.

From source:

Install the DSH plugin from source at https://github.com/MichengAI/dsh-archive-manager: clone it, run pnpm install --frozen-lockfile and pnpm build, then run dsh plugin --profile web add . from that directory. Do not copy lib by itself. Then run dsh --profile web --dump-config, confirm archive-manager is mounted, and remind me to restart DSH Web and hard-refresh the browser.

Product	How to use it
DSH	Send one of the sentences above to the current session.
Codex	Send one of the sentences above to Codex and let it install locally.
WorkBuddy	Send one of the sentences above to WorkBuddy; for a source install you can also paste https://github.com/MichengAI/dsh-archive-manager.

Codex and WorkBuddy only install the plugin. After that, open DSH Web and use Settings → Archived.

You can also run the same npm command yourself:

dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/

If dsh is not on PATH, replace the leading dsh with npx --yes @deepseek-ai/dsh.

Install the latest package from the official npm registry

Run this from any PowerShell directory:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config

To pin a release, replace @latest with a version such as @0.1.8.

The configuration output should contain workspace-archive-manager and ui-workspace-archive-manager. Restart DSH Web and hard-refresh the browser. Do not copy client files manually: the Settings page and archive menu need the mounted plugin.

Install from source

Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
Set-Location D:\Repository\deepseek-harness-plugin
git clone https://github.com/MichengAI/dsh-archive-manager.git
Set-Location .\dsh-archive-manager
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add .
dsh --profile web --dump-config

Restart DSH Web and hard-refresh the browser. dsh plugin ... add . reads the package metadata and cordis.patch.yml; do not install by copying lib directly.

Usage

1. Open the sidebar session menu and choose Archive session.
2. Open Settings → Archived to inspect sessions by workspace.
3. Use the search box or project filter to narrow the list.
4. Select Unarchive to restore a session, or use the delete icon to remove it permanently.
5. Confirm deletion. It cannot be undone.

If the entry is missing after installation or upgrade, restart DSH Web and hard-refresh the browser. It is located directly after Connectors in Settings.

Data handling limits

• Deletion always requires confirmation.
• It removes the session directory, workspace records, archive set, and projection cache.
• A live session finishes writing before cleanup to prevent data truncation.
• The plugin replaces DSH’s default workspace and projection services. Install through the DSH profile instead of manually composing the patch.

Secondary development

This repository has no src directory. lib is directly maintained runtime source, which is its current layout rather than the recommended layout for new plugins. New plugins should prefer src built to lib.

• lib\index.js: host service entry point.
• lib\workspace.js: archived-session and workspace service.
• lib\projcache.js: session projection cache.
• lib\client.js: Settings page and archive UI.
• test\*.test.mjs: host, client, Remote, and styling coverage.

After changing the runtime source, validate, test, and install from the local directory:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm build
pnpm test
pnpm pack:check
dsh plugin --profile web add .

pnpm build validates package integrity; it does not compile lib into another directory.

Validation

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm build
pnpm test
pnpm pack:check

prepublishOnly runs the build check and tests before publishing.

License

Licensed under Apache License 2.0.