Repository navigation
Releases
Releases · FFFold/astrbot_plugin_suwayomi_server
v0.8.0
[0.8.0] - 2026-11-15
Changed
- 破坏性:漫画 ID 必须写作
ID:数字— 裸数字改为表示「最近一次搜索的结果编号」,并放宽到/漫画 章节、/漫画 阅读、/漫画 下载(与/漫画 订阅共用,600 秒内有效、仅限展示过的编号)。编号未命中时按「ID 存在 / 超出展示范围 / 无有效搜索」给出可直接复制的下一步;取消订阅同步只认ID:数字与名称,并在取消前校验订阅是否存在
Added
- 搜索结果编号现在可直接用于
章节/阅读/下载,如搜索 安达与岛村后发阅读 1 5 订阅也接受ID:151(按 ID 直接订阅已入库/可拉取的漫画),与搜索结果编号并存- 全插件的 ID 提示统一为可复制形态:多结果引导、
我的订阅、取消订阅回执均输出ID:151
v0.7.3
v0.7.2
[0.7.2] - 2026-11-02
Fixed
- Docker 跨容器文件发送权限 — 配置
temp_dir后,本次新建的各级临时目录及每次下载的子目录由 0700 放开为 0711(可穿越、不可列目录;O_NOFOLLOW打开后fchmod,避免符号链接重定向),打包产物统一补为 0644,修复 SnowLuma 等以非 root uid 运行的 OneBot 端发送 PDF/ZIP/CBZ 时报EACCES: permission denied, realpath(#22);未配置共享目录时仍保持 0700。已存在但不可穿越的temp_dir会输出一次性告警并指出阻塞路径
Dev
- 修复 pytest 9.2 下
test_card_commands对MagicMock子属性打补丁后,teardown 将logger.warning标记为_deleted、导致后续用例连锁失败的问题(改为 patch 模块级logger)
v0.7.1
v0.7.0
Added
- 搜索结果相关度排序 — 跨源结果按标题相关度混排(完全匹配 > 包含 > 简称 > 模糊),同分保持原顺序;
/漫画 搜索、AI 工具与批量订阅共用。新增search_result_ranking(默认开,关闭恢复按源分组旧格式)与search_display_limit(默认 20)配置 - 搜索标题修复与 Bangumi 别名扩展 — 被源站截断的标题自动从详情页补全;无强命中时通过 Bangumi 解析官方译名/别名重搜。新增
search_refresh_truncated_titles、search_alias_expansion配置 - Bangumi 镜像回退 — 网络受限环境可选
bangumi_mirror/bangumi_mirror_url,官方 api.bgm.tv 不可达时改用镜像 - 文件打包页数上限可配置 — 新增
file_delivery_max_pages(默认 300),整卷/合集章节可按需调大
Changed
/漫画 搜索改为并发请求全部漫画源,搜索等待时间明显缩短
Fixed
- 图片下载安全加固:拒绝指向私网/环回地址的封面与重定向目标,跨源重定向不携带认证头,限制单张图片响应大小
- 第三方文本(源站标题/章节名/来源名、Bangumi 别名)进入消息前统一清洗;超长更新通知按 24 条截断
- GraphQL 请求设默认超时;损坏的订阅数据不再导致订阅列表接口报错;
sanitize_filename过滤控制字符并处理 Windows 保留名
Docs
- README、AGENTS、CONTRIBUTING 与开发文档同步架构、配置与测试说明
New Contributors
v0.6.2
Added
- 卡片渲染支持单独配置 T2I 端点 — 新增
t2i_source(system使用 AstrBot 系统 T2I 配置,默认;custom单独配置)与t2i_endpoint(仅custom时生效)两个配置项。选择custom后插件不再依赖 AstrBot 全局 T2I 设置,而是直接调用自建 astrbot-t2i-service 的/text2img/generate(端点末尾无需/text2img,插件自动补全;留空则回退系统配置并打印警告)。适用于 AstrBot 默认官方端点位于国外导致的渲染慢/失败率高、系统 T2I 设为本地渲染、多实例隔离等场景。失败仍按原有语义回退纯文本;WebUI 保存配置后立即生效(清空卡片缓存与失败冷却)。
Docs
docs/setup.md新增「可选:优化 T2I 卡片渲染服务」章节:说明为何建议自建(AstrBot 默认官方端点在国外,慢且失败率高)、改 AstrBot 全局端点与插件单独配置两种方案对比、Docker/源码部署与环境变量README.md配置表补充t2i_source/t2i_endpoint;WebUI 仪表盘设置页同步新增两项AGENTS.md记录 T2I 端点选择的唯一入口(_card_render_fn)与配置变更后的状态重置(_reset_after_config_change)
v0.6.1
v0.6.0
Added
- 指令结果卡片渲染 — 搜索、订阅确认、批量订阅汇总、我的订阅、更新通知、章节列表可通过 AstrBot T2I 服务渲染为带封面的卡片(浅色主题,适配手机阅读);封面本地下载压缩后以 base64 嵌入,失败显示占位块。新增配置
result_cards_enabled(全局开关,默认关闭)与card_render_timeout_sec(渲染超时,默认 30s);关闭或渲染失败/超时自动回退原有纯文本。章节列表按高度分块为多张卡片(每卡三列,最多 4 张,超出回退文本)。 - 「漫画 章节」封面增强 —
/漫画 章节在列表顶部显示漫画封面(默认开启,可通过chapter_list_show_cover关闭);封面从 Suwayomi-Server 的/api/v1/manga/{id}/thumbnail下载到本地后随首条消息发送,长列表仅首条带封面,无章节时也会显示封面。
Changed
- 配置项按功能分组 — 全部配置项改为七组嵌套结构(
server服务器连接 /cards卡片渲染 /reading阅读体验 /pack下载打包 /push自动推送 /aiAI 漫画工具 /advanced高级),与 WebUI 设置页分组一致;旧版平铺配置在升级时自动无损迁移到分组,无需手动重配 - 卡片渲染配置前置并醒目提示 —
result_cards_enabled/card_render_timeout_sec移至独立「卡片渲染」分组(紧跟「服务器连接」之后),WebUI 设置页以警示样式突出显示并附行为说明,引导用户决定是否开启(默认关闭,渲染失败或超时自动回退纯文本) - WebUI 设置页补全缺失配置项 — 新增
result_cards_enabled/card_render_timeout_sec/chapter_list_show_cover表单(此前仅存在于插件配置 schema,WebUI 无法修改)
Dev
- 新增
tests/test_list_chapters.py,并扩展tests/test_downloader.py,覆盖封面下载、配置开关、无章节、封面缺失回退,以及封面下载/章节拉取的错误路径。 - 新增
tests/test_config.py,覆盖分组配置读写、旧版平铺配置迁移与 schema/定义一致性。
v0.5.4
Fixed
- 「漫画 搜索」尾部源名被截断 — AstrBot 按空格拆分参数导致
/漫画 搜索 <关键词> <源名>的源名丢失、静默搜索默认源;改为从event.message_str解析完整关键词与源提示(split_search_query),源名无效时提示可用「漫画 源」查看 - 「漫画 搜索」默认源选择与 AI 工具统一 — 默认搜索不再取原始
sources[:5](本地源 + MangaDex 多语言变体挤占);search_manga与批量订阅的search_best_match改用select_search_sources:排除本地源(ID "0")、优先不同扩展名、语言变体补位,与 AI Agent 路径行为一致 - 「漫画 搜索」源名匹配语义 — 源提示改为前缀/语言代码匹配(
match_source_hint,排除本地源),不再子串匹配(避免"漫画"等常见词误锁单源);末词不是源名时自动拼回关键词并提示;多词标题用+连接(如香格里拉+再),client.search_manga将+转回空格传给源;select_search_sources/_bounded_int从ai_service移至service(消除反向依赖) - live 集成测试自动跳过 —
test_live_api.py/test_live_web_api.py在 Suwayomi-Server 不可达时自动跳过(3s 探活),不再使全量pytest失败;本地调试仍可用SUWAYOMI_URL指向真实服务器 - 订阅数据并发丢失更新 —
SubscriptionManager全部写操作(订阅/取消/推送开关/章节进度/标题同步)加asyncio.Lock串行化读-改-写,避免后台更新循环与用户命令并发时互相覆盖 - 章节时间戳并发覆盖 —
get_chapter_timestamp/set_chapter_timestamp加锁,配合更新检查并行化后不会互相覆盖 - 更新检查并行化 —
check_updates改为按订阅并行检查(并发上限 5,asyncio.Semaphore),订阅多时一轮检查耗时显著下降;单部漫画失败不再拖累全部 last_update_check时间戳失真 — 后台更新循环与「漫画 更新」命令完成后统一写入suwayomi_last_update_check,WebUI 仪表盘时间戳不再只随手动 API 更新;全部订阅检查均出错时返回失败提示且不写入时间戳,避免掩盖服务故障- URL 模式 + 认证告警 — 图片获取方式为 URL 模式且 Suwayomi 开启认证时记录告警日志,提示改用下载模式(URL 模式不兼容带认证的服务器)
- WebUI 配置枚举校验 —
send_mode/image_fetch_mode/auto_push_mode/download_format白名单校验,非法值不再写入配置 - 命令支持「第X话」格式 —
resolve_chapter与 AI 路径共用parse_chapter_number_text,/漫画 阅读/下载 xxx 第5话不再报"章节号无效" - temp_dir 自动创建 — 配置的临时目录不存在时自动
mkdir,不再直接抛异常 - 临时目录泄漏 — 延迟清理任务集中跟踪,插件卸载(
terminate)时取消未执行的清理,避免目录残留 - 投递失败提示区分原因 — 阅读失败时按真实原因提示:无页面 / 认证配置(下载模式)/ URL 模式不兼容认证 / 服务异常,不再一律归因认证
Changed
- 统一图片消息链构建 — 阅读、自动推送、AI 发送共用
build_image_chain()(utils/pusher.py),消除三处重复的 forward/inline 分支 - 统一文件打包助手 — 新增
sanitize_filename/normalize_pack_format/build_chapter_output_path/pack_images(utils/pack.py),下载命令、AI 文件发送、自动推送文件共用 - 源列表 TTL 缓存 —
SuwayomiClient.get_sources()60s 内复用结果,减少命令与更新循环中的重复请求
Performance
- 内存上限 —
AiInteractionState与搜索缓存增加条目上限(512 / 64),淘汰最旧条目,避免长期运行内存缓慢增长
Dev
- 新增
.github/workflows/ci.yml,push/PR 自动运行单元测试(live 测试在 CI 中自动跳过) - 新增
tests/helpers.py(server_reachable探活助手)、tests/test_live_skip.py、tests/test_updater.py、tests/test_downloader.py - live 集成测试增强:新增真实命令主路径覆盖(
test_download_and_pack_chapter下载→打包 zip/pdf/cbz、test_check_updates_detects_new_chapters_live真实更新扫描→推送→水位线→时间戳);漫画源限流(如拷贝漫画 "Request was throttled")时 AI 搜索测试自动重试并跳过(_search_zh_for_agent),多章节列表测试对单章结果/限流容错
v0.5.3
Fixed
- 认证服务器下图片下载 401 — 当 Suwayomi-Server 开启认证(Basic 或 JWT)时,
download_images()创建的裸aiohttp.ClientSession不携带认证头,导致图片下载全部失败并回退到Comp.Image.fromURL()后再次 401。修复方案:SuwayomiClient新增auth_headers属性,暴露 Basic 和 JWT 认证头供图片下载复用download_images()和fetch_pages_local()新增headers参数,注入到下载会话- 所有调用点传入
client.auth_headers,确保图片下载携带正确的认证信息
- 下载失败静默吞错 — 当图片全部下载失败时,不再静默回退到 URL 模式并让 AstrBot Core 报 401。现在会向用户显示含认证排查建议的错误提示。
Changed
image_fetch_mode默认值改为download— 原默认值url在认证服务器下彻底不可用(AstrBot Core 的 HTTP 客户端无法注入认证头),改为先下载到本地再发送。配置 hint 同步更新。
Dev
- 集成测试 fixture 支持通过
SUWAYOMI_AUTH_MODE/SUWAYOMI_USERNAME/SUWAYOMI_PASSWORD环境变量配置认证参数