Sidebar disk browser for DeepSeek Harness - browse any folder on the server (including hidden ones) with text preview, streaming download and upload (multi-select / drag-and-drop, overwrite confirm), responsive on desktop and mobile.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:yanJ26/dsh-disk-browser
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
DeepSeek Harness (DSH) web 插件:侧边栏一键浏览服务器磁盘任意目录(含隐藏文件夹),支持文件预览、下载与上传。
English summary: a sidebar plugin for dsh web to browse any folder on the server disk (including hidden ones), with text preview, download and upload.
功能
- 📂 侧边栏「文件夹」按钮,打开全屏/弹窗式磁盘浏览器(默认从
/开始) - 🕶 隐藏文件默认显示(可关闭);隐藏项半透明标记
- 🧭 面包屑导航、路径输入框跳转、上一级 / 家目录快捷按钮
- 👁 文本文件预览(前 256 KB,二进制只显示大小)
- ⬇️ 文件下载:行内下载按钮 + 预览面板下载按钮(流式,支持中文文件名)
- ⬆️ 文件上传:工具栏多选上传 + 直接拖拽进列表;同名弹确认后可覆盖;单文件上限 1 GB
- 📱 响应式:宽侧边栏显示「图标 + 文件夹」,窄栏(手机)仅图标;弹窗在移动端全屏
兼容性
- dsh web 0.1.x(在 0.1.1-rc.2 验证)
- Node.js ≥ 20
- 零第三方依赖
安装
git clone https://github.com/yanj26/dsh-disk-browser.git
cd dsh-disk-browser
dsh plugin --profile web add .
然后重启 dsh web(或对应的 systemd 服务),浏览器强制刷新即可在侧边栏底部看到「文件夹」按钮。
反向代理子路径部署注意
如果你的 DSH 通过 nginx 等反代挂在子路径(如 https://example.com/dsh/),
需要把插件的根路径接口也转发到 DSH,否则打开面板报错:
location ~ ^/disk-browser(/|$) {
proxy_pass http://127.0.0.1:<DSH端口>;
proxy_http_version 1.1;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
proxy_buffering off;
}
直接以根路径暴露的部署无需任何额外配置。
HTTP API
| 路径 | 说明 |
|---|---|
GET /disk-browser/api/list?path=&hidden=1 |
列目录(目录优先,上限 2000 项) |
GET /disk-browser/api/read?path= |
读取文件头部(≤256KB,二进制检测) |
GET /disk-browser/api/download?path= |
流式下载(中文文件名安全) |
POST /disk-browser/api/upload?dir=&name=[&overwrite=1] |
上传(请求体即文件内容,≤1GB) |
⚠️ 安全提示
- 该插件对任何已登录 DSH 的用户开放整盘只读浏览与任意目录写入(上传),请以 root/普通用户的实际权限理解它;不要在共享多人的 DSH 上安装,或安装前自行收紧路由
- 上传接口会校验文件名(禁止路径穿越),同名默认拒绝、显式
overwrite=1才覆盖
卸载
dsh plugin --profile web remove dsh-disk-browser
License
MIT
作者 / Author
- yanJ26 — yanj.rvs@gmail.com
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 34626
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
superdesigndev/treg★ 5760
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 3102
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1139
Tencent CloudBase backend for DeepSeek Harness — scaffold and deploy full-stack apps from chat, render query results as table cards with paging, sorting and CSV export, preview a deployment on its domain, and call the CloudBase MCP toolset (`mcp__cloudbase__*`) with device-code login.
sixtysevenlf/dsh-blender-plugin★ 599
Lets a DSH agent drive a local Blender over a direct TCP channel with 16 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 186 ops across 28 families.
anysearch-team/anysearch-dsh★ 537
AnySearch-powered real-time web and vertical search provider for DeepSeek Harness.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.