媒体标签管理器

使用说明

1. 点击「选择文件夹」，在系统对话框中选择要浏览的文件夹，并允许读写。
2. 页面会递归列出其中的图片、视频与音频；点击卡片打开全屏深色预览（类似 Twitter 的图片查看器）：关闭按钮在左上角，左右两侧的圆形箭头切换文件，媒体居中显示，右侧是固定的详情与操作栏；点击图片外的黑色区域也可以关闭。
3. 在预览右侧输入标签后按 Enter 添加，点击标签上的 × 移除；也可以直接点击「已有标签」中的标签进行添加或移除。进入预览时焦点在窗口本身而不是输入框，所以可以直接按 ← / → 切换文件；需要输入时按 Enter 或直接点击输入框。
4. 标签保存在文件夹根目录的 media-tags.json 中，刷新页面后可恢复上次打开的文件夹。
5. 工具栏可按标签、文件名筛选；排序支持最近修改、名称、大小、类型、扩展名、路径，并可一键切换升序 / 降序。
6. 「预览尺寸」提供小 / 中 / 大 / 特大四档，卡片网格会随之变化；「完整显示」可让缩略图按原始比例显示而不裁切。
7. 状态栏显示已加载多少个媒体；筛选时显示「显示 M / 共 N 个媒体」。数量超过单次扫描上限（默认 5,000 个媒体 / 2,000 个目录 / 8 层深度）时，状态栏会标出已达上限，并出现提示横幅，可逐步提高到 20,000 或 50,000（8,000 / 20,000 个目录，12 / 16 层深度），也可以改为只选择子文件夹。
8. 网格使用虚拟滚动，只渲染视口附近的卡片，所以几万个媒体也不会产生几万个页面元素；但扫描本身、自动刷新和排序仍会随数量变慢，数量很多时建议按子文件夹整理。
9. 如果所选目录是 mklink 创建的目录联接 / 符号链接，浏览器不会跟随，也拿不到它指向的真实路径；请改为选择真实文件夹（在链接所在目录运行 dir /AL 可看到目标，或使用项目 tools/resolve-link.bat 解析并复制）。
10. 如果浏览器提示「无法打开此文件夹 / 此网站无法打开此文件夹，因为它包含系统文件」，那是 Chrome 的敏感目录限制，不是你的文件夹真的有问题。受限的是：用户主目录、桌面、文档、下载、C:\Windows、Program Files、AppData，以及它们的上级（例如 C:\、C:\Users）。把媒体放进它们内部的任意子文件夹（如 文档\媒体库）再选择该子文件夹即可。

快捷键

• ← → 上一个 / 下一个文件（预览打开且焦点不在输入框时）
• F 收藏 / 取消收藏当前文件（切换标签「收藏」，也会写入 media-tags.json）
• Enter 把焦点移到标签输入框；在输入框内按 Enter 添加标签
• Esc 关闭预览或建议列表
• R 重新扫描（不在输入框内时）

数据格式

{
  "version": 1,
  "updatedAt": "2026-02-05T00:00:00.000Z",
  "files": {
    "photos/001.jpg": ["旅行", "待整理"],
    "clips/a.mp4": ["收藏"]
  }
}

提示：文件夹变化会在约 2.5 秒内自动刷新；文件被原地修改会在约 30 秒内更新缩略图。切换到后台标签页时暂停。