上周三，晚上十一点四十。老周发来一个压缩包，说他 2019 年拍的一批照片全打不开了。
不是文件丢了。压缩包里 314 张 JPG 一张没少。丢的是那份 XML 文件对应的展示层——描述每组照片顺序、标题、拍摄地点的那一套结构，被某个旧工具读不出来了。
说到底，问题不在照片，在于谁替照片说话。
我用了两个晚上处理这件事。说结果之前，先说说那份 XML 具体的毛病，因为这决定了我后来走的路。
那份 XML 到底坏在哪里
打开看，结构本身完整。根节点下面 314 个 <item>，每个带 id、path、caption 三段。问题出在两处：path 用的是 2019 年那台电脑上的相对路径，比如 D:\photos\raw\IMG_0417.JPG，换台机器就指不到；caption 里嵌了一批没转义的 & 和中文引号，浏览器自带的解析器直接停在那里，剩下的 200 多条它一条都不读。
看起来像坏了一半。其实只是第一处硬伤把整条链掐断了。
解析器不猜。它遇到一个错就停，剩下的整段当没看见。
这是最容易被误会的地方。老周一直以为文件损坏了，甚至想过去找数据恢复的人。事实是他那份 XML 只是碰到了一个非法字符，后面 200 多张照片的元数据好端端躺在文件里。
我做了什么
第一件事，把 path 全部改成相对文件名，只保留 IMG_0417.JPG 这一段。这样无论换哪台机器、放哪个目录，只要能读到同目录下的图片，就能对上。
第二件事，重写 caption 的转义。这部分我不太放心自动脚本，手动过了一遍，因为有 11 条是从老相机里导出的，带着一些奇怪的控制字符。
第三件事，也是最花时间的——写一个转换脚本，把 XML 转成浏览器能直接读的 JSON，然后配一页静态页面。缩略图按原顺序排列，点开看原尺寸，下面带那段 caption。整套东西不到 40 KB，丢在任何静态托管上都能跑。
第三天早上七点，我把链接发给老周。他隔了半小时回了句：「都在。太好了。」就这四个字。
后来他补了一句，说那张他女儿三岁在老家院子里踩水坑的照片，标题原本是乱码，现在能正常显示了。他说他差点没认出来那是那天的照片。
关于「免费」和「高清」两件事
这个站叫「免费高清私人照片xml展示格式转换」。名字长，被问过几次为什么这么起。这里说清楚。
免费，指的是工具本身不收钱。转换用的脚本我放在站内，谁都能拿走用。不注册，不要邮箱，不上传照片。所有处理都在本地跑。我不留你任何一张照片。
高清，指的是转出来的展示页默认指向原图，不是重新压缩过的缩略图。代价是首次加载会慢一些。我试过给老周加一层预览缓存，试了两次还是放弃——他原话是「看得清比看得快重要」。这话我认同。
顺手记一下：如果你手头也有一份此类 XML，想先熟悉结构，可以参考 六库宝典图库 的目录组织方式，那边对私人类 XML 的分组说得比较细。另外 恢复原来的49图库资料版 讲的是另一种常见的字段修复思路，可以先看，再决定要不要动手。
一处不太客气的判断
说实话，市面上大多数所谓「照片 XML 转换工具」，是把你的照片上传到他们的服务器，转完再下载回来。中间那几秒到几分钟，你的私人照片在别人的机器上。这不是技术问题，是信任问题。
我不接受这个流程，哪怕它省事。
所以我这套东西全在浏览器本地跑。你可以断网跑。转换逻辑就两百多行，看得完。这就是我坚持的取舍。
需要说明的是，本地跑也有代价。比如遇到超大的 XML、带二进制内嵌的照片包，浏览器会卡。我试过一份 180 MB 的，跑了两分多钟。够用，但不算快。如果你只处理几十张，几乎无感。
转换完之后，展示结构建议保持扁平。层级一多，旧版 XML 的 id 引用就容易错位，这一点在 管家婆内部资料图 里有很具体的例子，可以直接参考那种线性排法。如果你还想保留相册分组的树形结构，app49图库正版下载 那份文档里讲了怎么用纯 CSS 做折叠，不依赖脚本，体积小。
几个具体的坑
第一个坑，编码。老周那份 XML 头部声明是 UTF-8，实际存的是带 BOM 的 UTF-8。浏览器大部分能自己处理，但转换脚本不一定。我是在读文件时先剥掉 BOM 才通过的。
第二个坑，文件名大小写。他的原文件里写的是 .jpg，磁盘上实际是 .JPG。Linux 服务器不认这个，一张都对不上。改完路径后一次通过。怎么打开图库 里提过类似的问题，当时没在意，后来遇到才明白。
第三个坑，标题里的别名字符。中文书名号、单引号、& 都要转义。我写了一个小函数一次性过，不用正则替换全文，太容易误伤标签。
还有一个不算坑但容易忽略的点：转换后一定要在本地预览一遍。不要只信脚本的返回结果。预览时我一眼就看出有 3 张照片缩略图方向不对——原图带 EXIF 旋转标记，展示页没读到。补上 EXIF 处理就正常了。如果你不处理这个，竖拍的照片会横躺。49图库下载最新版app 里有一份 EXIF 字段对照，可以对着查。
最后
这件事本身不大。但对于老周，那是他 2019 年整整一年的照片，里面有他女儿三岁时候的样子，有老家院子那场雨。技术上的工作量，我两个晚上。情感上的重量，不该用分钟算。
所以这个站我做下来了。做得不花哨，界面就是你现在看到的这样。工具都在。管家婆正版资料库图库资源 和 49图库资料库免费打开49图库app下载安卓版 是两条我用得比较多的参考路径，如果你也想在本地环境跑通 XML 到展示页的链路，从这两处入口看起会比较顺。
就这样。凌晨三点，写完。