workspace-files-explorer

English · 中文

Workspace file explorer plugin for the DeepSeek Harness (dsh) Web GUI: browse the file tree of the current session's workspace (cwd) in a floating panel; click a file to preview it — code files with line numbers and syntax highlighting, Markdown files rendered as rich text.

DeepSeek Harness（dsh）Web GUI 的工作区文件浏览器插件：在浮层面板中浏览当前会话工作区（cwd）的文件树，点击文件即可预览——代码文件带行号与语法高亮，Markdown 文件渲染为富文本。

English

中文 · ← Back to DeepSeekHarnessPlugins

Features

• Floating file panel: registered on shell.overlay, additive registration — replaces no built-in UI; docks at the top right by default
• File tree: lazy-loaded expansion, directories first, hidden files (dot-prefixed) dimmed, file sizes shown, truncation notice at 500 items per directory, one-click refresh
• Code preview: line numbers + lightweight syntax highlighting (30+ languages by extension: JS/TS/Python/Go/Rust/Java/C#/PHP/Bash/SQL/JSON/YAML/CSS/HTML…), auto-adapts to light/dark themes, oversized files truncated
• Markdown preview: headings / lists / tables / quotes / links / code blocks rendered, embedded code blocks highlighted too; the whole HTML is escaped before rendering, links only allow http/https and enforce rel="noopener noreferrer"
• Panel interaction: drag the title bar to move, drag the bottom-right corner to resize (400–1400 × 280–900), close / refresh
• Session header button: a "Workspace Files" button in the title-bar action area (lit = panel open), toggles visibility on click
• Follows the session: the workspace root comes from the current session's cwd (standard useSessions hook); switching sessions resets the panel and loads the new workspace automatically

Installation (dsh.bundle)

This repo is also an installable dsh plugin package (package.json declares dsh.bundle + dsh.client):

dsh plugin --profile web add github:YZz-S/dsh-workspace-files-explorer

After installation, the "Workspace Files" button appears in the session title-bar action area and the floating panel takes effect automatically. The dynamic usage (cordis_define loading host.js / client.js) is kept; pick either one.

Files

File	Description
index.js	Host half (installed form): webServer routes /api/wsf-explorer/*, read-only file browsing API
lib/client.js	Client half (installed form): __ModuleLoader__ browser module, calls Host routes via fetch
cordis.patch.yml	Bundle patch: inserts the plugin row into the dsh composition
host.js	Host half (dynamic form): for cordis_define, package-private RPC via harness.handle
client.js	Client half (dynamic form): for cordis_define, calls Host via host.call
README.md	This document
LICENSE	MIT license
package.json	Package metadata + dsh.bundle / dsh.client declarations

Usage

Method 1: dynamic Cordis plugin (temporary)

Define and run in a dsh Web GUI session with the Cordis tools:

1. Call cordis_define: paste host.js content as code.host and client.js content as code.client (plugin.kind: 'new', idPrefix of 3–6 lowercase letters)
2. Call cordis_run to activate and allow authorization in the UI
3. The panel opens by default; the "Workspace Files" button appears on the right of the title bar to toggle visibility

…