Nothree-code/folder-tree-sh

folder-tree-sh

DSH Web GUI 的工作区文件树插件（dsh-ftree）：文件浏览、多格式预览、内联编辑、Git 变更面板与完整文件操作，零核心修改、热插拔（profile bundle）。

功能

文件树
- 目录展开/折叠，5 秒自动刷新 + 手动刷新
- 过滤框：按文件名实时过滤
- 排序：名称 / 大小 / 修改时间（目录始终置顶）
- 隐藏文件开关：默认隐藏 .git / node_modules / .DS_Store
- 宽度拖拽调整 + 面板开关状态持久化（localStorage）

预览（多标签）
- Markdown：渲染 + 编辑双模式（工具栏、实时预览、自动保存、Ctrl+S），支持工作区相对路径图片（ 经 host raw 路由渲染）
- 代码：30+ 语言轻量高亮
- CSV：自动分隔符检测（, ; Tab）+ 表格渲染
- 图片：缩放（Ctrl+滚轮）/ 双击复位
- PDF：浏览器原生渲染（no-cache 字节流）
- DOCX：mammoth → HTML 真渲染（含图片），无 mammoth 时自动降级为 PowerShell 提取纯文本
- 文本：分块加载（1MB/块，100MB 上限），GBK 编码自动检测回退
- 多标签同时打开多个文件，切换即时

编辑
- Markdown 内联编辑：自动保存（800ms 防抖）+ 手动 Ctrl+S，保存前滚动备份 .dshbak.1~3

Git 变更面板
- 分支显示 + 变更列表（未跟踪 / 已暂存 / 已修改）
- 操作：暂存（add）、取消暂存（restore --staged）、丢弃更改（checkout --，未跟踪文件走回收站删除）、查看差异（diff / diff --cached）

文件操作（右键菜单）
- 刷新、新建文件、新建文件夹、重命名、删除（回收站）、复制/剪切/粘贴、原地复制、打开源文件夹（资源管理器定位）、复制路径、添加到聊天（图片）

安全模型

- Origin 白名单：从 webStartup 动态派生（127.0.0.1 / localhost / [::1] / 配置的 host / trustedHosts），跨站请求一律 403；监听 0.0.0.0（LAN）时退化为仅靠 CSRF token
- 每进程 anti-CSRF token：所有变更路由（op / write / git-op）必须携带 /dsh-ftree-token 颁发的 token
- 工作区白名单：所有路径必须位于已注册 workspace 根（deny by default）
- 删除进回收站，不永久删除；写入前滚动备份 .dshbak.1~3
- Shell 注入防护：所有 PowerShell 命令经单引号转义（' → ''）
- realpath 路径守卫（lib/pathguard.js）：所有路径经 realpath 规范化（跟随符号链接与 NTFS junction）后再做工作区前缀校验，.. 穿越、junction 与 symlink 逃逸均无法绕过白名单；不存在的写入目标自动回溯最近存在祖先（realpathLenient）
- 预览缓存：按文件 size 校验自动失效，写入后主动清除

开发

同步修改到 node_modules 实体拷贝（改完 lib/ 后执行）
powershell -ExecutionPolicy Bypass -File sync.ps1
若 package.json 有改动（名称/版本/dsh.client）
cd ..\.. && pnpm add "file:./packages/dsh-ftree"
重启 dsh web 生效

版本号以 package.json 为准（host 启动时读取，/dsh-ftree-meta 暴露给客户端做 stale-cache 检测）。

路由一览（host）

| 路由 | 方法 | 说明 |
|---|---|---|
| /dsh-ftree-meta | GET | 版本信息 |
| /dsh-ftree-token | GET | CSRF token |
| /dsh-ftree-list | GET | 列目录（withMtime=1 时附修改时间） |
| /dsh-ftree-read | GET | 分块读文件（text/image/pdf/docx） |
| /dsh-ftree-op | POST | rename / delete / paste / open / mkdir / newfile |
| /dsh-ftree-write | POST | 保存文本（带 .dshbak 备份） |
| /dsh-ftree-pdf | GET | PDF 字节流 |
| /dsh-ftree-raw | GET | 工作区原始字节（markdown 图片） |
| /dsh-ftree-git | GET | git status（branch + 变更） |
| /dsh-ftree-git-op | POST | stage / unstage / discard / diff |

许可

MIT