前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的理念。在 Web GUI 环境下，快速定位文件并直观区分文件类型是日常开发中的常见需求。现有的资源管理器功能在搜索灵活性和视觉区分度上存在局限。本插件通过在 dsh-better-sidebar 的内置 Explorer 标签页中增加搜索功能和文件类型徽章，直接在现有界面中提升了文件管理效率。
插件介绍¶
该插件由用户 mastereal 维护，开源协议为 MIT。它是一个客户端插件，主要解决两个问题：一是无需跳转即可在资源管理器内进行模糊搜索，二是通过彩色徽章在资源管理器树和编辑器标签页中展示文件类型。
核心功能¶
-
内嵌筛选框
筛选框直接位于内置 Explorer 标签页的「工作文件夹名」下方。输入关键词即可即时筛选文件列表。 -
Codex 式子序列匹配
搜索采用子序列匹配算法（字符按顺序命中即可）。例如，输入bxmd可以匹配到博客.md。算法对连续命中和分隔符边界进行了加权，文件名匹配优先于路径匹配。 -
文件类型徽章
插件会在资源管理器树和编辑器标签页的文件图标旁添加彩色徽章。支持的类型包括 TXT、DOC、XLS、PPT、PDF、IMG、ZIP、PY、JS、CFG、SH、C、WEB 等。Markdown 文件 (md) 按设计保留内置的#图标。 -
搜索结果可定位
在搜索结果列表中，悬停行尾的文件夹图标，可以将资源管理器窗口定位到该文件夹中。 -
自愈机制
插件包含心跳兜底观察器。当观察器失效时，会自动尝试恢复，以防止徽章显示异常。
安装与启用¶
安装需要 DeepSeek Harness Web GUI 环境，并依赖 dsh-better-sidebar 版本 0.14（v1.0.2+ 已适配 0.14 的 editorTreeSearch 挂载点）。
dsh plugin --profile web add https://github.com/mastereal/dsh-sidebar-enhancement-search/archive/refs/tags/v1.0.6.tar.gz
安装完成后，请执行以下步骤确保插件生效：
1. 重启 dsh web 服务。
2. 在浏览器中进行硬刷新（Ctrl + Shift + R）。
3. 关闭所有旧的 DSH 窗口或标签页，避免旧实例残留代码导致界面重复。
使用方法¶
- 打开侧边栏的资源管理器标签页。
- 在「工作文件夹名」下方的筛选框中输入关键词（如
bxmd）。 - 点击搜索结果在侧边栏编辑器打开；将鼠标悬停在行尾的文件夹图标上，可在系统文件夹中定位。
- 观察资源管理器树和编辑器标签页，文件图标旁会显示对应类型的彩色徽章。
风险与注意事项¶
本插件属于 vibecoding 作品（与 AI 协作编写），作者纯自用，未经过大规模测试。
- 代码依赖风险：插件直接操作
better-sidebar的 DOM（CSS 类名后缀、MutationObserver、注入样式表）。如果宿主软件升级，插件可能失效。 - 显示异常：安装有风险，可能出现徽章不显示或布局异常的情况。
- 免责声明：作者不对数据丢失、功能异常或使用后果负责，也不保证修复时间。遇到问题欢迎提 Issue，但不保证回复。
结语¶
该插件通过轻量级的 DOM 操作和子序列匹配算法，在不增加额外标签页的前提下，增强了 DSH 内置资源管理器的可用性。对于需要频繁在 Web 环境下管理文件的开发者，这是一个实用的增强工具。
插件目录：https://www.skillhub.cn/plugins/mastereal/dsh-sidebar-enhancement-search
GitHub 地址：https://github.com/mastereal/dsh-sidebar-enhancement-search
