<?php
require_once __DIR__ . '/source_deploy.php';

/**
 * 源码发布：为源码下载中心生成完整源码 ZIP，并为站外站点生成在线升级包。
 */

function source_release_excluded_dirs()
{
    // 插件只进入插件商城与本站 storage/plugins，绝不并入源码下载中心的源码包。
    return ['storage', 'uploads', 'data', 'plugins', '.git', '.idea', 'node_modules', 'system'];
}

function source_release_excluded_files()
{
    // install.php 由完整源码包单独补入安装模板；在线升级包绝不能覆盖目标站安装入口。
    // source_release.php / source_deploy.php 是源码下载中心的核心模块，必须随完整包和升级包一起发布。
    return ['config.php', 'komorebi-upgrade.json', 'komorebi-source.json', 'install.php'];
}

function source_release_path_allowed($rel, $for_upgrade = false)
{
    $rel = str_replace('\\', '/', (string) $rel);
    if ($rel === '' || strpos($rel, '..') !== false) {
        return false;
    }
    $parts = explode('/', $rel);
    foreach ($parts as $part) {
        if (in_array($part, source_release_excluded_dirs(), true)) {
            return false;
        }
    }
    if (in_array(basename($rel), source_release_excluded_files(), true)) {
        return false;
    }
    // 完整源码包同时保留 inc/install_dist.php 作为源码重建模板；直接访问该文件会返回 404。
    // 在线升级包不覆盖站点的 Apache 配置，避免目标站伪静态/安全规则被替换。
    if ($for_upgrade && in_array(basename($rel), ['.htaccess', '.user.ini', 'deploy_origin.php'], true)) {
        return false;
    }
    $full = realpath(APP_ROOT . '/' . $rel);
    if ($full === false || strpos($full, realpath(APP_ROOT)) !== 0) {
        return false;
    }
    return true;
}

function source_release_portable_htaccess()
{
    // 共享主机常限制 AllowOverride；Options / Require / RedirectMatch 写在根 .htaccess
    // 会让整站直接 500。这里只保留最常见的目录首页，其他安全规则放在子目录兼容块中。
    return "# 木漏茶室论坛 · Apache 兼容配置\n"
        . "# 为防止虚拟主机 AllowOverride 限制导致 500，根目录不写 Options / Require / RedirectMatch。\n"
        . "DirectoryIndex index.php\n";
}

function source_release_latest_mtime($for_upgrade = false)
{
    $latest = 0;
    $rii = new RecursiveIteratorIterator(new RecursiveDirectoryIterator(APP_ROOT, FilesystemIterator::SKIP_DOTS));
    foreach ($rii as $f) {
        if (!$f->isFile()) {
            continue;
        }
        $rel = str_replace('\\', '/', substr($f->getPathname(), strlen(APP_ROOT) + 1));
        if (!source_release_path_allowed($rel, $for_upgrade)) {
            continue;
        }
        $mtime = (int) $f->getMTime();
        if ($mtime > $latest) {
            $latest = $mtime;
        }
    }
    return $latest;
}

function source_release_cache_paths($for_upgrade = false)
{
    $dir = APP_ROOT . '/storage/tmp';
    if (!is_dir($dir) && !@mkdir($dir, 0775, true) && !is_dir($dir)) {
        throw new Exception('无法创建源码打包临时目录');
    }
    $version = preg_replace('/[^0-9A-Za-z._-]/', '-', APP_VERSION);
    $originKey = '';
    if (!$for_upgrade) {
        $origin = source_deploy_origin_manifest();
        $originKey = '-o' . substr(hash('sha256', $origin['source'] . '|' . $origin['token']), 0, 8);
    }
    return [
        $dir . '/source-channel-' . $version . $originKey . ($for_upgrade ? '-upgrade' : '') . '.zip',
        $dir . '/source-channel-' . $version . $originKey . ($for_upgrade ? '-upgrade' : '') . '.json',
    ];
}

