思源笔记中文件名包含百分号(%)的图片资源处理方案

在思源笔记v3.1.21版本中，开发团队修复了一个关于本地资源文件处理的特殊场景问题。当用户导入或使用包含百分号(%)字符的图片文件时，系统会出现资源访问异常的情况。这类问题在技术实现上涉及URI编码规范与文件系统操作的交互细节。

问题本质分析

百分号(%)在URI编码中具有特殊含义，它用于表示编码字符的开始（如%20代表空格）。当文件实际名称包含百分号时：

1. 直接作为URI部件会导致解码错误
2. 双重编码（如将%转为%25）虽可解决预览问题，但会导致系统无法识别原始文件路径

技术解决方案

开发团队采用的修复方案包含以下技术要点：

1. 导入阶段预处理：在文件导入环节自动检测文件名中的特殊字符，进行规范化处理
2. 资源访问双模兼容：
   • 存储时保留原始文件名
   • 访问时动态生成符合URI规范的编码路径
3. 透明化处理：用户操作层面无需手动修改文件名，系统自动维护两种表示形式的映射关系

实现原理

该修复涉及思源笔记的以下模块协作：

1. 文件系统监听服务：检测新增资源文件
2. URI编码转换器：处理资源路径的编解码转换
3. 资源管理器：维护原始文件名与编码后URI的映射表

这种设计既保证了系统内部处理的规范性，又确保了用户操作的透明性，是典型的兼容层设计模式应用。

用户影响与建议

对于普通用户，建议注意：

1. 系统已自动处理特殊字符问题
2. 无需刻意避免在文件名中使用%
3. 若从外部直接复制文件到资源目录，建议通过思源笔记的导入功能

对于开发者用户，可以了解到：

1. 资源访问API已内置编码转换逻辑
2. 插件开发时可直接使用原始文件名进行引用
3. 需要处理本地文件时建议使用系统提供的资源管理接口

该修复体现了思源笔记对边缘场景的细致处理能力，通过架构设计在保持用户体验一致性的同时满足技术规范要求。