AstrBot CopyManga 插件
CopyManga 漫画搜索和下载插件,用于 AstrBot 机器人框架。
功能特性
- 🔍 漫画搜索功能,支持关键词搜索
- 📚 漫画章节列表获取
- 📖 章节内容阅读,支持两种阅读模式:
- 单页发送模式:逐页发送章节内容
- 合并转发模式:一次性发送整章内容
- 🔧 章节阅读模式切换
- 👤 用户独立配置,配置存储在本地文件
- 🌐 支持 WebUI 配置
- 📱 支持多种平台
安装方法
- 将插件目录
astrbot-plugin-copymanga放入 AstrBot 机器人的data/plugins目录中 - 安装插件依赖:
pip install -r requirements.txt
使用指南
基本使用流程
- 搜索漫画:
/搜索漫画 <关键词> [页码] - 选择漫画:
/选择漫画 <序号> - 选择章节:
/选择章节 <序号> - 翻页阅读:
/下一页//上一页 - 跳页阅读:
/跳页 <页码> - 切换阅读模式:
/章节模式 <模式>
命令列表
🔍 搜索相关
/搜索漫画 <关键词> [页码]- 搜索漫画/搜索下一页- 搜索结果下一页/搜索上一页- 搜索结果上一页
📖 阅读相关
/选择漫画 <序号>- 选择搜索结果中的漫画/选择章节 <序号>- 选择章节阅读/下一页- 下一页/上一页- 上一页/跳页 <页码>- 跳转到指定页码/章节模式 [模式]- 切换章节阅读模式(single/merge)
🔧 配置相关
/登录 <用户名> <密码>- 登录 CopyManga 账号/用户信息- 查看当前登录用户信息/配置 [配置项] [值]- 查看或修改插件配置/测试API [API域名]- 测试API域名连接
❓ 帮助信息
/帮助- 查看帮助信息
配置说明
配置项说明
| 配置项 | 默认值 | 说明 |
|---|---|---|
| api_domain | api.copymanga.site | API域名 |
| custom_api_domain | 自定义API域名 | |
| api_domain_mode | Default | API域名模式,可选值:Default/Custom |
| download_dir | 插件目录/downloads | 下载目录 |
| search_limit | 20 | 搜索结果最大返回数量 |
| chapter_content_mode | single | 章节内容返回方式,可选值:single/merge |
| search_display_limit | 10 | 一次合并转发消息最多显示的漫画数量 |
用户独立配置
每个用户的配置存储在 user_configs 目录下,每个用户对应一个 JSON 文件(如 user_123456789.json)。
目前支持的用户独立配置项:
chapter_content_mode:章节内容返回方式,可选值:single/merge
WebUI 配置
插件支持通过 WebUI 进行配置,包括:
- 命令名称自定义
- API 域名配置
- 下载目录配置
- 搜索结果显示限制配置
章节阅读模式说明
single 模式(单页发送)
- 逐页发送章节内容
- 适合网络较慢或需要逐页查看的场景
- 支持
/下一页、/上一页、/跳页命令进行翻页
merge 模式(合并转发整章内容)
- 一次性发送整章内容
- 适合网络较好且希望快速浏览整章内容的场景
- 所有页内容会合并为一个消息发送
注意事项
- 请遵守相关法律法规,合理使用本插件
- 插件依赖于 CopyManga 网站的 API,若 API 发生变化可能导致插件无法正常使用
- 首次使用需要登录 CopyManga 账号
- 建议使用合适的 API 域名,若默认域名不可用,可尝试其他域名或自定义域名
- 章节内容下载需要消耗账号的下载次数
许可证
MIT License
更新日志
v1.0.0
- 初始版本
- 实现漫画搜索、选择、阅读功能
- 支持章节阅读模式切换
- 实现用户独立配置
- 支持 WebUI 配置
贡献
欢迎提交 Issue 和 Pull Request!
联系方式
如有问题,请通过以下方式联系: