Introduction¶
The DSH community adopts a plugin-based approach to extend its capabilities, allowing the web profile to gain browser-side features through plugins. For developers using dsh web, a common requirement is to centrally display documents, webpages, and images involved in the current conversation, while being able to directly view workspace files, run terminal commands, and preview HTML or images on the right side.
dsh-summary-sidebar is an independent client plugin for the DeepSeek Harness (dsh) web profile. It packages “Summary” and “Sidebar” together: the Summary is responsible for aggregating documents, webpages, and images in the current conversation, while the Sidebar provides five tools: folder, terminal, browser, document reader, and image reader.
What is this¶
dsh-summary-sidebar is the “Summary + Sidebar” plugin for DeepSeek Harness Web, maintained by az790871109, licensed under MIT, and current version is 0.4.0.
It is a completely independent and deployable plugin that does not rely on any other installed plugins. The plugin mainly solves two things:
- Provides a “Summary” in the session header to centrally display documents, webpages, and images output by the current conversation.
- Provides a “Sidebar” on the right side, containing five tabs: Folder, Terminal, Browser, Document Reader, and Image Reader.
Core Features¶
Summary¶
After clicking the “Summary” button in the top right corner of the session header, the plugin aggregates documents, webpages, and images output by the current conversation. The Summary only outputs these clickable items and does not output derivation/narrative text.
The sources of the summary come from the tool calls and result text of the current session, such as URLs from read / glob tools or web_fetch / web_search results.
Each summary item is clickable:
- File: Opens the sidebar and uses the corresponding tool to preview/edit the file.
- Link: Opens the sidebar “Browser” to load the URL.
- Image: Opens the sidebar “Image Reader”.
Sidebar¶
The Sidebar is a right-side drawer panel containing five tabs:
| Tab | Capabilities |
|---|---|
| Folder | Browse, open, create file, create folder, rename, delete |
| Terminal | Independent PTY terminal (node-pty), input commands, Ctrl+C, clear, restart |
| Browser | Address bar + iframe preview for workspace HTML or external URLs, including iframe embedding detection |
| Document Reader | Open text files for reading and editing, save back to workspace |
| Image Reader | View workspace images (png/jpg/gif/webp/svg, etc.) |
When the sidebar is open, the plugin reserves 360px in the right details column of Harness, and the dialog box automatically shifts to the left to make room. The sidebar fits within the reserved area without obscuring the conversation content.
Installation and Activation¶
First, confirm the prerequisites: DeepSeek Harness (dsh) is installed and using the web profile (dsh web); node-pty is installed on the local machine. If node-pty already exists in Harness’s deployment directory or $DSH_HOME/profiles/node_modules, it is fine; if not, execute the following command to install it:
pnpm add node-pty
GitHub Installation (Recommended)¶
Execute the following command to install the plugin from GitHub:
dsh plugin --profile web add github:az790871109/dsh-summary-sidebar
After installation, append the insert entry in $DSH_HOME/profiles/web/cordis.patch.yml to make the web profile combine this plugin:
- insert:
- id: summary-sidebar
name: dsh-summary-sidebar
Local Installation¶
If a local plugin directory already exists, you can install it using the file: method:
dsh plugin --profile web add file:/path/to/dsh-summary-sidebar
Alternatively, you can directly copy the plugin directory to node_modules:
cp -R /path/to/dsh-summary-sidebar "$DSH_HOME/profiles/web/node_modules/dsh-summary-sidebar"
Restart the web profile and perform a hard refresh of the browser:
dsh web
Uninstallation¶
Execute the following command to uninstall the plugin:
dsh plugin --profile web remove dsh-summary-sidebar
You can also manually delete the insert entry in $DSH_HOME/profiles/web/cordis.patch.yml and the node_modules/dsh-summary-sidebar directory.
Typical Usage¶
After enabling, start operating from the top right corner of the session header:
- Click “Summary” to view documents, webpages, and images involved and output in the current conversation.
- Click on a file, link, or image in the summary; the sidebar will automatically switch to the corresponding tool: files are for preview/editing, links are for browser loading, and images are for the image reader.
- Click “Sidebar” to directly open the Folder, Terminal, Browser, Document Reader, or Image Reader.
In the sidebar:
- In Folder, you can browse workspace files, execute operations such as creating files, creating folders, opening, renaming, and deleting.
- In Terminal, you can execute commands, send
Ctrl+C, clear, or restart the terminal. - In Browser, you can input an address to preview workspace HTML or external URLs; external URLs are limited by the site’s own
X-Frame-Options/ CSP, and the plugin performs iframe embedding detection to provide a new tab for opening. - In Document Reader, you can open text files for reading and editing, and save them back to the workspace.
- In Image Reader, you can view workspace images such as
png/jpg/gif/webp/svg.
Use Cases and Notes¶
It is suitable for use in the dsh web profile for scenarios that require aggregating conversation artifacts and workspace tools, such as:
- Quickly reviewing files, webpages, and images involved and output in the current session after a long conversation;
- Viewing workspace HTML, text files, and images directly in the browser;
- Maintaining workspace files in the sidebar and executing commands in an independent PTY terminal.
Please note the following before using the plugin:
- The plugin runs with the permissions of the current
dshprocess; you should check the source code, license, and source before installing. - Terminal, file, and browser capabilities depend on the host
/sbsJSON API, including file list/operations (read/write/create/rename/delete), terminal streams, and/sbs/frame-checkframe detection; please ensure the plugin is installed in thewebprofile. - The plugin does not register host-side model tools.
- The Summary sources come from tool calls and result text in the current session; file paths in commands like
bashare extracted conservatively. - External URL preview is limited by the site’s own
X-Frame-Options/ CSP; the plugin performs iframe embedding detection and new tab opening handling. - The terminal depends on
node-pty; please ensure it is available in thewebprofile runtime environment.
Getting¶
GitHub Repository:
https://github.com/az790871109/dsh-summary-sidebar
The DSH Community directory is an independent site with no official affiliation with DeepSeek or Huansuan. Please refer to the current DSH Community entry or the local plugin directory query results for the specific directory page.