dsh-file-explorer
给 DeepSeek Harness 加一个远程服务器文件树：左侧栏入口、右侧栏可停靠标签，VSCode 风格的目录树，点开就能看图片、直接播放视频。
A DeepSeek Harness plugin that renders a VSCode-like file tree for a remote SSH directory, with inline image preview and Range-streamed video playback.
它长什么样
左侧栏「文件」 ──┐
├── 主区域：整页文件树（点开文件夹逐层展开）
右侧栏 + →「文件树」┘ 服务器目录树
├─ 📁 DCR/
├─ 📁 LHM-plusplus/
└─ 📄 CLAUDE.md 22 KB
┌──────────────────────────────
│ 右侧预览：图片直接显示
│ 视频原生播放器，可拖进度条
└──────────────────────────────
三种入口，同一个页面：左侧导航栏入口（全屏）、右侧栏标签（和对话并排）、以及独立浏览器窗口
http://127.0.0.1:8910/。顶部路径栏可编辑：默认从
treeRoot开始，输入任意绝对路径回车即可跳转（↑回上一级、刷新重载当前目录）。拖拽上传：从资源管理器拖文件到目录行（或树空白处）即可上传到该目录，走
rclone rcat流式写入，带进度提示。
右键菜单：复制绝对路径 / 复制相对路径、重命名、移动到…、删除、在此新建文件夹；空白处右键可新建文件夹、复制当前目录路径、刷新。
右侧栏标签能分割、能浮动：一边对话一边看文件；浮动面板切换会话也不会被关掉。
预览：图片直接显示；视频用 HTTP Range 流式播放（不整段下载）；文本/代码显示前 256 KB；其它类型给下载/新窗口链接。
只读为主：服务只绑
127.0.0.1；默认允许浏览任意绝对路径，可用restrictToTreeRoot: true限制在起始目录子树内；上传可用allowUpload: false关闭。
依赖
| 依赖 | 说明 |
|---|---|
| DeepSeek Harness ≥ 0.2.2 | 需要 sidebar.panellist / main / sidebarRightTabs 槽位 |
| rclone | 唯一的外部程序，负责 SFTP 读取与字节范围读取 |
| OpenSSH 密钥 | 到目标服务器的免密登录（BatchMode 可用） |
choco install rclone -y # 或从 rclone.org 下载解压后加入 PATH
安装
方式一：插件市场（推荐）
在 DSH 里添加索引地址，然后在市场里安装 @bruce_young/dsh-file-explorer：
https://bruceyounggit.github.io/dsh-file-explorer/index.json
索引文件是仓库根目录的 index.json，已通过官方 parseMarketIndex 校验；0.3.0 同时提供 npm 源与 Git 源。
方式二：从仓库安装
git clone https://github.com/BruceYounggit/dsh-file-explorer.git
cd dsh-file-explorer
.\scripts\install.ps1 `
-SshHost 203.0.113.10 `
-SshPort 22 `
-TreeRoot /srv/data
脚本会做两件事：把仓库联接进 <profile>/node_modules/dsh-file-explorer，并在 <profile>/cordis.patch.yml 末尾插入一条带配置的 loader 条目。之后重启 DeepSeek Harness（或在插件列表里停用再启用该条目）即可。
卸载：
.\scripts\uninstall.ps1
配置
条目配置既可以写在 cordis.patch.yml，也可以放在 $DSH_HOME/file-explorer.json（默认 ~/.dsh/file-explorer.json），条目配置优先级更高。示例见 file-explorer.example.json 和 cordis.patch.example.yml。
| 字段 | 默认 | 说明 |
|---|---|---|
treeRoot |
/ |
文件树的默认起始目录；不是边界 |
restrictToTreeRoot |
false |
设 true 则只允许访问 treeRoot 子树 |
allowUpload |
true |
是否接受 POST /api/upload 拖拽上传 |
allowWrite |
true |
是否允许重命名 / 移动 / 删除 / 新建文件夹 |
treePort |
8910 |
本机端口；改端口需同步改 lib/client.js 的 TREE_URL |
ssh.host |
空 | 空则不启动树服务 |
ssh.port |
22 |
SSH 端口 |
ssh.user |
root |
登录用户 |
ssh.keyFile |
空 | 私钥路径 |
ssh.knownHosts |
空 | known_hosts 路径 |
sources |
[] |
额外的本地目录，每个起一个 rclone HTTP 目录（id/path/httpPort） |
装好但还没配置 SSH 时，面板不会白屏，而是一个引导页，直接告诉你配置文件路径和示例内容。
工作原理
DeepSeek Harness（Electron / Web）
├─ lib/client.js 浏览器插件：注册左侧入口、主区页面、右栏标签
│ └─ 三个入口都是同一个 iframe
└─ lib/index.js Host 插件：Node 进程内
├─ http://127.0.0.1:8910/ ── lib/explorer.html（树 + 预览）
├─ GET /api/list?path=… └─ rclone lsjson
├─ GET /api/file?path=…（Range） └─ rclone cat --offset --count
└─ http://127.0.0.1:89xx/ └─ 可选的本地目录（rclone serve http）
树页面是纯 HTML/CSS/JS，不依赖宿主框架；目录按需懒加载，视频靠 Accept-Ranges 边看边取。
安全
- 所有服务只监听
127.0.0.1，不对外暴露。 - 只读接口用
cat/lsjson；写操作只有上传和右键菜单那几个接口，都可用allowUpload/allowWrite单独关掉。 restrictToTreeRoot: true时，读写都被限制在treeRoot子树内。- 插件不做任何写操作以外的事情，也不接触凭据；SSH 认证交给系统
ssh/rclone。
已知限制
- Windows 优先（安装脚本是 PowerShell，
taskkill用于回收端口）；Linux/macOS 的 Host 半边可直接用，但脚本需自行改写。 - 一次只服务一个
treeRoot；没有搜索、排序、右键菜单、上传。 - 视频首次播放比本地文件慢一拍：每个 Range 请求都要一次 SSH 往返。
- 端口固定为 8910（客户端 URL 常量），被占用时树服务会启动失败并在日志里报错。
目录结构
lib/index.js Host 半边（树 API + 本地目录桥）
lib/client.js 浏览器半边（槽位注册）
lib/explorer.html 树 + 预览页面
scripts/ 安装 / 卸载脚本
cordis.patch.example.yml
开发
改完 lib/*.js 不需要构建：重启插件条目（插件列表停用/启用）即可让 Host 重新 import、浏览器重新拉模块。改 explorer.html 只需刷新页面。
排错：装了但左侧/右侧都没有入口
宿主半边通常正常（http://127.0.0.1:8910/ 能打开），缺的是浏览器那一半。按顺序检查：
插件是否被注册了两次
dsh.profile.bundles里有这个包，同时cordis.patch.yml里又有一条insert指向它，会让加载器把条目标成unaddressable，客户端模块随之不加载。 只保留一种：要么从bundles里删掉、只留 patch 的insert；要么反过来。模块 id 是否等于包名
lib/client.js第一行window.__ModuleLoader__.load({ id: ... })的 id 必须和package.json的name完全一致（含 scope）。改名后忘了同步这一行，就会宿主能跑、界面全无。是否真的重启过应用
dsh.profile.bundles与条目名只在启动时读取；关窗口再打开不等于重启，要从托盘退出后重新启动。
License
MIT
No comments yet. Be the first to write one.