AKS1st/dock-files

README 摘要

dock-files English DSH 生态中最好的文件浏览插件 —— 没有之一。 别的插件只会列个文件列表，dock-files 把 VSCode 资源管理器整个搬进 DSH：类型彩色图标、树形导引线、拖放导入、剪贴板粘贴、粘贴图片、上传进度条、右键菜单，样样齐全。在 DSH 里管理文件，用这一个就够了。 dock 系列的文件浏览插件：在侧边栏挂载文件面板，浏览当前会话工作目录（通过自己的 /wb-files 主机路由），点击文件交给已注册的文件查看器打开（如 dock-editor）。 效果预览 主界面 右键菜单 功能 - 目录树浏览 ：惰性递归展开，目录优先、大小写不敏感排序（VSCode 资源管理器顺序）；VSCode 风格文件树 UI（类型彩色图标、树形导引线、工具栏刷新/折叠全部、悬停操作按钮）。 - 会话隔离 ：所有操作以会话工作目录为边界，路径经 realpath 规范化后必须位于会话工作区内，越界路径一律 403。 - 文件打开 ：点击文件通过 ctx.files.open 分发给匹配的文件查看器（浮窗打开）。 - 对话路径打开 ：会话上下文中的文件路径——模型回复里的文件提及、工具卡片（read/edit/bash 摘要）中的路径、产出文件——点击后按扩展名交给对应的文件查看器（dock-editor / dock-images / dock-markdown）打开，不再依赖系统默认应用（ xdg-open / open / Invoke-Item ）；宿主没有桌面关联（容器 / headless / 失效的 IDE IPC socket）时不再弹出 path open failed 错误。文件夹、不存在的路径以及没有查看器注册的类型仍走系统默认应用。 - 文件管理器操作 ：右键菜单提供常用文件管理功能——新建文件 / 新建文件夹（自动去重命名，创建后直接进入行内重命名）、重命名（行内编辑，Enter 确认 / Esc 取消）、复制 / 剪切 / 粘贴（复制可重复粘贴，剪切项变灰、粘贴后清除）、粘贴图片（把系统剪贴板中的图片保存为文件，如 image.png ，按 mime 类型自动命名去重；菜单项会探测剪贴板，仅在其中有图片时自动显示）、删除（确认后递归删除，不会覆盖同名文件）、复制路径、刷新；空白区域右键可对根目录执行新建 / 粘贴 / 粘贴图片 / 刷新。 - 拖放 ：把系统里的文件拖进浏览器即可导入到目标文件夹（按原名自动去重，绝不覆盖）；树内拖动文件 / 文件夹到其它文件夹（或空白区域 = 根目录）可移动，拖到文件上则移入该文件所在目录（落点不准也能成功），拖到自身或子孙目录会被拒绝。 - 粘贴本地文件 ：在系统里复制文件后，点击面板使其获得焦点，按 Ctrl+V 即可粘贴导入（浏览器只通过 paste 事件暴露本地文件内…

分类