relay-dsh-plugin-files

Relay DSH Files Plugin

Now supports DSH 0.1.2-rc.1 while retaining 0.1.2-alpha.3 compatibility. Plugin 0.2.2 is verified on both releases. Install it from npm · Compatibility evidence.

Release channels: latest → 0.2.2; next → 0.2.1-rc.1.

npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.2 relay-dsh-plugin-files@0.2.2
npx @deepseek-ai/dsh@0.1.2-rc.1 web

English | 中文

npm package: relay-dsh-plugin-files · All Relay DSH plugins

Real npm-installed demo on official DSH: Files opens the Relay workspace README.md beside a live conversation. Watch the H.264 MP4.

relay-dsh-plugin-files adds a right-side workspace file explorer to the official DeepSeek Harness (DSH) Web UI. It lets you browse the active workspace and preview text files without leaving the conversation.

The plugin uses relay-dsh-plugin-workbench as its panel host. Install Workbench in the same DSH Profile.

The screenshot was captured from official DSH 0.1.1-rc.2 with Workbench, Files, and Terminal installed. Files works without Terminal; the combined screenshot shows the shared Workbench shell.

Do I Need This Plugin?

Install this plugin when you want to:

• browse the files in the workspace used by a DSH conversation;
• preview source files, Markdown, JSON, logs, and other UTF-8 text files;
• keep using official DSH while adding a file panel through the plugin system.

You do not need this plugin if you only use DSH chat and never inspect workspace files inside the browser.

Quick Start With Official DSH

The current development build has been validated with:

• DeepSeek Harness 0.1.1-rc.2, commit b150a551
• Node.js 22.13 or newer
• pnpm available on PATH

DSH is a developer preview and may introduce compatibility-breaking changes.

1. Install

Stop a running DSH Web process before changing Profile plugins.

GitHub development build

Use this when you want the latest unreleased development build:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-workbench#main github:yangbobo2021/relay-dsh-plugin-files#main

For a reproducible install, replace each #main with a tag or full commit SHA. The Workbench package is listed explicitly because DSH's pnpm profile blocks GitHub packages as transitive dependencies.

npm release

Install the published packages with:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest relay-dsh-plugin-files@latest

2. Start or restart DSH Web

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 web

If you already have a dsh command installed, dsh web is equivalent. Restart DSH Web after installing, updating, or removing plugins.

3. Open a workspace

In DSH Web:

• Open the DSH URL printed by the terminal.
• Complete the first-launch screen if DSH shows one.
• Create or select a conversation that has a workspace directory.
• Open the Workbench side panel and choose Files.
• Click a text file to preview it.

If no workspace session is selected, the panel asks you to open a workspace session first.

What It Provides

• A Files view in the Workbench side panel
• Workspace file tree loading through DSH Agent identity
• Workspace containment checks, so previews stay inside the active workspace
• Bounded UTF-8 text previews for practical browser use
• A filter box for quickly narrowing visible files
• Composition with the shared Workbench shell

Binary files, very large files, and paths outside the workspace are not previewed as plain text.

Plugin Boundary and Relay

This plugin owns only the Files view. It does not depend on Codex, Claude, Relay Events, or any private Relay runtime. It communicates with the shared Workbench shell through the public plugin contract.

The repository is maintained as part of Relay, an open-source project for long-running agent work, external-event delivery, reusable DSH workbench views, and multiple conversation backends.

Update, Inspect, or Remove

Stop DSH Web before changing plugins, then restart it afterward.

dsh plugin --profile web why relay-dsh-plugin-files
dsh plugin --profile web update relay-dsh-plugin-files
dsh plugin --profile web remove relay-dsh-plugin-files

For GitHub installs, pnpm records the package source inside the DSH Profile. Run dsh plugin --profile web why relay-dsh-plugin-files to inspect it.

Troubleshooting

The Files panel does not appear

Restart DSH Web after installing the plugin. Then inspect the Profile:

dsh plugin --profile web why relay-dsh-plugin-files

If the package came from GitHub main, try pinning a known commit SHA.

The panel says to open a workspace session

Create or select a DSH conversation that has a workspace directory. The Files plugin reads files from the active workspace, not from an arbitrary folder on your machine.

A file does not preview

The plugin previews bounded UTF-8 text content. Binary files, very large files, and paths outside the active workspace may be hidden or reported as unavailable.

Installation says pnpm is missing

Install pnpm using the official guide: https://pnpm.io/installation.

Development

git clone https://github.com/yangbobo2021/relay-dsh-plugin-files.git
cd relay-dsh-plugin-files
npm install
DSH_ROOT=/path/to/deepseek-harness npm run verify
npm pack

npm run verify runs type checking, tests, and the production build against an official DSH checkout.

Feedback

Report bugs and feature requests in this repository's issue tracker: https://github.com/yangbobo2021/relay-dsh-plugin-files/issues