function source_release_upgrade_changelog()
{
    $builtin = "木漏茶室 v6.25.156 系统升级包（完整更新内容）\n"
        . "一、插件与源码包彻底隔离\n"
        . "1. 上传的插件 ZIP / JSON 只解压安装到本站 storage/plugins 目录，不会写入核心源码目录。\n"
        . "2. 插件上传只在本站生效，不会自动录入插件商城，也不会同步到源码下载中心。\n"
        . "3. 插件商城只展示内置插件和超级管理员明确维护的商城包，普通上传不会出现在商城里。\n"
        . "4. 源码包改为从独立构建目录生成，只收录 admin、assets、inc、pages 等核心源码；storage、uploads、data、plugins、配置文件、商城包和升级残留一律不进入源码包。\n"
        . "5. 完整源码包固定为根目录结构，index.php、install.php 直接位于第一层，不再多套 komorebi-forum/ 文件夹。\n"
        . "6. install.php 始终由受保护的安装模板重建，不会把本站已安装或隔离的旧安装文件带入源码包。\n"
        . "7. 每次生成源码包都会先做 PHP 语法检查、ZIP 内容隔离检查和安装后首页运行检查，任一项失败都不会生成可下载源码包。\n"
        . "8. 源码包缓存只有通过自检后才复用；旧缓存、半成品包和未验证包不会再被下载。\n"
        . "9. 旧 api.php 的 source_zip 打包入口统一到新打包器，旧链接下载到的也是可直接安装的源码包。\n"
        . "10. 安装教程同步改为新版根目录结构，不再要求手动处理多余文件夹。\n"
        . "11. 修复完整源码包漏掉 inc/source_release.php 导致新装站点源码下载中心直接报错的问题；源码包现在强制包含源码中心、部署回传和插件商城模块。\n"
        . "12. 源码包新增源码中心模块加载自检，缺少该模块时不会生成可下载包。\n"
        . "13. 源码下载中心的站外部署卡片新增真实站点 Logo 和实时检测：优先读取站外站点 api.php?action=deploy_public 的名称、版本、Logo，旧站点回退解析首页图标；Logo 缓存到本站，避免 HTTPS 页面加载 HTTP 图片和外站防盗链，并显示在线、证书异常或离线状态，每 60 秒自动刷新。\n"
        . "14. 在线升级包不再携带或覆盖 inc/deploy_origin.php，保留目标站点原有的源码部署回传标识。\n"
        . "15. 升级包补带 sw.js，系统升级后 PWA 静态缓存名称同步更新，浏览器不会继续读取旧样式和旧脚本。\n"
        . "16. 修复虚拟主机把 PHP_BINARY 指向 php-fpm、或 exec 被禁用时源码包自检被误判失败、源码中心显示 ZIP 暂不可用的问题；现在会自动探测真正的 PHP CLI，没有 CLI 时退化为核心文件完整性检查，仍能生成可下载源码包。\n"
        . "17. 源码下载中心页面不再每次打开都自动打包，只在点击“打包下载完整最新源码 ZIP”时生成；未生成时显示“点击打包生成”，避免虚拟主机反复执行重任务导致页面超时或 502。\n"
        . "18. 安装教程与安装协议统一改为 install.php 永久保留，删除旧的“安装后删除 install.php”提示；避免删掉入口后 index.php 在配置缺失时跳转 404。\n"
        . "19. 完整源码包继续强制包含 install.php、index.php 和源码中心模块，虚拟主机 Kangle、云服务器 Nginx/Apache 均可直接打开安装向导。\n"
        . "20. 网盘音乐播放器改为全局音频接管：网盘单曲点击播放后转入悬浮播放器，切换页面、点击其他功能不会中断；跨页保存队列与进度，返回页面自动续播，浏览器拦截自动播放时首次触屏恢复；新增 Media Session 锁屏/通知栏控制与后台播放状态同步。\n"
        . "21. 悬浮播放器播放中新增站内保持播放容器：点击首页、发帖、扩展、我的、后台及页内链接时，目标页面在同一站点的容器中加载，父页面全局 audio 不重建，切换功能时音乐立即继续；容器内页面自己的播放器会隐藏并静音，网盘曲目仍由父页面悬浮播放器接管；顶部新增「返回原页」按钮。\n"
        . "22. 后台上传设置新增四类独立单文件上限：世界圈文件、帖子文件（发帖编辑器插入正文的图片/视频/音频/任意文件）、帖子附件、网盘文件；四个上传接口在服务端再次校验，超过上限直接驳回并提示；发帖编辑器、帖子附件、世界圈、网盘上传都显示上传进度条，提交前也会先做一次大小检查。\n"
        . "23. 修复源码下载中心的完整源码包在虚拟主机上安装失败的问题：新增 mbstring 内置兼容层，主机未启用 mbstring 也能安装和运行；安装向导自动补齐 data、uploads、storage 等运行目录并修正权限；根目录 .htaccess 改为兼容写法，不再因 Options / Require / RedirectMatch 被共享主机拒绝而整站 500；子目录防护同时兼容 Apache 2.4 与 2.2；源码包自检强制包含 inc/compat.php。\n"
        . "24. 广告杀手新增网站网址检测开关和联系方式检测开关：可分别开启/关闭；开启后帖子、评论、回复、世界圈内容出现网址、手机号、座机、邮箱、QQ、微信、WhatsApp、Telegram 等联系方式时自动驳回并发出警告，关闭后对应类型完全不检测；违规记录会标注命中类型并继续累计处罚。\n"
        . "25. 修复电脑端点击登录后直接退回首页、仍显示未登录的问题：会话目录优先落到站点 data/sessions，主机禁止写入时自动回退系统临时目录；登录成功后先落盘再跳转，session_regenerate_id 失败不再打断登录；Cookie 安全属性按 HTTPS/反向代理自动判断，避免电脑浏览器把登录 Cookie 丢掉。\n"
        . "26. 修复源码下载中心的完整源码包上传虚拟主机后无法运行的问题：源码包补齐 mbstring 兼容层、会话目录准备、运行目录自动创建和 Apache 2.2/2.4 双写法上传防护；根 .htaccess 只保留 DirectoryIndex，避免共享主机因 Options/Require 直接 500；install.php 始终保留并位于根目录。\n"
        . "27. 广告杀手卡片界面整改：标题不再被按钮挤成竖排，长说明收进「说明」按钮，网址检测和联系方式检测两个开关统一移入「设置 → 检测开关」，卡片顶部只保留「说明」「设置」两个按钮，底部只保留关键词、累计拦截、记录用户三项统计；手机端和电脑端都不会再出现一条很长的竖排文字。\n"
        . "28. 修复电脑端帖子音乐无法播放：移除 Web Audio createMediaElementSource 对 audio 输出的接管，音频始终走浏览器原生播放通道，频谱律动改用 CSS 动画；电脑、手机、平板三端帖子音频、网盘音频、世界圈音频均已实测可播放，播放失败时自动露出原生 controls 兜底。\n"
        . "29. 重新设计发帖页副标题：去掉原来生硬的“文字、图片、视频、附件，都可以放进这一盏茶里”和绕口的“写你想写的，也放你想放的”，改为“一帖一盏茶，写下想说的，也收好照片、视频和文件。”，保留茶室语气，读起来更顺。\n"
        . "30. 网盘新增文件夹分享：文件夹卡片改为 Finder 风格的三列图标网格，可按文件夹生成独立分享链接并设置访问密码；打开链接只显示该文件夹内容，后续往文件夹里上传文件，链接页每 15 秒自动同步，新文件无需重新生成链接即可出现；文件夹改名后链接仍有效，取消分享后旧链接立即失效。\n"
        . "31. 修复图床上传报错“SQLSTATE[HY000]: General error: 1 no such column: size”：图床数据表新增 size 字段，上传时写入真实文件大小；旧站点升级后自动补列，并按 uploads / storage 中的原图回填已有图床记录的文件大小，配额统计恢复正常。\n"
        . "32. 修复源码下载中心“已经跑起来的木漏茶室”检测不到站点：新增跨下载中心部署记录合并，当前源码中心会读取自身来源下载中心（以及 data/source_centers.txt 中登记的下载中心）已记录的站点，并把来源下载中心本身也作为运行站点展示；站点列表改为展示全部，不再只显示最近 12 个；名称、版本、Logo、在线状态继续每 60 秒实时刷新，新增 deploy_list 公开只读接口，旧版下载中心没有该接口时自动回退读取 deploy_feed 或公开页面卡片。\n"
        . "33. 修复安卓手机横幅调高后内容被裁切：手机横幅改为按实际高度自适应，标题、副标题、节日倒计时、帖子 / 茶客 / 评论、年月日与天气随高度同步缩放；帖子 / 茶客 / 评论改为更大的胶囊按钮；年月日与天气移到横幅下方左侧，不再遮挡右侧头像 / Logo；160–300px 全部完整显示，后台高度预览也同步缩放。\n"
        . "34. 手机横幅右侧大 Logo 换成「冰晶极光双轨光环」：移除原水晶 / 三角 / 多层蓝色旋转圈，改为双层反向旋转光环、环绕光点、玻璃内圈与呼吸流光；Logo 整体上移，避免遮挡评论按钮。横幅标题、副标题和统计文字取消黑色描边，改为与节日倒计时一致的柔和投影。\n"
        . "35. 后台“F12 / 右键自动刷新”改为卡片右上角的独立开关：开关旁直接显示“已开启 / 已关闭”，点击立即保存并写入实时事件；实时保护关闭时也可以先保存子开关，开启实时保护后立即生效，不再需要滚到说明文字下方找开关。\n"
        . "36. 修复源码下载中心“已经跑起来的木漏茶室”实时 Logo 不生效：检测时优先读取目标站点首页实际渲染的 Logo，而不是只依赖 og:image / favicon；支持图片 Logo 与动态视频 Logo，部署卡片会按类型显示静态图或自动播放的循环视频；证书链异常的站点会自动降级读取公开 Logo 并缓存到本站，HTTPS 下载中心也能稳定显示站外 Logo；旧部署记录会自动识别并升级 Logo 类型。\n"
        . "37. 源码下载中心的源码包同步更新到 v6.25.146：完整源码包与在线升级包都包含本次 F12 开关、实时 Logo、动态视频 Logo 和证书兼容改动；完整包继续采用根目录结构，上传虚拟主机或云服务器后可直接打开 install.php 安装运行，升级包覆盖后无需额外改动。\n"
        . "38. 手机横幅大 Logo 改为顶部对齐：取消原来仅 10% 的位移，改为贴住横幅上沿并允许光环轻微出框，160 / 178 / 300px 高度下都与帖子、茶客、评论统计按钮完全分开，不再压住评论按钮；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.147。\n"
        . "39. 升级到 v6.25.148：手机横幅大 Logo 改用绝对定位贴住横幅上沿，右侧预留独立安全区，160 / 178 / 300px 高度都不再压住评论按钮；个人资料编辑页新增仅超级管理员可见的「IP 登录历史」入口，新页面展示当前账号登录过的 IP、设备 ID、设备码、设备详情与自动解析的详细地址，IP / 设备 ID / 设备码 / 地址均可点击自动复制；登录记录表自动补齐 device_id、device_code、address 字段，升级前旧记录按 IP + 浏览器归档并标注；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.148。\n"
        . "40. 升级到 v6.25.149：登录记录入口开放给所有登录用户，每个用户只能查看本人的 IP、设备 ID、设备码与详细地址；新增「被删除账号恢复」存档列表和逐条恢复，每条只重建对应账号、不批量处理，恢复后账号可重新登录，已清理内容不回来；后台用户详情新增单账号「注册资料恢复」，个人资料页也可自助恢复注册时填写的用户名、邮箱、昵称、性别、简介、所在地、展示范围和头像，密码、角色、积分与内容不变；后台删除账号改为必须发送并输入当前管理员绑定邮箱的 6 位验证码；后台保留「添加管理员」与角色下拉；手机横幅大 Logo 完整收进卡片右上角安全区，光环、虚线圈和 Logo 框不再被上沿裁切；木卫守护仅超级管理员可见可用，非超管导航隐藏且直接访问被拦截；永久封禁账号时同步把该账号最近登录 IP 与最近设备指纹加入木卫守护永久封禁；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.149。\n"
        . "41. 升级到 v6.25.150：后台移除「＋ 添加超级管理员」按钮，新增用户/管理员时角色只能选普通用户、版主、贵宾或管理员，不能再创建超级管理员；用户编辑页也移除超级管理员角色选项，后端直接驳回任何提升为超级管理员的请求；升级时自动检查全站超级管理员，仅保留部署站长账号，历史多余超管自动降为管理员，之后每个请求都不能再新增第二个超级管理员；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.150。\n"
        . "42. 升级到 v6.25.151：全局音乐悬浮播放器补齐「下载」按钮，网盘分享广场、分享链接与组合播放列表选中的音乐都沿用当前曲目的下载地址；播放器底部改为歌词 + 律动双区，歌词显示当前时间轴，右侧 24 根频谱随播放律动，手机与电脑布局一致；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.151。\n"
        . "43. 升级到 v6.25.152：在线升级的手工上传接口仅对绑定 210255270@qq.com 的超级管理员开放；非该邮箱超级管理员仍可使用在线自动升级，但无法上传本地 ZIP，服务端在后台入口、AJAX 上传、同步上传三处统一拦截；在线升级包与源码下载中心同步更新到 v6.25.152。\n"
        . "44. 升级到 v6.25.153：个人中心「我的」页面顶部新增「登录需要验证邮箱」独立开关；邮箱未绑定或未验证时展示去验证入口，验证通过后可直接开启；开启后密码登录会跳转到邮箱验证码页面，必须填写发送到本人绑定邮箱的 6 位验证码才能完成登录；关闭后恢复只用密码登录。\n"
        . "45. 升级到 v6.25.154：修复手机误入「电脑端模式」后「我的」页面被挤成右侧窄条、文字一字一行的问题；手机屏幕宽度小于 760px 时，若站点记忆为电脑端且没有手动指定 ?device=desktop，会自动切回手机端布局并重写 viewport，个人卡恢复整宽；手动点过「电脑端」的链接仍保持电脑端，不被强制切回；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.154。\n"
        . "46. 升级到 v6.25.155：移除用户主页底部的「管理员操作 / 仅管理员可见」整块，禁言、封禁、删除用户按钮不再出现在手机和电脑的用户主页；管理员需要处理用户时统一到后台用户管理操作；同时保留 v6.25.154 手机误入电脑端自动回手机端布局的修复；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.155。\n"
        . "47. 升级到 v6.25.156：手机端强制使用手机布局，不再被旧的电脑端 Cookie 或地址里的 ?device=desktop 撑成 1200px 窄条；脚本同时识别 iPhone / iPod / Android 和短边小于 760px 的屏幕，命中后立即改写 viewport 为 width=device-width，并同步 data-device-mode=mobile；电脑端屏幕不受影响；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.156。\n"
        . "48. 升级到 v6.25.157：修复苹果 Safari 开启「请求桌面网站」后仍显示桌面窄条的问题；苹果 Safari 的桌面模式 UA 会伪装成 Macintosh，新增「苹果触屏设备」判断：只要设备是 iPhone / iPad / iPod 或 Macintosh 且带触屏，就强制切回手机布局；Mac 电脑没有触屏，不受影响；Android 与电脑端保持原逻辑；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.157。\n"
        . "49. 手机首页横幅右侧大 Logo 向右移动 10px，与左侧「距离下一个节日」倒计时框留出安全间距，光环虚线圈不再压进倒计时框；电脑端布局不变。\n"
        . "50. 升级到 v6.25.158：修复苹果手机 Chrome 仍显示桌面窄条的问题；iOS Chrome 即使开启「请求桌面网站」，UA 中也带 CriOS，服务端直接把 CriOS / FXiOS / EdgiOS 识别为手机并输出手机布局，不再依赖前端脚本；Windows / Mac 电脑 Chrome 不受影响；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.158。\n"
        . "51. 升级到 v6.25.159：个人中心整页改为手机单列自适应；苹果触屏设备检测到桌面网站模式写入手机 Cookie 后自动重载一次，让服务端直接输出手机布局；若系统强制保留 980px 桌面画布，则在 900–1010px 触屏画布下按 2.45 倍缩放，个人卡恢复整宽，不再缩成右侧一条；电脑端和 iPad 不受影响。\n"
        . "52. 升级到 v6.25.160：彻底解除苹果桌面网站模式下手机画布的 430px 宽度限制；触屏设备在 760px 以上画布时整页铺满画布，并按屏幕实际宽度比例放大，个人中心、页头、底栏同步铺满，不再被锁成右侧窄条；电脑端与常规手机模式不受影响。\n"
        . "53. 升级到 v6.25.161：苹果触屏设备只要落在 900–1010px 桌面画布，就不再依赖 screen.width，强制按 390px 手机画布放大 2.5 倍；个人中心、页头、底栏按手机宽度铺满，昵称和标签不再一字一行；电脑端、iPad 与常规手机模式不受影响。\n"
        . "54. 升级到 v6.25.162：安卓及其他触屏设备不再套用苹果的 2.5 倍缩放；大画布只解除 430px 宽度上限，个人中心恢复整宽，常规手机视图保持原生。\n"
        . "55. 升级到 v6.25.162：修复电脑端输入账号密码后跳回首页仍是游客的问题；登录不再轮换会话 ID，避免共享主机新会话文件丢失，同时 Cookie 的 Secure 只按真实 HTTPS/443 判断，代理头不再造成登录态丢失。\n"
        . "56. 升级到 v6.25.163：站长本人（唯一超级管理员）密码登录不再被邮箱二次验证拦截；邮箱验证码发送失败时改为密码直接登录，不再把人锁在登录页。\n"
        . "57. 升级到 v6.25.163：持久登录令牌在设备 Cookie 丢失或变化时自动重新绑定，PHP 会话 Cookie 被清理后仍能恢复登录，不再反复跳回登录页。\n"
        . "58. 升级到 v6.25.164：触屏设备落在 900–1010px 桌面画布时，页面直接切换为 mobile 单列布局，个人中心不再显示成右侧窄侧栏；苹果保留 2.5 倍手机画布，安卓只解除宽度上限。\n"
        . "59. 升级到 v6.25.165：登录回退版，关闭“登录必须邮箱验证码”这一项，恢复账号密码直登；邮箱验证码登录入口与 TOTP 动态验证保留，布局修复不受影响。\n"
        . "61. 升级到 v6.25.169：移除内置“广告杀手”插件，停止自动登记并清除旧启用记录。\n"
        . "60. 升级到 v6.25.166：登录框支持用户名或绑定邮箱，电脑浏览器密码管理器把邮箱自动填入时也能正常登录；登录表单提示同步改为“用户名或邮箱”。\n"
        . "46. 升级到 v6.25.155：彻底修复 iOS Safari 打开「我的」仍是右侧窄条的问题；所有页面不再输出 width=1200 / width=900 的固定布局视口，统一使用 width=device-width，桌面浏览器不受影响；服务端识别到手机 UA 时直接使用手机布局，旧 desktop Cookie 和桌面板入口不再把手机页面撑成 1200 画布；手机个人卡、藤蔓边框、登录安全与邮箱验证开关全部恢复整宽显示。\n"
        . "二、v6.25.129 历史更新\n"
        . "木漏茶室 v6.25.129 系统升级包（完整更新内容）\n"
        . "一、网盘歌曲搜索与歌词封面\n"
        . "1. 手动搜索改为并发采集：同时查询 LRCLIB 歌词库、iTunes 封面库和网易云音乐，单次最多返回 20 条相关候选。\n"
        . "2. 候选支持精确匹配、同名歌曲、歌名近似、同歌手、相关推荐五类标签，先列精确结果，再列同歌手和相关版本。\n"
        . "3. 新增网易云歌词与封面补齐：中文歌曲即使歌词库没有收录，也能从网易云取得歌词和专辑封面。\n"
        . "4. 歌手名支持简繁转换，例如“黄霄云”和“黄霄雲”会按同一歌手匹配。\n"
        . "5. 修复“烟火里的尘埃 / 黄霄雲”这类只输歌名和歌手却搜不到的问题；现在会优先显示黄霄雲原版，并带封面和歌词。\n"
        . "6. 选中候选后，歌曲标题、歌手、文件名、封面、歌词会一起更新；播放器立即使用新封面和新歌词。\n"
        . "二、播放器律动\n"
        . "7. 播放器新增 28 根大频谱律动条，放在当前歌曲标题上方。\n"
        . "8. 桌面高度 54px、手机高度 46px，使用青蓝、紫粉、金橙三组渐变和发光效果，播放时整排持续起伏。\n"
        . "9. 保留小频谱兼容逻辑，播放、暂停、切歌时自动开始或停止，不影响歌词同步。\n"
        . "三、扩展与插件\n"
        . "10. 扩展管理入口迁回扩展中心，只有超级管理员可见、可用。\n"
        . "11. 扩展包安装与系统升级共用同一套上传、检测、备份和安装接口。\n"
        . "12. 插件中心支持超级管理员删除插件；上传的插件只安装到当前站点，不会加入插件商城，也不会进入源码下载中心。\n"
        . "13. 扩展中心“扩展管理”“插件中心”“插件制作教程”三张卡片移除说明文字，卡片更简洁。\n"
        . "四、电脑端与手机端界面\n"
        . "14. 电脑端首页圆形 Logo 改为 190px 并铺满整个圆环，使用 object-fit: cover，不再留下大片白边。\n"
        . "15. 修复手机端手动搜索歌词封面弹窗右侧超出屏幕的问题，390px、320px 窄屏均可完整显示。\n"
        . "16. 网盘分享卡片在手机端改为单列，播放器不再被挤成窄条，封面、标题、歌词、进度条完整显示。\n"
        . "五、系统升级与账号\n"
        . "17. 本地上传升级包和站外在线升级都会显示完整更新内容，保留换行并逐条展示，不再只显示一行摘要。\n"
        . "18. 升级记录保留每次更新的完整说明，升级完成、回滚和文件数量都可回看。\n"
        . "19. 移除 QQ 登录：首页、登录页、个人中心绑定入口和后台 QQ 登录设置全部下线，相关路由和模块文件一并移除。\n"
        . "六、兼容与升级说明\n"
        . "20. 适用版本：v6.0.0 及以上，升级后为 " . APP_VERSION . "；PHP 7.4 及以上。\n"
        . "21. 升级包包含完整站点源码，保留 config.php、data/、uploads/、storage/ 和 install.php，不会覆盖站点配置与已有数据。\n"
        . "22. 升级前自动备份核心文件，检测目录、版本、PHP 语法和运行时兼容性，通过后才会覆盖。\n"
        . "23. 建议升级后清除浏览器缓存；若使用 CDN，请刷新静态资源缓存。\n"
        . "24. 源码下载中心的完整源码包、在线升级包和实时检测包会校验清单版本；站点升级后自动重建，升级后的文件立即进入检测包，不再出现清单版本落后或包内容未更新。\n"
        . "25. 电脑端点击页脚“手机端”后，整站切换为 430px 手机画布：隐藏电脑顶栏、显示手机底栏，并套用全部手机断点布局；点“电脑端”可恢复。
"
        . "26. 网盘手动搜索新增搜索源切换：全部、网易云音乐、QQ音乐、酷狗音乐、酷我音乐；选中搜索源后会自动重搜，候选卡片显示来源平台，封面和歌词按平台重新获取。
"
        . "27. 修复 QQ 音乐歌词接口缺少 Referer 导致歌词取不到的问题；同时修复网易云、QQ、酷狗、酷我封面域名后缀判断，四个平台的专辑封面都能正常显示。
"
        . "28. 电脑端个人主页改为手机端同款单列卡片布局：头像、资料、操作按钮垂直居中排列，拉黑、加好友、发消息、转账、举报和管理员操作不再被挤成多条窄列。\n"
        . "29. 新增「霜庭 · 纯白」主题：页面、卡片、首页介绍区、公告条、每日一言和筛选标签统一纯白底（#ffffff），标题与正文纯黑（#000000），次要文字深灰；只改变字体和颜色，不改变布局与功能。\n"
        . "30. 新增「霜庭宋体」字体：优先使用宋体/思源宋体/Noto Serif，正文、标题、按钮和输入框统一衬线字形，可在后台字体设置或主题面板切换。\n"
        . "31. 「霜庭 · 纯白」隐藏首页蓝雪山景与雪点装饰，保留站点 Logo 和全部入口；深浅色和其他主题互不影响。\n"
        . "32. 后台顶部升级提示改为和参考站一致的信息卡：直接显示发现的新版本号、升级建议和绿色「前往升级」按钮，所有后台页面顶部可见。\n"
        . "33. 扩展中心「在线升级」出现新版本时显示 NEW 角标，图标持续轻微抖动，进入后即可在线升级。\n"
        . "34. 聊天大厅有新消息时，扩展中心聊天卡片显示未读条数角标，图标同步抖动；打开聊天大厅后自动清零。\n"
        . "35. 后台功能栏改为手机端左侧抽屉：点「功能菜单」向右展开，点 × 或遮罩向左收起，菜单为深色单列布局。\n"
        . "36. 移除旧的全站背景图设置，升级后前台不再显示自定义全站背景；原背景值自动备份到 site_bg_image_backup_v62586。\n"
        . "37. 后台功能栏按「仪表盘 / 内容管理 / 扩展应用 / 其他」分组，条目顺序与参考站一致；手机抽屉隐藏 ABC 排序条，当前功能用绿色整行高亮。\n"
        . "38. 后台抽屉改为整块深色菜单栏从左侧水平滑入：去掉右侧圆角，宽度覆盖整条菜单，展开/收起只做横向位移动画。\n"
        . "39. 后台抽屉入口改为「两条杠」图标按钮，点击图标即整条菜单栏从左侧滑出，不再显示「功能菜单」文字按钮。\n"
        . "40. 桌面后台功能栏改为固定在左侧、从顶部一直连到底部的整条深色菜单栏；手机端仍由两条杠图标触发，整条菜单栏水平滑入。\n"
        . "41. 修复后台功能子页点击两条杠后只剩灰色遮罩、菜单不显示的问题；手机抽屉恢复满屏高度，整条菜单栏完整滑出。\n"
        . "42. 后台侧栏宽度收窄到参考位置，黑色底改回站点主题色；电脑切到「手机端」时后台不再错位空白，按手机抽屉正常展示。\n"
        . "43. 后台功能子页移除顶部「回到上一页」按钮，包括站点设置和模板管理，进入页面后直接显示内容。\n"
        . "44. 后台功能菜单栏整体加宽，菜单文字向右移动，图标与文字间距更舒展。\n"
        . "45. 主机状态改为轻量统计站点占用，避免扫描大量文件导致页面超时或内存耗尽；异常兜底页改为全屏居中显示，不再挤成竖排乱码。\n"
        . "46. 用户管理页的「编辑」改为卡片弹窗，保留用户列表背景并带右上角关闭按钮，关闭后直接回到列表，不再跳转独立编辑页。\n"
        . "47. 手机端后台抽屉底部移除「返回前台」和「退出登录」两个按钮。\n"
        . "48. 「霜庭 · 纯白」主题恢复首页卡片背景图和飘雪：卡片图以浅色蒙层显示，雪花改为灰蓝色以便在白色底上可见，正文仍保持黑色。\n"
        . "49. 彻底删除官方通知账号（UID 2，登录名 101）及其发布的公告和通知，移除扩展中心「官方通知」入口；升级时自动备份该账号数据。\n"
        . "50. 公告提示新增开始时间和结束时间：弹窗公告、横幅公告都只在设定时间段内生效，过期自动停止。\n"
        . "51. 弹窗公告新增「允许所有用户 12 小时内不再提示」开关；开启后用户可点「12小时内不再提示」，12 小时后恢复弹窗。\n"
        . "52. 横幅公告新增「允许关闭横幅」开关；允许时才显示关闭按钮并可关闭，不允许时不显示且无法关闭。\n"
        . "53. 后台侧栏左上角改为站点 Logo，下面显示站名「木漏茶室」，整体居中；左侧功能菜单加宽加大并居中。\n"
        . "54. 修复完整源码包清单版本异常：打包时排除站点根目录残留的旧 komorebi-source.json，上传升级包后实时检测会自动生成与当前版本一致的新清单。\n"
        . "55. 网盘歌词封面搜索兼容「歌曲 - 歌手」文件名；没有精确匹配时自动交换歌名和歌手再搜一次，黄霄雲《烟火里的尘埃》可直接搜出原版。\n"
        . "56. 网盘音频卡片下载按钮加大，下载两个字改为横排显示，手机端和电脑手机模式同步生效。\n"
        . "57. 帖子附件音频新增歌词封面匹配：上传者可一键匹配，也可手动搜索网易云、QQ、酷狗、酷我，选中后标题、歌手、封面、歌词一起更新。\n"
        . "58. 世界圈音乐新增同样的歌词封面匹配入口；帖子附件、世界圈和网盘使用同一套播放器卡片，标题、歌手、封面、歌词显示保持一致。\n"
        . "59. 修复网盘手动选择歌曲后卡片标题和歌手不变的问题：匹配结果会覆盖原始文件名信息，刷新后立即显示新标题、新歌手和新封面。\n"
        . "60. 木卫守护公开页删除安全评分，只保留最近一次检测结果和通过/需处理状态。\n"
        . "61. 移除首次安装后的木卫守护自动检测弹窗，安装完成不再自动弹出全站检测卡片，管理员仍可在后台手动检测。\n"
        . "62. 升级后版本为 v6.25.101，帖子附件和世界圈新增的歌词、封面、匹配标题、匹配歌手字段会自动迁移，无需手工操作。\n"
        . "63. 木卫守护不再删除、移动或隔离任何文件，install.php 会一直保留在站点根目录；上传目录可疑文件、根目录备份文件等只提示风险，由站长手动处理。\n"
        . "64. 木卫守护的数据库令牌清理、.htaccess 写入、config.php 权限收紧等非文件删除类修复保持不变。\n"
        . "65. 发帖上传音频与网盘同款匹配：拖拽上传音频自动显示匹配歌词 / 封面按钮，支持一键匹配与手动搜索选择；匹配后显示网盘同款音乐卡片（封面、标题、歌手、歌词、播放、下载），发布后帖子正文保持同款卡片。\n"
        . "66. 世界圈发布框新增同一套音频匹配能力；匹配结果随动态发布写入，前台动态直接显示同款音乐卡片。\n"
        . "67. 音频上传新增实时进度条；只有服务端确认是音频文件时才显示匹配按钮。\n"
        . "68. 修复发布帖子后音频卡片丢失匹配标题 / 歌手 / 封面 / 歌词的问题，帖子卡片可正常播放和下载。\n"
        . "69. 木卫守护移除安全评分展示与安装后首次自动检测；不再拥有删除或移动任何站点文件的权限，install.php 永久保留，文件风险只提示由站长处理，其他防护功能不变。\n"
        . "70. 前台页脚在版本号后显示当前 PHP 版本。\n"
        . "71. 本次升级后版本为 v6.25.103。\n"
        . "72. 网盘手动选择结果后，歌曲文件名同步改为“歌手 - 歌名”，歌词和封面以选中结果为准，旧信息不再残留，文件卡片立即更新。\n"
        . "73. 帖子音频卡去掉发布时重复的小封面和标题块，音乐卡片居中显示，封面与文字间距加大。\n"
        . "74. “保存到网盘”从封面浮层移到音频卡右下角，改为和播放、下载并列的按钮。\n"
        . "75. 本次升级后版本为 v6.25.104。\n"
        . "76. 世界圈音乐卡片同步改为居中卡片、封面与文字留出间距，并在右下角加入“保存到网盘”按钮。\n"
        . "77. 本次升级后版本为 v6.25.105。\n"
        . "78. 帖子与世界圈音乐卡片按播放进度逐句显示当前歌词，歌词字号加大并加粗，播放到哪一句就切到哪一句；有歌词时不再重复显示文件名。\n"
        . "79. 音频卡封面四周留出更自然的间距，手机端卡片内边距、封面和文字间隔加大。\n"
        . "80. 网盘新增文件夹：支持新建、重命名、删除；删除文件夹只把文件移到未分类，不会删除文件。\n"
        . "81. 网盘文件列表新增“移动到文件夹”下拉，上传时也可以直接选择保存到某个文件夹，并可按文件夹筛选、查看各文件夹数量。\n"
        . "82. 修复同一首音频重新手动匹配歌词封面后封面仍显示旧图的问题：封面缓存改为按图片内容生成新地址，文件行匹配完成后立即刷新封面、标签和文件名，并短暂高亮提示。\n"
        . "83. 帖子详情页手机端音乐卡改为封面居中置顶、歌曲信息与歌词居中，作者与编辑/锁定/置顶/加精/删除这一行整体上移，减少标题到操作区的空白。\n"
        . "84. 手机端音乐播放改为原生音频输出，切到微信、浏览器等其他应用后继续播放；手机端频谱使用 CSS 律动，不再因后台挂起 Web Audio 而中断。\n"
        . "85. 帖子音乐卡封面向下移动并放大到 110px，保持 1:1 正方形和等比裁切，避免上下压扁的感觉。\n"
        . "86. 阅读记录新增每位用户的阅读次数，并分别显示首次阅读和最新阅读的完整年月日时间。\n"
        . "87. 插件中心新增内置插件“广告杀手”：可自行添加、修改、删除广告关键词，对帖子、世界圈动态、帖子评论、世界圈评论和回复做连续子串检测，命中即驳回并警告；达到设定次数后按配置自动限时/永久禁言或限时/永久封禁，可设置处罚截止年月日；超级管理员和管理员的内容不受检测，也不会被插件处罚。\n"
        . "88. 广告杀手设置入口改为卡片右上角“设置”按钮：默认收起，点击展开完整设置面板，按钮变为“收起设置”，再次点击收回。\n"
        . "89. 首页页脚新增“小黑屋”入口：展示处罚中的用户、处罚理由、封禁时间与解封时间；新增释放页，显示处罚已到期或已被提前解除的用户。\n"
        . "90. 管理员编辑页新增插件中心权限：可见可上传、可见不能上传、不可见三种状态，仅对普通管理员设置，超级管理员始终可见并可上传。\n"
        . "91. 扩展中心新增“插件管理”入口，仅管理员可用：集中显示已下载和已安装插件，可启用、设置、禁用和卸载；内置插件不可卸载。\n"
        . "92. 广告杀手以 0 积分免费内置商品展示在插件商城，标记为已内置、免费。\n"
        . "93. 完整移除源码下载中心的“源码包实时检测”功能、界面与源码模块，升级时自动清理旧文件。\n"
        . "94. 修复手机端页头视频 Logo 首帧未加载时显示空白：视频 Logo 统一回退为内置静态 Logo，页头始终保留图形标识。\n"
        . "95. 首页卡片移除“发帖”按钮，把平台用户、每日签到、公告列表、分享应用四个按钮移出卡片，放到卡片下方等宽横向排列。\n"
        . "96. 站点设置的三端横幅合并为一套：只保留一个上传入口和一个网络链接输入框，电脑、平板、手机共用同一张横幅，手机和平板按屏幕分辨率自动裁切铺满。\n"
        . "97. 手机端横幅改为与电脑端一致的长方形覆盖式布局：标题、时间天气、倒计时和数据直接叠加在横幅上，右侧保留站点 Logo，不再把信息区拆到横幅下方。\n"
        . "98. 手机端横幅按电脑端 1080×360 的设计稿整块等比缩放：固定电脑端 3:1 宽扁比例，文字、倒计时、数据和右侧 Logo 的位置与电脑端一致，手机屏幕只改变整体大小，不再把横幅压成接近正方形。\n"
        . "99. 手机端横幅高度略微增加，卡片内 Logo 放大，横幅下方快捷按钮同步加大；全部茶客列表新增每位茶客的最后登录时间，未登录过的显示“从未登录”。\n"
        . "100. 重新打包为 v6.25.117：包含手机横幅放大、卡片 Logo 放大、快捷按钮放大和全部茶客最后登录时间，用于在已安装 v6.25.116 的站点继续升级。\n"
        . "101. 站点设置新增手机横幅高度滑块（160–300px）和 402px 手机卡片预览，可实时查看高度、Logo 与三个快捷按钮效果；手机横幅 Logo 与快捷按钮再次放大；视频 Logo 改为直接在页面循环播放，不再回退成内置静态图标。\n"
        . "102. 手机横幅的下个节日倒计时条保持左边不动，向右延伸到横幅宽度约 47% 的位置；四个快捷按钮调整到 54px 高度。\n"
        . "103. 手机横幅左侧的英文小标题、主标题、副标题、下个节日倒计时条以及帖子/茶客/评论三项数据整体放大；平台用户这一行四个快捷按钮恢复为最初横向排列时的 95×46px 大小。\n"
        . "104. 手机横幅左侧内容整体向右微调；右上角时间日期移到横幅底部中间并加大；左侧叠加暗色渐变和文字阴影，让图片上的文字更清楚；右侧大 Logo 增加旋转渐变光环、呼吸外圈和环绕光点。\n"
        . "105. 横幅底部的时间日期卡片改为白底深色字，加大字号与内边距，增强和图片背景的对比度。\n"
        . "106. 保留白底黑字时间卡与动感 Logo 框效果，版本号提升到 v6.25.123，用于覆盖已安装的 v6.25.122。\n"
        . "107. 后台站点设置新增“清空横幅”按钮，点击并确认后会清空电脑/平板/手机共用横幅及旧版回退字段。\n"
        . "108. 把“清空横幅”按钮从页面底部移到站点横幅预览框正上方，方便在横幅区域直接操作。\n"
        . "109. 后台首页轮播的本地图片上传改为拖拽上传框，支持直接拖入图片并回显文件名，保留 16:9 建议与 1000MB 上限。\n"
        . "110. 清空横幅后，首页不再切换回浅色卡片，而是保持深色横幅布局：深色渐变底、白字、白底时间卡与动感 Logo 环，手机端结构与有图时一致。\n"
        . "111. 无横幅状态下的白色标题、副标题与统计数据增加黑色描边，保持白字主体并提升深色底可读性。\n"
        . "112. 首页横幅右侧 Logo 框改为蓝色霓虹律动样式：加粗蓝色光环、旋转光弧、呼吸外圈，并加入四块空心晶体尖片、三角碎片与浮动闪点；本次升级后版本为 v6.25.129。\n"
        . "113. 升级到 v6.25.200：用户主页「管理员操作」卡片的「删除用户」改为必须先验证当前管理员绑定邮箱，点击后弹窗发送并输入 6 位验证码，验证码错误或未填写都不会删除；后台用户管理的删除流程保持不变，两个入口统一使用同一套邮箱验证；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.200。\n"
        . "114. 升级到 v6.25.201：用户主页和后台将账号设为永久封禁时，都必须先验证当前管理员绑定邮箱并输入 6 位验证码；永久封禁会写入小黑屋处罚记录，并同步封禁该账号最近使用的 IP 与设备指纹；恢复账号时自动解除由该账号永久封禁连带产生的 IP、设备封禁，不影响管理员手动封禁记录；进入后台「木卫守护」解禁 IP 或设备时，也必须先验证当前管理员绑定邮箱；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.201。\n"
        . "115. 升级到 v6.25.202：TOTP 绑定验证器时「复制密钥」按钮改为复制页面上同样的四字符分组密钥，粘贴后保留空格分组，不再连成一串；二维码和 otpauth 链接导入方式不变；源码下载中心的完整源码包与在线升级包同步更新到 v6.25.202。\n"
        . "116. 升级到 v6.25.203：源码下载中心的完整源码包重新构建并同步到 v6.25.203，升级后会自动按当前版本重建最新整站源码，不再继续提供旧版本缓存；完整包保留 install.php，采用根目录结构与虚拟主机兼容的 .htaccess，data、uploads、storage 运行目录和防护文件齐全，不带站点 config.php、数据库、上传文件与插件；已通过 PHP 语法、ZIP 隔离、升级后首页、源码中心导出和从零安装验证，适用于虚拟主机与云服务器。\n"
        . "117. 升级到 v6.25.204：修复部分虚拟主机上安装向导协议页点击“我同意”后仍反复提示倒计时、无法进入下一步的问题；协议页前端仍显示 10 秒阅读倒计时，同时把阅读时间写入 Cookie 兜底，服务端不再因会话或计时数据丢失而把用户卡在第一步；勾选协议后即可正常进入数据库、管理员和站点信息步骤，安装流程不变。\n"
        . "118. 升级到 v6.25.205：源码下载中心的完整源码包重新构建并同步到 v6.25.205，升级后按当前版本强制重建最新整站源码，不再继续提供 204 旧缓存；新源码包根目录完整包含 install.php、index.php、api.php 与源码中心模块，安装向导协议页已带上 204 的 Cookie 兜底修复，上传虚拟主机或云服务器后可直接打开 install.php 安装；已重新验证 PHP 语法、ZIP 隔离、从零安装、首页与后台运行，以及升级后源码中心导出。\n"
        . "119. 升级到 v6.25.206：安装向导第一页取消强制阅读 10 秒的等待，打开 install.php 即可直接勾选“我同意以上协议”并进入数据库设置，不再出现按钮被禁用、倒计时或反复提示“还需约 10 秒”；协议正文仍需手动勾选确认，后续安装步骤不变；源码下载中心的完整源码包同步重建到 v6.25.206。\n"
        . "120. 升级到 v6.25.207：源码下载中心打包前自动把当前站点已验证的 install.php 同步为安装模板，并强制校验模板必须取消 10 秒等待；下载链接附带当前版本参数，ZIP 响应增加 no-store 缓存控制，避免虚拟主机、浏览器或 CDN 继续返回 206 及更早的旧源码包；升级后下载到的 komorebi-forum-v6.25.207-source.zip 根目录包含可立即安装的 install.php、index.php、api.php 和源码中心模块，已用该包从零跑通数据库、管理员、站点信息、首页与后台，适用于虚拟主机与云服务器。\n"
        . "121. 升级到 v6.25.208：修复源码部署到部分虚拟主机后根目录 install.php 丢失、访问首页直接跳 404 的问题；未安装站点检测到 install.php 缺失且根目录可写时，会自动从 inc/install_dist.php 还原安装入口再跳转，不再要求手工补文件；源码中心继续强制打包 install.php，并在升级后立即重建 v6.25.208 完整源码包。\n"
        . "122. 升级到 v6.25.209：修复手机端安装协议页点“我同意以上协议”没有反应、无法进入下一步的问题；现在点按钮会自动勾选协议并直接提交，不再要求先点中那个小复选框；仍然保留手动勾选方式，协议内容不变；源码中心同步重建 v6.25.209 完整源码包。\n"
        . "123. 升级到 v6.25.210：csrc.954377.xyz 的源码下载中心仅允许管理员和超级管理员进入，并要求账号邮箱已完成验证；普通用户和未验证邮箱的管理员无法访问，扩展中心也不再显示入口，直接调用源码下载接口同样会被拒绝；该限制只对 csrc.954377.xyz 生效，其他站点保持原样；站外部署回传和升级源接口不受影响。\n"
        . "124. 升级到 v6.25.211：csrc.954377.xyz 站点彻底关闭源码下载中心与在线升级入口；扩展中心不再显示源码下载中心和在线升级卡片，直接访问源码中心、安装教程、作者页和后台系统升级页均按不存在处理，源码下载与升级 AJAX 接口同样被拒绝；站外部署回传、升级源下发接口继续保留；本限制只对 csrc.954377.xyz 生效，mlcs 等其他站点保持原样。\n"
        . "125. 升级到 v6.25.212：去掉帖子、世界圈和网盘音频卡片的封面浅蓝占位底色，封面缺少图片时不再露出蓝色圆角块，封面图加载后直接贴合卡片背景；同时源码下载中心的完整源码包按 v6.25.212 自动重建，下载到的是包含本次样式修复的最新源码。\n"
        . "126. 升级到 v6.25.213：系统升级页把在线升级按钮移到最新一条升级记录的标题右侧，发现新版本时可直接在那里点“升级到 vX”；没有新版本时同一位置显示“升级”按钮，点击自动跳到上传升级包区域并打开文件选择；升级源异常时同样可从这里转手动上传；原在线升级区不再重复放按钮。\n"
        . "127. 升级到 v6.25.214：扩展管理页在“恢复默认布局”右侧新增“添加网络扩展”按钮，点击自动跳到添加网站扩展表单并聚焦名称输入框；网站扩展不设数量上限，可添加任意数量，添加后仍只显示在自己的扩展中心。\n"
        . "128. 升级到 v6.25.215：帖子详情和世界圈共用的音频卡封面改为竖向更高的比例（桌面 56×66、手机 54×62），卡片上下留白同步增加，两处音频卡一起变高，封面仍按原图等比裁切填充。\n"
        . "129. 升级到 v6.25.216：网盘“我的文件”列表新增“下载”入口，所有格式都可直接下载；分享广场的单文件公开卡片也提供下载按钮；文件主人打开自己设置了访问密码的文件时不再被密码拦住，非音频文件下载改为标准附件响应，避免被浏览器当成音频播放。"
        . "130. 升级到 v6.25.217：后台新增独立“文件大小设置”入口，集中设置世界圈、帖子正文文件、帖子附件、网盘的单文件上传上限；原“上传与配额”改为“存储配额”，只保留网盘、图床、附件累计配额，避免单文件大小和用户配额混在一起。
"
        . "131. 修复后台“头像大小”入口图标显示成蓝色三角尺、容易被误认为报错的问题，改为人物头像图标，入口名称与页面功能保持一致。"
        . "132. 升级到 v6.25.218：重新打包“文件大小设置”版本，供已安装 6.25.217 的站点覆盖升级；后台“站点设置 → 文件大小设置”可分别设置世界圈、帖子正文文件、帖子附件、网盘的单文件上传上限，存储配额保持独立入口。"
        . "133. 升级到 v6.25.219：源码下载中心改为独立发布包机制，完整源码 ZIP 冻结在 storage/releases，文件树、单文件下载和完整 ZIP 都只读这份发布包，不再实时扫描线上工作区；升级完成后自动重新发布当前版本源码包，后台首次进入升级页也会自动补齐；保留超级管理员“重新发布源码包”入口。"
        . "134. 升级到 v6.25.220：修复手机端“浏览模式”切换失效，显式选择电脑端 / 平板端后不再被前端按 UA 强制改回手机端；服务端优先采用 device 参数与用户选择 Cookie，只有首次访问且没有选择记录时才自动识别设备。"
        . "135. 升级到 v6.25.221：修复手机端切到电脑端 / 平板端后页面布局没有变化的问题；现在浏览模式会同步切换布局视口，手机端用 device-width、平板端用 900px、电脑端用 1200px，媒体查询和导航样式随之一并生效。"
        . "136. 升级到 v6.25.222：扩展中心新增「一键部署」，超级管理员可生成带签名令牌的终端命令；在云服务器终端或宝塔面板执行后自动下载本站最新完整源码包、校验 SHA256、备份旧源码、解压部署，并在新服务器上自动建库、建表、创建管理员和生成 config.php；已有站点只更新源码，保留数据库配置、上传文件和运行数据；部署页内置约 40 秒视频教程和分步图文教程，包含真实后台截图、终端输出与常见问题。\n"
        . "137. 升级到 v6.25.223：部署页视频教程升级为豆包“阳光甜妹”配音讲解，时长约 1 分 26 秒，按宝塔面板实操顺序演进到进入木漏茶室论坛首页；新增宝塔添加站点、SQLite 建库、文件权限确认三段演示；图文教程同步改为 6 步宝塔 + SQLite 流程，并替换为 1280×720 示意截图；视频继续托管在 CDN，升级包体积保持轻量。\n"
        . "138. 升级到 v6.25.224：修复 MySQL / MariaDB 全新安装时报 1101 的问题；users.feature_perms 不再使用 TEXT DEFAULT，SQLite 继续保留默认值，MySQL 改为普通 TEXT，老站补列逻辑同步按驱动区分；现在 MySQL 与 SQLite 两种数据库配置均可正常安装。"
        . "139. 升级到 v6.25.225：扩展中心的蓝奏云入口新增“本机账号簿”，账号可继续本机保存，密码可选仅本机保存并按登录用户隔离；密码使用浏览器 WebCrypto AES-GCM 加密后存放，密钥保存在本机 IndexedDB，不上传服务器、不跨设备同步；页面提供复制账号、复制密码和清除按钮，不会自动登录第三方网站；未使用 HTTPS 或浏览器不支持 WebCrypto 时会明确提示，不降级为明文保存。"
        . "140. 升级到 v6.25.226：后台“F12 / 右键自动刷新”在未显式设置过的站点默认关闭；发帖标题改为可选，留空也能正常发布；无标题帖子在首页用与有标题帖子同样高度的卡片显示正文开头，进入详情页才展示全文，详情页标题与通知、列表、搜索、后台文章列表等位置统一回退为正文摘要；阅读记录弹窗移出带入场动画 transform 的正文容器，固定在视口上方显示，长帖向下滚动时不会再跑到正文中间。"
        . "141. 升级到 v6.25.227：后台升级记录里的目标版本如果已经是当前站点版本，不再显示“升级”按钮，改为显示“当前版本”，避免已升级的站点继续看到可点击的升级入口；有新版本时仍按原逻辑显示升级按钮。"
        . "142. 升级到 v6.25.228：主机状态改为仅超级管理员可见可用；普通管理员后台菜单不再显示“主机状态”入口，直接访问页面或调用主机状态 AJAX 都会被拦回仪表盘并提示“主机状态仅对超级管理员开放”；超级管理员查看和复制部署信息的权限保持不变。"
        . "143. 升级到 v6.25.229：修复 mlcs.xnn.lol 后台在线升级一直显示“升级源不可用”的问题；旧源码站 csrc.954377.xyz 已失联，站点首次升级后自动把升级源切到本站可用的 upgrade_meta 接口并清掉旧缓存，后台改为显示“当前站点就是升级源站点 / 已是最新”，不再出现 Could not resolve host；该切换只对 mlcs.xnn.lol 生效，其他站点升级源保持不变。"
        . "144. 升级到 v6.25.230：修复部分 MySQL 站点在线升级到 226 时在并包阶段报 SQLSTATE[22001]、1406 Data too long for column 'svalue' 并回滚的问题；升级历史改为完整记录写入 storage/upgrades/history.json，数据库 settings.svalue 只保留精简副本，避免二十条长更新说明累计超过字段上限；旧站点已有历史会自动读取，完整更新内容继续在升级记录里展示，数据库兜底写入失败也不会再中断升级。"
        . "145. 升级到 v6.25.231：修复部分 MySQL 站点在线升级到 229 时在并包阶段报 SQLSTATE[HY000]、1366 Incorrect string value for column 'svalue' 并回滚的问题；数据库里的升级历史精简副本改为 ASCII 转义的 JSON，中文和表情符号不会再因数据表字符集不支持四字节字符而写入失败，读取时会自动还原，完整内容仍从 history.json 读取。"
        . "146. 升级到 v6.25.232：后台站点信息新增标签页图标（favicon）设置，支持拖拽上传 ICO / PNG / SVG / WebP 图标，也可直接填写网络图标链接；上传区带浏览器标签页实时预览和已选择文件提示，支持一键清除并恢复跟随站点 Logo，前台所有页面的浏览器标签页会优先显示自定义图标。";
    $custom = trim((string) setting('upgrade_channel_changelog', ''));
    if ($custom !== '' && mb_strlen($custom, 'UTF-8') >= 100) {
        return $builtin . "\n\n【升级源补充说明】\n" . $custom;
    }
    return $builtin;
}

