qinglong/docs/releases/2.24.0.md

青龙 2.24.0

新增功能

• Node.js 原生部署支持 Python venv 隔离环境。Python 依赖可使用包名、Git URL，以及位于脚本或订阅仓库中的 requirements 文件和 pyproject.toml；拉取订阅不会自动安装仓库声明的依赖。
• 新增通知审计日志，便于查看通知发送结果和失败原因。
• 提供经过平台校验的升级包，支持在线暂存、离线安装及失败回退。升级过程保留账号、配置、环境变量、任务和脚本等数据。

修复与优化

• 默认 Alpine 与 Debian 镜像统一使用 Node.js 24；SQLite 依赖升级至 1.1.4。ARM64 升级包使用原生构建环境。
• 修复额外调度规则校验、单实例任务运行期间的新触发排队、订阅同步、Python 依赖安装与脚本发现等问题。
• 修复系统日志清理时活跃日志文件被移除、页面加载时序和升级流程中的异常情况，并补齐相关中英文提示。
• 独立远程 CLI 更新至 0.1.3，最低 Node.js 版本为 22.12.0。

镜像与升级提醒

• 2.24.0 的 Alpine 镜像支持 amd64、arm/v6、arm/v7、arm64、ppc64le、s390x 和 386；2.24.0-debian 支持 amd64、arm64、ppc64le 和 s390x。Debian 暂不提供 arm/v7。
• 2.23.0 是 Python 3.10 兼容镜像的最后一个版本；2.24.0 不再更新该变体。需要 Python 3.10 的用户请先评估迁移方案。
• 升级前停止任务并备份完整持久化数据目录，记录原镜像摘要和启动配置。升级后检查脚本、依赖、订阅与通知；如需回退，请同时恢复与旧版本匹配的数据备份。
• 主 npm 包 @whyour/qinglong 与独立远程 CLI 包 @whyour/qinglong-cli 均提供 ql 命令。在已有面板的主机上安装远程 CLI 时，使用独立 npm prefix 或 npm exec --package=@whyour/qinglong-cli -- ql ...，避免覆盖面板内置入口。

本版本以 2.23.0 为上一正式版本。开发候选的源码、npm 包与 11 个发布镜像架构已完成隔离验收；正式产物发布后仍以各目标渠道的实际构建结果为准。