工作区文件面板Lings01/dsh-filepanel-plugin

dsh-filepanel-plugin

DeepSeek Harness (DSH) 工作区文件面板插件 —— 在浏览器界面中管理当前工作区文件的可视化面板。

一个运行在 DSH Web 界面中的动态 Cordis 插件：从屏幕右侧边缘滑出一个文件面板，浏览、上传、下载、预览、编辑、搜索、压缩…… 当前工作区的全部文件操作，都在浏览器里完成。

UI 无 emoji，全部使用 SVG 线条图标，配色全面接入 DSH 主题令牌（--dsw-alias-），亮/暗主题自动适配。

功能一览

| 分类 | 功能 |
| --- | --- |
| 入口 | 屏幕最右边缘热区/标签，鼠标悬停 0.3s 滑出，移出面板 0.5s 自动收起；面板宽度可拖拽调整 |
| 浏览 | 面包屑导航、上级目录、刷新、目录内过滤、目录优先排序 |
| 传输 | 流式上传（1MB/块、进度条 + 速率 + 可取消、上限 2GB、临时文件原子替换）、下载、浏览器新标签打开 |
| 预览 | PDF（内嵌浏览器阅读器）、图片、文本/代码（行号 + 语法高亮 + 编辑，Ctrl/Cmd+S 保存） |
| 文件操作 | 新建文件/文件夹、重命名、删除（二次确认）、复制路径、移动/复制到其他目录（目录选择器） |
| 批量 | 多选 → 批量下载 / 打包 / 移动 / 复制 / 删除 |
| 搜索 | 全工作区递归搜索：文件名 + 文本内容匹配，结果一键直达 |
| 压缩 | 选中项打包为 zip；.zip 文件一键解压到当前目录 |
| 上传方式 | 按钮选择 + 拖拽上传（拖入面板即传） |

截图

（暂无截图 —— 请打开面板自行体验）

工作原理

这是一个 Host + Client 双端的动态 Cordis 插件：

- Host 半部（src/host.js）：
- 通过 harness.handle 注册 15 个 Package-private RPC 方法（列表、搜索、读写、移动/复制、zip/unzip、流式上传等）
- 在 webServer 注册同源下载路由 /__dsh__/filepanel/download，带一次性令牌 + 工作区包含校验，支持 inline 预览（图片/PDF）与附件下载
- 所有路径经 fs.contains 强制约束在会话工作区内；写操作遵循会话沙箱策略（workspace-write）
- Client 半部（src/client.js）：
- 注册到 shell.overlay 插槽（浮动层，不替换任何自带 UI）
- React 组件 + 内联 SVG 图标 + DSH 主题令牌，无需构建、无外部依赖

RPC 方法表（panel.）

| 方法 | 说明 |
| --- | --- |
| list | 列出目录（名称/类型/大小/绝对路径） |
| search | 递归搜索（文件名 + ≤256KB 文本文件内容；深度 ≤8，结果 ≤200） |
| readText / writeText | 文本读取（≤512KB 预览）/ 原子写入 |
| createDir / remove / rename | 新建目录 / 删除 / 重命名 |
| move / copy | 批量移动 / 递归复制（含同名冲突检查） |
| zip / unzip | 打包（zip -r）/ 解压（unzip -o） |
| uploadStart / uploadChunk / uploadAbort | 流式上传（base64 分块写入临时文件，完成后原子替换） |
| token | 下载路由一次性令牌 |

安装与使用

当前版本以 DSH 动态插件形式运行（无需改部署配置、无需构建）：

1. 在 DSH 会话中调用 cordis_define，提供 src/host.js 与 src/client.js 两段代码（函数体，不含外层 export）。
2. 调用 cordis_run 激活（Client 半部首次需在界面中批准）。
3. 激活后：鼠标移到屏幕最右边缘悬停片刻，文件面板即从右侧滑出；或点击右侧边缘的文件夹标签。

注意：动态插件是进程内临时扩展，重启后需重新定义/运行。若要持久化，可将该插件纳入 DSH 部署的 Cordis 组合（cordis.yml）。

依赖与限制

- Host 依赖服务：fs、shell、webServer、sandboxPolicy（DSH 标准能力，均随部署提供）
- 压缩功能依赖系统命令 zip / unzip（Linux 常见，未安装时仅打包/解压不可用）
- 上传上限 2GB；预览上限：文本 512KB、图片/PDF 256MB；全局搜索限深度 8、访问节点 4000、结果 200
- 「用系统应用打开」在无图形界面的服务器上不可用（会给出友好提示；请使用面板内预览或浏览器打开）

开发

dsh-filepannel-plugin/
├── src/
│   ├── host.js        # Host 半部（RPC + 下载路由）
│   └── client.js      # Client 半部（面板 UI）
├── README.md          # 中文文档
├── README.en.md       # English docs
└── LICENSE            # MIT

提交 PR 前请保持：无 emoji、配色仅用 DSH 主题令牌、纯 JavaScript（无 TS/JSX/构建）。

License

MIT