whitefirer/dsh-browser-fs2

dsh-browser-fs

dsh plugin: let the agent list/read/write files inside a browser-authorized local directory (File System Access API) through a WebSocket relay

AI 分析

核心用途是让 AI Agent 安全地操作浏览器端用户的本地目录。适合需要在网页端直接让 AI 读写本地代码或文档的用户,通过浏览器原生授权,无需直接暴露宿主机文件系统。

パッケージ
dsh-browser-fs
バージョン
0.1.3
最終更新
2026/08/16

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:whitefirer/dsh-browser-fs

ドキュメント

README 全文を読む ↗

使用

  1. 打开 dsh web 页面,右下角出现「browser-fs 浏览器文件」卡片(未授权时默认展开; 授权后默认折叠成 📁 圆钮,点一下展开、按住可拖动,「—」收起;折叠状态存 localStorage,刷新保持,圆钮上的状态点颜色与卡片一致);
  2. 点「授权目录」,在系统选择器里选一个本地目录(需要 readwrite 权限);
  3. 卡片上的「目录内容」区可直接浏览授权目录:懒加载树(点目录行展开/收起, 每级上限 200 条,超出显示「…还有 N 项」),文件行显示大小并带「复制路径」 按钮(复制相对路径,方便贴给 AI);
  4. 之后 agent 即可使用三个工具:
    • browser_fs_list { path?, recursive? } — 列目录(相对路径/类型/大小,递归可选)
    • browser_fs_read { path, maxBytes? } — 读文本文件(默认上限 256 KiB,截断会标注)
    • browser_fs_write { path, content } — 写文本文件(自动创建父目录,返回字节数)

工具描述里明确告知模型:操作的是浏览器机器的本地盘,不是宿主机文件系统。

卡片界面语言跟随 dsh 的「设置 → 通用设置 → 语言」(插件订阅 dsh 客户端的 locale 服务,切换即时生效;无该服务的组合退回 ``/浏览器语言)。