[简体中文] | English
[ 现代化的一个 Windows 文件夹样式编辑器 ]
这是一个可以快速修改 Windows 系统上文件夹别名，以及速将一个应用的文件夹设置成它内部的应用图标的工具。
- 修改别名：修改其显示名称，但是不修改路径名称，基于Windows Desktop.ini配置项实现
- 修改图标：使用相对路径调用文件夹内的文件的图标，如果选择文件夹外的图标或有图标的文件，将会提取图标并放在当前文件夹的.ICON下
FolderStyleEditorForWindows 是一款基于 Avalonia UI 框架和 .NET 9.0 开发的桌面应用程序，旨在为用户提供一个现代化、美观的界面，以便通过对desktop.ini进行可视化编辑，轻松自定义 Windows 文件夹的样式，包括修改文件夹的别名和图标。
- ✅ 管理员权限模式修改: 通过按需提权的 helper 模式处理受保护目录，主界面继续保持普通权限与拖拽能力。
- ✅ 图标路径便携化: 图标采用相对路径存储，确保移动文件夹后样式依然生效。外部图标会自动存入文件夹内的
.ICON隐藏目录，实现一体化管理。 - ✅ 全方位拖拽操作:
- 目标: 拖拽 文件夹 以指定编辑目标。
- 图标: 拖拽
.ico、.exe、.dll文件以提取和设置图标。 - 别名: 拖拽 文本 以快速填充别名。
- ✅ 图标智能识别与自动获取: 自动扫描并展示
.exe或.dll中包含的图标，支持渐进加载、平滑切换与自动获取图标。 - ✅ 别名快速编辑: 直观修改文件夹显示名称，并保留历史名称以便快速回退与复用。
- ✅ 最近编辑与状态提示: 提供最近编辑记录、权限状态提示、Toast 通知与统一弹窗交互。
- 支持多文件夹批量编辑: 提供更完整的多文件夹批量处理与统一编辑能力。
- 更多细化设置: 扩展系统选项、图标工作流和更多可视化细节设置。
- C# / .NET 9.0: 构建高性能 Windows 桌面应用。
- Avalonia UI: 跨平台 UI 框架，提供现代化的用户界面。
- 操作系统: Windows 10/11
我们推荐直接从 GitHub Releases 页面下载最新的预编译版本。这是最简单、最快捷的获取方式。
如果您想体验最新的功能，可以 Fork 本仓库，并利用 GitHub Actions 自行构建：
- Fork 仓库: 点击本页面右上角的 "Fork" 按钮，将此仓库复制到您自己的 GitHub 账户下。
- 启用 Actions: 在您 Fork 的仓库页面，进入 "Settings" > "Actions" > "General"，选择 "Allow all actions and reusable workflows" 并保存。
- 运行工作流:
- 进入 "Actions" 标签页。
- 在左侧找到名为 "Build Application" 的工作流，并点击它。
- 点击 "Run workflow" 下拉框，然后再次点击绿色的 "Run workflow" 按钮。
- 下载产物: 等待工作流运行完毕后，在工作流的 "Summary" 页面找到名为 "FolderStyleEditorForWindows-Executables" 的构建产物 (Artifacts)，点击下载即可。
如果您想自行构建，可以使用项目根目录 build/ 下的 build.ps1 脚本。该脚本会自动处理依赖，并将应用打包为带版本号的单个可执行文件。
-
确保环境:
- 安装 .NET 9 SDK。
- Windows PowerShell 5.1 或 PowerShell 7+。
-
执行脚本: 打开 PowerShell 终端，并运行以下命令：
# 构建所有支持的版本 (x64 和 x86) .\build\build.ps1构建成功后，应用将输出到
publish/目录下，并根据build/version.txt的内容自动命名。
- 克隆仓库:
git clone https://github.com/PingGai/FolderStyleEditorForWindows cd FolderStyleEditorForWindows - 打开解决方案:
使用 Visual Studio 2022 或更高版本打开
FolderStyleEditorForWindows.sln。 - 构建项目:
在 Visual Studio 中，选择
Release配置并点击 "生成解决方案"。这将在FolderStyleEditorForWindows_Avalonia/bin/Release目录下生成零散的程序文件。 - 运行程序:
可以直接在 Visual Studio 中启动
FolderStyleEditorForWindows_Avalonia项目进行调试。
- 拖拽到主界面: 将您想要自定义的文件夹直接拖拽到应用程序的主界面。应用程序将自动识别并进入该文件夹的编辑页面。
- 点击选择文件夹: 您也可以点击主界面的“点击以选择文件夹”区域，通过文件浏览器选择目标文件夹。
- 进入编辑页面后，您会看到一个“文件夹别名”输入框。
- 直接在输入框中输入您想要的文件夹别名。
- 您也可以将包含文本的拖拽到此窗口上以自动填充别名。
- 在编辑页面，找到“文件夹图标”部分。
- 拖拽图标文件: 将
.ico文件、包含图标的.exe或.dll文件直接拖拽到图标输入框区域。- 如果是
.exe或.dll文件，应用程序将自动提取其中的图标。 - 应用默认会使用相对路径，如果图标文件不在当前文件夹内，应用会在本文件夹内创建一个.ICON隐藏文件夹用于存储外部来的图标。
- 如果是
- 点击选择图标: 点击图标输入框右侧的文件夹图标按钮，通过文件浏览器选择图标文件。
- 自动获取图标: 应用程序会自动解析选定的
.exe或.dll文件中的所有图标，并在下方以缩略图形式展示。您可以从中选择一个图标，应用程序会自动将其路径填充到输入框中。 - 重置图标: 如果您想清除当前图标设置，可以使用“重置图标”按钮，这将使文件夹恢复默认图标。
- 当目标文件夹需要更高权限时，应用会弹出统一权限提示弹窗。
- 用户确认后，程序会启动管理员 helper，在当前会话内复用权限完成保存。
- 这样既可以修改受保护目录，又不会让主界面失去拖拽能力。
本项目采用 C# 和 .NET 9.0 开发，界面使用 Avalonia UI 框架构建，并遵循 MVVM 设计模式。通过这种架构，实现了模块化的代码结构高效的数据绑定。
本项目为实验性项目，有两个目标
- 其一：实现基本的软件功能
- 其二：探索从自然语言策划书直接生成桌面小型应用的可行性
当前已经支持对需要管理员权限的目录进行修改，并通过独立 helper 进程避免了“主进程提权后无法接收拖拽”的问题；同时已经支持将图片直接转换为 .ico 并应用到文件夹图标。
后续仍会继续推进以下方向：
- 支持多文件夹批量编辑
- 更多细化设置与可视化选项
如果不反感这个项目的性质，欢迎对项目进行贡献！如果您有任何建议、功能请求或 Bug 报告，请随时提交 Issue 或 Pull Request。
本项目版权归 PING 所有，Copyright 2025-2026 PING。项目自身源码与文档遵循 Apache License 2.0（Apache-2.0）。第三方依赖与资源仍按各自原始许可证分发，详见 THIRD-PARTY-NOTICES.md、LICENSES/ 目录与 NOTICE 文件。需要特别注意的是，当前 SVG 渲染链中包含 Svg.Custom，其许可证为 MS-PL；该组件并不改为 Apache-2.0，而是继续按其原始许可证保留。