故障排查手册

处理失败往往不是算法出了问题，而是格式、尺寸或方向出了偏差。这一篇按现象组织，先给总表，再逐条说明原因判断与处理办法。

现象 → 原因 → 处理 总表

先在表里找到与你遇到的最接近的一行，照着处理列做一遍。多数问题在前两列就能定位。

按钮点击没有反应

最常见的原因是还没有产生有效输入。工具必须先拿到一张图，才能计算曲线序与位移量，所以在选图之前，处理按钮要么不可用，要么点了不会有变化。

按顺序确认三件事：图片区里是否已经显示出图片；处理方向有没有点对（该点「混淆」还是「解混淆」）；批量模式下队列里是否至少有一项。三项都正常时，点下按钮应当立刻出现处理中提示，并在完成后显示耗时与输出体积。

如果预览已出现、方向也选了，点击仍然毫无反应，先刷新页面重试，再换一个浏览器。浏览器版本过旧，或扩展脚本拦截了页面脚本执行，都可能造成这种表现，记下浏览器版本再反馈会更快定位。

图片选不进来 / 提示格式不支持

浏览器能直接解码的格式是有限的，编解码能力由浏览器决定，不由页面决定。

JPEG、PNG、WebP、GIF 在主流浏览器里都能正常打开。HEIC 是主要例外：它是部分手机相机的默认拍照格式，但多数桌面浏览器无法解码，表现就是选了文件却看不到预览。遇到这种情况，先在系统相册里把照片导出成 JPEG，再重新选择。

动图需要单独说明。GIF 与动态 WebP 包含多帧，本站按静态图片处理，只取用其中一帧参与置换。如果需要保留动画效果，请不要用这个流程处理。

还要排除文件损坏：同一个文件在系统看图工具里也打不开，那就与本站无关。从聊天窗口拖拽有时拿不到真实文件，先保存到本地再选择更稳妥。

结果是马赛克或满是噪点

先区分两种表现：整体呈网格状被打散，和细节上布满彩色噪点。前者通常意味着方向选反，后者通常意味着链路里发生过有损压缩。

方向判断很直接：混淆与解混淆互为逆运算，同方向执行两次并不会还原，只有反向执行才回到原状。如果结果比原图更乱，改成另一个方向再试一次，现象描述可以对照解混淆完整教程。

方向没问题的话，噪点来自格式。JPEG 的块效应、色度抽样与高频量化会在还原结果里留下痕迹，并且会在每一轮转存中叠加。判断方法是用同一张图分别导出 JPEG 与 PNG：PNG 那份明显更干净，就说明问题出在格式而不是算法。成因与参数取舍写在输出格式与画质里。

还有一种情况无法通过重试解决：源图本身就是被压缩过的 JPEG，丢失的细节已经固化，任何工具都补不回来。

处理后颜色变怪

颜色偏移几乎都发生在 JPEG 环节，原因有两个：色度抽样与色彩空间转换。

色度抽样让相邻像素共用一组色度值，像素被打乱后，原本配对的亮度与色度被拆开，高饱和度边缘上容易出现不属于原图的红绿蓝细纹。色彩空间转换则是图片在解码、绘制到画布、重新编码的过程中经历了一次 RGB 与 YCbCr 的往返，数值可能被轻微改写。

处理办法是把链路改成 PNG。PNG 不抽样色度、不做有损量化，颜色数值能原样保留，必须用 JPEG 时就不要反复转存。

手机端处理大图卡住或页面崩溃

这是内存问题，不是功能缺陷。处理一张图需要在内存里同时保留曲线序和两份像素数据：曲线序用 32 位整型数组保存需要 4N 字节，输入与输出像素各占 4N 字节。200 万像素约需 24MB 临时内存，还不含画布本身的开销。

手机浏览器的可用内存比桌面紧张得多，标签页被系统回收时，表现就是卡住、白屏或页面重新加载。像素数越大，触发概率越高。

可行的办法有三条：先把图片裁剪或缩小到实际需要的尺寸；关掉其他占用内存的标签页；改用桌面浏览器处理。像素数与内存、耗时的关系见复杂度与性能。

处理完尺寸变小了

说明这张图超限了，工具先做了等比缩放。上限是单张不超过 800 万像素、单边不超过 4000 像素，任意一个条件不满足都会触发缩放。

缩放是等比的，不会拉伸变形，但会改变像素值。因此经过缩放的图片不再处于无损链路：即使输入输出都用 PNG，结果也无法逐字节还原成原始分辨率。要保留完整分辨率，只能先自行裁剪成多块分别处理。

如果输出尺寸变小而处理前的提示里没有提到缩放，先检查自己在别的环节有没有压缩过图片，对比原图与输出图的宽高数值是最快的确认方式。

粘贴快捷键没反应

粘贴需要两个条件同时成立：页面获得键盘焦点，且剪贴板里确实是一张图片。

先在投放区域点一下让页面拿到焦点，再按 Ctrl+V，macOS 上用 Command+V。如果剪贴板里是文本或文件路径，粘贴不会产生图片输入，改用「选择图片」直接选文件最稳妥。

部分浏览器对剪贴板读取有限制，页面未获得用户交互时尤其明显，刚打开页面就立刻粘贴往往失败。此外，系统级剪贴板管理工具可能改写内容，暂时关闭可以排除干扰。

都试过了还是不行

上面所有条目都排除之后，剩下的问题通常需要看具体信息才能定位，请通过意见反馈提交。

为了一次就能定位，反馈时请附上：原图与结果图的格式、宽高和文件大小；处理时选择的方向与输出格式；操作系统与浏览器的名称和版本；完整的现象描述，包括是完全没有反应、中途卡住，还是结果不符合预期。

还有一点需要提前说明：本站能排查的范围只到工具本身。如果图片在到达你手上之前就被压缩、裁剪或用别的方案处理过，那么无论如何调整参数都无法恢复原始内容，这属于上游数据问题。其他综合疑问可以先看常见问题 FAQ。