dock-files
DSH 停靠栏的文件浏览器：浏览当前对话的工作目录，并在已注册的文件查看器中打开文件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dock-files@0.3.0
Dock Files 以 dock-files 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
面向 DSH 工作区的文件浏览插件。 dock-files 提供 VSCode 风格的文件树、拖放导入、剪贴板粘贴、传输任务管理和右键菜单。
dock 系列的文件浏览插件：在侧边栏挂载文件面板，浏览当前会话工作目录（通过自己的 /wb-files 主机路由），点击文件交给已注册的文件查看器打开（如 dock-editor）。
| 主界面 | 右键菜单 |
|---|---|
| dock-files 文件浏览主界面 | dock-files 右键菜单 |
ctx.files.open 分发给匹配的文件查看器（浮窗打开）。dock-files.open-source 默认值为 dock，可选 dock / harness。Harness 模式不包装 sidebarRight.openResource()，完全保留原生行为。dock 模式仅包装该 canonical carrier：识别 dsh-resource://file/session/... 和 file/absolute/...，按 b67 规则逐段解码并解析实际路径；存在、非目录且有查看器的文件交给 Workbench，否则原样调用 Harness，并保留 options。异步探测在设置切换或插件销毁后不会产生 stale Workbench 路由。image.png，按 mime 类型自动命名去重；菜单项会探测剪贴板，仅在其中有图片时自动显示）、删除（确认后递归删除，不会覆盖同名文件）、复制路径、刷新；普通文件可通过右键菜单触发浏览器下载，软链接跳过下载；空白区域右键可对根目录执行新建 / 粘贴 / 粘贴图片 / 刷新。locale/change 事件即时切换）；新建文件 / 文件夹的默认名也随语言（New File.txt / 新建文件.txt）。ctx.files（open / registerFileViewer / registerFileIcon），其他插件可注册自己的查看器（exts 扩展名匹配或 default 兜底）及按扩展名的图标（registerFileIcon，一个插件可注册多组）；注册时可附带 icon（主题色 + 可选自定义 SVG 图形），文件浏览器按扩展名渲染各插件注册的图标，未注册类型回退内置调色板。| 依赖 | 类型 | 说明 |
|---|---|---|
| dock-base >= 0.2.0 | peer（必需） | 工作台外壳：dock-files 的侧边栏面板、浮窗、ctx.workbench 都由它提供 |
| DSH Web 环境 >= 0.1.3-alpha.2 | 运行时 | 必需；最低 Harness 版本为 >=0.1.3-alpha.2（b67），客户端平台为 Web |
cordis ^4.0.0-rc.7 | peer | 插件框架（DSH 自带）；客户端注入的 workbench 为硬依赖 |
react ^18.2.0 | peer（可选） | 客户端渲染需要；未提供时面板 UI 不激活 |
可选查看器（不装也能浏览，装了才能打开对应文件）：dock-editor（文本）、dock-images（图片）、dock-markdown（Markdown）。
需要 dock 基础插件：
推荐从 npm registry 安装：
dsh plugin --profile web add dock-base
dsh plugin --profile web add dock-files
或通过 GitHub 安装（备选）：
dsh plugin --profile web add github:AKS1st/dock
dsh plugin --profile web add github:AKS1st/dock-files
配合查看器插件使用（可组合、按需）：dock-editor（文本）、dock-images（图片）、dock-markdown（Markdown）。
主机路由只接受来自受信任来源（回环地址 / 配置的 trustedHosts + 同源检查）的 POST 请求，且任何目录访问都会先做 realpath 规范化再与会话工作区做前缀比较——.. 逃逸、指向工作区外的符号链接、无关绝对路径都会被拒绝（403）。
MIT