DeepSeek Harness Plugin

MichengAI/dsh-archive-manager

Stars ★ 352 Downloads (30d) 114,280 Category Sessions & Messages Added 2026-08-18 npm @michengai/dsh-archive-manager

Adds an archived-sessions page in Settings to search, restore, and delete archived DeepSeek Harness sessions by workspace.

Install

# from npm (prebuilt)

dsh plugin --profile web add @michengai/dsh-archive-manager

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:MichengAI/dsh-archive-manager

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

DSH Archive Manager

Safely manage archived sessions in DeepSeek Harness

简体中文 · English · 日本語 · Español · Français · Deutsch · Русский · Português

Changelog · Apache-2.0

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

This document describes 1.3.3. See Changelog for published releases.

Overview

Put inactive conversations away and find them again when needed, keeping everyday task lists tidy.

  • Dual entry points & wide workspace view: Manage sessions from Settings → Archived sessions, or enable the primary sidebar icon to open a full centered panel in the main workspace.
  • Archive & restore: Archive individual chats, all chats in a workspace, or cross-project batches, and restore or restore-and-open sessions seamlessly.
  • Full-text search & quick preview: Search across conversation titles and message history together, combine project, favorites, and date-range filters with flexible sorting, and preview context in Markdown or highlighted source text without restoring.
  • Favorites & idle cleanup: Star important conversations and filter with Favorites only; preview and archive idle chats by day threshold while automatically protecting running tasks, pending interactions, and starred chats, with instant batch undo.
  • Sidebar actions & cross-workspace move: Right-click workspace or session rows in the sidebar to favorite, archive, move standard sessions between workspaces, or copy/open workspace folders.
  • Orphan subagent cleanup & permanent deletion: Detect and clean up leftover subagents whose parent sessions were deleted externally, and permanently purge unwanted sessions and logs after confirmation.
  • Multilingual & reverse proxy ready: Supports all 8 built-in DeepSeek Harness languages, follows light/dark themes, and works behind path-prefixed reverse proxies.

Screenshots

1. Archive Management Panel

Search, favorite, preview, restore, and clean up in Settings → Archived sessions → Archived:

Archived: shared search filters, favorites, and compact rows

Switch to Unarchived for idle cleanup previews and project-level batch archiving:

Unarchived: smart idle cleanup and project archiving

2. Main Workspace Panel (Direct Sidebar Entry)

With the sidebar entry enabled, click the icon in the left navigation bar to open the full workspace view:

Main Workspace Panel: dedicated sidebar entry centered view

3. Sidebar Context & Move Menus

Right-click any workspace or session row in the sidebar for quick actions and cross-workspace session moving:

Workspace Actions (Copy/Open Folder) Move Session Across Workspaces

Installation

A working DeepSeek Harness environment is required. Examples below use the web profile; adjust to your environment.

  • Host compatibility: DeepSeek Harness 0.2.x (>=0.2.0-rc.1 <0.3.0-0), verified across all 0.2.x release candidates (0.2.0-rc.1 through 0.2.2-rc.2; intermediate alphas are not supported).
  • Hosts prior to 0.2.0-rc.1 are no longer supported, and 0.3.0 breaking releases are blocked by the version gate. Users on 0.1.x hosts should install 1.0.20.
  • Reverse proxy support: Works behind path-prefixed reverse proxies (e.g. /app/dsh/).

Ask an agent to install it (recommended)

Send this prompt to an agent with terminal access:

Please install the latest @michengai/dsh-archive-manager into my DSH web profile using the official npm registry, verify activation, and explain how to reload.

Install manually & update

