dsh-file-explorer 🗂️

Workspace file explorer for DeepSeek Harness Web — a floating, resizable file browser with preview, editing, quick search, drag-to-move, trash/undo and Qoder-style context references.

DSH 工作区文件浏览器：悬浮可拖拽面板、分栏预览、语法高亮编辑、Ctrl+F 快速定位、行内重命名/新建、拖拽移动、回收站撤销、上下文引用与多种面板风格。

一个 dsh-plugin · Built for the DSH open ecosystem.

---

✨ Features

• 🖱️ Floating panel — drag by its header/blank tree area, resize from edges/corner, choose from 4 styles (Aurora glass · CRT terminal · Holo · Paper). Position / size / style remembered.
• 📂 Split tree + preview — lazy directory tree, type-colored file dots, syntax highlighting with per-language theming (IntelliJ IDEA-style for Java).
• ✏️ Edit & save — syntax-highlighted overlay editor, identical to read-only view in every panel style.
• 🔎 Ctrl+F quick locate — IDE-style incremental search as you type; first match auto-revealed, expanded & scrolled into view.
• 🔀 Inline rename / new file / new folder — edit-in-place on the row; move files by dragging onto a folder (with "won't cascade references" warning).
• 🗑️ Trash + Ctrl+Z undo — delete moves to .dsh-trash/ (30 min TTL), Ctrl+Z restores.
• 🧠 Context references — right-click a file/folder → add it as a reference chip above the composer; send expands it into the model's context (Qoder-style @path mentions also supported).
• 💾 State memory — open file, expanded dirs, scroll, panel geometry all persist across restarts.

🚀 Install (one command)

Requires DeepSeek Harness with a web profile.

dsh plugin --profile web add @jie-rong-214/dsh-file-explorer

Then restart dsh web and click the 🗂️ / folder icon in the bottom-right quick bar.

The package ships a dsh.bundle patch, so installing it automatically activates the profile layer — no manual cordis.patch.yml edits needed.

🛠 Development

git clone <your-repo>
cd dsh-file-explorer
npm install        # pulls esbuild
npm run build      # assembles lib/ from src/ + integrity checks

src/index.js is the host half (filesystem API on /hok-fs); src/client.js is the browser half (React components, rendered into shell.overlay).

Package scripts:

• npm run build — verify + assemble artifacts into lib/
• npm publish — package + publish to npm (runs prepublishOnly build)

📄 License

MIT — free to use, modify, distribute.