Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions plugins/local-fsearch/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# 更新记录

## 0.0.2

- 一个插件支持 Windows(Everything)和 macOS(FSearch)。
- 文件名、完整路径、分类、目录、扩展名、修改时间、大小筛选与分页。
- 图片缩略图与独立大图窗口,支持滚轮定位缩放和任意比例自由拖动。
- fs / find 快捷入口、搜索预设、主搜索推送和上次条件恢复。
- Windows 提供官网下载入口、连接检测,并随包提供官方 ES;Everything 客户端由用户自行安装。
- 公开作者:lifeek。
21 changes: 21 additions & 0 deletions plugins/local-fsearch/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 lifeek

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
51 changes: 51 additions & 0 deletions plugins/local-fsearch/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# FSearch 文件搜索

作者:**lifeek** · 版本:**0.0.2** · Windows / macOS

在 ZTools 中输入 fs 或 find,快速查找本机文件和文件夹。

## 主要功能

- 按文件名或完整路径搜索,支持字符模糊、正则和大小写匹配。
- 按类型、位置、扩展名、修改时间和大小筛选,支持排除目录。
- 图片列表显示缩略图;大图在独立窗口打开,支持滚轮定位缩放、自由拖动和最大化。
- 保存常用搜索为预设,也可生成 ZTools 独立指令。
- 可开启主搜索推送,在 ZTools 搜索框直接输入 fs 关键词查看匹配。

## 首次使用

**Windows**:从 [Everything 官网](https://www.voidtools.com/downloads/) 安装 Everything 完整版并启动客户端,然后在插件“使用与连接”点击“检测连接”。插件已附带官方 ES 命令行工具,不需要另外下载;不包含 Everything 客户端安装程序。

**macOS**:单独安装 [noahdunnagan/fsearch](https://github.com/noahdunnagan/fsearch)。正文、代码定义、Git 状态、常用优先和 Quick Look 为 macOS 专属功能。

## 数据与隐私

查询和预览在本机完成,插件不上传文件名、图片或正文,不建立额外索引。设置和预设保存在 ZTools 本地存储中。

## 兼容说明

Windows 已在 ZTools 3.2.0 与 Everything 1.4.1.1026 环境检查主要功能。macOS 最新图片窗口体验仍待实机确认。更多信息见安装和隐私说明。

## 功能预览

截图来自 Windows ZTools,使用专门生成的演示文件和图片;可点击查看原图。

### 文件搜索

![文件搜索](docs/screenshots/market-0.0.2/01-windows-search.png)

### 图片缩略图

![图片缩略图](docs/screenshots/market-0.0.2/02-windows-images.png)

### 独立大图预览

![独立大图预览](docs/screenshots/market-0.0.2/03-large-preview.png)

### 主搜索推送

![主搜索推送](docs/screenshots/market-0.0.2/04-main-push.png)

### 搜索预设

![搜索预设](docs/screenshots/market-0.0.2/05-preset-command.png)
45 changes: 45 additions & 0 deletions plugins/local-fsearch/THIRD_PARTY_NOTICES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# 第三方说明

本项目是第三方 ZTools 插件,不隶属于 FSearch 或 ZTools 官方。

## 外部引擎:noahdunnagan/fsearch

项目:https://github.com/noahdunnagan/fsearch\
已验证版本:v0.2.1(macOS Apple Silicon)\
许可证:MIT。FSearch 由用户独立安装,本插件不捆绑其二进制、不复制其索引或实现代码,仅使用公开的 JSON Lines 接口。以下保留其许可声明以便用户了解依赖。

```text
MIT License

Copyright (c) 2026 Noah Dunnagan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

## Windows:Everything 和 ES

Everything 索引服务由用户独立安装。随包提供 voidtools 官方 ES 1.1.0.38 命令行工具(x64、ARM64、x86),用于查询已运行的 Everything。官方来源、MIT 许可证及 SHA-256 见 [vendor/es](vendor/es/README.md)。不包含 Everything 客户端安装程序。

## 宿主与图标

ZTools 由用户独立安装。本项目调用公开插件 API,不捆绑宿主代码或二进制;宿主许可证以其项目声明为准:https://github.com/ZToolsCenter/ZTools 。

插件 Logo 的 SVG 源文件及 PNG 导出随本项目 MIT 许可证分发。渲染导出使用 @resvg/resvg-js 2.6.2(MPL-2.0),渲染器不进入运行文件或安装产物。本项目没有 npm 运行时第三方依赖。

若后续改为捆绑引擎或引入第三方实现,需要重新核查所有随包组件的许可与声明;此文档不代表官方市场已审核。
Loading
Loading