okooooooo/lsky-pro-docker
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
133 Commits 1 Branch 0 Tags
db0543359668cec7f8b23b86e8a1af940b0bca2e
Commit Graph
10 Commits
Author SHA1 Message Date
mole404 5773d432fb feat(细节二): 弹窗观感统一 + 三个旧弹窗换新装 + 返回键间距真修好 + 手机弹窗高度适配 + 上传全部按队列显隐补漏 
①弹窗：
- 「移动到相册」弹窗：相册列表下那行「我也是有底线的~」（无限加载的哨兵）按弹窗 id 收窄隐藏，
  footer 多余的横线（border-t）去掉；列表仍可滚动、触底仍会继续加载相册。
- 两个新弹窗排版统一：标题 16px semibold、标签 13px / 值 14px、行高宽松、字段行装进一张
  divide-y 卡片等距排列；只用设计令牌色（亮/暗自动正确）。
- 右键菜单的「删除」「重命名」「设置权限」三个 sweetalert2 确认框换成同一套观感
  （12px 圆角、16px 标题、13/14px 正文、按钮 = ls-btn/ls-btn-primary/ls-btn-danger、
  输入框 = ls-input）；JS 一行未改，确认/取消/校验流程原样。皮肤不用 !important，
  靠 html 前缀提权重压过 swal2 运行时注入的样式。
②「＜返回」间距真因（上一轮判断错了）：标记里那个 mr-1 工具类**从未被 Tailwind 生成**
  （tailwind.config.js 的 content 只扫 blade，扫不到 resources/js 里的类名），图标 margin-right
  实测 0px；且 context-js.css 在页面里没有版本串、iOS 会吃缓存。修法：规则同时写进
  context-js.less 与 common.less（后者由 layout 用 ?v=assetVersion() 引入，必然重新拉取）。
  真触摸复现实测：图标右缘→文字左缘 = 7px（修前 0px），旧缓存 CSS 情形下同样 7px。
③手机弹窗底部空一块：共用组件 modal.blade.php 的容器改 h-[100dvh]、内层保留 min-h-screen 兜底
  （CSSOM 实测 dvh 声明排在 vh 之后，支持则用 dvh、不支持自动退回 100vh）；桌面端逐项实测
  与改前完全一致（容器/卡片高度、居中位置、页面可滚动高度均未变）。
④「上传全部」显隐补漏：漏在「逐张手动删除」那条路径上（走的是另一个函数），现已接上，
  共覆盖 入队/状态变化/自动清除/逐张删除/一键清空 五条路径；文案去掉「同时」二字。
  另修一处会让构建失败的坑：context-js.less 注释里写了 resources/views/**/*.blade.php，
  其中的 **/ 提前闭合了 /* */ 注释 → LESS "Unrecognised input"（已改写该句）。
验证：longpress 79/79、sidebar 6/6、images-modal 35/35、images-modal-dom 35/35、
swal-theme 48/48（新增，含 jsdom 复刻注入顺序验证皮肤真生效 + 一条反证）；php -l + view:cache
exit 0；重建产物核对 .text-[16px]/.h-16/.transition-colors/.divide-y/.min-h-[100dvh]/.h-[100dvh]/
#image-movements-modal/.swal2-popup 全部存在；钉住的 context-js.js 两份 md5 仍 = b916555a…，
images.blade.php md5 已同步为 00f38dbf…，补丁重生成 2578 行且字节级验证通过。
 2026-09-29 15:41:13 +08:00
