🎉 青龙（QingLong）GitHub Stars 突破 20,000！ 感谢每一位使用、反馈、贡献代码和分享青龙的朋友。每一颗 Star，都让青龙走得更远。🐉 🔗 https://github.com/whyour/qinglong

青龙 v2.24.0 ✨ 新增功能： 1. Node.js 原生部署支持 Python venv 隔离；Python 依赖可使用 Git URL、requirements 文件和 pyproject.toml。订阅拉取不会自动安装仓库声明的依赖。 2. 新增通知审计日志，便于查看系统及 JavaScript/Python 脚本通知的发送结果。 3. 平台升级包支持在线暂存、离线安装、失败回退，并在迁移时保留账号、配置、环境变量、任务和脚本等数据。 🔧 修复与优化： 1. 默认 Alpine 与 Debian 镜像升级至 Node.js 24、Python 3.11，SQLite 依赖升级至 1.1.4。 2. 修复任务调度与排队、额外规则校验、订阅同步、Python 依赖安装和脚本发现等问题。 3. 修复清理系统日志时移除活跃文件、页面加载时序和升级流程中的异常，补齐中英文提示。 4. 独立远程 CLI 更新至 0.1.3，扩展任务、订阅、应用、环境、配置、脚本、依赖与系统管理命令。 🤖 CLI 安装与 Agent 使用： 远程 CLI 需要 Node.js ≥ 22.12，推荐 Node.js 24。在面板「系统设置 → 应用设置」创建应用并授予所需权限，再按登录提示输入 Client ID 和 Client Secret。 npm install -g @whyour/qinglong-cli@0.1.3 ql login --url https://你的青龙面板地址 ql auth status --json ql task list --json ql subscription list --json npm 包附带 Agent Skill。将 $(npm root -g)/@whyour/qinglong-cli/skills/qinglong-cli 整个目录复制到所用 Agent 的 skills 目录，保留 SKILL.md 和 references。已有面板的机器建议使用独立 npm prefix，避免覆盖面板内置 ql。 CLI 使用说明 Agent Skill ⚠️ 升级提醒： 升级前停止任务并备份完整持久化数据目录，记录原镜像摘要和启动配置；升级后检查脚本、依赖、订阅与通知。回退时恢复与旧版本匹配的完整数据备份。 2.23.0 是 Python 3.10 兼容镜像的最后一个版本；2.24.0 不发布该变体。Debian 版暂不提供 arm/v7。面板内升级不会替换容器系统、Node.js 或 Python；迁移运行时请拉取新镜像并按原数据挂载重建容器。 更新方法： → 面板更新：系统设置 → 其他设置 → 检查更新 → 宿主机更新：拉取对应新镜像，按原启动配置重建容器 → npm 原生部署：npm install -g @whyour/qinglong@2.24.0 版本镜像： Alpine：whyour/qinglong:2.24.0（amd64、arm/v6、arm/v7、arm64、ppc64le、s390x、386） Debian：whyour/qinglong:2.24.0-debian（amd64、arm64、ppc64le、s390x） 主 npm 包：@whyour/qinglong@2.24.0 远程 CLI：@whyour/qinglong-cli@0.1.3 完整更新说明 长风破浪会有时，直挂云帆济沧海。 机场推荐（已稳定使用一年+，支持 IPV6/GPT）： 虎云 熊云 青龙官网

青龙 v2.23.0 ✨ 新增功能： 1. 新增脚本历史版本查看、对比与恢复，每个脚本最多保留 20 个版本。恢复前检查内容哈希，避免覆盖同时发生的修改。 2. 远程 CLI 更新至 0.1.2，增加脚本历史命令，完善冲突和认证错误提示。 🔧 修复与优化： 1. 普通任务与订阅调度迁移到 node-cron，保留旧规则兼容，补充宏与夏令时行为说明。 2. 修复禁用、删除或修改后旧排队任务仍执行的问题，完善超时、停止和 Shell before/after 环境传递。 3. 修复长期运行后的系统令牌失效和认证缓存并发更新；Shell API 遇到 401 会刷新令牌并重试一次。 4. 降低任务启动开销，JS/Python 通知依赖改为首次调用时加载。 5. 加固环境变量、订阅参数、路径与 SSH 配置，保留合法中文和分支别名。 6. 修复页面升级、ql update 和静态资源同步，完善升级校验、完整备份与恢复；修复 Debian 依赖、通知和调度问题，补齐中英文翻译。 7. 最小修补 HTTP 压缩、上传、gRPC、代理 IP、WebSocket 与 JSON 查询路径的依赖漏洞。其余依赖治理和运行时迁移后续处理。 🤖 CLI 安装与 Agent 使用： 远程 CLI 要求 Node.js ≥ 22.12： npm install -g @whyour/qinglong-cli@0.1.2 ql login --url https://你的青龙面板地址 ql auth status --json ql task list --json ql subscription list --json 在面板「系统设置 → 应用设置」创建应用、授予所需权限，再按提示输入 Client ID 和 Client Secret。 将 npm 包中的整个 Skill 目录复制到所用 Agent 的 skills 目录，保留 SKILL.md 和 references；加载后确保 Agent 可访问 ql 及登录配置： $(npm root -g)/@whyour/qinglong-cli/skills/qinglong-cli 例如：「查看青龙最近失败的任务，分析日志。」已有面板的机器使用独立安装目录，避免覆盖面板内置 ql。 CLI 使用说明 | Agent Skill ⚠️ 升级提醒： 升级前停止面板和任务，备份完整持久化数据目录，包含数据库、脚本、配置、日志、依赖缓存和 script-history。回退时恢复升级前的完整备份。 默认 Debian 镜像仍为 Debian 12 / Node.js 20，默认 Python 为 3.11。Node.js 20 已结束上游维护，运行时迁移将在后续版本处理；本次仅完成已选定的最小依赖修补。 2.23.0 是两个 Python 3.10 兼容镜像的最后一个版本，发布后停止维护。请验证脚本与依赖后迁移到默认 Python 3.11 镜像。 更新方法： → 面板更新：系统设置 → 其他设置 → 检查更新 → 容器内更新：执行 ql update → 宿主机更新：拉取对应新镜像，按原启动配置重建容器并沿用完整数据挂载 → Debian 版本同步更新 版本镜像： 正式版：whyour/qinglong:2.23.0 Python3.10 正式版：whyour/qinglong:2.23.0-python3.10（最后维护版本） Debian 版：whyour/qinglong:2.23.0-debian Python3.10 Debian 版：whyour/qinglong:2.23.0-debian-python3.10（最后维护版本） npm 版本：npm i -g @whyour/qinglong@2.23.0 完整更新说明 潮平两岸阔，风正一帆悬。 机场推荐（已稳定使用一年+，支持 IPV6/GPT）： 虎云 去注册 熊云 去注册 青龙官网