Calibre 中文路径不再变拼音NoTrans 插件安装与配置完整指南【免费下载链接】calibre-do-not-translate-my-pathSwitch my calibre library from ascii path to plain Unicode path. 将我的书库从拼音目录切换至非纯英文中文命名项目地址: https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path很多中文用户都见过这样的场景书库里按「作者」「分类」建好的中文目录经过一次导入或一次发送到设备之后变成了拼音或拉丁转写目录。开源项目 calibre-do-not-translate-my-path 提供的 NoTrans 插件Do Not Translate My Path正是针对这个问题它以 Calibre 官方插件机制接管路径处理逻辑让中文及其他非拉丁文字的路径保持原样支持 Calibre 5.0 及以上版本Windows、macOS、Linux 均可使用。路径为什么会被改写成拼音Calibre 作为跨平台软件为了保证不同文件系统的兼容性默认会对路径做拉丁化处理中文、日文等非 ASCII 字符会被转写成 ASCII 拼音或拉丁字符。这个行为对英文环境无害但对以中文组织书库的用户来说意味着目录结构、命名习惯和与设备间的一一对应关系全部被打乱。NoTrans 的思路并不复杂在插件入口__init__.py中注册一个 Hook运行时把 Calibre 内部负责路径净化的几个函数书库的ascii_filename、USB 设备与智能设备应用的sanitize、MTP 的create_upload_path替换为只清理非法字符、不转写字形的sanitize_file_name取消勾选某个选项时再把对应函数还原回 Calibre 的原始实现。整个过程中不修改 Calibre 的核心文件。插件覆盖的四种路径场景配置界面里有四个独立开关对应 Calibre 的四条路径入口默认全部启用见config.py书库Library添加书籍到书库时生成的目录与文件名是最常用的场景。USB 设备含本地文件夹涵盖 U 盘、SD 卡、挂载目录等系统原生存储发送到文件夹走的就是这条路径。MTP 设备Android 手机、平板等媒体传输协议设备。智能设备应用通过 Calibre 配套 App 访问书库时的路径。四个开关互相独立可以只关掉部分场景的翻译行为。插件界面文本带有中文翻译源文件位于translations/zh_CN.po。NoTrans 插件安装步骤获取插件文件。直接下载项目 Release 中的 zip 包或者克隆仓库源码git clone https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path打开 Calibre进入首选项 → 高级选项 → 插件点击右下角的从文件加载插件。选中下载或构建得到的 zip 文件等待加载完成。按提示重启 Calibre插件即生效。值得一提的是仓库里的release.py会负责编译翻译文件并把__init__.py、config.py、ui.py、图标等打包成 NoTrans.zip所以从源码构建发布包也是一条可复现的路径。中文路径保持原样的配置方法配置入口有两个二选一即可。其一是插件列表在首选项 → 插件 → 自定义插件中双击 NoTrans会弹出四个勾选框勾选项含义是禁用该场景的翻译保存后 Hook 会立即按新配置更新。其二更顺手右键 Calibre 工具栏在添加/删除工具栏项目里加入 NoTrans之后点击工具栏图标即可随时打开配置界面界面逻辑在ui.py中实现。修改选项后刷新书库路径勾选或取消某个选项只影响之后的新操作书库里已经存在的旧路径不会被自动改写。如果需要把当前书库所有书籍的保存路径按新规则重刷一遍使用工具栏 NoTrans 菜单里的刷新书库Refresh Library点击工具栏 NoTrans → 刷新书库确认对话框提示操作可能需要一段时间。插件会以后台任务逐本书重算路径状态栏显示进度和当前书名。完成后即可在书库目录中看到更新后的路径。刷新书库有三个边界需要清楚只作用于当前打开的书库其他书库不受影响已经发送到设备的文件不会被重写设备文件与书库文件的关联关系在刷新后原样保留操作过程是后台线程执行期间可以继续使用 Calibre。常见疑问与版本选择Release 列表里除了 v3.x 还能看到 v6.x、v7.x 这样的高版本号容易让人困惑。这些高版本号是早期补丁方案使用的版本号与对应的 Calibre 版本一一绑定v1、v2 同属补丁路线而 v3 是插件路线也就是现在推荐使用的形态。选 v3 的实际理由是安装是一次性的不改动 Calibre 自身文件之后升级 Calibre 无需重新处理兼容性也更好。如果坚持要用补丁版项目提供了 bypy-patch 分支可作参考但维护成本明显更高。另一个常见误会是担心刷新书库会波及设备上的文件。实际机制只重算书库内的路径记录设备侧文件与书库文件的对应关系保持不变任何时点执行刷新都可以。小结NoTrans 用四个独立开关覆盖了书库、USB含本地文件夹、MTP 和智能设备应用四条路径通道配合刷新书库功能可以处理存量路径。对于以中文组织书库、并经常向手机或 U 盘传输电子书的用户按本文步骤装好插件、保留书库 USB两项勾选再视需要打开 MTP就能让路径从导入到同步全程保持原样。许可证为 GPL v3见项目LICENSE与中文说明readme_zh.md。【免费下载链接】calibre-do-not-translate-my-pathSwitch my calibre library from ascii path to plain Unicode path. 将我的书库从拼音目录切换至非纯英文中文命名项目地址: https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Calibre 中文路径不再变拼音：NoTrans 插件安装与配置完整指南
Calibre 中文路径不再变拼音NoTrans 插件安装与配置完整指南【免费下载链接】calibre-do-not-translate-my-pathSwitch my calibre library from ascii path to plain Unicode path. 将我的书库从拼音目录切换至非纯英文中文命名项目地址: https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path很多中文用户都见过这样的场景书库里按「作者」「分类」建好的中文目录经过一次导入或一次发送到设备之后变成了拼音或拉丁转写目录。开源项目 calibre-do-not-translate-my-path 提供的 NoTrans 插件Do Not Translate My Path正是针对这个问题它以 Calibre 官方插件机制接管路径处理逻辑让中文及其他非拉丁文字的路径保持原样支持 Calibre 5.0 及以上版本Windows、macOS、Linux 均可使用。路径为什么会被改写成拼音Calibre 作为跨平台软件为了保证不同文件系统的兼容性默认会对路径做拉丁化处理中文、日文等非 ASCII 字符会被转写成 ASCII 拼音或拉丁字符。这个行为对英文环境无害但对以中文组织书库的用户来说意味着目录结构、命名习惯和与设备间的一一对应关系全部被打乱。NoTrans 的思路并不复杂在插件入口__init__.py中注册一个 Hook运行时把 Calibre 内部负责路径净化的几个函数书库的ascii_filename、USB 设备与智能设备应用的sanitize、MTP 的create_upload_path替换为只清理非法字符、不转写字形的sanitize_file_name取消勾选某个选项时再把对应函数还原回 Calibre 的原始实现。整个过程中不修改 Calibre 的核心文件。插件覆盖的四种路径场景配置界面里有四个独立开关对应 Calibre 的四条路径入口默认全部启用见config.py书库Library添加书籍到书库时生成的目录与文件名是最常用的场景。USB 设备含本地文件夹涵盖 U 盘、SD 卡、挂载目录等系统原生存储发送到文件夹走的就是这条路径。MTP 设备Android 手机、平板等媒体传输协议设备。智能设备应用通过 Calibre 配套 App 访问书库时的路径。四个开关互相独立可以只关掉部分场景的翻译行为。插件界面文本带有中文翻译源文件位于translations/zh_CN.po。NoTrans 插件安装步骤获取插件文件。直接下载项目 Release 中的 zip 包或者克隆仓库源码git clone https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path打开 Calibre进入首选项 → 高级选项 → 插件点击右下角的从文件加载插件。选中下载或构建得到的 zip 文件等待加载完成。按提示重启 Calibre插件即生效。值得一提的是仓库里的release.py会负责编译翻译文件并把__init__.py、config.py、ui.py、图标等打包成 NoTrans.zip所以从源码构建发布包也是一条可复现的路径。中文路径保持原样的配置方法配置入口有两个二选一即可。其一是插件列表在首选项 → 插件 → 自定义插件中双击 NoTrans会弹出四个勾选框勾选项含义是禁用该场景的翻译保存后 Hook 会立即按新配置更新。其二更顺手右键 Calibre 工具栏在添加/删除工具栏项目里加入 NoTrans之后点击工具栏图标即可随时打开配置界面界面逻辑在ui.py中实现。修改选项后刷新书库路径勾选或取消某个选项只影响之后的新操作书库里已经存在的旧路径不会被自动改写。如果需要把当前书库所有书籍的保存路径按新规则重刷一遍使用工具栏 NoTrans 菜单里的刷新书库Refresh Library点击工具栏 NoTrans → 刷新书库确认对话框提示操作可能需要一段时间。插件会以后台任务逐本书重算路径状态栏显示进度和当前书名。完成后即可在书库目录中看到更新后的路径。刷新书库有三个边界需要清楚只作用于当前打开的书库其他书库不受影响已经发送到设备的文件不会被重写设备文件与书库文件的关联关系在刷新后原样保留操作过程是后台线程执行期间可以继续使用 Calibre。常见疑问与版本选择Release 列表里除了 v3.x 还能看到 v6.x、v7.x 这样的高版本号容易让人困惑。这些高版本号是早期补丁方案使用的版本号与对应的 Calibre 版本一一绑定v1、v2 同属补丁路线而 v3 是插件路线也就是现在推荐使用的形态。选 v3 的实际理由是安装是一次性的不改动 Calibre 自身文件之后升级 Calibre 无需重新处理兼容性也更好。如果坚持要用补丁版项目提供了 bypy-patch 分支可作参考但维护成本明显更高。另一个常见误会是担心刷新书库会波及设备上的文件。实际机制只重算书库内的路径记录设备侧文件与书库文件的对应关系保持不变任何时点执行刷新都可以。小结NoTrans 用四个独立开关覆盖了书库、USB含本地文件夹、MTP 和智能设备应用四条路径通道配合刷新书库功能可以处理存量路径。对于以中文组织书库、并经常向手机或 U 盘传输电子书的用户按本文步骤装好插件、保留书库 USB两项勾选再视需要打开 MTP就能让路径从导入到同步全程保持原样。许可证为 GPL v3见项目LICENSE与中文说明readme_zh.md。【免费下载链接】calibre-do-not-translate-my-pathSwitch my calibre library from ascii path to plain Unicode path. 将我的书库从拼音目录切换至非纯英文中文命名项目地址: https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考