joejojoking-cloud/dsh-file-explorer

Name: joejojoking-cloud/dsh-file-explorer
Author: joejojoking-cloud

Plugin插件 Native原生 ⭐ 21 Models & Routing模型与路由 Docs & Writing文档与写作

DeepSeek Harness 的文件资源管理器插件：文件树、预览、Markdown、语法高亮、面板内编辑、VS Code 集成 - DeepSeek Harness 全局文件资源管理器插件

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native plugin built exclusively for DeepSeek Harness that adds a full-featured file explorer to the DSH web client. To install the plugin, you run the DSH CLI command dsh plugin --profile web add dsh-file-explorer, then restart DeepSeek Harness to activate it. Once activated, the plugin adds a folder toggle button to the header of every DSH session, which opens a resizable file tree panel on the right side of the interface. This panel supports core features like Markdown rendering, syntax highlighting for text files, in-panel file editing, and one-click opening of selected files or workspaces in VS Code or your system's native file manager.

The plugin is designed for developers who work with DSH regularly and need to manage project files without leaving their DSH session. When you double-click the chat area, the plugin will collapse both the file tree and preview panel, keeping only tags for files that belong to your current project. When you reopen the file explorer, your previous open tags are automatically restored, so you can pick up right where you left off. The plugin includes a search box that recursively scans your workspace to help you quickly find the files you need. By default, the search skips .git and node_modules directories and returns a maximum of 300 results to keep performance smooth.

The plugin does not support previewing files larger than 1MB, and supports syntax highlighting for over 15 common file types including JSON, Python, Go, Rust, CSS, HTML, and more. It is written in TypeScript, and uses pnpm as the build tool for local development. When modifying the plugin's code, you should only edit source files in the src/ directory, never edit built output files in the lib/ directory, because any changes there will be overwritten on the next build. After making changes, run pnpm run build to generate new output files, which are automatically picked up by DSH on restart.

这是专为DeepSeek Harness开发的原生文件资源管理器插件，为DSH添加了可调节宽度的右侧文件树面板，支持Markdown渲染、代码语法高亮、面板内文件编辑，还支持一键打开文件到VS Code或系统文件管理器。用户可通过DSH命令行工具执行dsh plugin --profile web add dsh-file-explorer完成安装，重启Harness后即可在所有会话中生效。

该插件适合需要在DSH会话中快速浏览、管理和编辑项目文件的开发者。日常使用时，用户可点击会话标题栏右侧的文件夹按钮打开面板，通过文件树点击或搜索框查找目标文件，打开后的文件会以标签页形式保留在预览面板，支持拖拽调整面板宽度、单独收起文件树或预览，操作逻辑和常见桌面文件管理器一致。

插件对超过1MB的文件不提供预览支持，搜索文件时默认跳过.git和node_modules目录，最多返回300条结果，支持近20种常见编程语言和配置文件的语法高亮。项目使用TypeScript开发，构建依赖pnpm，开发时需修改src/目录下的源码，不要直接改动构建生成的lib/目录产物。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-file-explorer（joejojoking-cloud/dsh-file-explorer）
仓库：https://github.com/joejojoking-cloud/dsh-file-explorer
本站详情页：https://www.yhbd.top/plugins/joejojoking-cloud-dsh-file-explorer/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 21 · 最近提交 2026-08-31 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
21 stars - an early-stage project星标 21，属于早期项目

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:joejojoking-cloud/dsh-file-explorer

把 joejojoking-cloud/dsh-file-explorer 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.7 KB · 缓存于 2026-09-01 05:12:54 · 3.7 KB

dsh-file-explorer

File Explorer for DeepSeek Harness — right-side resizable file tree with Markdown rendering, syntax highlighting, in-panel editing, and one-click VS Code / system file manager open. Install: dsh plugin --profile web add dsh-file-explorer.

DeepSeek Harness 的全局文件资源管理器插件：在任何会话的标题栏右侧提供文件夹切换按钮，点击后在页面右侧打开可调宽度的文件树面板。

功能

右侧面板（shell.overlay，可开关）：文件树与文件预览独立收起——各自左边缘有「>」按钮，收起文件树时预览保留并自动靠到页面右边缘；预览面板收起时标签全部保留，点树中文件即恢复；左边缘拖拽调宽（260–900px）
预览标签化：浏览器式多标签——每个文件一个标签，按打开顺序排列、点击后台标签不改变顺序，标签条溢出时横向滚动，点击切换不重新加载，标签带 × 可单独关闭，全部关完面板消失
双击聊天区：同时收起两个窗口，并按项目过滤——属于当前项目文件夹的预览标签保留，重新打开文件浏览器时自动恢复；不属于的关闭
标题栏：「文件」+ 六个图标 —— VS Code（在 VS Code 中打开整个工作区）、系统文件浏览器（在系统文件管理器中打开当前选中项：选中目录直接打开、选中文件在所在文件夹中定位高亮，未选中时打开项目根目录）、全部展开/折叠、刷新、编辑、收起文件树（预览保留）
搜索框「搜索文件」：递归扫描工作区（跳过 .git / node_modules，最多 300 条）
文件树：根目录默认展开，目录点击展开/折叠（懒加载），文件单击/双击打开预览
预览：.md 渲染 Markdown（标题/列表/代码块/引用/链接），Markdown 代码块按围栏语言高亮；其他文本文件按扩展名自动语法高亮（JSON / YAML / JS / TS / Python / C / C++ / Java / Go / Rust / Shell / SQL / TOML / INI / CSS / HTML 等）；「编辑」图标进入可编辑模式，保存写回磁盘；再次单击预览中的文件关闭该标签
超过 1 MB 的文件提示不支持预览

安装

dsh plugin --profile web add <本包路径或 npm 包名>

重启 harness 后生效：所有会话都会加载该插件（host 路由 /plugins/file-explorer/* + web client 面板）。

结构

src/index.ts — host 半部（构建到 lib/index.js）：fs/shell 服务 + webServer HTTP 路由（list / search / read / write / open-vscode / open-folder）
src/client/index.ts — web client 半部（tsc → lib/client/index.js → tsdown → lib/client.js）：注册 shell.overlay 面板与 conversation.session.header.actions 切换按钮
cordis.patch.yml — bundle 补丁，把 file-explorer 行插入 profile 的 host 组合

开发（重要）

pnpm run build        # clean && tsc && tsc -p tsconfig.client.json && tsdown
node --check lib/client.js
pnpm test             # host 半部单元测试（node --test）

永远不要直接改 lib/ 下的产物：它们由 src/ 构建生成。历史上直接手改 lib/client.js 曾把反引号写进 CSS 模板字符串，导致模板提前终止、整个 bundle SyntaxError、启动报 "loaded without registering"；而且下次构建会覆盖掉落手改内容。样式/逻辑改动一律落 src/，构建后由 host 的 rev 内容哈希自动换新。

已有约定：[data-phase=active] 的右侧让位 padding 即时生效（无 transition/will-change）——动画化的聊天列宽在流式期间会让 transcript 重排竞争 scroll anchoring，造成消息上跳/内容空白。

渲染基于仓库 joejojoking-cloud/dsh-file-explorer 的 README.md。在 GitHub 查看原文 →