🎉 首个正式发布 / First release
@open-agfs/dsh-agfs — 面向 DeepSeek Harness 的文件浏览器插件:由宿主 webserver 托管的 React 前端 + REST API,附带 /dsh-agfs 命令与 browse_files 模型工具。
A file-browser web app plugin for the DeepSeek Harness: a React frontend and REST API served by the host webserver, with a /dsh-agfs command and a browse_files model tool.
功能 / Features
/dsh-agfs命令在系统默认浏览器中打开文件浏览器- 完整 REST API:
listreaddownloadopenopen_locationsearchinfoworkspacesidebarthumbnailmodedebugdeletecreate_folderrenamecopy - 路径安全:浏览根限定、
strictRoot实路径校验、符号链接/连接点逃逸拦截(干净 400 信封) readOnly只读模式、remoteMode远程禁用、自定义roots侧边栏根- 安全响应头:
X-Content-Type-Options: nosniff、X-Frame-Options: DENY、Referrer-Policy: no-referrer - 离线前端:React/ReactDOM 随包发布,无 CDN、无 Babel 即可启动
- 文本/图片预览(markdown、代码、日志)
browse_files模型工具:模型可直接列出或递归搜索浏览根(200 命中上限、深度上限 5)- 随包发布
dsh.bundlepatch:dsh plugin add一条命令激活为 profile 层
安装 / Install
dsh plugin --profile web add @open-agfs/dsh-agfs配置 / Config(节选)
| Key | 默认 | 含义 |
|---|---|---|
basePath |
/dsh-agfs |
服务应用与 API 的路由前缀 |
fileRoot |
当前工作目录 | 浏览根;侧边栏仍可访问各磁盘 |
readOnly |
false |
只读模式:写端点返回 403 |
strictRoot |
false |
锁定浏览根,拒绝绝对路径与符号链接逃逸 |
roots |
{} |
侧边栏自定义根 name -> path |
完整配置与开发文档见仓库 README(中英双语)。
链接 / Links
- npm:https://www.npmjs.com/package/@open-agfs/dsh-agfs
- 源码:https://github.com/openAGFS/dsh-agfs
- 环境要求:Node
^22.19 || >=24;依赖已发布的@deepseek-ai/dsh-*(rc.6)peer 包