# 文件预览全屏与目录切图 ## 用户需求 当前图片预览被容器缩放,需要点击放大全屏,并能左右切换当前文件夹图片;优先复用 cc-web 现成组件。 ## 验收条件 - 点击文件预览中已加载的图片打开已有附件图片弹层的全屏模式,图片适应整个可用视口,保留加载、失败、关闭操作。 - 查看器提供前后按钮和左右方向键,在当前文件夹中按文件列表顺序切换支持的图片;跳过目录和文本。 - 显示文件名、当前位置;单图与首尾行为清晰。 - 移动端按钮可用,关闭全屏返回原文件浏览器,不误触关闭文件浏览器。 - 图片按需鉴权加载,SVG 延续现有安全路径;切换时处理加载、失败、过期请求和 Blob URL 释放。 - 文件夹变化或文件浏览器关闭时正确清理查看器状态。 - 原有消息图片查看体验保持可用。 ## 已定位的复用入口 - public/app.js:openAttachmentPreviewModal / closeAttachmentPreviewModal;现有组件目前是居中大图弹层,没有缩放平移功能。 - public/app.js:openFileBrowserFile / renderFileBrowserDirectory / loadFileBrowserDirectory / showFileBrowser。 - 文件图片继续通过 fetchAuthImage 读取 /api/fs/image,SVG 用 data URL,其余用 Blob URL。 ## 约束 复用现有组件,不新增图库依赖;不做额外代码审计;本轮不打包、不提交、不推送、不重启。 ## 验证结果 - file-browser-image、file-preview-encoding、frontend-asset-version 专项回归通过。 - Chromium 149 桌面和手机视口 20 项交互验证通过,页面无未捕获异常。