mole404 30862d602f feat(图片页 1/2): 详细信息与移动到相册改用居中卡片弹窗、二级菜单返回键加空隙 
#1 「详细信息」「移动到相册」弃用右侧抽屉，改复用 x-modal 的居中卡片弹窗（新增
   #image-detail-modal / #image-movements-modal 及其内容容器，三个新模板）：
   - 详细信息：顶部小缩略图 + dl 行式布局（<640px 自动上下堆叠），标签 13px / 值 14px /
     leading-6；字段顺序按老师要求 = 上传时间 → 图片名称 → 其余 10 项（原抽屉里 12 项一个没删，
     只换位置）；弹窗内不放复制链接/下载/删除（单一职责）。
   - 移动到相册：单选列表（当前所在相册带「当前」徽标）、行 min-h-[44px]（手机点击区）、
     未选中时「移动」disabled；请求逐字沿用原实现（同 route user.images.movement、同 payload）；
     点「移动」才提交，成功关弹窗 + resetImages + toastr。
   - 右侧抽屉保留本职（工具栏「相册列表」入口、自带无限加载、相册增删改查）原样不动；
     桌面右键、手机长按、工具栏三个入口都走新弹窗。
#2 二级菜单「＜返回」箭头与文字间距：context-js.less 加 7px（选择器权重压过标记自带 mr-1）。

关键：本轮的 images.blade.php 改动不属于补丁文件（context-js.js 两份 md5 全程 = Dockerfile 钉住的
b916555a…，未动），Dockerfile 的 images_blade_md5 已随自证同步更新为 27bb3f20…，补丁重生成 2563 行
且「打回上游 = 仓库文件」字节一致。

验证：四套回归我自己跑过 —— longpress 79/79、sidebar 6/6、images-modal 35/35（静态契约：
12 字段与顺序 / 13-14px 字号 / min-h-44 / 请求不变 / 无硬编码色 / 返回键 7px / 补丁 md5 未变）、
images-modal-dom 35/35（jsdom 真跑页面内联脚本：点菜单 → 内容进新弹窗、抽屉全程为空且未被推开、
单选互斥、点「移动」实发 {selected,id,album_id} 后关弹窗、抽屉路径仍能筛选相册）；
php -l + view:cache exit 0；重建产物含 text-[13px]/[14px]/min-h-[44px]/max-h-[50vh]/ls-badge 等。
 2026-09-29 14:34:25 +08:00
mole404 6e1306d77b fix(手机/桌面体验): 头像居中、二级菜单就地展开防误触、恢复根滚动、策略卡桌面卡内滚动、小字号抬一档 
① 头像在圆形容器里偏左：按钮 h-10 pl-1 pr-2 左右留白不对称（左 4px / 右 8px），
   且 <640px 用户名隐藏后只剩纯圆钮 → 改成 h-10 w-10 p-0 justify-center，
   ≥640px 用 sm:w-auto sm:pl-1 sm:pr-2 保持桌面胶囊形态不变。
   实测：手机 390px 下头像左右留白各 6.0px，偏差 0.0px（原 4/8）。

② 二级菜单重合 + 误触：真机触摸带粘滞 :hover，手指一按「复制链接」二级菜单就先弹出来
   （旧版还因侧向定位被 clamp 成压在主菜单上），抬手那发合成 click 直接落在菜单项上，
   实测被判成「Url」并立刻复制。改为：
   - 手机不再侧开二级菜单，改成**就地替换**（面板原地换成 Url/HTML/BBCode… + 顶部「返回」）；
   - touchstart 即切换并「武装」防误触：判据是**同一根手指那一发**（不是时长），
     按多久（实测按住 700ms）抬手都不会误触；
   - 守卫顺序：父项处理 → 守卫 → 「返回」；桌面仍保留右侧二级菜单 + 视口钳制。
   真触摸（CDP Input.dispatchTouchEvent + CSS.forcePseudoState 模拟粘滞 hover）复现：
   改前二级菜单被挤出屏幕外 116px、改后抬手触发动作 = []（什么都没发生）。

③ 手机浏览器地址栏不会自动收起：body 有 overflow-hidden + 内容区是 absolute + overflow-y-auto
   的自滚容器，不是根滚动，浏览器只认根滚动。改成 body 去掉 overflow-hidden、容器回正常流
   （pt-14 pb-14 补顶栏高度）。fixed 侧栏/顶栏不受影响，全仓无 JS 依赖该内部滚动容器。

