青龙 v2.22.0

✨ 新增功能：

1. 新增独立远程 CLI，支持命令行管理任务、订阅、环境变量、脚本等，支持 JSON 输出和中英文帮助
2. 仪表盘支持点击「今日成功 / 今日失败」查看任务明细
3. 新增客户端 IP 与代理链诊断、可信代理配置和登录 IP 黑名单
4. 新增历史运行记录清理预览、手动清理、依赖缓存清理和数据库压缩
5. 新增 WPUSH 通知，支持面板、JavaScript、Python 和 gRPC
6. 新增 ql log 命令，方便查看服务日志

🔧 修复与优化：

1. 优化任务调度、排队、停止与恢复，完善停止失败提示
2. 优化大日志分块读取，修复任务结束后日志显示不完整、中文日志名等问题
3. 加固密码存储、登录认证、两步验证和文件访问
4. 修复登录过期后页面反复刷新，完善任务参数校验提示
5. 优化大目录读取、缓存和依赖管理，减少常驻资源开销
6. 启动时保留 .env 配置，完善启动和数据库迁移错误诊断
7. 改进多架构镜像构建，增加构建来源证明和软件物料清单
8. 其他问题修复

🤖 CLI 安装与 Agent 使用：

在运行终端或 AI Agent 的机器上安装，需要 Node.js ≥ 22.12，推荐 Node.js 24：

npm install -g @whyour/qinglong-cli
ql login --url https://你的青龙面板地址


先在面板「系统设置 → 应用设置」创建应用并授予所需权限，再按登录提示输入 Client ID 和 Client Secret。

登录后即可使用：

ql auth status --json
ql task list --json
ql subscription list --json
ql --help


npm 包内附带 qinglong-cli Skill。将以下目录完整复制到所用 Agent 的 skills 目录，保留其中的 SKILL.md 和 references：

$(npm root -g)/@whyour/qinglong-cli/skills/qinglong-cli


让 Agent 加载该 Skill，并确保它能访问 ql 命令及登录配置，即可用自然语言管理面板，例如：

「查看青龙任务列表，找出最近失败的任务并分析日志。」

「创建一个每天早上 8 点执行的任务，执行命令为 task demo.js。」

CLI 支持 JSON 输出，方便 Agent 查询状态、执行操作和核对结果。已有面板的机器请使用独立安装目录，避免覆盖面板内置的 ql 命令。

CLI 使用说明 | Agent Skill

⚠️ 升级提醒：

升级前请停止面板和任务，备份完整持久化数据目录。新版首次成功登录或修改密码后会迁移密码存储格式，回退旧版时不能仅回退镜像，应恢复升级前的完整备份。

自定义 API 客户端请留意旧文件读取接口和日志分页方式的变化。独立远程 CLI 要求 Node.js ≥ 22.12，安装时避免覆盖面板内置的 ql 命令。

更新方法：

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像：

正式版：whyour/qinglong:2.22.0
Python3.10 正式版：whyour/qinglong:2.22.0-python3.10
debian 版：whyour/qinglong:2.22.0-debian
Python3.10 debian 版：whyour/qinglong:2.22.0-debian-python3.10
npm 版本：npm i -g @whyour/qinglong@2.22.0

完整更新说明

删繁就简三秋树，领异标新二月花。

机场推荐(已稳定使用一年+，支持IPV6/GPT)：
虎云 去注册
熊云 去注册

青龙官网