DramaMoyu CLI
终端摸鱼看短剧神器
English Version → README_EN.md
简介
dramamoyu是一个运行在命令行终端中的看短剧摸鱼工具, 支持:
- 多搜索引擎 (默认红果)
- 多集短剧 (一部剧 → 多集)
- 播放 / 续播 / 连播
- AI 搜索建议与关键词改写 (FreeGPTHub + MiniMax-M2)
- 使用 pkl 文件保存缓存与观看进度
- 基于 mpv 的稳定播放 (可选终端渲染)
适合科研摸鱼 / 上班摸鱼 / 服务器 SSH 摸鱼。
功能特性
核心功能
- 多搜索引擎
- 围观短剧 (默认)
- 七猫短剧
- 百度短剧
- 红果短剧
- 河马短剧
- 多集短剧支持
- 搜索返回"剧"
- 每部剧包含多集
- 播放控制
- 指定集播放
- 续播 (自动播放下一集)
- 连播 (指定集数区间)
- 本地状态缓存(pkl)
- 最近搜索结果
- 剧集列表缓存
- 每部剧的观看进度
AI功能 (FreeGPTHub + MiniMax-M2)
- 搜索关键词建议 (爽点导向)
- 口语需求改写为可搜索关键词
- 入坑集推荐 (从第几集开始最好看)
安装
python包安装:
pip install freegpthub-dramamoyu
mpv播放器安装参考: https://mpv.io/installation/
快速开始
usage: drama_moyu [-h] [--lang {zh,en,auto}]
[--engine {HeMaProvider,BaiDuProvider,QiMaoProvider,WeiGuanProvider,HongGuoProvider}]
[--state STATE] [--aesgemkey AESGEMKEY]
{search,eps,play,resume,binge,ai} ...
终端摸鱼看短剧: 多集播放 + 可选搜索引擎 + AI 搜索助手
positional arguments:
{search,eps,play,resume,binge,ai}
search 搜索短剧 (剧层级)
eps 获取某部剧的集列表 (基于最近搜索结果 idx)
play 播放某部剧的某一集 (基于最近搜索结果 idx)
resume 续播: 播放上次记录的下一集
binge 连播: 播放一段集数区间
ai AI 功能 (FreeGPTHub + MiniMaxEndpoints)
options:
-h, --help show this help message and exit
--lang {zh,en,auto}
--engine {HeMaProvider,BaiDuProvider,QiMaoProvider,WeiGuanProvider,HongGuoProvider}
搜索引擎 (默认: HongGuoProvider)
--state STATE pkl 状态文件路径 (默认: ~/.drama_moyu_state.pkl)
--aesgemkey AESGEMKEY
AES GEM KEY PATH, 使用AI功能时引入FreeGPTHub需要的密钥路径, 例如: aes_gem_key.txt
默认搜索引擎: 红果短剧 (HongGuoProvider)
-
搜索短剧 (按"剧"):
dramamoyu search "总裁复仇"
-
查看第一个搜索结果的集列表:
dramamoyu eps 1
-
播放第一部剧的第三集:
dramamoyu play 1 --ep 3
-
续播 (自动下一集):
dramamoyu resume 1
-
连播 (播放第一部剧的第一到十集):
dramamoyu binge 1 --from 1 --to 10
-
修改/指定其他搜索引擎:
# 七猫短剧 dramamoyu --engine QiMaoProvider search "霸道总裁" # 百度短剧 dramamoyu --engine BaiDuProvider search "霸道总裁" # 围观短剧 dramamoyu --engine WeiGuanProvider search "霸道总裁" # 河马短剧 dramamoyu --engine HeMaProvider search "霸道总裁"
-
终端渲染播放 (可选, 部分系统支持mpv在终端中渲染视频):
dramamoyu play 1 --ep 1 --vo tct dramamoyu play 1 --ep 1 --vo caca
-
AI功能: 搜索关键词建议 (密钥关注微信公众号"Charles的皮卡丘", 回复"FreeGPTHub"获取)
dramamoyu --aesgemkey "aes_gem_key.txt" ai suggest --mood "爽" --avoid "虐" -n 10
-
AI功能: 口语需求改写 (密钥关注微信公众号"Charles的皮卡丘", 回复"FreeGPTHub"获取)
dramamoyu --aesgemkey "aes_gem_key.txt" ai rewrite "我想看节奏快、反转多、女主很强的短剧"
-
AI功能: 入坑集推荐 (密钥关注微信公众号"Charles的皮卡丘", 回复"FreeGPTHub"获取)
dramamoyu --aesgemkey "aes_gem_key.txt" ai hook 1
-
默认状态文件保存在
~/.drama_moyu_state.pkl, 你可以使用如下方式修改:dramamoyu --state ./my_state.pkl search "霸道总裁"
Metadata
Release files for freegpthub-dramamoyu 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| freegpthub_dramamoyu-0.1.2.tar.gz | 19.2 kB | Without provenance | Details for freegpthub_dramamoyu-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| freegpthub_dramamoyu-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for freegpthub_dramamoyu-0.1.2-py3-none-any.whl |
Total release size: 45.3 kB
Release files / freegpthub_dramamoyu-0.1.2.tar.gz
| Download URL | freegpthub_dramamoyu-0.1.2.tar.gz |
|---|---|
| Size | 19.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e4c428b0cccaf2c70b3f999b5d6072e1ff01ed29738365852398e020dc320727
|
|
BLAKE2b-256 checksum How to use checksums |
9c091418876b5bbf550bf5b942f5e89b7dd0ca91628166493f3611dd2086877c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.14
|
Release files / freegpthub_dramamoyu-0.1.2-py3-none-any.whl
| Download URL | freegpthub_dramamoyu-0.1.2-py3-none-any.whl |
|---|---|
| Size | 26.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7ba7f9c12e1f98089ddca791c9dcb9e323cbb3170cd97df2f98236ae404bc335
|
|
BLAKE2b-256 checksum How to use checksums |
b5995690ab33620f8324bd3f737f35810c35b1a7bf20cf3b06a4574def8c916b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.14
|
Security for freegpthub-dramamoyu 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.