④ 策略卡桌面端限高 18rem + 卡内滚动（md: 前缀，手机仍是一列全展开、不滚不截断）。

⑤ 小字号统一抬一档（11/11.5→12.5、12.5/13→13.5、13.5→14，14 以上不动），
   受影响页遗留的 text-xs 一并抬到 13.5。
 2026-09-29 04:49:25 +08:00
mole404 c6a02d88c2 fix(菜单/控制台): 菜单与二级菜单做视口边界钳制、控制台信息项整理、版本升到 v3.1 
1) 靠屏幕边缘右键/长按，弹出菜单跑到屏幕外（老师实测手机+电脑都有），二级菜单「复制链接」
   时好时坏 —— 上游只在 above:'auto' 时做过纵向翻转，横向从来没钳制；二级菜单固定往右展开
   (left:100%)，且只在 hover 路径判一次 drop-left，纵向完全没人管，所以「跑不跑」取决于菜单
   开在页面什么高度。
   改法（只动定位，显示/隐藏逻辑一行不碰 —— 长按与点击防护依赖 CSS :hover 的真实可见性）：
   - 新增 clampMenu($dd)：openMenu 定位完统一调用；按视口夹 top/left（主菜单是 body 下绝对定位、
     坐标是页面坐标，所以用 pageXOffset/clientWidth 换算），比视口还高时给 maxHeight + overflow-y:auto
   - 新增 fitSubmenu($li)：hover 与 touch-open 两条路径都调用；每次先从「默认右开、无内联约束」
     重算，避免上次残留；左右翻不够时用内联 left 兜底，纵向用内联 top 回拉，超高转内部滚动
   - 子菜单里原先两处重复的 drop-left 判断合并成这一个函数

2) 控制台「软件信息」：删掉官方网站/使用手册两项，仓库地址改成本仓库
3) 版本号 v3.0 → v3.1（config/app.php 一行）

顺带把「手写资源版本串」这个坑根除：images.blade.php 引入补丁脚本那行的 ?v=ios-longpress4
改成 Utils::assetVersion('js/context-js/context-js.js')，由文件 mtime 自动失效 —— 之前手写
递增忘过一次，浏览器一直吃旧补丁，和上一轮 app.js 那次是同一类问题。

验证：
- 真 jQuery + 真菜单数据搭页面，在右下角右键/长按后量矩形（4 个用例：桌面右下角、桌面下滚 400px、
  手机 iOS 右下角长按、手机下滚 600px）：改后 4/4 主菜单与二级菜单都完整落在视口内（留 8px 边距）；
  **用改前的文件跑同一套用例，每个都报「跑出去 125~140px」** —— 证明用例真能抓到问题、也证明 bug 真实存在
- 暗色实拍：手机主菜单 + 二级菜单完整可见（二级菜单自动翻到左侧），桌面贴边不截断
- jsdom 行为测试 70/70 + 侧栏 6/6；php -l 全仓库；view:cache 全量通过；
  verify_repo.py 全通过（含从 Dockerfile 解析的 16 条护栏）
- 补丁 md5 同步：078a0d98…（两份 context-js.js）、5d1926d2…（images.blade.php），
  .code-revision 里的 md5 一并更新 → fork_sha 变化 → 容器会重新同步进卷
- patches/ios-longpress.patch 已用 tools/diff-vs-upstream.sh 重新生成
 2026-09-29 02:46:20 +08:00
mole404 bc3751b394 feat: 侧栏可折叠 + 上传结果按钮不再压标签 + 文案与对齐调整 
1) 上传结果行：「复制全部 / 清除」原来绝对定位盖在右上角，压住 Markdown with link /
   Thumbnail url 两个标签，且只在 hover 时出现（手机没有 hover，等于点不到）。
   改为与标签栏同一行的左右两段：标签栏 flex-1 自行横向滚动，按钮固定右侧、常显。
   （div 开闭数已核对：与原始一致，只多一层包装）

