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-pathCalibre 在添加书籍和发送到设备时会把中文等非 ASCII 路径悄悄转成拉丁字母。Calibre 插件 NoTrans 做的事情很直接在书库保存、USB 传输、MTP 传输等关键位置接管路径处理让鲁迅/呐喊.epub这样的中文路径原样保留。装一次不用管发书到 Kindle、Android 或本地文件夹时设备上看到的就是你熟悉的中文目录而不是拼音。一次典型的拼音化过程Calibre 把中文路径转成拼音不是 bug而是它为了兼容各种文件系统做的统一处理。实际影响有两个地方本地书库添加书籍时Calibre 会把书名和作者名里的非 ASCII 字符转成拉丁形式中文书库会变成一堆 pinyin 目录。发送到设备书传到 Kindle、Android 手机后设备上的文件夹名同样是拼音。一个直观的例子你书库里是鲁迅/呐喊.pdf发完设备后变成类似 Lu Xun/Nahan.pdf 的目录。找书要逐个点开批量管理更麻烦。NoTrans 的思路只有一个在转换发生前把这条路径原样放行。三步完成安装5 分钟内跑通安装就是装一个标准 Calibre 插件不需要改任何 Calibre 文件拿到插件包从项目 Release 下载最新的NoTrans.zip。也可以自行克隆仓库后按release.py打包git clone https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path加载插件Calibre 中依次打开首选项 → 高级选项 → 插件点右下角的从文件加载插件选择下载的 zip 文件。重启 Calibre重启后插件即生效默认四个开关全部开启中文路径直接保留。如果想把它的菜单挂到工具栏方便日后操作再进入自定义工具栏在动作列表里找到 No Trans 加入即可。四个核心能力书库路径保持原样添加书籍时保存路径不做拉丁化中文书名和作者名直接落盘。USB 与本地文件夹通道U 盘、SD 卡、挂载目录以及发送到设备里的本地文件夹传输时的目录名保持中文。MTP 设备支持Android 手机、平板这类走 MTP 协议的设备上传路径同样不翻译。刷新书库工具栏菜单一键重算当前书库所有书籍的保存路径给已经拼音化的老书库一次批量补救的机会。三个真实使用场景发书到 Kindle 或电纸书。安装后直接发送到设备设备上的文件夹名就是中文书名和作者名。再配合设备端在设备上查看之类的功能找书不再靠拼音联想。本地文件夹同步到网盘或 NAS。很多人用 Calibre 的本地文件夹设备把书库同步到 U 盘、NAS。保持 USB 通道开启后同步出去的目录结构和书库一致中文命名不被打乱两边对照着看也不会乱。救回一整个拼音化书库。如果书库里已经有几百本书是拼音路径把对应开关打开后点工具栏 NoTrans 菜单里的刷新书库。插件会后台遍历全部书籍、逐本重写保存路径大书库会花几分钟期间会有进度提示等它跑完即可。配置只有四个开关默认全开配置入口在插件的自定义设置窗口或工具栏 NoTrans 菜单的配置里对应源码见 ui.py 和 config.py。一共四个勾选项逻辑都是勾选 该通道不翻译开关作用范围书库添加书籍时的保存路径USB 设备含本地文件夹U 盘、SD 卡、挂载目录、本地文件夹MTP 设备Android 等 MTP 协议设备智能设备应用远程 App 传输一般保持默认全开即可。只有当某个通道在你的设备上出现乱码或传输失败时才需要单独关掉对应那一项。原理速览把四个转换函数换掉就够插件启动时做一件关键的事把 Calibre 内部负责拉丁化路径的函数替换成 Calibre 自带的sanitize_file_name——后者只做轻量清理不动非 ASCII 字符。四个通道各对应一个被替换的函数书库是ascii_filenameUSB 和 App 是sanitizeMTP 是create_upload_path具体逻辑见init.py 里的Hook类。关闭某个开关时插件会把原函数还原回去。整个过程不修改 Calibre 安装目录里的任何文件禁用插件后行为立即回到默认要求 Calibre 5.0 及以上。先想清楚这四件事再动手刷新不等于重新发送。刷新书库只改本地书库里的保存路径记录设备上已有的文件不会自动改名也不会重传。想让设备端用上新路径需要重新发送一次原有的设备文件与书库文件的关联仍然保留。设备端出现乱码要关对应通道。个别老设备的文件系统对中文支持差出现乱码或传输失败时把对应开关单独关掉而不是整体禁用插件。高版本号不是给这个插件的。旧 Release 里那些 v6.x、v7.x 是早期 patch 方案留下的与 Calibre 版本一一对应。v3 起改用插件方案版本号与 Calibre 版本无关。刷新是长任务。大书库下刷新书库会在后台线程逐本处理中途不要关闭 Calibre。常见问题Q1装了 NoTrans 会影响 Calibre 其他功能吗不会。插件只替换上面提到的四个路径函数书籍转换、元数据编辑等功能都不经过这些函数。Q2它只支持中文吗不是。插件做的是不翻译任何非 ASCII 字符中文、日文、韩文、西里尔字母等都会原样保留不是针对中文特判。Q3Linux 和 macOS 上能用吗支持 Windows、macOS、Linux 三个平台唯一要求是 Calibre 5.0 以上。Q4为什么叫 v3v1、v2 是 patch改 Calibre 源码补丁方案v3 改成标准插件方案安装和卸载都干净得多。Q5不想要了怎么删在插件设置里禁用或卸载即可。被替换的函数在配置保存和插件移除时会还原Calibre 恢复默认路径行为。下一步如果你的书库和设备正被拼音路径困扰按前面三步装上 NoTrans发一次书看看设备上的目录名。遇到开关取舍、刷新顺序这类问题先看 readme_zh.md也可以到项目仓库提交 Issue 反馈。【免费下载链接】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），仅供参考
