概览
@dsh-external/dsh-file-explorer
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **轻量文本编辑**:内置编辑覆盖 Markdown 以及未被扩展预览认领的任何文本文件(行内编辑/保存,切换文件或关闭面板时自动保存);全文件类型的富 CodeMirror 编辑(语法高亮、行号)仍需 `preview-code` 扩展。 - **单文件预览**:无多标签页、无行内 diff。 - **自动刷新采用防抖轮询**:抽屉打开且标签页可见时,目录树每约 3 秒及窗口获得焦点时重新拉取其已加载目录;没有服务器推送(`fs.watch`)通道。 - **文件链接拦截为 best-effort**:依赖 DSH 会话区的 CSS 类名(`_fileLink`、`data-produced-files-row`),上游 UI 结构调整时需同步选择器。 - **大文件**:超大文本文件分页流式加载(超过 `maxTextBytes` 后经 `readRawFile` 分页预览);图片读取受 `maxImageBytes` 上限约束,二进制 hexdump 只读取前 `maxBinaryBytes` 字节。 - **隐藏文件默认不显示**:以点开头的文件/目录默认不列出,点击头部"眼睛"开关即可显示;组合包配置 `showHidden: true` 表示始终显示(取或语义)。 - **搜索为纯客户端**:树顶搜索框只匹配已加载(已展开)的条目,位于未展开目录中的文件不会命中;当前没有服务端递归搜索。