2) 侧栏品牌块去掉 sm:justify-center → 桌面端 logo + 站点名靠左（手机端本就不居中，无影响）

3) 文案：「设置」→「用户设置」（侧栏导航项、页面大标题「基础设置」、顶栏标题、头像菜单）

4) 桌面端侧栏可折叠（手机端抽屉行为完全不变）：
   - 折叠状态 = <html class="sidebar-collapsed">，由 stores/sidebar.js 管理并记入 localStorage；
     app.blade.php 的首屏内联脚本在样式之前就贴类，不会「先展开再收起」地抖一下
   - 折叠宽度 4rem 只留图标；文字、分组标题、容量区整体隐藏；导航项居中；每项带 title 便于悬停辨认
   - 折叠规则全部在 @media (min-width: 640px) 内，并用选择器权重（html.sidebar-collapsed #app-sidebar）
     压过工具类 sm:w-64 / sm:ml-64 —— 不依赖打包顺序（components 层总在 utilities 之前）
   - 顶栏 ☰ 桌面端也显示：桌面=折叠/展开、手机=抽屉，同一语义；toggleSmart() 按视口分流
   - 我的图片页：图片墙按容器宽度算布局，侧栏一动必须重排 —— 监听 lsky:sidebar-toggled，
     等 300ms 宽度动画结束后 justifiedGallery('norewind') + viewer.update() + ds.setSelectables()
     （这三个 API 在翻页加载数据时本来就在用）
   - 不做「悬停临时展开」：那会让图片墙每次鼠标划过都重排

验证：
- 新增 test/sidebar.test.mjs（6 例，jsdom）：默认展开 / 存过 collapsed 则加载即贴类 /
  折叠写存储并派发事件 / 展开还原 / 手机端只开抽屉不动折叠态 / 桌面端走折叠。
  与既有 70 例一起由 npm test 串行执行（CI 那步就是 npm test）
- 用真编译产物 + 真实 DOM 结构在 Chromium 里量计算样式：
  桌面折叠 → 侧栏 64px、内容左边距 64px、文字/分组/容量隐藏、图标居中偏差 0px、按钮与标签零重叠；
  桌面展开 → 256px / 256px；手机端即使贴了折叠类 → 侧栏仍 75% 抽屉、无隐藏、边距 0（确认零影响）
- php -l 全仓库通过；php artisan view:cache 全量编译通过；verify_repo.py 通过；
  context-js.js 两份仍字节一致（e114c840…，长按与点击防护未动）
 2026-09-29 02:00:53 +08:00
mole404 7c3188e25a refactor(源码): 应用源码 vendored 进 src/ + 上游 pin 升级到 38d52c46（2025-11-24） 
上一版是「钉死上游 commit、构建时拉 archive、再用 overlay/ 叠加补丁」。但上游已明示停止维护
（README 里 2024-12-28 起挂着警告：「开源版本已停止维护，不再进行新特性更新和 bug 修复」），
所以把源码放进本仓库：构建不再依赖 github.com/lsky-org 长期可用，之后要改 PHP 代码直接改
src/ 提交即可，不必再维护叠加机制。

1) 上游 pin：911275c（2023-05-16）→ 38d52c4609eb85236b45ac75acac2ced55174953（2025-11-24）。
   中间 32 个提交只动了 9 个文件，**数据库迁移 0 处**，所以升级不碰站点数据（SQLite 结构不变）。
   吃进三个真实修复：图片格式转换时不同图片共用同一个临时文件（并发上传会变成同一张图，
   默认配置即触发）、加水印后丢质量参数、SVG 支持；另有 laravel 9.52.4→9.52.17、
   phpseclib 3.0.19→3.0.43、commonmark 2.3.9→2.6.0、aws-sdk-php 等一串依赖安全升级。

