koishi-plugin-ll-bangumi

Bangumi（bgm.tv）番剧查询与卡片插件，基于 Koishi v4。无追番 / 无订阅 / 无数据库依赖，只做「查询 + 出卡片」。

功能

| 指令 | 说明 | 数据请求 | |:--|:--|:--| | bgm <关键词\|ID> | 搜索单条目卡。纯数字视为条目 ID 直查 | 1 次（连载中 TV 再 +1 次取放送进度） | | bgm -n N | 一次出多张条目卡 | 1 次 | | bgm.anime <关键词> | 只搜 TV 动画 | 1 次 | | bgm.movie <关键词> | 只搜剧场版 | 1 次 | | bgm.manga <关键词> | 只搜漫画 | 1 次 | | bgm.rank | 近期注目动画 TOP N（当季新番热度榜） | 1 次 | | bgm.calendar [星期] | 每日放送时间线；带星期看那天 | 1 次 | | bgm.today | 今日放送 | 1 次 |

中文快捷触发：番剧、剧场版、漫画、排行榜、近期注目、每日放送、今日番剧。

卡片

• subject.html：单条目卡（封面 / 放送进度格 / 评分分布 / 标签 / 简介 / 曜日徽章）
• trending.html：近期注目榜（NO.1 大卡 + NO.2/3 中卡 + 列表行）
• calendar.html：每日放送时间线（早间/下午/晚间/深夜四段）

出图依赖 koishi-plugin-puppeteer。未安装时自动降级为纯文字，不会报错。

安装

npm i koishi-plugin-ll-bangumi koishi-plugin-puppeteer

在 Koishi 控制台/配置文件的 plugins 中启用这两个插件。

配置

| 参数 | 默认 | 说明 | |:--|:--|:--| | token | 空 | Bangumi Access Token（可选，填了不易被限流） | | userAgent | koishi-plugin-ll-bangumi/0.2.4 (...) | User-Agent，bgm.tv 要求可识别 | | defaultCount | 1 | 搜索默认返回条目数 | | maxCount | 3 | 单次最多返回条目数（防刷屏） | | summaryLength | 180 | 简介最大字数，超出截断 | | fetchAiredEpisodes | true | 为连载中 TV 动画显示放送进度 | | imageMode | auto | auto/image/text | | rankCount | 10 | 榜单条数 | | rankMinDoing | 100 | 榜单过滤门槛（至少多少人在看） | | calendarItemLimit | 12 | 每日放送每天最多几部 | | daySegmentLabels | 早间/下午/晚间/深夜 | 放送时段标签 | | 翻译（可选） | 关 | translateSummary + OpenAI 兼容 endpoint |

说明：bgm.tv 官方接口不提供具体播出时刻（HH:MM），故每日放送采用「早/午/晚/深夜」时段分组。第三方 bgmlist 已失效，不依赖。

许可证

MIT。参考致谢：united-pooh/astrbot_plugin_bangumi（Apache-2.0）。