fastengiel-kurai/dsh-peekfile-everything

README 摘要

PeekFile 面向 DeepSeek Harness（DSH） 的全盘文件搜索、目录浏览与多格式预览插件。 PeekFile 连接当前工作目录、WSL 文件系统和 Windows Everything 索引，把散落在不同磁盘与目录中的文件带回 DSH 会话：搜索、浏览、预览、复制内容、截图、OCR，或作为文件引用加入对话。 当前主要适配 Windows 11 + WSL2 Ubuntu 24.04 + DSH Web。Everything、Better Sidebar、文档转换与 OCR 工具均为可选组件；不安装它们也能使用工作目录/WSL 搜索、目录浏览和基础格式预览。 ✅ 兼容性 项目 已验证环境 DSH 0.1.0-rc.8 ，mainline commit 141eb6fef83422698aef7a981029e843e8161534 Node.js = 22 操作系统 Windows 11 + WSL2 Ubuntu 24.04 Better Sidebar（可选） 0.14.0 最近验证日期 2026-08-22 验证记录 VERIFICATION.md 其他 Linux 环境可能可以运行，但尚未完成同等实机验证；macOS 目前隐藏画框截图入口。 ✨ 主要功能模块 🔍 全盘文件搜索 PeekFile 的核心定位是搜索“当前项目之外”的文件。 - 工作目录搜索 ：优先显示当前会话所属工作目录中的文件（better sidebar只能预览工作目录内有权限的文档）。 - WSL 搜索 ：搜索 Linux/WSL 文件系统中的文件，如果wsl自己的搜索效率太低，也可以把\\wsl.localhost\Ubuntu-24.04\home\用户名 文件夹放到everything的索引目录列表中。 - Everything 搜索 ：调用 Windows Everything 索引搜索本地磁盘，everything 1.5版本，exe文件安装在win系统里，cli 也就是es命令安装在wsl里。。 - 以上三个搜索范围可多选，默认全选；取消某一来源后立即重组现有结果。 - 三个来源分别分页、分别受“每来源每页上限”控制，结果按“工作目录 → WSL → Everything”排序。 - 搜索结果只缓存在当前页面内存中，不写入磁盘；开始全新搜索时释放旧缓存。 - 在原查询后追加 +关键词 可筛选当前缓存，例如 动画片 +合集 。 - 保存最近 10 条去重历史，点击历史词即可直接搜索。 - 显示文件名、类型、上级目录、搜索来源及文件名中的命中片段。 🗂️ 目录浏览 - 点击目录在原位置打开目录内容。 - 支持上级目录、返回本次搜索结果和当前路径显示。 - 文件夹与不支持内嵌预览的压缩文件保留为列表条目。 - 压缩文件可交给系统关联程序打开，不在 Pee…

分类