前言¶
在使用 DeepSeek Harness 进行会话开发时，查看当前工作目录结构往往需要切换窗口。这个插件在侧边栏底部增加了一个停靠的文件浏览器，提供懒加载目录树、筛选与重读功能，以及可拖拽调整高度的交互。
核心功能¶
- 停靠式集成：渲染在侧边栏脚部，宽度自动跟随侧边栏，不使用浮窗或独立卡片。
- 高度可拖动：通过拖动上边缘调整面板高度。
- 懒加载目录树：只展开已点击的层级，减少内存占用。
- 内存态开关：开关在内存中（设置 → 通用 → 文件浏览器），关闭后面板收起至标题行。
- 只读与围栏：插件只列举元数据，限制路径在会话工作目录内，单次最多列举 800 项。
- 双语支持：跟随 DSH 界面语言。
- 安装便捷：无需构建，直接安装。
安装¶
使用官方 CLI 安装 profile 插件：
dsh plugin --profile web add github:mabaoguo9527/dsh-file-explorer
安装后重启 dsh web 即可生效。
使用方式¶
- 导航：点击目录行展开或收起层级，点击文件行选中并显示相对路径。
- 筛选：在筛选框中输入名称过滤已加载的文件。
- 刷新：点击标题旁的 ↻ 图标重新读取目录。
- 折叠/展开面板：点击标题行左侧的箭头，或通过设置中的开关。
- 调整高度：按住面板上边缘并拖动。
安全与限制¶
插件设计为只读环境：
* 路径校验：所有请求都会校验路径是否在会话工作目录内，拒绝逃逸。
* 无内容读取：仅使用 fs.stat 和 fs.listDir，不读取文件内容。
* 无网络请求：不访问凭据或发起外部网络请求。
* 配置限制：插件不接受任何配置文件，开关状态保存在内存中，重启后重置。
结尾¶
这个插件通过将文件树集成到侧边栏，解决了本地开发时频繁切换窗口查看目录结构的痛点。其严格的只读限制和安全设计使其适合在开发环境中使用。