2) vendored 源码：src/ = 上游 38d52c46 的完整树（304 个文件、8.1MB，按 commit 精确复制，
   文件数与上游 git 树一致）。我们的三个补丁文件就地打上补丁，取消 overlay/。

3) Dockerfile：去掉 curl 下载 archive 那一层，改成 COPY src/；自证拆成两组 ——
   「自证 1 上游纯净性」ImageService.php / convention.php / public/index.php / routes/web.php /
   composer.lock 必须等于上游 md5；「自证 2 补丁产物」三个补丁文件 md5 + 关键标记 grep。
   快照被误改、补丁丢了，构建期就拦下。

4) 新增维护脚本：tools/diff-vs-upstream.sh（拉上游快照做全树对比 + 白名单校验：除三个补丁文件
   外不许有别的改动，同时可重生成 patches/ios-longpress.patch）、tools/vendor-upstream.sh
   （换 pin 时重新 vendor，自动保留补丁文件并打印上游侧差异）。

5) 测试与文档：jsdom 测试默认路径改指 src/public/js/context-js/context-js.js，新增两条结构自检
   （两份 context-js.js 必须一致、blade 必须带 ?v= 版本串）→ 70/70 通过；README 重写
   「代码在仓库哪里、怎么改、怎么升 pin」，并修正许可证说明（应用 GPL-3.0 / 打包 AGPL-3.0）。

数据安全逻辑一字未动：entrypoint.sh 仍是「版本标记不一致才同步」，排除
.env / storage / database / bootstrap/cache / public/i。换镜像后容器自动把新代码同步进卷。
 2026-09-28 22:36:48 +08:00
mole404 ffb7947d89 fix(menu): 菜单只要还在屏幕上就不许点穿（修掉 Windows 偶发点穿）+ 诊断转储 
老师报：Windows 上偶尔“菜单还在显示时，点一下别的图片就透了”，直接开预览。

根因：拦不拦那一发点击只看内存状态 menuVisible，而外部滚动 / resize / Esc / 关菜单后的
100ms 淡出都会把它提前置 false。其中 scroll 恰恰很容易被“非用户操作”触发 —— 菜单是绝对定位
插进 body 的，**插入这个动作本身**就可能改变页面高度/滚动条、让浏览器自己滚动（滚动锚定、
图片懒加载重排、justified-gallery 重排）。于是“菜单刚打开就被自己引发的滚动关掉”，紧接着
元素淡出的那 100ms 里菜单看着还在、状态已经是关 —— 这时点别的图片就直通开预览。这也解释了
它为什么是“偶尔”：取决于菜单落在哪、要不要出滚动条、浏览器是否触发滚动锚定。

改法（仍然只改 overlay/context-js.js 一个文件）：
1) 判据由 menuVisible 换成 menuOnScreen()：状态打开 || 关菜单后的淡出窗口(fadeSpeed+50ms)
   || DOM 实测（.dropdown-context 存在且 getBoundingClientRect().height > 0）。
   这样任何一条把状态提前置 false 的路径，都不再让“看得见的菜单”失去拦截能力 ——
   “看得见就不许点穿”变成硬保证。
2) MENU_OPEN_IGNORE_INPUT = 300ms：菜单刚打开的 300ms 内忽略 scroll/resize/orientation
   （这一段里的滚动多半是菜单插入自身引发的）；过了之后用户滚动照旧关菜单。
3) 诊断：常驻环缓冲记录最近 240 条菜单事件（打开 / 关闭**原因** / 每次点击的判定），
   暴露 context.debugDump()（控制台 copy(context.debugDump()) 即可导出）；
   context.debug = true 时实时打控制台。

验证：
- test/longpress.test.mjs 68/68 通过。新增 5 条回归：淡出期间点别的图片不许点穿、
  状态已 false 但 DOM 实测菜单可见时仍要吞、菜单刚打开 300ms 内的自引发滚动不关菜单、
  菜单彻底消失后点击恢复正常（不会一直吞）、debugDump() 含打开记录与关闭原因。
