手搓了一个追番兼媒体库管理的小工具（追加了海报和logo）
本帖最后由 panyijunpyy 于 2026-9-3 08:36 编辑试用了网上各种大佬制作的版本，
总感觉不符合自己的需求。
于是就手搓了一个软件，顺便分享给S1er。
推荐使用的用户画像：
喜欢下载到本地，不想在线观看低画质或者卡顿的版本。能翻墙。有媒体库管理需求，需要每周自动追番的人。
特点：
1.拥有高性能播放：完全基于windows环境，不需要通过浏览器打开界面，直接调用本地的mpv播放器或者potplayer，不论是4k还是蓝光因为都是本地播放，流畅度和字幕支持能力拉满。
2.基于本地的媒体库管理：所有下载的动漫文件能自动移动文件夹，自动改名，记录播放进度。进度文件不用上传他人服务器，全数据本地明文记录。
3.方便的下载管理：内置动漫花园，animegarden，nyaa三个不同数据源进行下载，创建rss订阅的时候能筛选字幕组，语种，清晰度等内容。做到自动添加记录。
4.一键补番功能：从媒体库可以一键搜索相关所有动画，就算平时不关注，偶尔查一下就能知道有没有出新的剧场版或者新的季度，甚至可以查询什么时候出新。
使用方法：
下载安装后
第一步配置qbittorrot，主要打开webUI，后续所有下载都会走qbittorrent。
如果本地已经有了则可以不安装，安装后打开qbittorrent的设置界面，把webui打开，设置下管理员密码和端口。
第二步设置下设置页面的媒体库与下载临时文件夹，最后配置下代理路径，我这边就测试了clash。只要能联通，软件全部功能就能正常使用了。
补充说明：
媒体库是以文件夹为单位的，一个文件夹是一部动漫。
多季和剧场版会统一归档到一个文件夹内。
之前下载的历史数据，也能手动移动到媒体库文件夹。然后手动匹配刮削海报和说明。
界面一览：
下载地址：
https://github.com/Hamster-P/hamstash/releases
有bug或者想追加的功能可以留言
可以摸鱼帮大家开发一点。
目前在北美所以会有时差，国内时间下午到凌晨我在睡觉，其他时候应该找得到我。
刮削全部需要自己手动刮削是吗 rayaxu 发表于 2026-8-5 13:26
刮削全部需要自己手动刮削是吗
历史的之前下载好的，需要手动选择，通过我软件新下载的就不需要刮削了。已经逻辑自动匹配上去了。 代码生产过剩
我就等具身机器人出现后，实体商品生产过剩 虽然现在很多东西已经过剩了
到时候真可以退休了 本帖最后由 [皆神孝介] 于 2026-8-5 15:09 编辑
如果文件夹移动了，文件名修改了，需要洗版的时候要怎么确定自己当初下载的是什么资源？
比如：
2022/09/01 10:01 南家三姐妹 / Minami-ke / みなみけ 10-bit 1080p/720p HEVC BDRip/DVDRip
2026/07/04 14:07 南家三姐妹 / Minami-ke / みなみけ 10-bit 1080p HEVC BDRip
还有些作品收过不止一份不同压制组/字幕组的资源，这些是怎么处理的？ [皆神孝介] 发表于 2026-8-5 14:25
如果文件夹移动了，文件名修改了，需要洗版的时候要怎么确定自己当初下载的是什么资源？
比如：
2022/09/01 ...
移动改名是最麻烦的，尤其是合集种子包，BD原盘。所以我软件里面留了个口子，可以选择不自动改名。
如果不出bug的话，2026/07/04 14:07 南家三姐妹 / Minami-ke / みなみけ 10-bit 1080p HEVC BDRip
理论上会被归档成这样的格式
南家三姐妹
L Season01
L南家三姐妹 S01E01 .mp4
L南家三姐妹 S01E02 .mp4
L Season02
L南家三姐妹 S02E01 .mp4
L Season03
L Season04
L OAD
L我记得会保留下载文件的原名
L Other
L会存放PV ED 等其他内容
不同字幕组的，会同样放入对应文件夹，后续靠用户自己决定保留哪一个，
同一字幕组的，比如V2版本的字幕，会自动改名覆盖原始文档。
目前本质是每个字幕组，每种清晰度，各保留一份。
希望有逻辑能及时发现字幕组已坑，自动选择别的字幕组，字幕组不是唯一选择，而是有个优先顺序，坑了自动下排第二的
—— 来自 HUAWEI ALT-AL10, Android 12, 鹅球 v3.5.99 魔法师lain 发表于 2026-8-5 14:44
希望有逻辑能及时发现字幕组已坑，自动选择别的字幕组，字幕组不是唯一选择，而是有个优先顺序，坑了自动下 ...
这逻辑其实能做，我想过超级追番功能，就是不限定字幕组，哪个字幕组最快就自动下载哪个字幕组。但是实际开发的时候我嫌麻烦，就没弄，主要每个字幕组命名规则不一样，有的第三季叫S3有的是第三季汉字，有的不写季，直接写副标题。测试不过来。。。而且不同字幕组质量差别有点大，我想了下还是牺牲速度，媒体库弄高质量归档算了。 panyijunpyy 发表于 2026-8-5 14:42
移动改名是最麻烦的，尤其是合集种子包，BD原盘。所以我软件里面留了个口子，可以选择不自动改名。
如果 ...
最好可在每个剧集文件夹中留个.json放改名记录
—— 来自 HUAWEI ALT-AL10, Android 12, 鹅球 v3.5.99 不知道可否联动115，比如自动存115里这种 panyijunpyy 发表于 2026-8-5 14:55
这逻辑其实能做，我想过超级追番功能，就是不限定字幕组，哪个字幕组最快就自动下载哪个字幕组。但是实际 ...
如果单独关注一个字幕组的话，使用体验跟我现在用ddp发qb下载不会太大。现在用ddp有两个难点一直想找方法去优化。一是一开始添加新番订阅的时候不能做到一键，虽然给了几个可能的名字，还是要逐个去搜，甚至全找不到可用资源，第二个就是中间坑了的问题。名字规则的确很难一开始全匹配，但最好先做个架构，后面不断完善匹配。
—— 来自 HUAWEI ALT-AL10, Android 12, 鹅球 v3.5.99 魔法师lain 发表于 2026-8-5 16:07
最好可在每个剧集文件夹中留个.json放改名记录
—— 来自 HUAWEI ALT-AL10, Android 12, 鹅球 v3.5.99 ...
改名记录我放数据库内了，因为确实会有改错的，我在开发一键还原功能。每个文件夹下放json，就太杂了。 zhehuobushi 发表于 2026-8-5 16:13
不知道可否联动115，比如自动存115里这种
很可惜，我选的技术路线天生和网盘相克，存网盘，然后用本地播放器播放网盘里的内容，天生就不是很兼容。感觉通过浏览器播放的转码的技术路线会更合适（转码成m3u8之类的流媒体格式）
如果硬要用的话，OpenList + RaiDrive 映射成本地硬盘，然后我的软件虽然能用，但是这样网络开销很大，你想一集1-2个G，本质上你下载完要自动传网盘，播放还要从网盘拉文件。网速慢的话，高清画质就不保了。
那还不如本地一季度全部看完后手动上传归档到115，减少本地硬盘空间
panyijunpyy 发表于 2026-8-5 22:20
很可惜，我选的技术路线天生和网盘相克，存网盘，然后用本地播放器播放网盘里的内容，天生就不是很兼容。 ...
哦哦，感谢大佬解答! zhehuobushi 发表于 2026-8-5 16:13
不知道可否联动115，比如自动存115里这种
自动存115太麻烦了，你可以找油猴脚本一键将磁链添加到115，然后再用播放器从115读数据** 第一个星标！ 把我笑死了，因为要管理jav库，我因为不能忍emby前端功能的缺失，在找是否有更好的，不小心下了你的软件。
没认真看介绍，结果安装完，首页一边推着超市后抽烟的2次元，一边是我的jav坦荡荡的各种老师。……
太尬了。 小修 发表于 2026-8-6 12:15
把我笑死了，因为要管理jav库，我因为不能忍emby前端功能的缺失，在找是否有更好的，不小心下了你的软件。
...
2333，我这是完全为了看动漫开发的，jav完全没打算支持，因为刮削和重命名的逻辑完全不一样，就连参照源也不一样，虽然nyaa和sukebei.nyaa就差个前缀。理论上改改，花点时间，也能兼容。但是这个功能就完全不同了 panyijunpyy 发表于 2026-8-6 12:25
2333，我这是完全为了看动漫开发的，jav完全没打算支持，因为刮削和重命名的逻辑完全不一样，就连参照源 ...
没哈哈。是我找错了软件不是来提需求的。
专注动漫没毛病。jav别碰，为了软件好。 ## - 2026-08-08
- 新增应用内自动更新：设置页可查看当前版本、手动检查更新，有新版时下载并安装（更新包托管在 GitHub Releases，安装需管理员授权，完成后自动重启）
- 修复「修复媒体库」改名后该集观看进度丢失的问题
- 导入插件tauri-plugin-window-state 记住主窗口的大小和位置
## - 2026-08-06
- 新增修复数据库功能，应对自动改名抓取季度错误的情况，提供后续修复渠道
- 自动改名功能加强，增加剧场版判断，抓取到【M28】类似字段，判断为剧场版，进行剧场版处理 好奇媒体库的数据源的选型是怎样的，怎么考量的，我这几天研究了下动画挂削整理，很多软件是和挂削源绑定的，tmdb，tvdb，anidb之类各有各的优势和问题，软件还没实际体验，数据源都选不过来。 indtability 发表于 2026-8-10 11:35
好奇媒体库的数据源的选型是怎样的，怎么考量的，我这几天研究了下动画挂削整理，很多软件是和挂削源绑定的 ...
对的，各个数据源都有优劣，尤其是英文那堆，处理不了各类oad，12.5话，第0集，总集篇，op，ed，pv，menu之类的。
所以我其实不是真正的刮削，是用软件的时候不经意间让用户自己选择好在看的是哪部动画。
否则光靠文件名和文件夹结构判断，我感觉永远判断不准，只有使用者自己才知道自己将要下载的是什么。
所以这时候源只要一个全的，我选了bangumi。
也不能保证我考虑全了所有情况，只能说尽量考虑全一点 panyijunpyy 发表于 2026-8-10 13:59
对的，各个数据源都有优劣，尤其是英文那堆，处理不了各类oad，12.5话，第0集，总集篇，op，ed，pv，menu ...
是这样的，即使不算oped，menu之类的东西，最起码还是想选个能搞清 ova 之类的，顺便对中文或者原文友好的，看下来搞不好 bgm 才是最正确的选择… indtability 发表于 2026-8-10 16:18
是这样的，即使不算oped，menu之类的东西，最起码还是想选个能搞清 ova 之类的，顺便对中文或者原文友好 ...
我感觉刮削是有极限的，因为他底层逻辑就是根据文件名自动判断。
之前我用Jellyfin，把我的乱马1/2识别成了1989年版，而我下的是2025版，我就知道这个再怎么改都没辙了。
需要每一集下载后，手动改名，归档，才能整理成海报墙，我就知道自动刮削不适合我这种懒人了。
其实我的软件对于已经有一个很大的历史动漫库的人不是很适合，毕竟要一部部番点击匹配，还是蛮麻烦的。
只能说对于从零开始用的人比较合适 panyijunpyy 发表于 2026-8-10 22:42
我感觉刮削是有极限的，因为他底层逻辑就是根据文件名自动判断。
之前我用Jellyfin，把我的乱马1/2识别成 ...
我看下来，先选作品再匹配剧集，这其实这也是个挺常见的路径了，jellyfin 这种对文件夹的识别确实是有极限的，所以像 sonarr，mp 都是这个套路，先选好作品，然后它尽可能匹配顺序，最后生成一个标准路径给 jellyfin，甚至直接在文件名中加入id来辅助识别，而且基本都把选择作品这一步塞到订阅里面，流程都大差不差，无非数据源，下载源和中间功能的区别，所以大家都是一样的问题，想完全自动化就得搞 anidb 那种，可惜人家是面向欧美阿宅的… indtability 发表于 2026-8-11 01:10
我看下来，先选作品再匹配剧集，这其实这也是个挺常见的路径了，jellyfin 这种对文件夹的识别确实是有极 ...
没错，是这样的，sonarr，mp 本质是后台整理，而且对动漫支持也不好，普通电视剧和电影倒是问题不大。整理后挂载前台plex或者jellyfin管理，可能还要装各种插件。折腾花的时间比我从头写一个工具都耗时间。
一开始我也是准备弄docker挂我自己nas里的，后面想想反正自己看，没啥投屏到电视和手机上看的需求，就纯windows版了 ## - 2026-08-10
### 下载源
- 下载源（dmhy / AnimeGarden / nyaa）从代码内置改为可在设置页管理：可停用某个源（从下载页下拉隐藏，已有订阅继续轮询），或在站点换域名/换镜像时修改地址
- 后端重构为统一的下载源适配器（SourceAdapter）注册表，新增数据源只需加一个适配器模块
- 搜索与 RSS 订阅统一走同一套过滤判定（后端权威过滤），保证「搜索页看到的」和「订阅实际下载的」一致；AnimeGarden 订阅改为与搜索同源取数
- 修复字幕语言筛选在 RSS 订阅侧对「简体/繁体」等实际不生效的问题（此前订阅与搜索的字幕判定不一致）
- 设置页新增下载源管理，至少需启用一个源；代理测试改为只探测当前启用的源（并使用其配置地址）
### 界面
- 下载详情页新增显示文件级别详情的功能
- 下载详情页新增分页功能，默认显示最新20条记录
- 搜索页和媒体库页面新增滚动条记忆功能
## - 2026-08-09
- 修复搜索页漏掉部分日本剧场版/OVA（如「游戏王剧场版 光之金字塔」）的问题
- 影视库详情页返回时自动补全未加载的封面
## - 2026-08-07
- 优化媒体库加载性能
- 修复国内代理没法更新的问题
新增剧场版功能，可以单独查看剧场版，点击直接播放，也可以手动添加 ## - 2026-08-31
### 软件更新
- 修复跳级升级时（比如落后好几个版本）设置页只显示最新一个版本更新说明的问题：现在会拼接展示当前版本到目标版本之间的全部更新内容
- 更新说明展示区域改为限高可滚动，避免多版本内容拼接后把设置页其他区块顶下去
### 季度编号
- 修复**同一部番的相邻两集分处两个季度目录**的问题：季度编号规则更新后（0.7.3 修好了「不同演绎」误伤），已经下载好的旧文件不会自动重排，于是升级前后下载的集数会落进不同的 Season 目录。「修复媒体库」此前也检测不出来——它只校验「这个季号存不存在」，而不校验「这个文件是不是真属于这一季」
- 「修复媒体库」现在会反查每个文件**当初是按哪个条目下载的**，据此校正季号，并给出改名建议（照旧逐条确认后才动文件）。反查不到来源的文件（手动拖进库的、单次下载的）保持原样，不猜
- 季度编号规则有更新时，设置页的「修复媒体库」会给出一次性提示，扫描过就自动消失
### AnimeGarden 字幕组识别
- 修复 AnimeGarden 搜索结果里**大量资源显示成「未知字幕组」**的问题：上游只对它自己登记过的字幕组填 `fansub` 字段，个人发布或未登记的组（如「晚街与灯」）组名只出现在 `publisher` 里。现在按 `fansub` → `publisher` → 标题解析依次兜底，跟 RSS 那条路径的判定口径拉齐
- 修复**按未登记字幕组搜索/订阅时一条结果都没有**的问题：上游收到不认识的字幕组名会直接返回空，而不是忽略该条件。现在查空会自动退回不带字幕组条件重查一次，交给本地过滤——已登记的字幕组不受影响，不会多发请求
- **升级时会自动把 AnimeGarden 上「未知字幕组」的订阅重置为「不限」**，并在 RSS 订阅页给出一次性提示。这些订阅原本靠「未知字幕组」这个临时标识匹配，标识不再产生后会静默失效、再也抓不到新集数。只影响 AnimeGarden，dmhy 的同名标识语义不同，不受影响
### 其他修复
- 修复**字幕组 v2 修正版先于原始版下载完成时，晚到的 v1 污染媒体库**的问题
- 修复 AnimeGarden 资源**大小虚报 1024 倍**的问题
## - 2026-08-20
### 系列归属可以自己定了
- 下载页在「RSS订阅」和「自动改名」之间新增**「合并到主系列」**开关：关掉之后这一部独立成一部，在媒体库单独一张卡、单独一个文件夹，不并进系列的家族目录
- 媒体库详情页管理模式下，每个分季/剧场版/OVA 分组都新增**「调整归属…」**：可以把误合并的内容**拆成单独一部**，也可以**合并到其他系列**；单集剧场版同样支持
- 判断不出属于哪一部时（比如高达家族的 OVA 桶塞着十几部），弹窗列出整个家族让你自己挑，不再是"系统认不出就没有按钮"
- **调整归属会真的移动文件**，并同步改名记录、观看进度、剧场版列表、媒体库绑定；搬完还会自动按新归属把文件名重排好，**不需要再手动跑一次「修复媒体库」**
- 你的手动决定单独存表，不会被「修复媒体库」的缓存清理抹掉
### 季度编号修正
- 修复**同一季拆成两段播出时，每段各占一个季号**的问题：Re:Zero 第三季（袭击篇/反击篇）、第四季（丧失篇/夺还篇）此前被编成第三～第六季，现在正确合并为第三季、第四季
- 修复**重制版/剪辑版抢占季号**的问题：机动战士Z高达此前拿不到季号（被自己 2005 年的剧场版剪辑版挤掉，掉进 Season 00 被播放器当特典），ZZ 顶替成第二季；现在是 01 初代 / 02 Z高达 / 03 ZZ。高达SEED 的两部 HD重制版也不再占用第三、第四季
- **算不出季号的旁支不再堆进 `Season 00`**，改为按作品名单独建目录（`雷霆宙域`、`独角兽 RE_0096`、`0083 星尘的回忆`…），目录名自动去掉重复的系列前缀。这些目录现在也能在详情页正常显示、被「修复媒体库」正常处理
- **升级后会自动重算家族关系**：季度算法改动过去对已缓存的系列不生效（改好了也看不到变化），现在启动时自动检测并重算，不需要手动清理任何东西
### 改名与修复
- 改名预览此前不换算跨季连续编号，**预览显示的集数和下载后实际落地的不一致**（字幕组发的 `- 78` 预览成 E78，实际是第四季第 12 集），现已一致
- 修复「修复媒体库」把**剧场版正确的文件名改错**的问题（副标题被抹掉，`机动战士高达 闪光的哈萨维` 被改成 `机动战士高达`）
- 修复对**已拆分出来的文件夹**跑「修复媒体库」时，会把整个系列的归属根改成被拆出那一季的问题（会导致此后新下载的剧集全部落进错误的文件夹）
- 跨文件夹移动时观看进度不再丢失
### 下载与整理稳定性
- 大文件移动超时问题改善：qBittorrent 移动文件是异步的，此前等待逻辑在网络共享盘上容易误判失败
- 修复整理流程在任意一步中断后，下一轮轮询无法自动修复、种子永久卡住的多处问题
- 剧场版分类规则优化：同一系列内标题互为前缀的多部剧场版不再被归错
##
### 性能改善与功能增强
- 家族树查询功能新增缓存，全面提升改名时候的查询性能
- 媒体库封面可自选：管理模式下每部番新增“选择图片”，可从该系列家族的全部作品里挑一张作封面
- 设置页新增“媒体库默认封面”策略：最新一季(TV) / 第一季 / 保持匹配条目本身；未手动选图的番按此自动选封面，纯剧场版用匹配条目本身的图（封面数据缓存优先，仅缺失才联网）
### 画面功能新增
- 新增“剧场版”画面，单独展示库内剧场版/OVA，每部一张卡（同一条目的多集归为一张卡），
- 后续下载剧场版/OVA 时自动加入；也可以把任意一集非tv版的内容手动设为独立剧场版/OVA
- 每张卡可“重选条目”换封面、“仅移出列表”（保留文件）或“删除文件”；封面/简介来自所选 Bangumi 条目，缓存优先
- 与原有模式互不影响：被设为独立的文件仍显示在原系列分集里，观看进度两边同步
## - 2026-08-14
- 修复了修复数据库功能的回归 bug
- 修改为冷启动时显示等待提示而非误弹 qb 引导页
- 优化搜索页结果数量
- 当网络不稳定时候，自动改名取得文件夹根目录可能会发生错误。改成从缓存中获取路径，而不是每次都从bangumi获取。
- 暂时无法访问媒体时，不自动切换备用库，新增提示路径出现问题。并新增自动重连功能。
- RSS轮询时，如果无法访问代理，则新增显示提示。同时新增刷新全部RSS功能。 ## - 2026-09-03
### 影视库
- 媒体库详情页和剧场版页面，增加背景图，动漫logo，优化字体颜色和按钮图标
- 新增未看集数角标（可以在设置界面关闭），仅统计tv版和剧场版ova，不统计other分类的集数。
- 详情页新增「Bangumi介绍」按钮
- 「刷新 & 扫盘」按钮改为跟随「管理」模式显示/隐藏（点「管理」才出现在其旁边）
- 详情页和剧场版页的简介改为限高可滚动，低分辨率下不再被截断吞掉内容
- 修复剧场版页窗口较小时滚动卡片会露到顶部介绍区后面的问题
- 详情页/剧场版页头部去掉「播放渠道（电视台）」一行，太占空间
- 「重新匹配」绑定到新条目后，封面/背景图/LOGO 立即按新条目刷新，不用再手动「选择图片 → 恢复默认」
- 管理模式「选择图片」换封面时，简介同步换成所选那一部，封面与简介保持一致
- 搜索页画面微调优化
- 背景图/动漫logo 增加解析逻辑版本化：挑图规则升级后，老条目会在后台按新逻辑重新取图并替换缓存，重取期间先照旧显示上一版的图，不闪空
- 动漫logo 挑选规则调整：横向logo 优先（避免竖排标题挤在头部），同为横向时再按 日文 > 中文 > 英文 选；旧条目会自动按新规则重取
- 详情页/剧场版页头部的动漫logo 加重投影，缓解 logo 颜色与背景剧照相近时看不清的问题
### 补番
- 补番一览增加缓存优化性能
- 修复**从补番一览点进某部番、详情页「返回」却回到媒体库网格**的问题
### 设置画面
- 设置画面排版优化
- 「软件更新」里的「当前版本」改为按钮，点击弹窗展示 CHANGELOG 里全部历史版本的更新说明
- 「默认首页」新增「剧场版页面」选项，软件启动可直接进入剧场版画面
页:
[1]