KPanel 1.23.0

KPanel 1.23.0

版本更新内容

v1.23.0 汇总 rc.1 至 rc.8 的预览内容，重新构建正式产物并提升稳定更新通道。

新增

• 备份中心支持 S3 兼容存储、WebDAV、远程上传重试和取回；可设置每日、每周或每月的自动备份及保留份数，继续使用现有加密包和恢复确认。
• 集群支持服务器到期日期、价格、月度流量周期、独立接收/发送提醒阈值和预计剩余价值；公开分享页可展示已填写资料，并支持可下载主题与地球视图滚轮缩放。
• 增加统一的服务器到期提醒、服务检测异常与恢复通知，以及可筛选的本地通知记录。
• 设置页支持修改站点名称、上传 PNG/JPG/WebP 图标和恢复默认，同步到登录页、经典侧栏、桌面任务栏与浏览器标签；登录页展示开源地址。
• 桌面支持 Tab / Shift+Tab 切换窗口和 D 显示桌面，终端右键菜单可复制选区或粘贴内容；kpanel-mcp version 可查询 bridge 和协议版本。

变更

• 登录页、桌面与经典模式从 Panel 读取同一份已保存外观，主题、配色和壁纸可跨已登录设备同步；保存失败保留修改并支持重试，并发冲突以服务端确认状态为准。
• 经典模式“氛围”和“通透”恢复静态背景绘制，并缓存已确认的内置壁纸，改善刷新闪黑和背景挪动；启动缓存不自动回写设置。
• 3D 场景加载保留海报，慢加载反馈与进入、退出、切换过渡更平滑；浅色主题采用蓝色系并改善侧栏透出、窄屏布局及状态配色。
• 镜像内置 kejilion.sh 更新到已发布的 Claude Code / Codex 兼容脚本，应用脚本终端向后台 PTY 同步实际行列数，改善缩放与重连后的绘制。

修复

• 明确选择“氛围”或“通透”时，减少透明度偏好不再直接隐藏壁纸；减少动态效果时 3D 场景仍可显示静态海报，强制高对比度模式继续使用纯色背景。
• 修复外观切换首帧显示默认图、场景元数据刷新重复触发切换、浅色侧栏过度不透明和场景加载占位短暂变亮。
• 修复 AI 对话在无 Clipboard API 时复制失败、流式快照状态丢失和 Responses 工具输出关联缺失。
• 生命周期锁兼容只有 flock -n 的 BusyBox，并保持有界等待与互斥保护；初始化 Token 文案更便于复制。
• 更新前端依赖安全补丁，并保留旧客户端主题保存时省略的站点信息。

升级注意事项

• GitHub Latest 与 Docker latest 提升至 1.23.0；Docker preview 保留 rc.8。安装和更新固定到正式镜像 digest，退出预览不会自动降级。
• 升级前备份 KPanel 数据目录和宿主脚本。内置脚本固定为 779192048077c130442a64a126d7c0050776d868；升级后结束旧的应用脚本任务并新建任务，才能使用终端尺寸同步。scriptLinkageState=coupled，兼容脚本已先发布。
• 无新增数据库迁移；主机资料、通知、远程备份配置和外观使用既有面板数据目录。启动位图缓存仅覆盖公开的内置静态壁纸，自定义图及 3D 场景通过服务端状态加载。
• 面板本体使用 Docker 部署；kejilion-panel-meta-1.23.0.tar.gz 仅包含部署、文档及许可元数据。

升级说明

• 已安装用户可继续通过 kejilion.sh 应用市场或 KPanel 稳定版通道原位升级。
• 默认兼容升级并保留现有数据目录、端口与反向代理配置；如上方列有升级注意事项，以该版本的明确说明为准。
• 更新前建议记录当前版本与镜像摘要；失败时按原应用市场回滚流程恢复上一镜像。

发布产物与完整性

• 生产镜像：docker.io/kjlion/kejilion-panel@sha256:236759215c0f527ac8e35bb66d3bd7a3f9f3d3c7a9110df3110b3048d11f46e5
• 面板本体仅支持 Docker 部署；Release 不提供 paneld 原生二进制或 web dist。
• kejilion-panel-meta-1.23.0.tar.gz 仅含部署脚本、文档和许可等元数据，不是可构建源码包。
• Agent、轻量节点和元数据归档须使用附件 SHA256SUMS 校验后再使用。
• Release 流水线已经执行测试、漏洞扫描、双架构构建、镜像运行契约及摘要一致性检查。

完整版本记录：CHANGELOG.md