- test/repro-clickthrough.mjs 最小复现（新增）：对旧版打印 ❌ 点穿、新版打印 ✅ —— RED→GREEN 证据。
- CI 镜像自证新增 MENU_OPEN_IGNORE_INPUT / menuOnScreen / debugDump 三个标记断言。
- blade 版本串提到 ?v=ios-longpress4（击穿 Safari 启发式缓存）；Dockerfile 三处 md5 +
  .code-revision 两行 + workflow 的 CONTEXT_JS_MD5/BLADE_MD5 全部同步；
  patches/ios-longpress.patch 重新生成并验证可干净应用、结果与 overlay 字节一致。
 2026-09-28 22:11:58 +08:00
mole404 5151eff2e2 feat(menu): 点菜单外只关菜单（不再点穿）+ 触摸端二级菜单点击展开 + 滚动/缩放/Esc 关闭 
老师在 iPhone 上提的两个交互问题，根因都在上游 context-js.js 里：

1) 点菜单之外会点穿：上游关闭逻辑只在 document 的冒泡阶段 fadeOut，不 preventDefault
   也不 stopPropagation → 点别的图片时"关菜单"和"开预览"同时发生（Viewer.js 的 click
   挂在图片网格上）；手机上想关菜单只能去点地址栏，而地址栏又窄又难点。
2) 手机上二级菜单一点就没：二级菜单是 CSS :hover 驱动的，手机没光标 —— 点"复制链接"
   时浏览器补发的合成 mouseenter 让子菜单闪一下，紧接着那发 click 撞上关闭逻辑，整个
   菜单消失 → 复制链接里的 Url/Html/BBCode/Markdown 在手机上根本点不到。

改法（只在 overlay/context-js.js 里，不动主题 CSS）：
- 菜单守卫装到 document 的捕获阶段：菜单打开时点菜单外 → 关菜单 + preventDefault +
  stopPropagation，事件永远到不了页面处理器；菜单内部点击照旧放行（复制/重命名/删除不变）。
- 手机上"手指按下"就收起来（更跟手），随后补发的 click 用 700ms 时间窗吞掉；
  拦截只打在 click 上、不拦 touchstart → 滚动/缩放不受影响。
- 刚打开的保护窗 MENU_OPEN_GRACE=800ms，只对"紧随一次触摸的 click"生效（lastTouchAt），
  鼠标点击不受影响：长按抬手补发的那发 click 只吞掉、不关菜单（否则菜单刚开就自己关）。
- 触摸设备（matchMedia('(hover: none)')）点带二级菜单的父项 → 加 touch-open 类 + 注入与
  hover 等价的 CSS，点击展开/收起、同层只留一个；有鼠标的设备继续 hover（桌面零改动）。
- 滚动/旋转缩放（含 #images-scroll 内部滚动）、Esc 关菜单；菜单自身滚动不误关。
- 新增 context.isMenuOpen()（上游没有）供测试与诊断观测菜单状态。

测试：test/longpress.test.mjs 25 → 56 个用例，覆盖上述每条分支，含三条回归
（抬手 click 不能关掉刚开的菜单 / 点菜单外必须吞点击 / 菜单关后点击要恢复正常）。
CI 新增 Behavior tests (jsdom) 步骤（构建前跑，npm ci + npm test），
镜像自证新增 installMenuGuard / MENU_OPEN_GRACE / touch-open / isMenuOpen 标记断言
与"Apache 实际吐出的 JS md5"端到端断言。

配套：blade 版本串 ios-longpress2 → ios-longpress3（击穿 Safari 启发式缓存）、
所有哈希断言同步（Dockerfile 自证 2 + .code-revision + workflow env）、
patches/ios-longpress.patch 重新生成（已 git apply --check 验证能干净打回上游并逐字节一致）、
README/test-README 文档更新、新增 .gitignore 与 test/package-lock.json。
 2026-09-28 21:29:45 +08:00
