告别中文路径乱码：通过Calibre-do-not-translate-my-path实现原生命名自由

在数字阅读管理中，中文路径乱码如同隐形的障碍，让精心整理的书库瞬间变得混乱不堪。当Calibre默认开启的拉丁化处理（将中文转为拼音或字母组合的过程） 遇上中文书名和作者名时，原本清晰的"红楼梦-曹雪芹"可能变成晦涩的"hongloumeng-caoxueqin"，不仅破坏文件结构美感，更可能导致设备间文件同步失败。

【核心价值主张】

Calibre-do-not-translate-my-path作为专业级路径管理插件，通过非侵入式路径保护机制，为中文用户提供三大核心价值：

• 原生命名保留：让中文路径保持原始字符状态，避免系统自动转码
• 跨设备一致性：确保PC与移动设备间文件路径完全一致
• 零成本迁移：无需重构现有书库，即装即用的平滑过渡方案

图标中禁止符号与中英文文档的组合，直观体现阻止自动翻译的核心功能

【技术原理】

该插件通过钩子函数拦截实现路径保护，工作流程如下：

Calibre文件操作请求 → 插件拦截路径处理函数 → 
【判断是否中文路径】→ 是→跳过拉丁化处理 → 否→默认处理流程

这种设计既不修改Calibre核心代码，又能精准控制路径转换逻辑，保持系统稳定性。

【快速部署指南】

1. 环境验证

在终端执行以下命令检查Calibre版本（需3.0以上）：

calibre --version

注意事项：若版本低于3.0，请先通过官方渠道升级Calibre主程序

2. 获取插件

通过仓库克隆获取最新版本：

git clone https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path

3. 安装流程

1. 打开Calibre → 点击"首选项" → 选择"插件"
2. 点击右下角"从文件加载插件" → 选择下载的ZIP文件
3. 重启Calibre使插件生效

注意事项：安装过程中若提示"不受信任的插件"，需在安全设置中允许第三方插件安装

4. 基础配置

在插件设置界面可完成两项关键配置：

• 勾选"启用路径保护"核心功能
• 将"刷新书库"按钮添加到工具栏

【常见误区解析】

误区1：多书库管理冲突

现象：同时管理多个书库时设置混乱
正解：在插件设置中启用"书库独立配置"，每个书库可单独开关路径保护功能

误区2：版本兼容性问题

现象：升级Calibre后插件失效
正解：插件会随Calibre主版本同步更新，通过仓库的release页面获取对应版本

误区3：设备同步异常

现象：启用插件后发送到设备的文件无法识别
正解：使用工具栏"刷新书库"功能，重建设备文件关联索引

【进阶技巧】

批量路径修复

对于已被拉丁化的现有书库，可通过插件提供的批量修复工具恢复中文路径：

1. 在插件菜单选择"路径修复"
2. 设置匹配规则（如"拼音转中文"）
3. 预览更改后执行批量处理

自定义排除规则

通过编辑配置文件config.py，可设置不需要保护的路径模式：

# 添加不需要翻译的路径前缀
EXCLUDE_PATHS = [
    "/tmp/calibre_temp/",
    "/backup/"
]

注意事项：修改配置后需重启Calibre生效

通过这套完整解决方案，中文用户终于可以摆脱路径乱码困扰，让书库管理回归本该有的简洁与高效。无论是个人藏书管理还是小型图书馆建设，Calibre-do-not-translate-my-path都能成为可靠的技术后盾。