Introduction¶
In DSH Web GUI, once sessions are archived, relying solely on the sidebar and log files for reviewing conversations, restoring sessions, organizing tags, or closing the current dsh process is quite scattered. The dsh-archive-viewer introduced below is a plugin for DSH Web GUI: it provides an “Archived Sessions” panel for viewing, searching, filtering, and restoring archived sessions, and offers a one-click entry to close dsh in the top right corner.
What is it¶
keepermttl/dsh-archive-viewer is an MIT License DSH Web GUI plugin, current version is 3.0.0-test (beta).
The main problem it solves is: archived sessions lack centralized viewing and restoration entry points, and operations like organizing tags, viewing logs, exporting logs, and closing dsh are scattered in different places. This plugin puts these capabilities into a sidebar panel.
Core Features¶
View / Restore Archived Sessions¶
The plugin provides an “Archived Sessions” entry at the bottom of the sidebar, above the settings button. Upon opening, you can view information such as the archived session’s title, last active time, workspace, running/blank status, etc.
“Restore Session” will put the archived session back into the original workspace group, preserving the position exactly.
Search, Sort, and Tag Filtering¶
The search box supports keyword real-time filtering, covering title, session ID, and workspace, case-insensitive. When the “Content” mode is enabled, it scans the latest conversations of each session page by page; the number of pages scanned per session can be adjusted in settings.
The toolbar supports sorting by the following methods:
- Recently Updated
- Name
- Session ID
Sorting can toggle between ascending/descending order.
Tag filtering is housed in the “Filter” button menu and supports:
- Multi-select tags
- AND / OR mode
- Tag search
Tag filtering can be combined with keyword search.
Custom Tags for Archived Sessions¶
Users can add or remove custom tags for each archived session. Tag data is persisted to dsh-archive-viewer-tags.json under the DSH profile directory and is read/written via a local HTTP API:
GET /api/archive-viewer/tags
POST /api/archive-viewer/tags
POST /api/archive-viewer/tags supports operations like add, remove, clearHidden, etc.
Built-in AI Assistant¶
A collapsible AI assistant window is provided at the bottom of the panel, used to invoke the DSH standard mode agent to help retrieve sessions, add tags, and organize archives.
The AI assistant’s default workspace is:
E:\dsh-ai-workspace
The AI workspace can also be modified in settings.
Sessions used by the AI assistant are automatically archived as internal helper sessions and will not appear in the sidebar or the archive panel. Clicking “New Conversation” safely deletes the previous helper session without accidentally deleting user sessions.
Hide Temporary Retrieval Tags¶
After an agent retrieval match, a hidden tag agent检索 is automatically added to the session, and the corresponding filter is switched to. This tag does not appear on the session badge and is automatically cleared when unchecked.
View Conversation Logs and Export¶
The plugin supports viewing archived session conversation logs, reading session.history, and supports paginated loading of older content.
Log export uses the official session.export endpoint and allows downloading a ZIP file.
Interface and Settings¶
The plugin supports two display modes: vertical list and horizontal grid.
The introduction text at the top of the panel can be closed or re-enabled in settings.
Settings are persisted in real-time and saved in the browser’s localStorage with the key:
dsh-archive-viewer:settings:v1
Configurable options include:
- Language
- Sort
- Layout
- Content Search
- AI Mode
- AI Model and Thinking Intensity
- AI Workspace
- Tag Filter Mode
- Show/Hide Introduction Text
- Restore Defaults
The plugin supports Chinese and English bilingual mode. By default, it follows the browser language, but can also be manually overridden in settings.
Regarding skin adaptation, the plugin uses shell design tokens and portals the panel to document.body to avoid being affected by token overrides from the skin sidebar scope.
Installation and Enabling¶
Prerequisites¶
Required:
- Node.js >= 22
- pnpm
DSH Core Patch Dependencies¶
“Restore Session” and “Close dsh” depend on two new RPCs added to the DSH core:
workspace.unarchiveSession
host.shutdown
As of August 2026, the official version has not yet included these two RPCs.
If you need to use these two features, you must apply the patch before use and restart dsh web. Users installing via release packages need to rebuild the affected package.
Installation Commands¶
The installation/build commands for POSIX environments are as follows:
git clone https://github.com/keepermttl/dsh-archive-viewer.git
cd dsh-archive-viewer
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)
After execution, restart dsh web and perform a hard refresh (Ctrl+F5) in the browser.
Typical Usage¶
- Click “Archived Sessions” at the bottom of the sidebar (above the settings button) to open the archived sessions panel.
- Enter keywords in the search box to filter by title, session ID, and workspace in real-time; click “Content” to also search conversation content. The number of pages scanned per session can be adjusted in settings.
- Select a sorting method (Recently Updated / Name / Session ID) in the toolbar and toggle ascending/descending order; click the “Filter” button to open the tag filter menu, allowing multi-select tags, choosing AND/OR, or searching for tags.
- Click the gear button to open settings, adjusting language, sort, layout, content search, AI mode, AI model and thinking intensity, AI workspace, tag filter mode, show/hide intro text, or click “Restore Defaults”.
- Perform operations on a single session row:
- View Conversation
- Restore Session
- Download Logs
- Copy ID
- Tags - Open the “AI Assistant” at the bottom of the panel to converse directly with the DSH agent, asking it to retrieve sessions, add tags, or organize archives; clicking “New Conversation” deletes the previous AI helper session.
- Click the power button in the top right corner of the session header and confirm to close dsh.
Use Cases and Notes¶
Suitable for developers who have generated a large number of archived sessions in DSH Web GUI and need centralized viewing and restoration of sessions.
Please note when using this plugin:
- Current version is
3.0.0-test(beta). - “Restore Session” and “Close dsh” depend on new RPCs added to DSH core; as of August 2026, the official version has not yet included them.
- The plugin runs with the permissions of the current
dshprocess; please check the source code and license before installing. - After upgrading from an old version, you need to restart
dsh webbecause a tag storage and the/api/archive-viewer/tagslocal API were added to the host scope. - This plugin was developed and verified against the DSH
0.1.0-rc.5source code checkout. - The client does not import any
@deepseek-ai/*values.
Conclusion¶
dsh-archive-viewer centralizes scattered operations in DSH Web GUI, such as viewing archived sessions, restoring sessions, organizing tags, exporting logs, and closing dsh, into a single panel. It is suitable as a practical tool in the DSH plugin ecosystem for handling the daily management of archived sessions.
Project Repository:
https://github.com/keepermttl/dsh-archive-viewer
Plugin Directory Listing:
https://www.skillhub.cn/plugins/keepermttl/dsh-archive-viewer
The above directory page is from the plugin listing; the community directory has no official affiliation with DeepSeek / Huansuan, and should not be understood as an official app store.