mole404 90e151eef0 feat: 长按阈值 500→250ms；入口脚本改为每次启动强制同步代码进已有卷 
老师的两个要求：

1) 长按 0.5s 偏长 → LONG_PRESS_DELAY 减半到 250ms。
   - 配套保留「手指移动 >10px 即取消」，用来抵消阈值变短带来的误触风险
   - blade 的资源版本串递增为 ?v=ios-longpress2，击穿 Safari 的启发式缓存
     （否则老浏览器还在用 500ms 那份 JS）
   - test/ 增加两个阈值回归用例（320ms 必须触发、160ms 必须不触发）

2) 升级不再需要人工 cp 文件：entrypoint.sh 在「已有部署」分支里每次启动都把
   镜像代码同步进卷（tar 覆盖式），并自动清掉编译视图缓存。
   - 绝不覆盖：.env / database/（SQLite）/ storage/（上传·日志·会话）/
     bootstrap/cache/ / public/i —— 这五项是站点数据与配置，不是镜像代码
   - Dockerfile 增加静态护栏：排除清单少一项就构建失败
   - CI 新增「Verify forced code sync」步骤：模拟已有部署的卷（塞旧代码 +
     .env/数据库/上传/编译缓存的哨兵文件），断言代码被更新、数据一项没被碰；
     不过就 exit 1，不会 promote 到 latest
   - README 重写升级/回滚章节并写明代价：手工改卷里的代码会失效、回滚必须连镜像一起回滚

自证：本地仿真 9/9（代码更新 + 五项数据保全）、jsdom 行为测试 25/25、
patch 能干净打到上游 911275c、Dockerfile 全部断言 grep 命中。
 2026-09-28 18:24:08 +08:00
mole404 565aa3fefc feat: iOS 长按菜单修复 + 源码钉死在 911275c + GHCR 发布 
问题：iOS WebKit 永远不派发 contextmenu（WebKit bug 213953），长按图片只弹系统
callout，导致"我的图片"页的自定义菜单在 iPhone/iPad 上完全不可用
（resources/js/context-js.js 的菜单只挂在 contextmenu 上）。

改动：
- overlay/context-js.js：纯增量补丁。新增仅 iOS 生效的长按分支（touchstart+500ms，
  移动 >10px / 多指 / 短按都取消），复用原本的开菜单逻辑（beforeOpen/afterOpen 照旧）；
  注入 -webkit-touch-callout:none 压掉原生菜单（只作用于本库绑定的元素范围）；
  抬手吞掉 iOS 补发的 click，避免长按后误开图片预览；长按与 contextmenu 之间 700ms 去重。
  判定只在 iPad/iPhone/iPod（含 iPadOS 伪装的 MacIntel+maxTouchPoints>1）为真，
  Android / Windows / 真 Mac（含 M 系列，maxTouchPoints=0）一行新代码都不执行。
- overlay/images.blade.php：只给脚本加 ?v=ios-longpress，绕开 Safari 的启发式缓存
- Dockerfile：源码钉死 911275c（= 2024-04-29 那版线上镜像使用的 master HEAD）；
  基础镜像显式 bookworm；install-php-extensions 钉版本；构建期两处 md5 自证
- .github/workflows/build-image.yaml：替换上游的定时构建，改推 GHCR + 构建后真机自证
  （核 md5、记录 PHP/扩展/Debian、真起容器 curl 安装页）
- test/：node + jsdom 行为测试（23 项，覆盖 iOS/iPad/Mac/Android/Windows 五类场景）
- README：补丁原理、跨平台隔离说明、升级/回滚步骤（含"换镜像不会更新已有卷代码"这个坑）

致谢与许可保留上游全部署名与 LICENSE（AGPL-3.0）。
 2026-09-28 16:41:41 +08:00