DeepSeek Harness Plugin Hub

发布与管理完整 Harness Profiles,发现适合你的插件。

探索

插件目录环境预设文档中心动态

社区

发布插件联系我们报告问题

相关链接

Plugin Hub GitHubDeepSeek Harness 官方项目系统状态隐私说明
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

独立、非官方社区项目,与 DeepSeek 官方无隶属、授权或背书关系。

DeepSeek Harness Plugin Hub
ProfilesPlugins分类动态文档登录管理 Profiles
ProfilesPlugins分类动态文档登录
← Plugins

dsh-folderead

Folderead

DeepSeek Harness 插件:在右侧栏浏览与管理工作区文件——树形展开、附加工作区外目录(模型可读写、文件保持原位)、把文件/文件夹引用到对话、面板内只读预览(Markdown/代码/图片/PDF),删除移入废纸篓。

插件会安装到这里;不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add dsh-folderead@0.2.0
README兼容性版本

兼容性与来源证明

Folderead 以 dsh-folderead 发布,当前版本为 0.2.0。Plugin Hub 会校验它的 manifest,并保存精确安装来源,便于复现安装结果。

DSH 兼容范围
*
运行环境
web
发布来源
npm
Registry 更新时间
2026/10/27

版本

0.2.0stable
2026/10/27

相关插件

正在加载相关插件…

最新版
0.2.0
DSH
*
HMR
重启进程
Tree shaking
未声明可安全裁剪
解包体积
4.4 MB
文件数
213
Surface
web
许可证
MIT
发布源
npm
GitHub
★ 0
周下载
0
最近提交
2026/10/27
查看源码 ↗
README Badge

点击下方 Badge 复制 Markdown,粘贴到 README 即可。

这是你的 Plugin?认领权益 · 优先安全扫描

验证 package.json 声明的 GitHub 仓库,即可管理这个公开页面。认领后,Hub 会优先安排当前版本的安全扫描,并在通过后公开展示结果。

认领这个 Plugin →
报告问题

相关插件

继续浏览 developer-tools 分类下经过校验的插件。

Web App@deepseek-ai/dsh-web-appdsh 浏览器界面捆绑包:位于 dsh-base 之上的 Web 补丁层,加上运行时粘合插件(提供前端 dist、Web 界面提示符、bash 运行时变量和 URL 行)Sdk Minimal@deepseek-ai/dsh-sdk-minimal独立的最小 SDK 配置包:JSON-RPC、一个 DeepSeek 适配器、持久化 Shell 和 JSONL 会话Sdk App@deepseek-ai/dsh-sdk-appdsh SDK 配置包:基于 dsh-base 提供 stdio JSON-RPC 服务和进程生命周期管理Experimental Plugin Market Bundle@deepseek-ai/dsh-experimental-plugin-market-bundle实验性的自定义插件索引:一个用于浏览和安装插件索引中捆绑包的 Discover 选项卡

README

dsh-folderead

DeepSeek Harness(DSH)的右侧栏文件管理插件:在工作区里浏览、预览、编辑、整理文件,也可以把工作区之外的目录附加进来,让模型与你都能直接读写原文件。

这是 DSH 插件,不是独立的 npm 库。 它通过 DSH 的插件装载机制运行,需要宿主提供 webServer、workspaceRegistry、fs、sandboxPolicy、systemPrompt 五项服务,脱离 DSH 无法启动。

安装

需要 DSH 0.2.0-rc.2 或更新,Node.js 20+。

# 从 npm
dsh plugin add dsh-folderead

# 或直接从 GitHub
dsh plugin add github:nipheryang/dsh-folderead

DSH Desktop 也可以从应用内的 Settings → Plugins 安装(该 profile 归应用的插件管理器所有,CLI 在应用运行时不会改动它)。装完重启 dsh web 或应用。

能力

  • 树形浏览:目录就地展开,懒加载并按层缓存;悬停与按下时预热下一层。
  • 多位置切换:位置胶囊在工作区与已附加目录之间切换,重名目录以父级消歧。
  • 附加工作区外的目录:由你在原生目录选择器里亲手选定;其中的文件保持原位,插件直接操作原文件,不复制。
  • 引用到对话:把文件或文件夹作为引用放进对话输入框。
  • 面板内预览:Markdown(含 GFM 表格)、代码、图片、PDF。PDF 由随包自带的 pdfjs-dist 渲染,不依赖宿主的内置阅读器。
  • 面板内编辑:带 mtime/size 冲突检查;文件在外部被截断时不给编辑入口,避免保存把内容写短。
  • 整理:新建、移动、重命名、导入、导出、删除。删除移入废纸篓,不永久删除。
  • 在访达中显示:优先走宿主官方通道,通道不可用时退回 open -R。

权限与安全边界

这个插件能写文件,边界值得读完再装。

  • 两类可写位置:已注册的工作区根,以及该工作区已附加的目录。除此之外一律拒绝。
  • 附加即授权:附加一个目录,等于同时把该目录的读写权限交给模型。界面上会如实标注这一点;沙箱换根由插件自己的拦截层完成(接管 tools/execute 上的 write / edit / bash / pwsh)。
  • 路径校验:所有读写目标先做词法包含检查,再用 realpath 解析最近的已存在祖先,确保软链接不能被用来逃出所在位置。
  • HTTP 路由只服务本机:通过 socket 地址、Host 头、同源标记三重校验,只接受本机回环请求。
  • 导出需要亲手确认:目标目录必须由你在原生选择器里选定,且请求带 confirmOutside: true。
  • 删除没有退路:唯一的删除操作是移入废纸篓,逐项执行,任一项失败立刻中止并点名那一项;没有任何退回永久删除的分支。非 macOS 直接返回 trash-unsupported,同样不退回 rm。

平台

  • 主要面向 macOS:删除依赖 osascript 驱动访达,首次使用可能弹 macOS 自动化授权;在访达中显示依赖 open -R。
  • 非 macOS 平台可以浏览、预览、编辑、引用,但删除不可用(返回 trash-unsupported)。

开发

源码是纯 JavaScript,无构建步骤,运行时只依赖 Node 内置模块;浏览器半由宿主注入 React。

git clone https://github.com/nipheryang/dsh-folderead.git
cd dsh-folderead
node selftest-client.mjs          # 浏览器半离线自测(React/DOM 桩,无需 DSH)
node selftest-secondary-dirs.mjs  # 存储层自测
node selftest.mjs                 # Host 半自测
node selftest-intercept.mjs       # 拦截层自测

Host 半与拦截层自测会在主工作区里建夹具目录(故意不放临时区,否则沙箱围栏会无条件放行,"忘了换根"就测不出来)。它们默认取插件目录上三级作为工作区根;克隆到别处时,用环境变量指定:

FOLDEREAD_SELFTEST_ROOT=/path/to/workspace node selftest.mjs
DFM_TEST_PARENT=/path/to/workspace node selftest-intercept.mjs

第三方

  • vendor/pdfjs/ 是 pdfjs-dist 6.3.289 的逐字节原样副本(Apache-2.0),来源、版本与文件哈希见 vendor/pdfjs/VENDOR.md。
  • 沙箱换根拦截层与 system prompt 段移植自 dsh-multi-folder@0.3.3(MIT,Copyright (c) 2025 Yutong Zou),完整许可证见 LICENSE.dsh-multi-folder.txt。

许可

MIT