Preface¶

DeepSeek Harness (DSH) emphasizes plugin-based extensibility, and the community directory is an independent site with no official affiliation to DeepSeek / High-Flyer. For developers using the dsh web GUI, agents create, modify, or download files during a conversation session. These files typically appear in the current session’s working directory, requiring subsequent manual steps to locate paths, open files, preview images, or view text.

dsh-file-panel is a right-side file panel plugin for DeepSeek Harness. It tracks files created or downloaded by the agent during a session and displays them centrally in the right-hand panel, supporting preview, open, reveal in folder, and copy path.

Positioning and Maintenance Information¶

dsh-file-panel is maintained by yu2025-luo and is licensed under MIT.

Its core purpose is: to provide a right-side file panel in the dsh web interface that displays files created or downloaded by the agent during the current session, along with common file viewing and locating operations.

Core Features¶

dsh-file-panel provides the following verified capabilities:

• Automatically pops up the right panel when the agent creates or downloads files.
• New files are marked with a NEW badge.
• Images can be previewed inline.
• Text files display the first 256 KB of content.
• Other file types display metadata.
• Select and reveal files in the operating system file manager.
• Open files with the system default application.
• Copy the file’s absolute path.
• Provide a quick entry to open the current session’s workspace folder.
• Toggle automatic popup for new files.
• Collapsible into a floating launch button, or hide the panel entirely.

Installation and Enablement¶

Install from GitHub to the web profile:

dsh plugin --profile web add github:yu2025-luo/dsh-file-panel

The plugin collection takes effect after the dsh web server restarts. After installation, restart the dsh web server and refresh:

http://127.0.0.1:3080

To remove this plugin later if needed:

dsh plugin --profile web remove dsh-file-panel

Typical Usage¶

After installation and enablement, you can use the plugin as follows:

1. After the agent creates or downloads files, the right panel automatically pops up, with new files marked with a NEW badge.

2. Click a row to preview images, text, or metadata inline.

3. Hover over a row’s actions to preview, open, reveal in folder, or copy the path.

4. Click the bell icon to toggle automatic popup for new files.

5. Click – / × to collapse the panel into a floating launch button or hide the panel.

6. Click open workspace folder at the bottom to open the current session’s working directory.

Security Boundaries and Runtime Limitations¶

When using this plugin, the following facts should be noted:

• The /file-panel RPC channel is restricted to loopback authority and can only be invoked from the 127.0.0.1 page; over network access, the panel displays a notice and remains inactive.
• The file read/display endpoints only accept absolute paths already observed by the tracker and cannot serve as a general-purpose file reading interface.
• The plugin runs with the current dsh process’s permissions; source code and the MIT license should be reviewed before installation.
• Recursive filesystem watching relies on fs.watch({ recursive: true }) with Node >= 20; on platforms where this is unavailable, shell downloads may be missed.
• Panel state is process-local; it is empty after restart and does not scan historical files.
• By default, node_modules, .git, and temporary file noise are ignored.
• On headless Linux, reveal may report canReveal: false and hide the button.
• DeepSeek Harness is in pre-release; the interfaces this plugin depends on may change as dsh is upgraded.

Applicable Scenarios¶

dsh-file-panel is suitable for developers who want to quickly view files produced by the agent in dsh web sessions. It reduces the steps of manually finding files, opening files, and copying paths, and is especially suitable for workflows where sessions generate images, text, logs, downloaded files, and other artifacts.

If you rely on fully enabling the panel over remote access, or need to scan historical files, or use the file read endpoints for general-purpose file reading, this plugin’s boundaries do not meet those requirements.

Links¶

GitHub:

https://github.com/yu2025-luo/dsh-file-panel

Directory page:

https://www.skillhub.cn/plugins/yu2025-luo/dsh-file-panel