# Windows-folder-remark

**Repository Path**: overrideHub/windows-folder-remark

## Basic Information

- **Project Name**: Windows-folder-remark
- **Description**: winows资源管理器，文件夹添加备注
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-25
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件夹备注

文件夹备注是一个 Windows 资源管理器右键工具。安装后，可以给文件夹添加、修改、删除备注，并在资源管理器的“备注”列中显示。

本项目不提供自编译 EXE 安装器，避免 Windows 11 智能应用控制拦截。安装入口使用 Windows 自带并由 Microsoft 签名的 PowerShell。

## 功能

- 在文件夹右键菜单中添加“添加/修改文件夹备注 (F8)”
- 在文件夹右键菜单中添加“删除文件夹备注 (F9)”
- 备注写入目标文件夹自己的 `desktop.ini`
- 自动为当前用户常见文件夹视图加入“备注”列
- 新增或修改备注后自动刷新桌面环境，并返回到当前文件夹
- 删除备注不二次确认，不重启资源管理器
- 支持选中文件夹后用快捷键添加/修改备注或删除备注
- 当前用户安装，不需要管理员权限
- 一键安装，一键卸载

## 效果图

![资源管理器右键菜单效果](docs/images/explorer-context-menu.png)

## 快速开始

1. 下载或克隆本项目。
2. 双击 `install.cmd`。
3. 安装窗口会提示固定快捷键。
4. 看到“安装完成”后，打开资源管理器。
5. 右键一个文件夹。
6. Windows 11 如果没有直接显示菜单项，先点“显示更多选项”。
7. 点击“添加/修改文件夹备注 (F8)”。
8. 输入备注并保存。

卸载时双击 `uninstall.cmd`。

说明：快捷键固定为 `F8` 和 `F9`，安装时不需要选择。

默认快捷键：

```text
F8  添加/修改选中文件夹备注
F9  删除选中文件夹备注
```

安装脚本会自动启动后台快捷键监听器，不需要用户输入。

## 使用说明

详细图文前的完整文字手册见 [中文用户手册.md](中文用户手册.md)。

### 添加备注

1. 在资源管理器中右键一个文件夹。
2. 点击“添加/修改文件夹备注 (F8)”。
3. 在弹出的窗口中输入备注。
4. 点击“保存”。
5. 程序会显示“正在应用备注”的过渡窗口，完成后重新打开父目录并选中该文件夹。

### 修改备注

修改方式和添加相同。程序会覆盖原备注。

新增和修改备注后，程序会刷新 Windows 资源管理器缓存，确保“备注”列显示最新内容。过渡窗口只提示正在应用备注，不需要用户操作。

### 删除备注

1. 右键有备注的文件夹。
2. 点击“删除文件夹备注 (F9)”。

删除不会二次确认，也不会重启资源管理器。弹出的编辑窗口里也有“删除备注”按钮，点击后会直接删除。

### 使用快捷键

1. 打开资源管理器。
2. 选中一个文件夹。
3. 按安装时设置的添加/修改快捷键，弹出备注编辑窗口。
4. 按安装时设置的删除快捷键，直接删除该文件夹备注。

快捷键由后台监听器处理。安装完成后监听器会立即启动，并会随当前用户登录自动启动。

### 查看备注列

如果资源管理器没有显示“备注”列：

1. 在文件夹空白处右键。
2. 选择“查看更多”或“排序/分组/列相关选项”，不同 Windows 版本入口略有差异。
3. 勾选“备注”列。

安装脚本会尽量自动把“备注”列加入当前用户的常见文件夹视图模板，但 Windows 会缓存每个目录的视图设置，个别目录可能仍需手动勾选一次。

## 安装目录

默认安装到：

```text
%LOCALAPPDATA%\FolderRemark
```

安装内容只有一个脚本：

```text
FolderRemark.ps1
```

右键菜单注册在当前用户注册表：

```text
HKCU\Software\Classes\Directory\shell\FolderRemarkEdit
HKCU\Software\Classes\Directory\shell\FolderRemarkDelete
```

## 卸载说明

双击：

```text
uninstall.cmd
```

卸载会清理：

- 右键菜单注册表项
- 开机启动项
- 后台快捷键监听器
- `%LOCALAPPDATA%\FolderRemark` 中的程序脚本
- 本工具保存的安装状态注册表

卸载不会批量删除已经写入各个文件夹的备注，因为这些备注属于用户对文件夹本身写入的数据。

如果需要删除某个文件夹的备注，请在卸载前右键该文件夹并点击“删除文件夹备注 (F9)”。

## 高级安装

也可以手动执行 PowerShell：

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-FolderRemark.ps1
```

指定安装目录：

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-FolderRemark.ps1 -InstallDirectory "D:\Tools\FolderRemark"
```

跳过自动添加备注列：

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-FolderRemark.ps1 -SkipCommentColumns
```

## 工作原理

Windows 资源管理器原生支持从文件夹的 `desktop.ini` 读取说明信息。本工具把备注写入：

```ini
[.ShellClassInfo]
InfoTip=你的备注
```

同时给文件夹设置必要属性，让资源管理器读取该配置。

由于 Windows 资源管理器会缓存文件夹属性，新增和修改备注后程序会刷新桌面环境并重新打开当前文件夹，确保“备注”列显示最新内容。删除备注时资源管理器通常能即时刷新，因此不会执行重启流程。

## 注意事项

- 只支持文件夹备注，不支持文件备注。
- 不需要管理员权限。
- Windows 11 新右键菜单可能需要点击“显示更多选项”。
- 备注保存在目标文件夹中，移动或复制文件夹时，`desktop.ini` 如果一同保留，备注也会保留。
- 如果安全软件拦截 PowerShell 脚本，请确认脚本来自本项目源码。

## 项目结构

```text
.
├─ install.cmd
├─ uninstall.cmd
├─ README.md
└─ scripts
   ├─ FolderRemark.ps1
   ├─ Install-FolderRemark.ps1
   └─ Uninstall-FolderRemark.ps1
```

## 开源地址

```text
https://gitee.com/overrideHub/windows-folder-remark.git
```

首次推送到 Gitee：

```powershell
git init
git add .
git commit -m "Initial release"
git branch -M main
git remote add origin https://gitee.com/overrideHub/windows-folder-remark.git
git push -u origin main
```