function source_release_zip_version($zipPath, $forUpgrade = false)
{
    if (!is_file($zipPath) || !class_exists('ZipArchive')) { return ''; }
    $zip = new ZipArchive();
    if ($zip->open($zipPath) !== true) { return ''; }
    $name = $forUpgrade ? 'komorebi-upgrade.json' : 'komorebi-source.json';
    $raw = (string) $zip->getFromName($name);
    $zip->close();
    $data = json_decode($raw, true);
    if (!is_array($data)) { return ''; }
    $type = $forUpgrade ? 'komorebi-upgrade' : 'komorebi-source';
    if (($data['type'] ?? '') !== $type) { return ''; }
    return trim((string) ($data['version'] ?? ''));
}

function source_release_php_cli()
{
    // 虚拟主机常见 PHP_BINARY 指向 php-fpm，不能执行 -l / CLI 脚本；这里只接受真正的 CLI。
    static $cli = null;
    if ($cli !== null) {
        return $cli;
    }
    $cli = '';
    if (!function_exists('exec')) {
        return $cli;
    }
    $candidates = [];
    if (PHP_SAPI === 'cli') {
        $candidates[] = PHP_BINARY;
    }
    if (defined('PHP_BINDIR')) {
        $candidates[] = rtrim((string) PHP_BINDIR, '/\\') . '/php';
    }
    $candidates[] = '/usr/bin/php';
    $candidates[] = '/usr/local/bin/php';
    foreach (array_unique($candidates) as $candidate) {
        if ($candidate === '' || !@is_file($candidate) || !@is_executable($candidate)) {
            continue;
        }
        $out = [];
        $code = 0;
        @exec(escapeshellarg($candidate) . ' -r ' . escapeshellarg('echo PHP_SAPI;') . ' 2>&1', $out, $code);
        if ($code === 0 && trim(implode('', $out)) === 'cli') {
            $cli = $candidate;
            break;
        }
    }
    return $cli;
}

