{"repo":"piratf/windows-folder-remark","free":true,"listed":false,"github":"https://github.com/piratf/windows-folder-remark","clone":"git clone https://github.com/piratf/windows-folder-remark.git","description":"A lightweight CLI tool to add remarks/comments to Windows folders via Desktop.ini. No background processes, privacy-first, ~12MB portable exe.","language":"Python","stars":163,"topics":["automation","cli","command-line","comment","desktop","folder","portable","python","remark","tool"],"license":"MIT","category":"cli-tools","readme_excerpt":"Windows Folder Remark/Comment Tool - Windows 文件夹备注工具 English Documentation 中文文档 A lightweight CLI tool to add remarks/comments to Windows folders via Desktop.ini. No system residency, no data upload, safe and secure, use it when you need it. / 一个轻量级的命令行工具，通过 Desktop.ini 为 Windows 文件夹添加备注/评论。无系统驻留，无数据上传，安全放心，用完即走。 Documentation : Full Documentation 完整文档 ⭐ 支持 如果这个工具对你有帮助，请在 GitHub 上给个 Star！ 工具优势 - 用完即走 ：需要时运行，用完即退出，无系统驻留 - 安全放心 ：完全本地运行，无数据上传，保护隐私 - 轻量便携 ：单文件 exe 打包，无需安装，随处可用 特性 - 支持中文等多语言字符（UTF-16 编码） - 支持中英文界面切换 - 命令行模式和交互模式 - 自动编码检测和修复 - 自动更新检查，保持最新版本 - 右键菜单集成，快速访问 - 单文件 exe 打包，无需 Python 环境 安装 方式一：使用 exe 文件（推荐） 下载 releases 中的 windows-folder-remark.exe ，直接使用。 方式二：从源码安装 使用方法 命令行模式 交互模式 右键菜单（推荐） 安装右键菜单后，可以直接在文件资源管理器中右键文件夹添加备注： - Windows 10 ：右键文件夹可直接看到「添加文件夹备注」 - Windows 11 ：右键文件夹 → 点击「显示更多选项」→ 添加文件夹备注 自动更新 程序会在退出时自动检查更新（每 24 小时一次），如有新版本会提示是否立即更新。 也可以手动检查更新： 编码检测 当使用 --view 查看备注时，如果检测到 desktop.ini 文件不是标准的 UTF-16 编码，工具会提醒你： 选择 Y 可自动修复编码。 开发 原理说明 该工具通过以下步骤实现文件夹备注： 1. 在文件夹中创建/修改 Desktop.ini 文件 2. 写入 [.ShellClassInfo] 段落和 InfoTip 属性 3. 使用 UTF-16 编码保存文件 4. 将 Desktop.ini 设置为隐藏和系统属性 5. 将文件夹设置为只读属性（使 Windows 读取 Desktop.ini ） 参考：Microsoft 官方文档 注意事项 - 修改后可能需要几分钟才能在资源管理器中显示 - 某些文件管理器可能不支持显示文件夹备注 - 工具会修改文件夹的系统属性 许可证 MIT License","default_branch":null,"files":null,"tree":[],"storefront":"/r/piratf","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/piratf/windows-folder-remark/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}