# ffrm
Windows 工具。查看谁占用了本地文件或文件夹，解除占用，然后删除。
只支持 Windows。不带参数，或直接传入路径时打开桌面窗口。`status`、`unlock`、`delete` 走命令行。桌面版和命令行是同一个程序。
## 下载
安装包发布在 [GitHub Releases](https://github.com/gaoyia/ffrm/releases)。下载页是 [gaoyia.github.io/ffrm](https://gaoyia.github.io/ffrm/)。
已经安装 Rust 时，可以执行：
```text
cargo install ffrm
```
装好后在命令行运行 `ffrm`。
## 构建
需要 Rust 1.79 或更新版本。
```text
cargo build --release
```
可执行文件在 `target\release\ffrm.exe`。构建时会把 MIT 许可复制到 `target\release\LICENSE`。
## 桌面
直接运行 `ffrm.exe`，或在命令行执行 `ffrm`。把文件或文件夹拖进窗口即可加入列表。
窗口是 16:9 横屏，标题栏由程序自己绘制，标题是「文件强制解锁删除工具」。右上角可以在中文和 English 之间切换，打开时默认中文。点「前置」后，窗口会保持在其他窗口前面。最小化、最大化、关闭和前置在悬停、按下时会改变颜色。窗口里可以查看占用、解除占用，或删除。拖入文件夹再删除，会删掉这个文件夹和里面的内容。勾选「解除占用」后，删除时会先请占用程序退出；程序没有退出时会结束该进程。「强制结束」会跳过等待。
标题栏的「设置」里可以看到版本号，打开时会检查 GitHub 上有没有新版本。点「检查新版」可以再查一次。有新版本时，点旁边的提示会下载并替换当前程序，然后重新打开。默认的语言、先解除占用、强制结束和窗口前置会记在程序旁边的 `ffrm.cfg`，第一次运行会写出这份文件。设置里也可以把程序加进文件和文件夹的右键菜单，或从右键菜单移除。右键后打开窗口并把选中的路径放进队列，不会直接删除。菜单图标用的是这个程序自己的图标。这项写在当前用户的注册表里。Windows 11 要在右键菜单中点「显示更多选项」才能看到。
## 命令行
```text
ffrm <路径>...
ffrm status <路径>...
ffrm unlock <路径>... [--force] [--yes]
ffrm delete <路径>... [--unlock] [--force] [--yes] [--recursive]
```
直接传入路径会打开窗口并把路径放进队列，不会删除。
`status` 列出占用该路径的进程。
`unlock` 让这些进程退出并释放文件。进程没有退出时，会结束该进程。`--force` 会在请求退出后直接强制结束。
`delete` 删除文件或目录。路径被占用时，需要加上 `--unlock`，否则只报告占用者并停止。
没有 `--yes` 时，`unlock` 和 `delete` 会先要求输入 `y` 确认。标准输入不是终端时必须加上 `--yes`。
## 删除目录
空目录可以直接删除。目录里还有内容时，加上 `--recursive` 或 `-r`。
```text
ffrm delete D:\temp\empty-dir --yes
ffrm delete D:\temp\project --yes --recursive
```
符号链接和目录联接只删除链接本身，不会跟着删到目标里面。
删除文件时会先去掉只读属性。
## 不会删除的路径
下面这些路径本身会被拒绝。它们里面的单个文件或子目录可以删除。
- 磁盘根目录，例如 `C:\`
- Windows 目录、`System32`、`SysWOW64`
- 用户主目录，以及系统盘下的 `Users`
- `Program Files`、`Program Files (x86)`、`ProgramData`
占用者如果是关键系统进程，解除占用会被拒绝。这些进程包括 System、`smss.exe`、`csrss.exe`、`wininit.exe`、`winlogon.exe`、`services.exe`、`lsass.exe`、`dwm.exe`、`fontdrvhost.exe`。
## 示例
查看是谁占着文件：
```text
ffrm status D:\notes\a.docx
```
关掉占用程序并删除：
```text
ffrm delete D:\notes\a.docx --unlock --yes
```
## 许可
本项目使用 MIT 许可，文本在 `LICENSE`。Release 构建会把同一份文件复制到 `target\release\LICENSE`。