yu2025-luo/dsh-file-panel 预览 preview

yu2025-luo/dsh-file-panel

Plugin插件 Native原生 ⭐ 3 MIT Vision & Media视觉与多媒体

DeepSeek Harness 的右侧文件面板 — 当代理创建或下载文件时自动弹出,支持图片/文本预览、在文件夹中显示和打开操作。双语 · MIT

Project Overview项目介绍

dsh-file-panel is a native plugin built exclusively for the DeepSeek Harness (DSH) web GUI. It adds a right-side popup panel that tracks all files created and downloaded by the agent during an active DSH session. To install the plugin, users can run either dsh plugin --profile web add github:yu2025-luo/dsh-file-panel to install directly from GitHub, or clone the repository locally and run dsh plugin --profile web add link:. after building. Pre-built artifacts are already committed to the repository, so no extra build step is needed during installation. After installation, users must restart the dsh web server and refresh the local GUI page at http://127.0.0.1:3080 to activate the plugin. No additional configuration is required after activation.

During a DSH session, the plugin automatically pops up the panel whenever the agent writes or downloads a new file, and marks newly added files with a "NEW" badge. Users can click any file row to see an inline preview: images render directly, text files show the first 256 KB of content, and other file types display metadata. Each file row also has hover actions to open the file with the default OS app, reveal it in the system file manager, or copy its absolute path to the clipboard. The panel is draggable and resizable, and its state persists between browser sessions via localStorage.

This plugin is released under the open source MIT license, and requires Node.js 20 or newer for full functionality, since it uses the recursive fs.watch API that is only available in newer Node versions. If recursive watching is not available on your platform, the plugin will still track files created by DSH's own write and edit tools, but may miss files downloaded directly via shell commands. There are other known limitations: it does not retain file history after a DSH server restart, ignores node_modules and .git directories by design, and the "show in folder" button is hidden on headless Linux systems.

这是一款专为 DeepSeek Harness (DSH) Web 界面开发的原生插件,作用是在 DSH 会话中监控代理创建和下载的文件,并在界面右侧弹出一个可拖动、可调整大小的悬浮面板展示这些文件,类似 Codex 的文件查看器功能。插件支持预览图片、文本文件内容和其他文件的元数据,还提供打开文件、定位到系统文件夹、复制绝对路径等快捷操作。

当代理在当前会话中写入或下载文件到磁盘时,面板会自动弹出,最新生成的文件会标记「NEW」标签。用户可以点击行预览内容,悬停唤起操作菜单,也可以通过铃铛按钮切换自动弹出开关,还能将面板折叠为悬浮启动按钮或直接隐藏。面板的打开/折叠状态和自动弹出偏好会保存在浏览器 localStorage 中,适合需要在 DSH 会话中快速访问代理生成文件的用户使用。

该插件基于 MIT 许可证开源,要求用户预先安装 DSH CLI(npm 包 @deepseek-ai/dsh)和 pnpm 才能正常使用。支持从本地检出或 GitHub 直接安装,安装后无需额外构建,因为预构建产物已经提交到仓库。安装完成后需要重启 DSH Web 服务并刷新页面才能激活,同时存在一些已知限制,比如无头 Linux 无法使用打开文件夹功能。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 yu2025-luo/dsh-file-panel 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-file-panel

CI License: MIT

A plugin for DeepSeek Harness (dsh web GUI) that watches what the agent creates and downloads during a session, and shows it in a right-side popup panel — like the file viewer in Codex.

When a file or image is written to disk during a session, the panel pops up automatically on the right. Every row lets you:

  • 👁 Preview — images render inline; text files show their first 256 KB; other types show metadata.
  • 📂 Show in folder — opens the OS file manager with the file selected (explorer.exe /select on Windows, open -R on macOS, xdg-open on Linux).
  • ↗ Open — opens the file with the OS default application (via the harness's built-in host.openPath RPC).
  • 📋 Copy path — copies the absolute path to the clipboard.

Also ships a workspace folder shortcut at the bottom of the panel.

中文说明

Screenshots

Session files panel

The right-docked session files panel: every row previews, opens, reveals, or copies its path; the bottom button opens the session's working directory. The panel is fully draggable (grab the header) and resizable from its left and bottom edges, with scrollbars appearing when it gets narrow.

Installation

Requires DeepSeek Harness dsh CLI (npm package @deepseek-ai/dsh) and pnpm.

From a local checkout

cd dsh-file-panel
npm install          # installs esbuild (dev-only)
npm run build        # produces lib/index.js + lib/client.js (committed)

# register in the web profile (link: tracks your checkout live)
dsh plugin --profile web add link:.

From GitHub

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

The built artifacts are committed, so no build step runs during install.

Activate

Restart the dsh web server (plugin sets take effect on restart), then refresh http://127.0.0.1:3080. That's it — no configuration required.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-slack 下一个 Next dsh-custom-instructions →