文件解锁
检测并解除文件、文件夹或外接 U 盘被进程占用的锁死状态，支持解锁后一键移入回收站或重命名
插件界面截图
核心功能特性
多源自动填入
启动插件时按优先级依次尝试：① 启动上下文传入的文件路径；② 剪贴板中复制的文件实体 (CF_HDROP) 或合法本地绝对路径文本；③ 本机当前挂载的可移动磁盘列表。
手动选择与切换
支持在搜索框直接粘贴任意文件/文件夹路径，或通过顶部全局按钮「选择文件 / 文件夹」调用系统对话框选择目标。
目录递归探测
当目标为文件夹或盘符（如 D:\project 或 E:\）时，自动检测该目录本身及其下属打开的子文件句柄。
占用详情透视
展示每个占用进程的：进程名称 (name)、PID、完整可执行路径 (exePath)、进程类型（普通应用 / Explorer 外壳 / 系统服务）、正在锁定的具体子文件路径 (lockedFilePath)。
一键全部解锁
按 expectedName 校验并优雅终止所有非系统保护的占用进程；若包含 explorer.exe，则自动执行 taskkill /f /im explorer.exe && start explorer.exe 刷新外壳释放句柄。
解锁并移入回收站
先解除所有占用进程，等待句柄释放确认（最多轮询 1.5s），随后调用 ztools.shell.trashItem 将目标文件安全移入回收站。
插件详细介绍与使用指南
功能概述
文件解锁（插件标识：file-unlock）是 ZTools 极客桌面效率中枢面向 系统工具 场景打造的官方核心扩展。检测并解除文件、文件夹或外接 U 盘被进程占用的锁死状态，支持解锁后一键移入回收站或重命名。
- 底层核心痛点：用户在删除文件、重命名文件夹或安全弹出 U 盘/移动硬盘时，Windows 频繁弹出“操作无法完成，因为其中的文件夹或文件已在另一程序中打开”，但系统绝不告诉用户到底是哪个后台进程（如
wps.exe、explorer.exe、node.exe、杀毒软件或预览窗格）占用了它。 - 核心不变量与安全红线：必须精准定位持有该文件或目录子孙句柄的具体 PID 与可执行路径；结束占用进程前必须拦截系统关键保护进程（如
csrss.exe、lsass.exe、svchost.exe、wininit.exe），若占用者是explorer.exe则支持平滑重启资源管理器而非把桌面搞黑屏。 - 最简收敛路径：支持自动读取当前资源管理器选中文件/剪贴板文件路径或手动选文件/盘符 → 1 秒列出所有占用该路径的进程清单 →
Enter一键结束占用进程并释放文件，Ctrl+Enter解锁后直接移入回收站。
- 架构标准：
@ztools/declarative-ui声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：系统工具
---
核心功能特性
- 多源自动填入：启动插件时按优先级依次尝试：① 启动上下文传入的文件路径；② 剪贴板中复制的文件实体 (
CF_HDROP) 或合法本地绝对路径文本；③ 本机当前挂载的可移动磁盘列表。 - 手动选择与切换：支持在搜索框直接粘贴任意文件/文件夹路径，或通过顶部全局按钮「选择文件 / 文件夹」调用系统对话框选择目标。
- 目录递归探测：当目标为文件夹或盘符（如
D:\project或E:\）时，自动检测该目录本身及其下属打开的子文件句柄。 - 占用详情透视：展示每个占用进程的：进程名称 (
name)、PID、完整可执行路径 (exePath)、进程类型（普通应用 / Explorer 外壳 / 系统服务）、正在锁定的具体子文件路径 (lockedFilePath)。 - 一键全部解锁：按
expectedName校验并优雅终止所有非系统保护的占用进程；若包含explorer.exe，则自动执行taskkill /f /im explorer.exe && start explorer.exe刷新外壳释放句柄。 - 解锁并移入回收站：先解除所有占用进程，等待句柄释放确认（最多轮询 1.5s），随后调用
ztools.shell.trashItem将目标文件安全移入回收站。
---
典型高频使用场景
- 场景 1：检测文件或文件夹被哪个进程占用并一键强制解锁、解锁并删除 — 当你需要快速执行该任务时，按下
Alt+Space输入文件解锁/解除占用/unlock/无法删除/文件被占用，回车即可直接进入file-unlock视图完成处理并一键复制或导出结果。 - 场景 2：检测 U 盘或移动硬盘被哪个后台进程占用导致无法安全弹出 — 当你需要快速执行该任务时，按下
Alt+Space输入U盘解锁/弹出U盘/无法弹出/移动硬盘占用/eject，回车即可直接进入usb-unlock视图完成处理并一键复制或导出结果。 - 纯净替代传统臃肿单机小工具：以轻量声明式扩展替代动辄上百 MB、带开机自启与推广弹窗的传统共享软件，保持操作系统常驻进程极致清爽。
---
唤醒指令与全键盘快捷操作指南
在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 文件解锁 的对应功能模块：
功能命令标识 (featureCode) |
功能说明 | 推荐触发词 / 唤醒指令 (cmds) |
|---|---|---|
file-unlock |
检测文件或文件夹被哪个进程占用并一键强制解锁、解锁并删除 | 文件解锁 / 解除占用 / unlock / 无法删除 / 文件被占用 |
usb-unlock |
检测 U 盘或移动硬盘被哪个后台进程占用导致无法安全弹出 | U盘解锁 / 弹出U盘 / 无法弹出 / 移动硬盘占用 / eject |
全局高频键盘快捷键
| 快捷键 (Windows / macOS) | 交互行为说明 |
|---|---|
Alt + Space / Option + Space |
呼出 ZTools 主搜索框，输入 文件解锁 直达本插件 |
↑ / ↓ |
在列表项、分类树或操作结果之间平滑移动键盘焦点 |
Enter |
对当前选中项执行默认主动作（打开、复制、执行或查看详情） |
Ctrl + Enter / ⌘ + Enter |
执行次要高频动作（如在资源管理器/Finder 中定位、复制次要字段） |
Ctrl + K / ⌘ + K |
展开当前选中项的完整动作面板（Action Panel），支持模糊筛选全部操作 |
Ctrl + F / ⌘ + F |
快速将光标聚焦至顶部搜索/过滤输入框 |
Esc |
关闭当前弹窗/动作面板，或从二级子视图安全返回上一级 |
---
架构性能与安全隐私保障
- 声明式 UI 零闪烁渲染：界面严格采用
@ztools/declarative-ui的List/Detail/Form/ActionPanel语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。 - 最小权限与沙箱隔离：本插件在清单（
plugin.json）中显式声明最小化权限集["fs", "system", "clipboard", "shell"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。 - Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。
---
延伸阅读与技术内链
关联技术与效率专栏文章
- C盘又红了别乱删！用这个清爽无捆绑的空间分析器，10秒揪出偷吃硬盘的元凶
- 电脑文件太多找半天？这款免费开源神器，100万个文件也能0.03秒瞬间搜出！
- 100 万文件检索仅需 0.035ms！基于 Rust 的 NTFS MFT 裸盘索引与 USN 增量追踪实战
- 卸载电脑里臃肿的广告软件吧！这一个不到100M的开源工具箱，顶替38款日常软件
同分类热门效率插件推荐（系统工具）
常见问题解答 (FAQ)
Q1: 如何最快唤醒并使用「文件解锁」插件？
安装并启动 ZTools 客户端后，在任意界面按下 Alt + Space（macOS 为 Option + Space），在搜索框中输入 文件解锁 或 file-unlock，按 Enter 即可在 0.1 秒内直达工作台。您也可以在 ZTools 设置中心为「文件解锁」绑定独立的全局一键呼出快捷键。
Q2: 「文件解锁」插件会将我的数据上传到云端服务器吗？
不会。ZTools 严格遵循 Local-First（本地优先）与隐私设计（Privacy by Design） 准则，「文件解锁」的核心处理流程完全在您的本机离线执行，零广告干扰、零用户行为监控。
Q3: 在「文件解锁」中如何不使用鼠标完成全部操作？
本插件针对全键盘流进行了深度优化：进入插件后可直接打字检索过滤，使用 ↑ / ↓ 键切换目标行，按 Enter 执行主操作，或按 Ctrl + K（macOS 为 ⌘ + K）呼出动作面板选择更多高级操作，按 Esc 即可逐级返回。
Q4: 插件支持哪些操作系统版本？是否开源免费？
完整支持 Windows 10 / Windows 11 (x64) 与 macOS 12+ 双平台（部分涉及 Windows 底层注册表或专属硬件驱动的特性在 macOS 下会自动适配原生等价实现）。本插件对个人用户 100% 永久免费开放，源码托管于 GitHub 官方仓库接受社区透明审计。 ---