SKILL.md
3.0 KB查看排版效果| 1 | --- |
| 2 | name: mikan-anime-watcher |
| 3 | description: 蜜柑计划(mikanime.tv)番剧更新监测。定时巡检预设番剧,发现带中文字幕的最新一集时给出磁力链接;也可以即时搜索任意番剧的最新带中文字幕资源。 |
| 4 | --- |
| 5 | |
| 6 | # 蜜柑番剧更新监测 |
| 7 | |
| 8 | 能做什么:监测蜜柑计划(mikanime.tv)上预设番剧的最新一集,发现更新就给出带中文字幕的磁力链接;也可以随时搜索任意番剧的最新带字幕资源。 |
| 9 | |
| 10 | - 带脚本:是(纯 Python 标准库,仅额外依赖系统 curl) |
| 11 | - 联不联网:联网(蜜柑官方 RSS + episode 页面) |
| 12 | - 写不写文件:会读写同目录下的 `mikan_watch_config.json`(预设番剧列表)和 `mikan_watch_state.json`(已推送条目去重状态) |
| 13 | |
| 14 | ## 用法 |
| 15 | |
| 16 | ``` |
| 17 | python3 mikan_watcher.py --check # 巡检预设番剧,发现新集输出磁力 |
| 18 | python3 mikan_watcher.py --search "番剧名" # 即时搜索某番剧最新带中文字幕磁力 |
| 19 | python3 mikan_watcher.py --list # 列出预设番剧 |
| 20 | python3 mikan_watcher.py --add "番剧名" # 添加预设番剧 |
| 21 | python3 mikan_watcher.py --remove "番剧名" # 移除预设番剧 |
| 22 | python3 mikan_watcher.py --dry-run # 与 --check/--search 同用:只打印不推送 |
| 23 | ``` |
| 24 | |
| 25 | 预设番剧写在同目录 `mikan_watch_config.json`:`{"shows": ["番剧名1", "番剧名2"]}`,也可以直接用 `--add` / `--remove` 维护。 |
| 26 | |
| 27 | ## 机制说明 |
| 28 | |
| 29 | - 数据源:蜜柑官方 RSS `https://mikanime.tv/RSS/Search?searchstr=<关键词>`,返回最新条目(标题 / guid / episode 链接 / pubDate / torrent)。 |
| 30 | - 中文字幕过滤:标题命中「简体 / 简繁 / 双语 / 中文 / 字幕」等关键词才入选;「生肉 / raw / 无字幕」直接淘汰。 |
| 31 | - 集数识别:自动从标题提取集数(`- 04`、`[04]`、`EP04`、`第4话`、合集 `01-12` 等格式都认),按「最新一集」判断更新,只推最新集里综合质量最高的最多 2 条(简中优先、1080p 优先、内封内嵌加分、招募 / SP / 总集篇降权)。 |
| 32 | - 磁力获取:从 episode 页抓完整 magnet;拿不到时用 episode id(btih)兜底构造。 |
| 33 | - 去重:`mikan_watch_state.json` 记录每个番剧已确认的集数和已推送的 guid,重复运行不会重复推送。 |
| 34 | |
| 35 | ## 通知(可选) |
| 36 | |
| 37 | 默认只输出到终端。设置以下环境变量后,结果会推送到 OneBot 兼容网关(如 NapCat / Lagrange 的 HTTP API): |
| 38 | |
| 39 | ``` |
| 40 | export ONE_BOT_URL="http://127.0.0.1:3000/send_private_msg" |
| 41 | export ONE_BOT_TOKEN="你的网关访问令牌" |
| 42 | export QQ_USER_ID="接收通知的 QQ 号" |
| 43 | ``` |
| 44 | |
| 45 | 不设置也能用,只是不推送。 |
| 46 | |
| 47 | ## 定时巡检 |
| 48 | |
| 49 | 用 cron 即可,例如每天中午 12 点巡检一次: |
| 50 | |
| 51 | ``` |
| 52 | 0 12 * * * cd /path/to/mikan-anime-watcher && python3 mikan_watcher.py --check >> mikan_watcher.log 2>&1 |
| 53 | ``` |
| 54 | |
| 55 | ## 隐私与安全 |
| 56 | |
| 57 | - 本技能不含任何密钥或账号凭据;推送凭据只通过环境变量注入,不会写进任何文件。 |
| 58 | - 联网目标仅为 mikanime.tv(蜜柑计划)官方域名。 |
文件内容是平台检查时读出的文本,只供查看。平台不会运行包里的任何脚本或程序。

