DeepSeek Harness Plugin Hub

Publish and manage complete Harness Profiles. Discover Plugins for your next setup.

Explore

PluginsPresetsDocsNews

Community

Publish a pluginContactReport an issue

Resources

Plugin Hub on GitHubDeepSeek HarnessSystem statusPrivacy notice
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

Independent and unofficial. Not affiliated with, authorized by, or endorsed by DeepSeek.

DeepSeek Harness Plugin Hub
ProfilesPluginsCategoriesNewsDocsSign inManage Profiles
ProfilesPluginsCategoriesNewsDocsSign in
← Plugins

dsh-folderead

Folderead

DeepSeek Harness plugin: Browse and manage workspace files in the right sidebar—expand as a tree, attach directories outside the workspace (the model can read and write them while files remain in place), reference files/folders in conversations, preview files as read-only in the panel (Markdown/code

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add dsh-folderead@0.2.0
READMECompatibilityVersions

Description

DeepSeek Harness plugin: Browse and manage workspace files in the right sidebar—expand as a tree, attach directories outside the workspace (the model can read and write them while files remain in place), reference files/folders in conversations, preview files as read-only in the panel (Markdown/code/images/PDFs), and move deleted items to the trash.

Compatibility and provenance

Folderead is published as dsh-folderead and currently resolves to version 0.2.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility
*
Runtime surfaces
web
Release source
npm
Registry updated
10/27/2026

Versions

0.2.0stable
10/27/2026

Related plugins

Loading related plugins…

Latest
0.2.0
DSH
*
HMR
Process restart
Tree shaking
Safe tree shaking not declared
Unpacked size
4.4 MB
Files
213
Surface
web
License
MIT
Source
npm
GitHub
★ 0
Weekly downloads
0
Last push
10/27/2026
View source ↗
README badge

Click the badge to copy Markdown for your README.

Do you maintain this Plugin?Claim benefit · Priority security scan

Verify the GitHub repository declared in package.json to manage this listing. After you claim it, Hub will prioritize a security scan of the current version and publish the result when it passes.

Claim this Plugin →
Report an issue

Related plugins

More verified plugins in developer-tools.

Web App@deepseek-ai/dsh-web-appThe dsh browser-surface bundle: the web patch layer over dsh-base plus the runtime glue plugin (frontend dist serving, web-surface prompt, bash runtime variables, URL line)Sdk Minimal@deepseek-ai/dsh-sdk-minimalThe standalone minimal SDK profile bundle: JSON-RPC, one DeepSeek adapter, persistent shell, and JSONL sessionsSdk App@deepseek-ai/dsh-sdk-appThe dsh SDK profile bundle: stdio JSON-RPC serving and process lifecycle over dsh-baseExperimental Plugin Market Bundle@deepseek-ai/dsh-experimental-plugin-market-bundleExperimental custom plugin indexes: a Discover tab that browses and installs bundles from plugin indexes

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