Skip to content

Releases

v0.8.0

Choose a tag to compare

@FFFold FFFold released this 15 Nov 03:31
6c91915

[0.8.0] - 2026-11-15

Changed

  • 破坏性:漫画 ID 必须写作 ID:数字 — 裸数字改为表示「最近一次搜索的结果编号」,并放宽到 /漫画 章节、/漫画 阅读、/漫画 下载(与 /漫画 订阅 共用,600 秒内有效、仅限展示过的编号)。编号未命中时按「ID 存在 / 超出展示范围 / 无有效搜索」给出可直接复制的下一步;取消订阅 同步只认 ID:数字 与名称,并在取消前校验订阅是否存在

Added

  • 搜索结果编号现在可直接用于 章节 / 阅读 / 下载,如 搜索 安达与岛村 后发 阅读 1 5
  • 订阅 也接受 ID:151(按 ID 直接订阅已入库/可拉取的漫画),与搜索结果编号并存
  • 全插件的 ID 提示统一为可复制形态:多结果引导、我的订阅、取消订阅 回执均输出 ID:151

v0.7.3

Choose a tag to compare

@FFFold FFFold released this 13 Nov 06:56

[0.7.3] - 2026-11-13

Added

  • 章节选择支持卷与章节名 — /漫画 阅读、/漫画 下载 除编号(1 / 38.5)与 ID:数字 外,还可输入 第5话、第01卷 或章节名;重号时列出 #编号 章节名 (ID:xxx),并给出可直接复制的章节名或 ID 用法

Fixed

  • 章节选择边界 — 第3卷 只有 第03话、或源站编号与名称不一致时列出候选;小数与番外编号不再误匹配(3.09 vs 3.08、番外1 vs 番外1.5)

v0.7.2

Choose a tag to compare

@FFFold FFFold released this 02 Nov 02:32

[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

Choose a tag to compare

@FFFold FFFold released this 17 Oct 05:47
06dac5e

[0.7.1] - 2026-10-17

Fixed

  • 卡片封面压缩移出事件循环:embed_covers 的 PIL 解码/缩放/编码改在工作线程执行,开启结果卡片后搜索、订阅列表与更新推送不再阻塞机器人消息处理

Dev

  • 新增回归测试,断言封面压缩运行在工作线程而非事件循环线程

v0.7.0

Choose a tag to compare

@FFFold FFFold released this 03 Oct 04:28
963108f

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

Choose a tag to compare

@FFFold FFFold released this 23 Sep 09:07
109112b

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

Choose a tag to compare

@FFFold FFFold released this 19 Aug 00:52
8ec7692

Added

  • T2I 卡片加入漫画简介 — 章节列表、订阅确认、更新通知卡片展示 Suwayomi 漫画简介(description,清洗 HTML 后按行数钳制),并移除卡片上的模板约束提示文字(强制刷新/阅读提示等)。

v0.6.0

Choose a tag to compare

@FFFold FFFold released this 16 Aug 14:11
2e84740

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 自动推送 / ai AI 漫画工具 / 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

Choose a tag to compare

@FFFold FFFold released this 10 Aug 13:31
9387c84

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

Choose a tag to compare

@FFFold FFFold released this 28 Jul 08:41
59c0ca7

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 环境变量配置认证参数