whitefirer/dsh-browser-fs

README excerpt

dsh-browser-fs 让 dsh 的 agent 读写 浏览器所在机器 的本地文件。dsh 自带的 fs 工具只能摸宿主机； 远程部署时浏览器在别的机器上，agent 够不到你本地的文件。本插件补上这个缺口： 用户在 dsh web 页面里通过 File System Access API（ showDirectoryPicker ）授权一个本地 目录，句柄存 IndexedDB；agent 通过三个模型工具 list/read/write 该目录下的文件，工具 调用经插件自建的 WebSocket 通道转发到浏览器执行。 原理 双面插件（cordis 插件体系）： - host 半 （ src/index.ts ，跑在 dsh 宿主 Node 进程） - ctx.webServer.registerUpgrade 注册精确路径 /browser-fs/ws 的 WS 通道； - ctx.tools.register 注册 browser fs list / browser fs read / browser fs write ； - execute 把 {type:'call', rpcId, op, args} 帧发给「持有授权句柄」的标签页，按 rpcId 配对 result 帧； exec.signal 接到 pending 的 abort（同时给浏览器发 cancel 帧）。 - client 半 （ src/client/ ，浏览器里跑） - 启动时从 IndexedDB 读回句柄并 queryPermission ；连回 host 的 WS（断线指数退避重连）； - 收到 call 帧后在授权目录上执行 File System Access 操作，回发 result 帧； - 在 shell.overlay 层注册一张浮动卡片：显示连接/授权状态，提供 授权目录 / 重新授权 / 更换目录 / 解除授权 按钮。 - 授权状态变化时广播 {type:'state', hasHandle, dirName} ；host 只把调用派给 hasHandle=true 的标签页（多个标签在线时的执行者选择）。 安装 dsh plugin add 会把本包装进 profile 的 dependencies，并因 manifest 里的 dsh.bundle.patch 声明自动把 dsh-browser-fs 追加进 dsh.profile.bundles 层栈 （patch 内容即本仓库的 cordis.patch.yml ：insert 一行挂 host 半，config 含 wsPath 与 requestTimeoutMs ）。 使用 1. 打开 dsh web 页面，右下角出现「browser-fs 浏览器文件」卡片（未授权时默认展开； …

Category