@jaxzhou/dsh-file-explorer
DeepSeek Harness 插件：工作区文件浏览器，提供按格式的预览（渲染后的 Markdown、JSON 树、24 种语法高亮、图像），作为 Conversation View 中位于 Chat 和 Trajectory 旁的标签页显示
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @jaxzhou/dsh-file-explorer@0.1.5File Explorer 以 @jaxzhou/dsh-file-explorer 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Published on npm as
@jaxzhou/dsh-file-explorer— the unscoped namedsh-file-explorerbelongs to a different author's plugin.
A Files tab for DeepSeek Harness, beside Chat and Trajectory: the session workspace as a tree, and a preview that adapts to what the file is — rendered Markdown, a JSON tree, highlighted source, an image, or plain text. Read-only, no configuration, nothing stored.
dsh plugin --profile web add @jaxzhou/dsh-file-explorer
dsh --profile web
The Files tab beside Chat and Trajectory: a workspace tree on the left, and a rendered Markdown document on the right whose toolbar carries Copy, Source and Export PDF
15 seconds — click for the full-quality MP4. A primary-school maths workspace: a lesson document rendered with its tables, the Source toggle showing the Markdown behind it, a second document open beside it in its own tab, and Export PDF, which hands the page to the browser's print dialog.
The left pane is the session's working directory, listed one level at a time, directories first. An expanded level stays expanded while you move between preview tabs.
Clicking a file opens it in a tab, so several files stay open at once — each with its own body and its own wrap setting. A file that is already open is focused rather than reopened, tabs whose names collide show their directory, and the tab's × or a middle click closes one.
The right pane picks each tab's body from the file:
| Category | Preview |
|---|---|
| Markdown | Rendered GFM — headings, tables, task lists, quotes, math, footnotes, images referenced beside the file, highlighted code fences — with a Source toggle and an Export menu |
| HTML | Drawn as a page in a sandboxed frame: the file's own CSS applies, and its scripts run in an opaque origin that cannot reach this application. With a Source toggle and an Export menu |
| JSON | A collapsible tree with per-value copy, and the same toggle |
| Source code | Syntax highlighting, line numbers, and a copy button for 24 grammars: TypeScript/JavaScript, shell, Python, Ruby, Go, Rust, Java, C, C++, C#, Kotlin, Swift, PHP, YAML, TOML, INI, HTML, CSS, SCSS, Less, SQL, XML, Lua, MDX |
| Images | PNG, JPEG, GIF, WebP, AVIF, BMP, ICO and SVG, drawn to the pane. An SVG goes through <img>, so its scripts never run |
| Anything else | Numbered plain text — an unmapped suffix (.vue, .proto, .txt) stays plain rather than guessing a wrong grammar |
Text previews wrap at their spaces and keep every word whole; an image reads its complete bytes. Every text body carries a Copy control in the pane's toolbar, which copies the file's own text — a rendered Markdown document copies its Markdown source.
A rendered Markdown or HTML document also carries Export, which downloads a file directly — no print dialog — in either of two formats:
| Format | What it is |
|---|---|
| A picture of the page, laid out as A4 and sliced to fit. The text in it is not selectable. That is deliberate: a text-mode PDF of a Chinese document would need a CJK font embedded in the plugin, which is megabytes for a preview tool | |
Word (.docx) | A real Word document: headings, lists, tables, code and images, with the text still text — editable, searchable, and rendered with Word's own fonts. Chinese included |
A document's own local assets come with it: the images a Markdown file references beside it, and the images and stylesheets an HTML file links to.
DeepSeek Harness 0.1.5-rc.2 on the Web surface — dsh web, or a profile
composed from @deepseek-ai/dsh-base + @deepseek-ai/dsh-web-app. A headless or
SDK profile has no browser and gets no tab. The plugin declares no configuration,
so nothing in cordis.yml needs setting.
dsh plugin --profile web add @jaxzhou/dsh-file-explorer
dsh --profile web # bundle membership is read at startup
A custom profile needs the Web composition first:
dsh --profile myprofile --from-default-profile web
dsh plugin --profile myprofile add @jaxzhou/dsh-file-explorer
dsh --profile myprofile
Prefer a checkout or a git ref? Nothing needs building — the runtime artifacts are committed:
dsh plugin --profile web add /path/to/dsh-file-explorer
dsh plugin --profile web add github:jaxzhou/dsh-file-explorer
Then open a session that has a workspace and click Files. To confirm the layer landed:
dsh --profile web --dump-config | grep -A 2 jaxzhou-file-explorer
Disable the tab without uninstalling by adding an override to the profile's
cordis.patch.yml — it is applied after every bundle layer, and a
patchReload: live profile picks it up without a restart:
- id: jaxzhou-file-explorer
disabled: true
Uninstall with dsh plugin --profile web remove @jaxzhou/dsh-file-explorer, then
restart the profile.
workspaceFiles Remote
namespace; the Host's filesystem decides what is readable. The plugin holds no
file access, no path resolution, and no credentials of its own.<img>, so its scripts
never run at all.JSON.parse rejects — tsconfig.json is the common case. The pane says so and
shows the highlighted source instead of guessing at a tree.style.css or images against, so only
absolute URLs load there. An export does resolve them — the file it writes is
read from a copy that has been made to stand alone — so a document can export
with pictures it does not show in the preview.Build, checks, the artifact model, and how the client bundle reaches the browser: CONTRIBUTING.md.
MIT — see LICENSE.