Hamster Archiver
Windows local-first file organizer and media catalog with MCP tools for AI assistants. Verified batch archiving. 本地文件整理、媒体建库与可校验批量归档，支持 AI 通过 MCP 调用。
- Transport
- Not stated
- Package
- —
- Registry id
- —
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
Windows 本地文件整理、媒体建库与可校验批量归档工具，现提供 macOS 公开 Beta。支持可选的本机 CLI / MCP 接入，可由具备本机操作能力的 AI / Agent 调用（实验功能）。
下载 Windows 正式版 · 下载 Mac Beta · English · 反馈问题
快速开始 · 功能介绍 · 实验性 AI 接入 · 常见问题 · 文档与贡献
AI 正在帮你使用这个项目？请直接阅读最短使用入口。Windows 正式发行包含 hamster.cmd 和离线指南，Mac Beta 提供应用内 CLI；普通使用无需克隆源码、安装 Node.js 或先配置 MCP。
下载/备份的资源越积越多，硬盘快满了，却一直没整理好？
- 文件夹散落各处，不知道怎么分类，也舍不得随便删。
- 想备份到网盘，又不愿让隐私图片、视频被审核和处理。
- 准备先压缩再上传，却又担心以后只剩一堆看不出内容的压缩包。
从添加一个资源文件夹开始。 Hamster Archiver 为文件夹和视频建立带封面、预览与目录清单的本地仓库，让你用标签、星级和备注整理收藏；需要备份时，再批量生成压缩包，按需设置密码和分卷，方便自行上传到网盘或保存到其他硬盘。
资源可以备份到别处，里面有什么、备份放在哪里，仍在本地留下清楚的记录。
以下保留现有界面截图，部分文字和布局可能与当前版本略有差异。
一座资源仓库，两种整理方式
| 这次想做什么 | 你会得到什么 |
|---|---|
| 本地整理：先把电脑里的收藏管起来 | 原文件保持原位，为资源生成预览和清单，在仓库里分类、打标签、写备注。以后需要备份，还能把这些项目继续送去压缩。 |
| 打包备份：把资源存储到网盘或其他硬盘 | 批量压缩、完整性验证、登记仓库、记录备份位置；本地仍能看封面、视频抽帧和目录，知道每个压缩包装了什么。 |
打包和仓库登记由应用完成，网盘上传由你或同步工具完成；本地分类通过仓库标签进行管理，不会自动重排磁盘上的文件夹。
已经不压缩入库的目录可以在仓库详情中直接“校对更新”，也可以批量检查。应用在任务真正执行时只扫描一次：仅新增文件会自动合并；修改、删除或旧清单不完整时会先展示逐项变化，让你选择覆盖原项目、新建独立项目或跳过。未变化文件复用已有 MD5 和预览，不重复抽帧；整个过程不会修改、移动或删除原文件。再次拖入同一路径时，也会先引导到校对更新或压缩，而不是静默创建重复项目。
提交校对后，可到归档工作台查看进度和待确认事项。完成时会提示目录未变化或仓库已更新；需要人工处理、失败和取消也会给出对应提示。
归档工作台超过 10 个任务时使用滚动列表；从仓库切回时会重新计算可见高度，已有任务无需添加新项目即可显示。
未压缩项目已有等待或运行中的校对、压缩任务时，先完成或取消任务才能删除仓库记录。若先删除记录，再次添加同一源目录会按新项目处理。
原文件搬到新位置后，可在项目详情重新设置原文件位置；这里只更新关联，下次校对更新或压缩入库时再核对内容。未压缩项目再次压缩时，已有备份位置与本次设置冲突的，可以明确选择保留或更新。
入库自动查重，在提供相似度报告的同时，可以自动跳过已存在内容；大目录也能流畅浏览，并可快速检索整个仓库。
快速开始
Windows 4.8.3 正式版适用于 Windows x64，提供中英文界面。直接使用请选择 Releases 发行包；GitHub 的 Source code 和克隆仓库用于源码开发。
- 下载 Setup EXE 安装版，或完整解压 ZIP 便携版后运行
HamsterArchiver.exe。 - 在“归档工作台”扫描目录，或拖入文件夹、视频，查看待处理内容。默认开启“小项目过滤”，阈值为 100 MB；处理较小项目时，先在“收纳设置”调整阈值或关闭过滤。
- 想先做本地整理，点击“不压缩入库”；准备打包备份，点击“压缩入库”，再按提示选择存储位置，也可以提前填写“压缩包保存在”。完成后到“仓库”浏览和整理。
应用默认打开仓库，空仓库会提供五步首次归档引导，可选择中英文、跳过或永久关闭。扫描主目录时，一级子文件夹和视频按独立项目加入；零散图片和其他文件请先收纳到文件夹中。
启动时会先显示启动窗口，再加载归档运行模块，减少等待期间没有界面反馈的情况。
Windows 压缩和视频预览所需工具已随发行包提供，无需另装 Node.js。下载页同时提供 ZIP、Setup EXE 及各自的 .sha256 校验文件。
Windows 便携版完整目录为 HamsterArchiver-v4.8.3-win-x64/，请保留随附文件。
Mac Beta（Apple Silicon 与 Intel）
从 Mac Beta 预发行页 下载 HamsterArchiver-v4.8.0-beta.mac.2-mac-universal.dmg 和同名 .sha256，核对校验值后打开 DMG，将应用拖入“应用程序”。支持 macOS 12 及以上。本 Beta 未经 Apple 公证，macOS 可能阻止首次打开；确认信任下载来源后，可在“系统设置 → 隐私与安全性”中选择“仍要打开”。Mac 资料默认保存在当前用户的应用支持目录，不随应用替换而删除。Mac 版的功能限制与构建说明见 Mac 版指南。
Mac 目前仍为 Beta，内置 7-Zip，视频抽帧默认关闭，需要自行配置 FFmpeg；归档后支持保留或移动原文件，不提供 Windows 回收站相关删除、复原和文件撤回。更新通过下载新版 DMG 手动替换应用。
面向现代本机工作流
除桌面界面外，Hamster Archiver 还提供可选的 CLI / MCP 自动化入口，便于脚本和具备本机工具能力的 AI / Agent 调用。该能力目前作为实验功能提供，不影响默认的本地桌面使用。
备份到别处，内容仍然看得见
每个项目都保留图片缩略图、视频抽帧和完整目录结构。你可以为它选封面、记下解压密码和备份位置；即使暂时不打开压缩包，也能浏览归档的内容。
把整理做顺手，也把细节做好
From the project's README.