function source_release_sync_install_template()
{
    // 源码中心打包前，把当前站点已经验证过的安装页同步回受保护的安装模板。
    // 避免只更新了根目录 install.php、模板仍是旧版，导致下载到的源码又出现 10 秒等待。
    $rootInstaller = APP_ROOT . '/install.php';
    $template = APP_ROOT . '/inc/install_dist.php';
    if (!is_file($rootInstaller)) {
        return;
    }
    $code = (string) @file_get_contents($rootInstaller);
    if (strpos($code, '木漏茶室论坛 · 安装向导') === false || strpos($code, '$agreeRemaining = 0;') === false) {
        return;
    }
    if (!is_file($template)) {
        @copy($rootInstaller, $template);
        return;
    }
    $rootTime = (int) @filemtime($rootInstaller);
    $templateTime = (int) @filemtime($template);
    // 模板比根目录新（例如刚升级过）时，用模板还原根目录安装页；
    // 根目录比模板新时，再把站长验证过的根页同步回模板。
    if ($templateTime > $rootTime) {
        @copy($template, $rootInstaller);
    } elseif ($rootTime > $templateTime
        && !hash_equals((string) @sha1_file($rootInstaller), (string) @sha1_file($template))) {
        @copy($rootInstaller, $template);
    }
}

