dsh-archive-manager-pro

Provenance & credits (please read)

This package is built and maintained by loyalchiiina — the favorites / pin / turns / auto-archive enhancements, the release packaging and the current documentation are all authored here.

Copyright of the pre-existing baseline code remains with MichengAI as required by Apache-2.0; everything documented under "what this adds" below is authored and maintained by loyalchiiina.

What this fork adds

1. Favorites for archived sessions — inline star buttons plus sidebar menu entries, a "favorites only" filter, favorited-first ordering inside each group, and automatic pruning when chats are deleted.
2. One-click delete of unfavorited chats — two scopes: all archived chats outside favorites, or only those in the current filtered results, sharing the existing confirmation dialog.
3. Pin sessions — pin from the sidebar session menu; pinned rows always sort first within their group without touching the host's manual ordering data.
4. Sort by conversation turns — a new "Turns" sort plus a per-row turn badge. Counts are derived locally from session transcripts with the same semantics as official sessionStats: no model calls, zero token cost, cached per persisted revision.
5. Copy session ID / transcript path — three clipboard entries in the sidebar menu; paths are resolved through the official persistence backend via a loopback-only read route.
6. Archive settings layout rework — rows wrap onto two lines so titles are no longer squeezed; toolbar and batch-action header become grouped cards.
7. Trimmed UI — this fork hides the "GitHub" / "Issues" header links and the built-in "check for updates" button (a pure UI preference, no functional impact).

⚠️ This package cannot coexist with upstream @michengai/dsh-archive-manager: both provide the same host services (workspace / projection cache / ui-workspace). Install one of them.

功能总览 · At a glance（中英对照 / Bilingual）

The enhanced build on top of upstream v0.1.40. 在上游 v0.1.40 之上增强的功能。

收藏与筛选 · Favorites & filtering

置顶与排序 · Pinning & sorting

一键归档 · One-click archive

删除与复制 · Delete & copy

界面与协同 · UI & coexistence

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

What you can do

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

• Archive conversations: put away one chat or all unarchived chats in a workspace.
• Find past work: search titles, filter by project, and sort by time or title.
• Restore tasks: restore one chat, selected chats, a project group, or all archives.
• Clean up records: permanently delete unwanted archived conversations after confirmation.

Screenshots

Archive, pin, and sort chats right from the sidebar session menu:

Find, restore, and clean up chats in Settings → Archived sessions:

Prerequisites

• A working DeepSeek Harness Web installation with dsh available in your terminal.
• Supported DSH versions: 0.1.0-rc.8, 0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.1, and 0.1.5-rc.2. Other versions are not currently supported.
• Node.js matching ^22.19.0 || >=24.0.0. Source installation also requires pnpm.

Installation

Examples use the web profile. Replace it with the profile you actually use.

Ask an agent to install it

Send this prompt to an agent that can run terminal commands on your computer:

Install the latest dsh-archive-manager-pro into my local DSH web profile using the official npm registry. Check the plugin configuration afterward, then explain how to reload DSH and open archived session management.

Install manually

Run in PowerShell:

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

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

Restart DSH Web, then hard-refresh your browser with Ctrl+Shift+R. Open Settings → Archived sessions to get started.

Usage

Selections persist when filters change. Check the hidden selection count before applying bulk actions, or clear your selection first.

View and continue archived conversations

Available starting with 0.1.40:

• View conversation: open the native DSH session to view messages, attachments, and tool details. Continue chatting while keeping the session archived.
• Restore and open: unarchive the session and open it to resume work.

Updates

Click Check for updates in the archive management page header. DSH CLI or Desktop environments with automatic update support can update directly; other environments provide a manual command for the current profile. You can also rerun the installation command above.

FAQ

Why is the entry missing after installation?

Restart DSH Web and hard-refresh your browser. Make sure you installed into the profile you are using. If the entry is still missing, run:

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

dsh --profile web --dump-config

The configuration should include workspace-archive-manager and ui-workspace-archive-manager. If you previously set the official ui-workspace to disabled: true in your profile's cordis.patch.yml, remove that disabling override and restart.

How is archiving different from deletion?

Archiving puts a conversation away so you can restore it later. Permanent deletion cannot be undone and may also remove that session's attachments. It does not delete your project working directory. Deletion requires confirmation.

Can I use it with Codex UI?

Yes. Codex UI keeps its sidebar appearance and interactions. Archive management remains available in Settings → Archived sessions.

For other problems, 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 .

Related projects

DSH Codex UI provides project and conversation management. For a desktop workbench, see DSH Codex Desktop.

License

Licensed under Apache License 2.0.