前言¶
DeepSeek Harness (DSH) 采用插件化架构。dsh-better-sidebar 提供了侧边栏的基础 UI，但默认的 Explorer 功能较为受限，通常不具备文件系统的写入能力。在开发或调试过程中，若需在对话上下文中直接管理文件、上传素材或调整目录结构，直接操作文件系统往往较为繁琐。dsh-sidebar-explorer-plus 为 dsh-better-sidebar 增加了一个名为「文件」的 Tab，通过 React 实现文件树，并利用 Host 端 API 处理文件读写操作，从而在侧边栏内实现了完整的文件管理能力。
插件简介¶
dsh-sidebar-explorer-plus 是一个 TypeScript/React 开发的文件管理插件，专为 DeepSeek Harness 的 Web 侧边栏设计。
它通过 dsh-better-sidebar 的 ctx.betterSidebar.registerTab 服务注册 Tab，不修改侧边栏底层源码。其核心作用是补充 dsh-better-sidebar 自带 Explorer 缺失的「写」操作，允许用户在侧边栏直接进行文件上传、移动、重命名和删除。
安装¶
安装前请确保环境满足以下依赖：
* 运行中的 DSH Web Profile
* dsh-better-sidebar (版本 >= 0.4.0)
* Node.js 20 或更高版本
使用以下命令安装：
dsh plugin --profile web add github:Wulabalabo/dsh-sidebar-Explorer-Plus
安装完成后，需要重启 dsh web，并在浏览器中进行硬刷新（Cmd/Ctrl + Shift + R）以加载新插件。
使用方法¶
- 启动 DSH Web，打开侧边栏。
- 点击侧边栏菜单中的「+」号，选择「文件」。
- 上传文件/文件夹：直接将本地文件或文件夹拖拽到文件树区域，插件会按原结构上传。
- 管理文件：在文件树上右键可进行移动、重命名、删除或创建文件夹操作。
- 打开文件：点击文件树中的文件，会在侧边栏编辑器中打开。
配置与限制¶
插件默认单文件上传限制为 50 MiB。若需调整此限制，可在 profile 配置中添加 uploadLimit 字段。
- insert:
- id: sidebar-explorer
name: 'dsh-sidebar-explorer-plus'
config:
uploadLimit: 104857600 # 100 MB
注意事项：
* 删除操作：删除文件或文件夹是永久性的，且操作前会要求确认。
* 覆盖与冲突：上传文件时可以覆盖同名文件；但在移动或重命名时，若目标路径已存在，操作会被拒绝。
* 安全检查：插件包含 Host/Origin 请求检查、工作目录检查及上传大小限制。当前的路径检查通过字符串比较实现，不解析符号链接或完全规范化路径遍历段，因此建议在可信工作区中运行。
* 构建依赖：插件仓库中已包含构建产物（lib/ 目录），通过 Git 安装无需本地构建步骤。
总结¶
dsh-sidebar-explorer-plus 将文件系统操作能力直接集成到 DSH 侧边栏 UI 中，简化了开发者在本地与工作区之间管理文件和素材的流程。