function source_release_archive_path($force = false, $for_upgrade = false)
{
    if (!class_exists('ZipArchive')) {
        throw new Exception('当前 PHP 未启用 zip 扩展，无法生成源码包');
    }
    if (!$for_upgrade) {
        source_release_sync_install_template();
    }
    list($zipPath, $metaPath) = source_release_cache_paths($for_upgrade);
    $latest = source_release_latest_mtime($for_upgrade);
    $cachedVersion = source_release_zip_version($zipPath, $for_upgrade);
    if (!$force && is_file($zipPath) && is_file($metaPath) && filemtime($zipPath) >= $latest
        && $cachedVersion !== '' && $cachedVersion === APP_VERSION) {
        $meta = json_decode((string) @file_get_contents($metaPath), true);
        if (is_array($meta) && !empty($meta['verified'])
            && (int) ($meta['total_size'] ?? 0) === (int) @filesize($zipPath)
            && (string) ($meta['sha256'] ?? '') !== ''
            && hash_equals((string) $meta['sha256'], (string) @hash_file('sha256', $zipPath))) {
            return $zipPath;
        }
    }

    // 先复制到独立构建目录，只纳入核心源码目录；插件包、上传文件、运行数据永远不会进入源码 ZIP。
    $buildDir = APP_ROOT . '/storage/tmp/source-build-' . bin2hex(random_bytes(8));
    $removeTree = function ($dir) use (&$removeTree) {
        if (!is_dir($dir)) {
            return;
        }
        $items = new RecursiveIteratorIterator(
            new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
            RecursiveIteratorIterator::CHILD_FIRST
        );
        foreach ($items as $item) {
            if ($item->isDir()) {
                @rmdir($item->getPathname());
            } else {
                @unlink($item->getPathname());
            }
        }
        @rmdir($dir);
    };
    $copy = function ($src, $dst) {
        if (!is_dir(dirname($dst)) && !@mkdir(dirname($dst), 0775, true) && !is_dir(dirname($dst))) {
            throw new Exception('无法创建源码包构建目录');
        }
        if (!@copy($src, $dst)) {
            throw new Exception('无法复制源码文件：' . basename($src));
        }
    };

    try {
        if (!is_dir($buildDir) && !@mkdir($buildDir, 0775, true) && !is_dir($buildDir)) {
            throw new Exception('无法创建源码包构建目录');
        }

        // 根目录只收录明确的核心入口，避免升级残留、临时文件或误放的引导文件进入源码包。
        foreach (['index.php', 'api.php', 'manifest.php', 'rss.php', 'sitemap.php', 'sw.js'] as $rel) {
            if (is_file(APP_ROOT . '/' . $rel) && source_release_path_allowed($rel, $for_upgrade)) {
                $copy(APP_ROOT . '/' . $rel, $buildDir . '/' . $rel);
            }
        }

        // 只遍历核心目录，不扫描 storage、uploads、data、plugins 等运行目录。
        foreach (['admin', 'assets', 'inc', 'pages', 'lang'] as $dir) {
            $fullDir = APP_ROOT . '/' . $dir;
            if (!is_dir($fullDir)) {
                continue;
            }
            $iterator = new RecursiveIteratorIterator(
                new RecursiveDirectoryIterator($fullDir, FilesystemIterator::SKIP_DOTS),
                RecursiveIteratorIterator::SELF_FIRST
            );
            foreach ($iterator as $item) {
                $rel = str_replace('\\', '/', substr($item->getPathname(), strlen(APP_ROOT) + 1));
                if (!source_release_path_allowed($rel, $for_upgrade)) {
                    continue;
                }
                $dst = $buildDir . '/' . $rel;
                if ($item->isDir()) {
                    if (!is_dir($dst) && !@mkdir($dst, 0775, true) && !is_dir($dst)) {
                        throw new Exception('无法创建源码包子目录：' . $rel);
                    }
                } else {
                    if ($item->getSize() > 30 * 1024 * 1024) {
                        continue;
                    }
                    $copy($item->getPathname(), $dst);
                }
            }
        }

        if ($for_upgrade) {
            $manifest = [
                'type' => 'komorebi-upgrade',
                'name' => '木漏茶室 v' . APP_VERSION . ' 系统升级包',
                'version' => APP_VERSION,
                'app_min' => '6.0.0',
                'app_max' => APP_VERSION,
                'php_min' => '7.4',
                'php_max' => '',
                'changelog' => source_release_upgrade_changelog(),
                'delete' => ['inc/source_package_doctor.php'],
                'published_at' => now(),
            ];
            $manifestFile = 'komorebi-upgrade.json';
        } else {
            $manifest = [
                'type' => 'komorebi-source',
                'name' => '木漏茶室 v' . APP_VERSION . ' 完整源码包',
                'version' => APP_VERSION,
                'php_min' => '7.4',
                'php_max' => '8.3',
                'entry' => 'install.php',
                'built_at' => now(),
            ];
            $manifestFile = 'komorebi-source.json';
        }
        file_put_contents($buildDir . '/' . $manifestFile, json_encode($manifest, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT));

        if (!$for_upgrade) {
            // 完整源码包必须使用受保护的安装模板，不能把当前站点已安装的 install.php 带进去。
            $installTemplate = APP_ROOT . '/inc/install_dist.php';
            if (!is_file($installTemplate)) {
                $installTemplate = APP_ROOT . '/install.php';
            }
            if (!is_file($installTemplate)) {
                $quarantined = glob(APP_ROOT . '/storage/security_guard/quarantine/install.php.disabled.*');
                if (is_array($quarantined) && $quarantined) {
                    rsort($quarantined, SORT_STRING);
                    foreach ($quarantined as $candidate) {
                        if (is_file($candidate)) { $installTemplate = $candidate; break; }
                    }
                }
            }
            if (!is_file($installTemplate)) {
                throw new Exception('缺少安装程序模板（inc/install_dist.php 或 install.php），无法生成可安装源码包');
            }
            $installCode = (string) file_get_contents($installTemplate);
            if (strpos($installCode, '木漏茶室论坛 · 安装向导') === false) {
                throw new Exception('安装程序模板内容异常，已停止生成源码包');
            }
            if (strpos($installCode, '$agreeRemaining = 0;') === false) {
                throw new Exception('安装程序模板仍含 10 秒等待，已停止生成源码包');
            }
            file_put_contents($buildDir . '/install.php', $installCode);
            if (!is_file($buildDir . '/inc/install_dist.php')) {
                $copy($installTemplate, $buildDir . '/inc/install_dist.php');
            }

            foreach (['data', 'uploads', 'storage', 'storage/tmp', 'storage/cache'] as $dir) {
                if (!is_dir($buildDir . '/' . $dir) && !@mkdir($buildDir . '/' . $dir, 0777, true) && !is_dir($buildDir . '/' . $dir)) {
                    throw new Exception('无法创建源码包运行目录：' . $dir);
                }
            }
            $guardFiles = [
                'data/.htaccess' => "# 木漏茶室运行数据目录，禁止直接访问
"
                    . "<IfModule mod_authz_core.c>
  Require all denied
</IfModule>
"
                    . "<IfModule !mod_authz_core.c>
  Order allow,deny
  Deny from all
</IfModule>
",
                'storage/.htaccess' => "# 木漏茶室缓存与升级备份目录，禁止直接访问
"
                    . "<IfModule mod_authz_core.c>
  Require all denied
</IfModule>
"
                    . "<IfModule !mod_authz_core.c>
  Order allow,deny
  Deny from all
</IfModule>
",
                'uploads/.htaccess' => "# 上传目录禁止执行 PHP
"
                    . "<FilesMatch \"\.(php|phtml|phar|php[0-9])$\">
"
                    . "  <IfModule mod_authz_core.c>
    Require all denied
  </IfModule>
"
                    . "  <IfModule !mod_authz_core.c>
    Order allow,deny
    Deny from all
  </IfModule>
"
                    . "</FilesMatch>
",
            ];
            foreach ($guardFiles as $name => $content) {
                file_put_contents($buildDir . '/' . $name, $content);
            }
            // 完整源码包始终使用兼容版根 .htaccess，避免目标虚拟主机因 AllowOverride 限制直接 500。
            file_put_contents($buildDir . '/.htaccess', source_release_portable_htaccess());

            $origin = source_deploy_origin_manifest();
            $originCode = "<?php\n"
                . "// 由木漏茶室源码下载中心生成，用于安装完成后回传部署统计。\n"
                . "return " . var_export($origin, true) . ";\n";
            file_put_contents($buildDir . '/inc/deploy_origin.php', $originCode);
        }

        // 1) PHP 语法自检：有 CLI 时逐文件检查；虚拟主机没有 CLI 时退化为静态文件完整性检查。
        $phpCli = source_release_php_cli();
        if ($phpCli !== '') {
            $lintCmd = 'find ' . escapeshellarg($buildDir) . ' -type f -name "*.php" -print0 | xargs -0 -n1 -P 8 '
                . escapeshellarg($phpCli) . ' -l 2>&1';
            $lintOut = [];
            $lintCode = 0;
            @exec($lintCmd, $lintOut, $lintCode);
            if ($lintCode === 127) {
                // 极简环境没有 xargs 时退回逐个检查。
                $lintOut = [];
                $lintCode = 0;
                $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($buildDir, FilesystemIterator::SKIP_DOTS));
                foreach ($iterator as $file) {
                    if ($file->isFile() && strtolower($file->getExtension()) === 'php') {
                        $oneOut = [];
                        $oneCode = 0;
                        @exec(escapeshellarg($phpCli) . ' -l ' . escapeshellarg($file->getPathname()) . ' 2>&1', $oneOut, $oneCode);
                        if ($oneCode !== 0) {
                            $lintCode = $oneCode;
                            $lintOut = array_merge($lintOut, $oneOut);
                            break;
                        }
                    }
                }
            }
            if ($lintCode !== 0 || preg_match('/(Parse error|Errors parsing)/i', implode("\n", $lintOut))) {
                throw new Exception('源码包 PHP 语法校验失败：' . substr(implode(' ', $lintOut), 0, 320));
            }
        } else {
            // 没有 CLI 时至少验证核心模块存在、PHP 文件未为空/未丢开标签，避免生成明显残缺包。
            foreach (['index.php', 'inc/bootstrap.php', 'inc/compat.php', 'inc/schema.php', 'inc/source_release.php', 'inc/source_deploy.php', 'inc/plugin_mall.php', 'pages/source.php'] as $rel) {
                if (!is_file($buildDir . '/' . $rel) || filesize($buildDir . '/' . $rel) < 20) {
                    throw new Exception('源码包核心文件缺失或为空：' . $rel);
                }
            }
            $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($buildDir, FilesystemIterator::SKIP_DOTS));
            foreach ($iterator as $file) {
                if ($file->isFile() && strtolower($file->getExtension()) === 'php') {
                    $head = (string) @file_get_contents($file->getPathname(), false, null, 0, 32);
                    if (strpos($head, '<?php') === false && strpos($head, '<?=') === false) {
                        throw new Exception('源码包 PHP 文件缺少开标签：' . substr($file->getPathname(), strlen($buildDir) + 1));
                    }
                }
            }
        }

        // 2) 安装后运行自检：复制当前 SQLite 数据到临时目录，实际启动 index.php。
        if (!$for_upgrade && $phpCli !== '' && is_file(APP_ROOT . '/config.php')) {
            $siteConfig = include APP_ROOT . '/config.php';
            if (is_array($siteConfig) && !empty($siteConfig['installed'])
                && (string) ($siteConfig['driver'] ?? '') === 'sqlite'
                && is_file((string) ($siteConfig['sqlite_path'] ?? ''))) {
                $verifyDb = $buildDir . '/data/verify.sqlite';
                if (!@copy((string) $siteConfig['sqlite_path'], $verifyDb)) {
                    throw new Exception('源码包运行自检无法复制测试数据库');
                }
                $verifyConfig = $siteConfig;
                $verifyConfig['sqlite_path'] = $verifyDb;
                $configCode = "<?php\nreturn " . var_export($verifyConfig, true) . ";\n";
                file_put_contents($buildDir . '/config.php', $configCode);
                $oldCwd = getcwd();
                @chdir($buildDir);
                $output = [];
                $code = 0;
                @exec(escapeshellarg($phpCli) . ' -d display_errors=1 index.php 2>&1', $output, $code);
                @chdir($oldCwd);
                $text = implode("\n", $output);
                if ($code !== 0 || strpos($text, '<!DOCTYPE html') === false
                    || preg_match('/(Fatal error|Parse error|Uncaught Error|Uncaught Exception)/i', $text)) {
                    throw new Exception('源码包运行自检失败：安装后的首页无法正常输出 ' . substr($text, 0, 300));
                }
                // 源码下载中心依赖的核心模块必须可加载；页面级自检不做，避免自检时递归打包。
                $sourceOutput = [];
                $sourceCode = 0;
                $sourceProbe = 'require "inc/source_release.php"; require "inc/source_deploy.php"; require "inc/plugin_mall.php"; echo "source-module-ok";';
                @exec(escapeshellarg($phpCli) . ' -d display_errors=1 -r ' . escapeshellarg($sourceProbe) . ' 2>&1', $sourceOutput, $sourceCode);
                $sourceText = implode("\n", $sourceOutput);
                if ($sourceCode !== 0 || strpos($sourceText, 'source-module-ok') === false
                    || preg_match('/(Fatal error|Parse error|Uncaught Error|Uncaught Exception|Failed opening required)/i', $sourceText)) {
                    throw new Exception('源码包运行自检失败：源码下载中心核心模块无法加载 ' . substr($sourceText, 0, 300));
                }
                @unlink($buildDir . '/config.php');
                @unlink($verifyDb);
            }
        }

        // 运行自检可能在 data/storage 下写入日志或回传文件；打包前清空整个运行目录，只保留防护文件和空目录。
        foreach (['data', 'uploads', 'storage'] as $runtimeDir) {
            $runtimePath = $buildDir . '/' . $runtimeDir;
            if (!is_dir($runtimePath)) {
                continue;
            }
            $runtimeIterator = new RecursiveIteratorIterator(
                new RecursiveDirectoryIterator($runtimePath, FilesystemIterator::SKIP_DOTS),
                RecursiveIteratorIterator::CHILD_FIRST
            );
            foreach ($runtimeIterator as $runtimeItem) {
                if ($runtimeItem->isDir()) {
                    @rmdir($runtimeItem->getPathname());
                } elseif (basename($runtimeItem->getPathname()) !== '.htaccess') {
                    @unlink($runtimeItem->getPathname());
                }
            }
        }

        $tmp = $zipPath . '.tmp-' . bin2hex(random_bytes(5));
        $zip = new ZipArchive();
        if ($zip->open($tmp, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
            throw new Exception('无法创建源码升级包');
        }
        $count = 0;
        $total = 0;
        $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($buildDir, FilesystemIterator::SKIP_DOTS));
        foreach ($iterator as $file) {
            if (!$file->isFile()) {
                continue;
            }
            $rel = str_replace('\\', '/', substr($file->getPathname(), strlen($buildDir) + 1));
            $zip->addFile($file->getPathname(), $rel);
            $count++;
            $total += (int) $file->getSize();
        }
        // 空目录不会进入 ZIP，显式补入可写运行目录。
        if (!$for_upgrade) {
            foreach (['data', 'uploads', 'storage', 'storage/tmp', 'storage/cache'] as $dir) {
                if ($zip->locateName($dir . '/') === false && $zip->locateName($dir) === false) {
                    $zip->addEmptyDir($dir);
                }
            }
        }
        $zip->close();

        // 3) ZIP 内容自检：禁止运行数据、插件包和配置文件进入源码包。
        $zipCheck = new ZipArchive();
        if ($zipCheck->open($tmp) !== true) {
            throw new Exception('源码包自检无法打开 ZIP');
        }
        $bad = '';
        for ($i = 0; $i < $zipCheck->numFiles; $i++) {
            $name = (string) $zipCheck->getNameIndex($i);
            $name = str_replace('\\', '/', $name);
            if ($name === '' || strpos($name, '..') !== false) {
                $bad = $name;
                break;
            }
            $parts = explode('/', trim($name, '/'));
            foreach ($parts as $part) {
                if (in_array($part, source_release_excluded_dirs(), true) && !in_array($part, ['storage', 'uploads', 'data'], true)) {
                    $bad = $name;
                    break 2;
                }
            }
            $base = basename($name);
            if ($base === 'config.php' || (!$for_upgrade && $base === 'komorebi-upgrade.json')) {
                $bad = $name;
                break;
            }
        }
        $required = $for_upgrade
            ? ['index.php', 'inc/bootstrap.php', 'inc/compat.php', 'inc/source_release.php', 'pages/source.php', 'komorebi-upgrade.json']
            : ['index.php', 'inc/bootstrap.php', 'inc/compat.php', 'inc/schema.php', 'inc/source_release.php', 'inc/source_deploy.php', 'pages/source.php', 'install.php', 'inc/install_dist.php', 'komorebi-source.json'];
        foreach ($required as $requiredName) {
            if ($zipCheck->locateName($requiredName) === false) {
                $bad = '缺少必需文件 ' . $requiredName;
                break;
            }
        }
        $zipCheck->close();
        if ($bad !== '') {
            @unlink($tmp);
            throw new Exception('源码包内容自检失败：' . $bad);
        }

        @rename($tmp, $zipPath);

        $meta = [
            'version' => APP_VERSION,
            'file_count' => $count,
            'total_size' => (int) @filesize($zipPath),
            'sha256' => (string) @hash_file('sha256', $zipPath),
            'built_at' => now(),
            'verified' => true,
            'verify_note' => '已通过 PHP 语法、ZIP 隔离、安装后首页与源码中心模块自检',
            'changelog' => $manifest['changelog'] ?? '',
            'name' => $manifest['name'],
        ];
        @file_put_contents($metaPath, json_encode($meta, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT), LOCK_EX);
        return $zipPath;
    } finally {
        $removeTree($buildDir);
    }
}

