Introduction

When using Agents in DSH, a single task can simultaneously produce reports, charts, images, PDFs, and data files. If these results are scattered across the workspace directory or tool logs, checking, comparing, and sharing them is not very direct. The DSH Right Sidebar adds a right-side artifact workspace to DSH Web, keeping the deliverables generated by the Agent next to the conversation during the session.

Overview

DSH Right Sidebar is a DSH plugin maintained by Limitinfinitude, licensed under MIT. It provides a native right-side artifact workspace for DeepSeek Harness, concentrating results like reports, charts, images, data, and documents next to the session; source code, configuration, and other internal project files remain the responsibility of the DSH workspace.

Below is an introduction to its core capabilities, installation methods, and typical usage.

Core Capabilities

Session-bound Artifact Bar

  • Permanent right-side entry that can auto-expand, or be manually collapsed and restored.
  • Artifacts are bound to the session; switching sessions synchronously switches tabs, sorting, and close states.
  • After an Agent updates an artifact at the same path, the current preview refreshes automatically.
  • Top stacked tabs support closing and drag-and-drop reordering, while narrow sidebars preserve readable filenames.
  • The bottom “Session Artifacts” directory allows reopening closed results, with independent scrolling when there are more than seven items.

Supported File Types

The plugin supports HTTP(S) file URLs explicitly output by the Agent, as well as incomplete file paths with unique matches within the workspace.

Auto-supported artifacts include:

  • Markdown
  • MDX
  • PDF
  • SVG
  • PNG
  • JPEG
  • WebP
  • GIF
  • AVIF
  • BMP

On-demand artifacts include:

  • TXT
  • JSON
  • JSONL
  • CSV
  • TSV

On-demand artifacts are only displayed when the Agent explicitly mentions the file path or name in its reply.

Files not displayed include:

  • Source code
  • HTML/HTM
  • Configuration
  • Logs
  • YAML
  • TOML
  • XML
  • INI
  • CONF, and other internal project files

Preview and Operations

  • Markdown can be edited directly on the rendered content and saved silently after stopping input.
  • Supports copying path, copying content, downloading, opening containing directory, pinning, and hiding.
  • JSON/JSONL supports collapsible structure trees, search, expand all/collapse all, formatting raw text, and error line indicators.
  • CSV/TSV supports filtering, numeric/text sorting, pagination, and column width adjustment, and correctly handles quotes and multiline fields.
  • TXT supports line numbers, full-text search, match count, auto-wrap, and pagination for large files in chunks of 250 lines.
  • Images/SVG supports fit to window, original size, zoom, drag-to-pan, dimension info, and transparent background checkerboard.
  • PDF uses the browser’s built-in PDF viewer and provides refresh and external open options.

Installation and Enablement

DSH Right Sidebar requires DSH Web to provide a session-level details.overlay slot and a named details bar API. First, confirm the current environment is DSH Web, then execute the installation command in the repository directory.

The following command will clone the repository, install dependencies, build the plugin, and add the current directory to the DSH Web profile:

git clone https://github.com/Limitinfinitude/DSH-Right-Sidebar.git
cd DSH-Right-Sidebar
npm install
npm run build
dsh plugin --profile web add .

After completing the steps above, refresh the DSH Web session.

Runtime Requirements

The plugin runs in the DSH client environment and accesses workspace files, artifact contents, or network artifacts. The following configuration declarations need attention:

  • package.json declares peerDependencies: @deepseek-ai/cordis ^4.0.1.
  • package.json declares dsh.client.platform as web.
  • package.json declares injection of the following client packages:
  • @deepseek-ai/dsh-client-runtime
  • @deepseek-ai/dsh-client-locale
  • @deepseek-ai/dsh-client-connection
  • @deepseek-ai/dsh-client-ui-layout

Typical Usage

  1. Let DSH generate reports, charts, images, PDFs, or data files.
  2. When rich preview artifacts like Markdown, PDF, SVG, and images appear, the right sidebar automatically expands and opens the latest artifact.
  3. Data files like TXT, JSON, and CSV only enter the artifact list when explicitly mentioned by the Agent, and do not take over the current rich preview.
  4. Use tabs to switch between different artifacts; they can be reopened from the bottom directory after closing.
  5. When source code or project files are needed, use “Open Containing Directory” to return to the DSH workspace.

Performance and Security

The sidebar does not poll files or ports when idle. Artifact content is only read after the user selects it, and complex previews are initialized on demand. JSON search iterates data only once, tables are limited to a maximum of 10,000 rows, and TXT uses pagination rendering. The browser bundle size is approximately 185 KB gzipped.

Files in the workspace have their paths validated. Artifacts outside the workspace have time-limited access after authorization via DSH’s same-origin policy. The maximum number of external authorized root directories is 256, expiring after 6 hours. Markdown and SVG are sanitized before rendering, binary files remain read-only, and HTML/HTM source files are not embedded in the Dock.

Network artifacts must be authorized by a same-origin DSH page first, then read through a restricted proxy without cookies or authentication headers; only supported file extensions are allowed, with a single response limit of 16 MB and a 10 second timeout. Incomplete paths are only resolved if there is a unique match in the registered workspace; multiple files with the same name will cause the system to refuse guessing.

Who is this for

Suitable for developers using Agents in DSH Web to generate documentation, charts, images, and data files, and who wish to view deliverables concentrated next to the session. Since the plugin runs with the privileges of the current dsh process, source code and the MIT license should be checked before installation.

Conclusion

The value of DSH Right Sidebar lies in gathering session artifacts from the workspace and tool logs into a stable right-side position: rich previews appear automatically, data files enter the list on demand, closed items can be reopened, and source code is returned to the DSH workspace for handling.

  • Repository: https://github.com/Limitinfinitude/DSH-Right-Sidebar
  • Directory Page: https://www.skillhub.cn/plugins/Limitinfinitude/DSH-Right-Sidebar