UnlockOccupancyUtools

一个面向 uTools 的小工具插件，用来结束正在占用文件或文件夹的进程/服务，方便继续重命名、移动或删除目标。

GitHub: https://github.com/Alkapuce/unlock-occupancy-utools

这个仓库现在是自洽的：

• 前端源码在 src/
• uTools 插件根目录在 package/
• 核心 PowerShell 解锁脚本直接收在仓库内的 package/scripts/Invoke-Unlock.ps1
• 构建、检查、发布脚本在 scripts/

功能概览

• 支持 uTools 文件/文件夹入口，选中文件后直接触发
• 支持关键词入口，手动粘贴一个或多个路径
• 在插件内展示占用者、处理结果、失败项与跳过项
• Windows 下通过 PowerShell 执行真实解锁逻辑
• 非 Windows 平台保留基础兼容处理，使用 lsof 做占用检测

开发

项目使用 bun + React + esbuild + Vite。

bun install
bun run dev

开发模式下，uTools 应指向：

• package/plugin.json
• development.main = http://127.0.0.1:5173/index.html

构建与发布

bun run build
bun run release

执行后会：

• 校验仓库内插件脚本和静态资源
• 生成 package/index.html
• 生成 package/assets/main.js 与 package/assets/main.css
• 生成 release/unlock-occupancy-utools-v<version>/
• 生成 release/unlock-occupancy-utools-v<version>.zip

测试与校验

bun run test
bun run build
bun run release
bun run check

当前仓库内置的是轻量测试和静态校验，覆盖：

• 路径解析与结果格式化
• 结果状态映射
• 版本一致性
• 构建产物存在性
• 发布产物存在性

说明：

• 本仓库目前没有内置自动化 uTools 容器烟测
• 如果要验证最终插件行为，仍建议在真实 uTools 环境里手动跑一遍文件入口和关键词入口

目录结构

src/                  React 前端源码
package/plugin.json   uTools 插件配置
package/preload.js    Electron / uTools 桥接层
package/scripts/      PowerShell 解锁脚本
scripts/              构建、检查、发布脚本
tests/                轻量 Node 测试

License

MIT