一个轻量级的、基于 Web 的 Windows 文件夹自定义工具。

English Version | Wiki | 功能特性 • 安装 • 使用 • Docker • 开发

---

Win Folder Manager 允许您通过简洁的 Web 界面轻松自定义 Windows 文件夹。无需手动编辑隐藏的系统文件，即可设置自定义图标、别名（本地化名称）和提示信息。

作者博客：Win Folder Manager：基于 Windows 原生机制的文件夹美化工具

✨ 功能特性

• 🖼️ 自定义图标：轻松设置文件夹图标（支持绝对路径和相对路径）。
• 🏷️ 文件夹别名：在资源管理器中直观地重命名文件夹显示，而不改变实际目录名称。
• ℹ️ 提示信息：为文件夹添加自定义悬停文本描述 (InfoTip)。
• 🤖 AI 自动命名：集成多种 AI 模型（OpenAI, DeepSeek 等），根据文件夹名称自动生成 Emoji 图标和中文别名。
• 🎨 自动图标转换：支持直接上传图片（PNG/JPG 等），自动转换为 .ico 格式并归档管理。
• 🔄 批量操作：批量将绝对图标路径转换为相对路径，便于移动设备使用。
• 📂 快速操作：直接从 UI 在资源管理器或 CMD 中打开文件夹。
• 🚀 Web 界面：基于 Flask 的简单 UI，通过浏览器即可访问。
• 💾 持久化配置：配置文件自动保存到 %APPDATA%，更新不丢失。

📸 界面预览

核心功能展示：物理路径保持不变（英文），但在资源管理器中显示为中文别名。

管理主页	属性编辑
配置页面	资源管理器效果

📦 安装

方式 1: 通过 GitHub Releases 下载 (推荐)

这是最简单的使用方式，无需安装 Python 环境。

1. 访问 Releases 页面。
2. 下载最新的 WinFolderManager.exe 文件。
3. 双击运行即可。

方式 2: 通过 PyPI 安装 (推荐)

pip install win-folder-manager

方式 3: 通过源码安装

git clone https://github.com/LinJHS/win-folder-manager.git
cd win-folder-manager
pip install .

注意：如果您在 Linux 或 Docker 环境下开发，请使用 requirements-docker.txt 安装依赖，以避免 pywin32 安装失败：

pip install -r requirements-docker.txt

🚀 使用

安装完成后，只需运行：

win-folder-manager

或者直接使用 python 模块运行：

python -m manager

程序将启动一个本地 Web 服务器（默认端口：6800）并自动打开您的默认浏览器。

命令行选项

您可以使用以下参数自定义启动行为：

• -p, --port: 指定服务器端口 (默认: 6800)
• --host: 指定监听地址 (默认: 127.0.0.1)
• --no-browser: 启动时不自动打开浏览器
• --debug: 开启 Flask 调试模式

示例：

# 在端口 9000 启动
win-folder-manager -p 9000

# 允许局域网访问
win-folder-manager --host 0.0.0.0

# 仅启动服务器，不打开浏览器
win-folder-manager --no-browser

配置

配置文件存储在： %APPDATA%\win-folder-manager\config.json

您可以在 Web 界面中直接配置需要扫描管理的根目录路径。

🐳 Docker 支持 (不推荐)

⚠️ 警告：本应用的核心功能（修改文件夹图标和属性）严重依赖 Windows 系统 API 和文件系统特性（如 attrib 命令）。在 Docker（Linux 容器）中运行将导致核心功能无法使用，仅能作为文件浏览器使用。除非您非常清楚自己在做什么，否则强烈建议在 Windows 原生环境下运行。

您可以使用 Docker 运行 Win Folder Manager。

docker run -d \
  -p 6800:6800 \
  -v /path/to/your/folders:/data \
  -v win-folder-manager-config:/root/.config/win-folder-manager \
  linjhs/win-folder-manager

🛠️ 开发

1. 克隆仓库

   git clone https://github.com/LinJHS/win-folder-manager.git

2. 安装依赖

   pip install -r requirements.txt

3. 本地运行

   python -m manager

📄 许可证

本项目采用 GNU General Public License v3.0 许可证 - 详情请参阅 LICENSE 文件。