/** 独立发布包目录：源码下载中心只对外提供这里冻结的 ZIP，不再实时读取线上工作区。 */
function source_release_snapshot_dir()
{
    return APP_ROOT . '/storage/releases';
}

function source_release_snapshot_pointer_path()
{
    return source_release_snapshot_dir() . '/latest.json';
}

function source_release_snapshot_current($verify = false)
{
    $pointer = source_release_snapshot_pointer_path();
    $meta = json_decode((string) @file_get_contents($pointer), true);
    if (!is_array($meta) || (string) ($meta['version'] ?? '') !== APP_VERSION) {
        return null;
    }
    $path = (string) ($meta['path'] ?? '');
    if ($path === '' || !is_file($path) || (int) @filesize($path) <= 0) {
        return null;
    }
    if ((int) ($meta['total_size'] ?? 0) !== (int) @filesize($path)) {
        return null;
    }
    if ($verify && (string) ($meta['sha256'] ?? '') !== '' && !hash_equals((string) $meta['sha256'], (string) @hash_file('sha256', $path))) {
        return null;
    }
    return $meta;
}

/**
 * 把当前版本源码冻结成独立发布包，并原子更新 latest.json。
 * 源码下载中心只读取该发布包；线上工作区后续改动不会自动混进下载包。
 */
