dsh-explorer：DeepSeek Harness 里的原生工作区文件浏览器

它是做什么的？

wwwroot/dsh-explorer 是 DeepSeek Harness（DSH）的工作区文件浏览器插件，把本地工作区目录树直接搬进 DSH 界面。它解决的是「在 AI 对话里引用文件要来回切换窗口、手动抄路径」的麻烦，让浏览、搜索、打开和引用文件都在同一个界面完成。插件提供拖拽插入对话、编辑器标签页打开、Git 状态徽章、紧凑目录折叠、动效展开与密度缩放等能力，由作者 wwwroot 维护，采用 JavaScript 编写。

核心功能

• 精准拖拽引用：把文件或文件夹拖进 DSH 对话输入框时，按当前光标位置插入 /file` 形式的引用标签，不会覆盖已有文字；按住 Alt 或 Shift 拖放则把文件完整源码作为代码块嵌入提示词。
• 标签页打开与实时搜索：双击文件即可在 DSH 编辑器标签页中打开，右键菜单同样支持；顶部搜索栏按路径实时过滤文件与文件夹。
• Git 状态徽章：自动识别工作区根目录及嵌套子仓库，用 M/U/D 徽章标记修改、未跟踪、删除状态，并向上冒泡到父目录，无需逐层展开即可看到变更。
• 紧凑目录与动效折叠：单子目录层级（如 src/client/ui）合并为一行显示，文件夹展开收起带平滑网格动画，两者均可在选项面板中开关。
• 显示密度与缩放：提供紧凑、普通、宽松三档行高预设，以及 75% 到 135% 的连续缩放滑块，同步调整行高、字号、图标与缩进引导线，偏好保存在本地。
• 完整文件管理与键盘操作：悬停可复制相对路径、重命名（F2）、删除，支持方向键导航与 Enter 引用，并通过 WebSocket 监听文件系统变化实时刷新目录树。

怎么使用这个插件？

在 DSH 中启用后，左侧工作区会显示完整目录树，点击顶部搜索栏输入路径片段即可快速定位文件。需要引用文件时，把文件拖到对话输入框的光标处，或点击行上的 @ 图标、右键选择插入引用；想直接读取源码，就按住 Alt 或 Shift 再拖放。双击文件会在编辑器标签页中打开，右键菜单也能完成同样操作。展开文件夹查看 Git 徽章，或在选项面板里调整密度、缩放、动效与 Git 显示开关，这些设置会自动保存并在下次打开时恢复。

报错怎么排查？

目录树没有随外部文件变化刷新时，先确认 DSH 的 WebSocket 服务正常运行，再检查工作区路径是否指向正确目录。Git 徽章不显示时，确认工作区或其子目录确实是 Git 仓库，并检查选项面板中 Git 状态开关是否被关闭。拖拽插入位置不对或源码未嵌入时，确认拖放时鼠标位于输入框内且修饰键已按住，必要时按官方说明重新启用插件。