dsh-sidebar-explorer-plus
一个 dsh-better-sidebar 的消费插件：在侧边栏新增一个「文件」tab，内置一棵固定在工作区（cwd）内的文件树，提供真正的文件管理能力——上传、移动、删除、重命名、新建文件夹。它补充了 better-sidebar 自带 Explorer 缺失的「写」操作（Explorer 只读）。
它通过 dsh-better-sidebar 公开的 ctx.betterSidebar.registerTab 服务注册，是一个独立插件，不改动 better-sidebar 源码。
功能
- 🗂️ 拖拽任意文件（文本 / 图片 / PDF / 二进制…）上传，上传到指定目录
- 📁 拖拽整个文件夹上传，按原目录结构落盘
- 📂 文件树展示文件与文件夹；点文件在侧边栏编辑器打开
- ↕️ 拖拽移动：把文件/文件夹拖到另一个文件夹上移动（冲突报错跳过，不覆盖）
- ✏️ 重命名：右键 → 重命名
- 🗑️ 删除：右键 → 删除（永久删除 + 二次确认；文件夹递归删除）
- ➕ 新建文件夹：在选中目录下建子目录
- 🔒 与
/api相同的浏览器信任围栏 + 会话 cwd 路径约束（所有操作锁定在当前项目内，防目录穿越）
安装
> 前置：已安装 dsh-better-sidebar（本插件通过其 betterSidebar 服务注册 tab）。
dsh plugin --profile web add github:Wulabalabo/dsh-sidebar-Explorer-Plus装完重启 dsh web（本插件含 host 半），再浏览器硬刷新（Cmd/Ctrl+Shift+R），侧边栏 + 菜单里就会出现「文件」tab。
工作原理
| 半边 | 作用 |
|---|---|
host（src/index.ts → lib/index.js） | 注册 /sidebar-explorer/* 路由：upload（原始字节）/ delete / move / rename / mkdir（JSON），全部限定在会话 cwd 内 |
client（src/client/index.tsx → lib/client.js） | ctx.betterSidebar.registerTab 注册 sidebar-explorer tab，渲染文件树 + 拖拽区 + 右键菜单 |
路由契约：POST /sidebar-explorer/<op>；upload 用 query（sessionId/dir/name）+ 原始 body，其余用 JSON body（sessionId/path/from/to/name）。响应统一 { ok, value }。
开发 / 构建
npm install # 安装 devDependencies
npm run typecheck # tsc --noEmit
npm run build # esbuild 打包 + 生成 lib/types/*.d.tslib/是构建产物，已提交进仓库，因此从 git 安装无需任何构建步骤。- 客户端 bundle 走
window.__ModuleLoader__.load({ id: 'dsh-sidebar-explorer-plus', factory })注册，react作为 external 由模块表运行时解析。
配置（可选）
在 profile 的挂载行加 config 可调上传大小上限（默认 50 MB）：
- insert:
- id: sidebar-explorer
name: 'dsh-sidebar-explorer-plus'
config:
uploadLimit: 104857600 # 100 MBLicense
MIT