function source_release_snapshot_publish($force = false)
{
    $dir = source_release_snapshot_dir();
    if (!is_dir($dir) && !@mkdir($dir, 0775, true) && !is_dir($dir)) {
        throw new Exception('无法创建源码发布目录');
    }
    $lockPath = $dir . '/.publish.lock';
    $lock = @fopen($lockPath, 'c');
    if (!$lock) {
        throw new Exception('无法打开源码发布锁');
    }
    try {
        if (!flock($lock, LOCK_EX)) {
            throw new Exception('源码发布锁占用中');
        }
        if (!$force) {
            $current = source_release_snapshot_current(true);
            if (is_array($current)) { return $current; }
        }
        $zipPath = source_release_archive_path(true, false);
        $name = 'komorebi-forum-v' . APP_VERSION . '-source.zip';
        $target = $dir . '/' . $name;
        $tmp = $target . '.tmp-' . bin2hex(random_bytes(6));
        if (!@copy($zipPath, $tmp)) {
            throw new Exception('无法写入源码发布包');
        }
        @chmod($tmp, 0644);
        if (!@rename($tmp, $target)) {
            @unlink($tmp);
            throw new Exception('无法更新源码发布包');
        }
        $zip = new ZipArchive();
        $count = 0;
        if ($zip->open($target) === true) {
            $count = (int) $zip->numFiles;
            $zip->close();
        }
        $meta = [
            'version' => APP_VERSION,
            'name' => '木漏茶室 v' . APP_VERSION . ' 完整源码包',
            'file' => $name,
            'path' => $target,
            'total_size' => (int) @filesize($target),
            'file_count' => $count,
            'sha256' => (string) @hash_file('sha256', $target),
            'published_at' => now(),
            'verified' => true,
        ];
        $tmpJson = source_release_snapshot_pointer_path() . '.tmp-' . bin2hex(random_bytes(6));
        file_put_contents($tmpJson, json_encode($meta, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT), LOCK_EX);
        if (!@rename($tmpJson, source_release_snapshot_pointer_path())) {
            @unlink($tmpJson);
            throw new Exception('无法更新源码发布指针');
        }
        return $meta;
    } finally {
        @flock($lock, LOCK_UN);
        @fclose($lock);
    }
}

