Plugin directory / UI & Skins / dsh-side-dir
dsh-side-dir
Verified · install-tested on dsh NonchalantLudens
What it does
Project directory preview for the DeepSeek Harness web GUI — details-panel file tree + read-only file preview via a fenced /dirpreview command
Works — verified, early-stage project
Project directory preview for the DeepSeek Harness web GUI — details-panel file tree + read-only file preview via a fenced /dirpreview command It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-side-dir
DeepSeek Harness（dsh）Web 界面的项目目录预览插件：侧栏「目录」开关 → 右侧 details 面板浏览当前会话工作目录的文件树，点击文件只读预览内容。
English | 简体中文
How it works
- 目录树：懒加载。展开目录时经
/dirpreview list命令（ctx.fs.listDir）列出该层全部子项——含文件、类型与大小，单层上限 500 条。 - 文件内容：核心 wire 契约封闭（插件不能新增 RPC），内容通过插件注册的
/dirpreview read命令经command.executeRPC 返回——官方允许的 host→client 数据通道。 - 安全围栏：所有路径
ctx.fs.resolve到会话 cwd 并用ctx.fs.contains校验，越界拒绝；只读（handler 无任何写入）；内容上限 256KiB；二进制文件由ctx.fs.readText原生拒绝。 - 入口：侧栏底部「目录」按钮切换。ON 时以 priority 遮蔽 details 单槽渲染面板（原生面板在 OFF 后完整恢复）；OFF 释放。
Install
dsh plugin --profile web add github:NonchalantLudens/dsh-side-dir
# 或 npm 发布后：
# dsh plugin --profile web add dsh-side-dir
重启 dsh web，侧栏底部点「目录」。
Structure
lib/index.js— host 半边：注册/dirpreview命令（root / list / read 三个子命令）lib/client.js— 客户端产物（加载器闭包工厂格式，手写维护）：侧栏开关 + details 面板（目录树 + 文件预览）cordis.patch.yml— 安装时插入 host 行；dsh.client声明使客户端产物自动进入 web roster
Design doc
docs/specs/2026-08-23-side-dir-design.md
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-side-dir for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:NonchalantLudens/dsh-side-dirHeadless (CLI) profile:
dsh plugin --profile headless add github:NonchalantLudens/dsh-side-dirTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-side-dir/)<a href="https://dshbase.com/plugins/dsh-side-dir/"><img src="https://dshbase.com/badges/dsh-side-dir.svg" alt="dshbase install-tested"></a>