# FileProcessingTtools

**Repository Path**: liaoqiang3232/file-processing-ttools

## Basic Information

- **Project Name**: FileProcessingTtools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件处理工具（File Processing Tools）

Windows 资源管理器**右键增强工具集**：把「高级更名器」「解除文件占用」以及**用户自定义的任意工具**
统一收纳进一个右键级联子菜单，并提供可编辑的工具配置表来管理它。

> ⚠️ 本仓库中的「高级更名器」基于 **Microsoft PowerToys / PowerRename** 二次开发（MIT 许可证）。
> 衍生关系、上游许可与已履行的合规义务见 [NOTICE.md](NOTICE.md)；
> 上游许可证全文见 [AdvancedRenamer/LICENSE](AdvancedRenamer/LICENSE)。
> 本项目与 Microsoft Corporation 无隶属、无赞助、无背书关系。

---

## 一句话定位

| 你可能想做的事 | 本工具提供 |
|---|---|
| 批量改名（搜索替换 / 正则 / 加前后缀 / 序号 / EXIF 元数据 / 随机串 / 时间戳） | **高级更名器**（WinUI3，成品免安装自包含） |
| 文件被占用删不掉 / 改不了名 | **解除文件占用**（默认静默，仅提示成功与否） |
| `.html` 想用 EmEditor 改源码、又保留浏览器默认打开 | **自定义工具表**：一个类型挂多个软件，各占一条菜单项 |
| 想把常用软件都塞进右键菜单 | 配置表增删改 + 上移/下移 + 导入导出，**免编译生效** |

---

## 目录结构

```
文件处理菜单/                        ← 仓库根
├── AdvancedRenamer/                 ★ 主力资产：高级更名器（WinUI3 / C++）
│   ├── PowerRename.sln              ← 解决方案（内部保留上游命名，见 NOTICE.md）
│   ├── build_powerrename.bat        ← 构建入口（%OUTROOT% 相对定位，随目录移动无需改）
│   ├── LICENSE                      ← 上游 MIT 许可证全文（Microsoft Corporation）
│   ├── NOTICE.md                    ← 本组件的衍生声明
│   ├── src/modules/powerrename/     ← PowerRenameUILib / lib / dll / unittests / testapp
│   └── x64/Release/WinUI3Apps/      ← 成品（自包含，约 68 MB；不入库，见 Releases）
│
├── FileMenuSuite/                   ☆ 零件库：解除文件占用 + 承载层雏形
│   ├── src/UnlockTool/              ← 解除文件占用（静默模式改造对象）
│   ├── src/FileMenuHandler/         ← 右键菜单承载层（含 Win11 稀疏包雏形）
│   ├── scripts/                     ← 安装/卸载/诊断脚本（思路可复用，键名待按新方案重写）
│   └── docs/                        ← 架构设计与合规风险分析
│
├── FileMenuApp/                     ☆ 仅保留 context_menu.py（注册表级联物化参考实现）
│
├── docs/screenshots/                ← UI 调试截图存档
├── _archive/                        ← 阶段0 归档区（不入库，可随时回退或删除）
│
├── 文件处理菜单_统一架构设计与升级方案.md   ★ 架构与升级路线（含分阶段方案）
├── 高级更名器_高级替换功能使用手册.md       ★ 高级更名器的占位符与功能基线
├── 文件处理菜单_开发问题总结与避坑报告.md   ★ 历史 63 项坑位总汇
├── UnlockTool静默模式改造方案.md
├── 火绒解除文件占用功能实现原理分析.md
└── NanaZip功能集成可行性分析报告.md
```

---

## 构建（高级更名器）

**环境要求**

- Visual Studio 2026（v18）Community，勾选 **C++ 桌面开发** 与 **Spectre 缓解库**
  （本工作流实测：用 `Microsoft Visual Studio\18\Community` 的 **amd64** MSBuild；
  其它工具集缺 Spectre 库会报 `MSB8040`）
- Windows 10 1809+ / Windows 11（WinUI3 自包含部署）

**一键构建**

```bat
:: 方式一：只构建高级更名器
AdvancedRenamer\build_powerrename.bat

:: 方式二：从仓库根一键构建（会自动先清理旧产物再全量编译）
build_and_install.bat
```

或直接用脚本（推荐，自动挑选正确的 MSBuild）：

```bat
python build_pr.py
```

**产物**：`AdvancedRenamer\x64\Release\WinUI3Apps\PowerToys.PowerRename.exe`（自包含，无需安装运行时）。

> 发布前建议跑一次 `python slim_pr.py`：成品目录 253 MB → **67.9 MB**
> （剔除 `*.pdb/lib/exp`、调试版 boost 正则、`onnxruntime.dll`、`DirectML.dll`），并做启动冒烟测试。

---

## 常用维护脚本

| 脚本 | 用途 |
|---|---|
| `build_pr.py` | 自动定位 VS2026 amd64 MSBuild 并编译 Release\|x64 |
| `slim_pr.py` | 成品目录瘦身（253 MB → 67.9 MB）+ 启动存活验证 |
| `clean_pr.py` | 清理 MSBuild 中间目录（`.pch` 单文件可达 1.16 GB）、僵尸副本与 `.vs` 缓存。`--dry-run` / `--all` / `--keep-debug` |
| `md2html.py` | 把本仓库的 `.md` 文档渲染为单文件自包含 HTML：`python md2html.py xxx.md` |

---

## 文档索引

| 文档 | 用途 |
|---|---|
| [文件处理菜单_统一架构设计与升级方案.md](文件处理菜单_统一架构设计与升级方案.md) | **架构总纲**：现状盘点、目标架构、配置模型、注册表物化、5 阶段升级路线 |
| [高级更名器_高级替换功能使用手册.md](高级更名器_高级替换功能使用手册.md) | 面向使用者：占位符语法、6 大功能、10 个配方、15 条排错 |
| [文件处理菜单_开发问题总结与避坑报告.md](文件处理菜单_开发问题总结与避坑报告.md) | 开发过程 63 项坑位与根因（改代码前先查） |
| [UnlockTool静默模式改造方案.md](UnlockTool静默模式改造方案.md) | 解除文件占用：`--silent` 执行逻辑与非阻塞通知设计 |
| [FileMenuSuite/docs/法律与合规风险分析.md](FileMenuSuite/docs/法律与合规风险分析.md) | 发布合规分析 |

---

## 当前进度

- [x] **阶段 0**：目录整理与基线（源码容器目录更名为 `AdvancedRenamer/`、归档退役件、仓库合规文件）
- [ ] **阶段 1**：解除文件占用 —— 默认静默 + 仅提示成败 + 非阻塞自动关闭
- [ ] **阶段 2**：菜单统一 —— 收敛为唯一「文件处理工具」级联 + 首次内置 `tools.json`
- [ ] **阶段 3**：配置表窗体 —— NavigationView 四页（工具列表 / 导入导出 / 帮助 / 常规）
- [ ] **阶段 4**：导入导出与排序
- [ ] **阶段 5**：可选增强（Win11 原生一级菜单、安装器、图标自动提取）

---

## 许可

- 本仓库整体：**MIT License**（见 [LICENSE](LICENSE)）。
- `AdvancedRenamer/`：**MIT License, Copyright (c) Microsoft Corporation**（上游衍生，见其目录内 `LICENSE`）。
- 第三方组件声明：[NOTICE.md](NOTICE.md)。