Hamster Archiver
Windows local-first file organizer and media catalog with MCP tools for AI assistants. Verified batch archiving. 本地文件整理、媒体建库与可校验批量归档,支持 AI 通过 MCP 调用。
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.