[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/

Restart DSH Web and hard-refresh your browser (Ctrl+Shift+R), then open Settings → Archived sessions. Re-run the install command to update.

Plugin Configuration

Open Sidebar → Plugins → Archive Manager to configure:

  • Entry placement (entryLocation)
    • Both (both): Show the navigation icon in the left sidebar and keep Settings → Archived sessions.
    • Sidebar only (sidebar): Show the icon in the left sidebar and hide the entry in Settings.
    • Settings only (settings) (Default): Keep the entry only under Settings → Archived sessions.
  • Sidebar favorite star (sidebarFavoriteStar)
    • Show all (all) (Default): Show stars on sidebar session rows on hover and when favorited.
    • Favorites only (favorites): Always show stars only on favorited sessions; hide hover stars on unstarred rows.
    • Hide all (none): Hide favorite stars on sidebar rows (you can still favorite via the context menu and filter with Favorites only).

Usage Guide

Action How to do it
Archive sessions Choose Archive session from a sidebar session menu, or select sessions on Unarchived for batch archiving
Archive workspace / group Choose Archive workspace in the sidebar workspace menu, or use the … menu on a project group in Unarchived (ignores search filters)
Search & filter Search matches both titles and message bodies; combine Favorites only, sort order, project filter, and date range (calendar popover supports presets and keyboard navigation)
Quick preview Click a match snippet or More → Quick preview to inspect context with highlights without restoring
View or restore chats Click a title to read and continue chatting while keeping it archived; click restore or More → Restore and open to unarchive
Favorite chats Click the star on any row or use the sidebar context menu, then filter with Favorites only in the view menu
Clean up idle chats On Unarchived, set idle days (1–36,500), preview candidates, and confirm; use Undo this archive before closing or refreshing the page
Move across workspaces Right-click a standard session in the sidebar and choose Move to workspace
Clean up orphan subagents When leftover subagents from externally deleted parent sessions are detected, click clean up in the organizer area to reclaim disk space
Rebuild missing list cache When sessions lack official list cache entries, click Rebuild list cache in the organizer area to read logs read-only and restore titles
Permanent delete Select sessions and click Delete (or use the sidebar context menu) to permanently purge logs and caches after confirmation
Copy session ID Choose Copy session ID from the More menu

Notes

  • Favorites & idle protection: Favorites are stored by the host and persist across archiving and restoring. Idle cleanup automatically excludes favorites, the open session, running sessions, and pending interactions; starred chats can still be archived manually. There is no automatic background archiving.
  • Search scope: Full-text search covers user and assistant messages and excludes tool outputs, attachments, reasoning, and system messages. There is no persistent full-text index, so narrowing by project, date, or favorites helps on large histories.
  • Batch actions & undo: Batch archive, restore, and delete continue past individual failures and let you retry failed items only. Undo this archive is available only while the current management page remains open. Permanent deletion cannot be undone.

FAQ

Why is the entry missing after installation?

Restart DSH Web and hard-refresh the browser (Ctrl+Shift+R), and confirm you installed into the active profile. If it still does not appear, run the command below to verify ui-workspace-archive-manager is present and that your profile's cordis.patch.yml is not disabling workspace, session-projection-cache, or ui-workspace:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh --profile web --dump-config

How is archiving different from permanent deletion?

Archiving tucks a conversation away so you can restore it anytime. Permanent deletion cannot be undone and erases the session's logs, cache entries, and attachments (your project working directory is never deleted). Confirmation is always required.

Can I use it with Codex UI or other archive plugins?

Yes. It works alongside Codex UI, and if other archive plugins are installed, each registers its own Settings entry independently.

For other issues, please open an issue with your DSH and plugin versions, reproduction steps, and error details.

Install from source

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

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 .

Restart DSH Web and hard-refresh the browser afterward. After editing src, run pnpm build before committing (checks: pnpm typecheck, pnpm test, pnpm verify).

DSH product ecosystem

For a desktop workbench, download DSH Codex Desktop. Existing DeepSeek Harness installations can add plugins as needed by following each project's README. Below are 11 first-party plugins; consult the corresponding desktop release notes and bundled catalog for what that version includes.

Plugin What you can do
Codex UI Organize projects and conversations, search tasks, and navigate chat turns
Agency Agents Choose and summon specialists for your task
Skills Manager Find, enable, create, and import local skills
Archive Manager Search, restore, or clean up archived conversations
IM Connect Send tasks and receive replies through messaging platforms
Automation Schedule tasks and review each run
BTW Ask side questions without interrupting the main task
Simplify Use /simplify to improve code within your Git changes
PUA Guide the Agent to try new approaches after failures, investigate causes, and verify results before completion
Code Review Use /review to request an independent Agent code review and receive the report in the current conversation
Codex Pet View conversation notifications and respond to tool approvals and questions through a desktop pet

License

Licensed under Apache License 2.0.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.