@kurai/dsh-peekfile-everything

🤝 与 Better Sidebar 配合使用

DSH Better Sidebar 是工作目录内的侧边工作台，PeekFile 是跨目录、跨文件系统的全盘入口。两者不是互相替代，而是分工协作：

使用场景	Better Sidebar	PeekFile
当前工作目录文件树	主要负责	可搜索并打开
工作目录内编辑与项目操作	主要负责	只读预览为主
WSL 其他目录	不作为主要范围	主要负责搜索和预览
Windows 本地磁盘	不作为主要范围	通过 Everything 搜索
对话中的绝对文件路径	工作目录内可接管	全局识别并提供兜底预览
界面形态	固定侧栏/底栏工作台	浮动窗口或注册为 Sidebar Tab

PeekFile 提供两种配合方式：

1. 界面位置：选择“浮动窗口”时使用 PeekFile 自己的预览窗；选择“Better Sidebar”时，将 PeekFile 搜索主界面注册为 Sidebar Tab。

2. 预览处理：选择“PeekFile”时全部由 PeekFile 处理；选择“按文件类型自定义”时，可分别指定文本、图片、视频、PDF、Office、电子书等由 PeekFile 或 Better Sidebar 打开。

当某类文件选择 Better Sidebar 时，PeekFile 只传递文件路径，后续预览和操作由 Sidebar 自己管理。由于 Sidebar 的文件服务以会话工作目录为边界，工作目录以外的文件始终由 PeekFile 预览，并提示“Sidebar只能预览工作目录内文件。”

未安装 Better Sidebar 时，相关选项自动禁用并回退到 PeekFile 浮动窗口。

最小使用示例

1. 启动 DSH Web，进入任意会话。
2. 点击会话右上角的 PeekFiles。
3. 在搜索框输入文件名，例如 report.pdf。
4. 保持“工作目录 / WSL / Everything”全选，点击搜索。
5. 点击目录可继续浏览；点击文件会切换到预览区。

Everything 未安装时，在搜索按钮后的范围菜单中取消 Everything，工作目录和 WSL 搜索仍可使用。也可以让模型在对话中输出一个有效本地路径，然后直接点击路径预览。