仓鼠症大结局 Hamster Archiver
收藏的时候很快乐，整理的时候也应该是。
把散乱的本地资源，整理成自己的可视化资源仓库。
下载 Windows 版 · 让 AI 帮你使用 · English · 反馈问题
下载/备份的资源越积越多，硬盘快满了，却一直没整理好？
- 文件夹散落各处，不知道怎么分类，也舍不得随便删。
- 想备份到网盘，又不愿让隐私图片、视频被审核和处理。
- 准备先压缩再上传，却又担心以后只剩一堆看不出内容的压缩包。
从添加一个资源文件夹开始。 Hamster Archiver 为文件夹和视频建立带封面、预览与目录清单的本地仓库，让你用标签、星级和备注整理收藏；需要备份时，再批量生成压缩包，按需设置密码和分卷，方便自行上传到网盘或保存到其他硬盘。
资源可以备份到别处，里面有什么、备份放在哪里，仍在本地留下清楚的记录。
一座资源仓库，两种整理方式
| 这次想做什么 | 你会得到什么 |
|---|---|
| 本地整理：先把电脑里的收藏管起来 | 原文件保持原位，为资源生成预览和清单，在仓库里分类、打标签、写备注。以后需要备份，还能把这些项目继续送去压缩。 |
| 打包备份：把资源存储到网盘或其他硬盘 | 批量压缩、完整性验证、登记仓库、记录备份位置；本地仍能看封面、视频抽帧和目录，知道每个压缩包装了什么。 |
打包和仓库登记由应用完成，网盘上传由你或同步工具完成；本地分类通过仓库标签等信息管理，不会自动重排磁盘上的文件夹。
备份到别处，内容仍然看得见
每个项目都保留图片缩略图、视频抽帧和完整目录结构。你可以为它选封面、记下解压密码和备份位置；即使暂时不打开压缩包，也能浏览归档的内容。
把整理做顺手，也把细节做好
文件安全：先核验，再处理原文件
压缩入库按 生成清单 → 压缩 → 完整性验证 → 登记仓库 → 按设置处理原文件 的顺序执行。磁盘不足、异常体积等情况会停止或要求确认，验证与登记成功后才执行原文件后处理。
- 压缩前生成清单并复核源文件；跨盘移动先复制、核验，再处理源位置。
- 归档成品在移动与清理前复核文件身份，避免误处理被同名替换的文件；分卷成品按整组处理。
- 仓库写入失败时保留已生成成品供恢复；缩略图阶段取消任务时保留源文件，并清理未提交生成物。
- 区分“源文件操作失败”和“操作已完成但状态保存失败”，把恢复线索写入诊断信息。
- 追踪原文件位置与处理状态；符合条件时，可将已移动或已回收的原文件复原。
- 数据位置失效时明确提示；安全切换数据位置时保留原目录，避免无声打开空仓库。
便于整理：看预览，分好类，记清楚
用封面浏览收藏，用标签、星级和备注建立自己的分类习惯。标题、标签、备注、路径和文件名都能搜索，备份位置也可以批量记录。
- 大缩略图与文本列表满足不同浏览习惯；支持键盘翻页、批量追加标签、修改备份位置，以及支持操作的撤回。
- 标签自动补全复用已有分类，可用 Tab 接受建议；选中项目时原位更新状态，减少闪烁和页面跳动。
- 同一视频的多帧预览成组展示，竖屏画面完整保留；封面可更换，也可手动添加或粘贴补充图片。
- 大项目详情按需读取，媒体靠近可见区域才加载，同时限制图片读取数量；目录使用虚拟列表，减少无效渲染。
- 仓库保存缩略图而非再复制一整套原始媒体，预览数量可调。
- 提供五套主题与中英文界面，持续完善深色菜单、文字对比度和动态提示。
相似资源：给出依据，让你决定
名称相似、文件内容一致、整个项目重复，分开显示。 符合完整重复规则时可按设置自动跳过；只是相似的资源保留确认机会，避免因为一个公共词就替你作决定。
- 名称相似只标出实际匹配片段；点击红色词语，可确认加入排除词表，减少这类词造成的干扰。内容一致证据用金色区别显示。
- 相似判断降低短标题、数字编号和公共词的干扰；支持调整强度，手动解除的关系在后续重算时仍保持排除。
- 先用索引缩小候选，再按需核验内容；候选排除后停止多余读取，报告复用已有证据，避免逐文件遍历整个仓库。
- 同一原始位置且完整目录、文件路径、数量和大小快照都一致时，可走快捷重复判断；不满足条件时继续内容核验，不能只靠同名或同大小自动跳过。
- 大文件夹“卡顿规避”限制普通相似分析的代表文件数量，并可跳过极小文件的普通 MD5 记录；完整目录清单和归档内容仍覆盖全部文件。
- 调整相似强度不会擅自启动全库重算；单项或全库重算由你选择。
打包方式：按你的备份习惯来
支持 7z/ZIP、密码和自定义分卷；资源多时可以批量排队、暂停或定时运行。压缩、视频抽帧和缩略图数量都可调整。
- 压缩等级 0—9，主动分卷大小可设为 64 MiB—10 GiB；工具随发行包提供。
- 可设置压缩密码，并按项目记录解压密码；记录默认遮盖，主动显示后可查看或复制。密码记录随本地用户数据保存，应一并妥善保管。
- 队列支持暂停、完成当前项后暂停、定时运行和剩余时间估算；桌面运行期间还能继续添加下一轮资源。
- 视频抽帧数与单项目缩略图上限可自定义，设置随任务保存。
- 密码保护不等于网盘保管承诺；软件不保证第三方平台永不审核或删除文件。
快速开始
- 从 下载页 选择 Setup EXE 安装版，或 ZIP 便携版。便携版完整解压后运行
HamsterArchiver.exe。 - 在“归档工作台”扫描目录，或拖入文件夹、视频，查看待处理内容。
- 想先做本地整理，点击“不压缩直接入库”；准备打包备份，在“收纳设置”中填写“压缩包保存在”，点击“开始压缩入库”。完成后到“仓库”浏览和整理。
便携版请保留完整目录，例如 HamsterArchiver-v4.6.9-win-x64/，不要只复制 EXE。压缩和视频预览所需工具已随发行包提供。
让 AI 帮你收纳
适用于能够访问本机并连接 MCP 的 AI 助手。安装、接入、能力检查和任务跟踪均可由 AI 完成，你只需用自然语言说明需求。
下载项目
把这句话发给 AI：
首次收纳
下载完成后，直接告诉 AI：
请帮我收纳 D 盘的 Downloads 目录。
AI 会先读取现有设置，并仅在首次缺少配置时确认：
- 压缩包需要保存的位置；
- 入库方式（压缩入库或不压缩直接入库），以及入库完成后如何处理原文件；
- 是否设置解压密码。
确认后即可等待任务完成。AI 会负责连接应用、执行入库、跟踪进度，并汇总成品位置、仓库记录和处理结果。
以后继续使用
非首次使用时，可以随时说：
请帮我使用仓鼠症大结局，把 E 盘的 Downloads 文件夹整理好。
AI 会复用已经保存的偏好；只有本次需求不同或缺少必要信息时才会再次询问。应用自身不上传媒体；通过 MCP 返回的标题、路径等元数据会进入你连接的 AI 客户端上下文。AI 助手的完整操作规范见 AI 快速上手。
常见问题
打包用于组织和备份资源，不代表视频、图片一定能大幅缩小。生成成品还需要可用磁盘空间，请选择空间充足的其他硬盘作为输出位置。
需要先确认成品已在目标位置妥善保存，再决定如何处理本地文件；仍在本机保留成品或回收站文件会继续占用空间。应用的归档后处理发生在本地核验与登记完成之后，不会等待或核实网盘上传。计划上传后再清理的资源，请先保留原文件，自行确认备份结果。
本地整理时原文件保持原位，仓库保存索引和缩略图；打包备份的成品放在你指定的位置。便携版默认使用程序旁的 userdata，安装版使用 Windows 用户数据目录。“更多设置”提供安全切换入口。
应用自身不上传资源，网盘上传由你或同步工具完成；检查和下载更新会访问 GitHub。接入 AI 时，返回的元数据会进入所选客户端的上下文。
在“检查更新”中查看新版说明并更新。网络不便时，先下载新版发行文件，再选择“手动更新”：便携版选择 ZIP，安装版选择 Setup EXE。
旧版本没有可用更新入口时，可先导出仓库，再在新程序中“并入外部仓库”；核对记录和缩略图后再处理旧目录。仓库导出保存索引和缩略图，不等于备份原文件或归档成品，它们仍需单独保管。
持续的版本更新
Hamster Archiver原本只是我自娱自乐的小工具，很高兴在发出来之后也帮助了许许多多有同样困扰的朋友。这段时间我做了大量的功能打磨，重做了相似判断和重复核验、增加大目录处理优化、失败恢复、标签自动补全等等，还有很多细节体藏在更少的误报和更流畅的ui体验上。如果你遇到了bug或者有功能上的建议，欢迎提issue。
完整更新记录见 更新日志。
开源与贡献
MIT License · 贡献指南 · 安全反馈 · 版本记录
Windows 源码开发使用 Node.js 22.12+（22.x）或 24.x、npm 10.x/11.x。运行 npm ci 安装依赖，按需用 npm run tools:prepare 准备内置工具，再用 npm start 启动。验证与贡献要求见贡献指南。
感谢 7-Zip、FFmpeg 及LinuxDo社区，也感谢每一位试用、反馈问题、帮助打磨细节的用户。
如果它让你的收藏更好整理了，求个 Star！希望Hamster Archiver能给你带来快乐!