function source_release_snapshot_ensure()
{
    $current = source_release_snapshot_current(true);
    return is_array($current) ? $current : source_release_snapshot_publish(false);
}

function source_release_snapshot_rel_allowed($rel)
{
    $rel = str_replace('\\', '/', (string) $rel);
    if ($rel === '' || strpos($rel, '..') !== false) { return false; }
    $parts = explode('/', $rel);
    foreach (['data', 'uploads', 'storage', 'plugins', '.git', '.idea', 'node_modules', 'system'] as $blocked) {
        if (in_array(strtolower($parts[0]), [$blocked], true)) { return false; }
    }
    if (in_array(basename($rel), ['config.php', 'komorebi-upgrade.json', 'install_dist.php'], true)) { return false; }
    return true;
}

function source_release_snapshot_tree(array $meta)
{
    $tree = [];
    $zip = new ZipArchive();
    if ($zip->open((string) $meta['path']) !== true) { return $tree; }
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $stat = $zip->statIndex($i);
        if (!is_array($stat)) { continue; }
        $rel = str_replace('\\', '/', (string) ($stat['name'] ?? ''));
        if (!source_release_snapshot_rel_allowed($rel)) { continue; }
        $isDir = substr($rel, -1) === '/';
        $tree[] = [
            'rel' => rtrim($rel, '/'),
            'dir' => $isDir,
            'size' => $isDir ? 0 : (int) ($stat['size'] ?? 0),
            'depth' => substr_count(rtrim($rel, '/'), '/'),
        ];
        if (count($tree) > 4000) { break; }
    }
    $zip->close();
    usort($tree, function ($a, $b) { return strnatcasecmp($a['rel'], $b['rel']); });
    return $tree;
}

function source_release_snapshot_entry_size(array $meta, $rel)
{
    $zip = new ZipArchive();
    if ($zip->open((string) $meta['path']) !== true) { return -1; }
    $idx = $zip->locateName($rel);
    $size = $idx === false ? -1 : (int) $zip->statIndex($idx)['size'];
    $zip->close();
    return $size;
}

function source_release_snapshot_read(array $meta, $rel)
{
    $zip = new ZipArchive();
    if ($zip->open((string) $meta['path']) !== true) { return false; }
    $idx = $zip->locateName($rel);
    $data = $idx === false ? false : $zip->getFromIndex($idx);
    $zip->close();
    return $data;
}

function source_release_snapshot_stream(array $meta, $rel)
{
    $zip = new ZipArchive();
    if ($zip->open((string) $meta['path']) !== true) { return false; }
    $idx = $zip->locateName($rel);
    if ($idx === false) { $zip->close(); return false; }
    $stream = $zip->getStream($rel);
    if (!$stream) { $zip->close(); return false; }
    return ['stream' => $stream, 'zip' => $zip, 'size' => (int) $zip->statIndex($idx)['size']];
}

function source_release_meta($for_upgrade = false)
{
    $zipPath = source_release_archive_path(false, $for_upgrade);
    list(, $metaPath) = source_release_cache_paths($for_upgrade);
    $meta = json_decode((string) @file_get_contents($metaPath), true);
    if (!is_array($meta)) {
        throw new Exception('源码升级包元数据缺失');
    }
    $meta['package_url'] = full_url(page_url('source', ['act' => 'upgrade_package']));
    $meta['package_url'] = str_replace('&amp;', '&', $meta['package_url']);
    $meta['published_at'] = date('Y-m-d H:i:s', (int) @filemtime($zipPath));
    $meta['app_min'] = '6.0.0';
    $meta['php_min'] = '7.4';
    return $meta;
}
