企业官网建设流程全解析

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

NoTrans 是一款免费的 Calibre 插件，解决一个具体问题：书库目录和发送到设备上的中文路径会被自动翻译成拼音。启用后，本地书库与设备端都保留中文目录名。

如何判断你的 Calibre 路径被翻译了

你按中文作者名和书名整理书库，传输到设备后打开一看，目录却是一串拼音；本地书库里的文件夹名也变成了拼音，找书时只能靠书名硬对。

对照下面三条自测：

• 新加入的书，在书库目录下生成的文件夹是拼音而不是中文？
• 通过 USB 或手机同步后，设备上的文件路径变成了 ASCII 或拼音？
• 你平时靠目录结构快速定位书，拼音路径让你很难辨认？

任意一条命中，这个插件就有用武之地。

三步安装并启用 NoTrans 插件 🚀

1. 获取插件文件。从项目 Release 页面下载 zip 插件包；如果你习惯用命令行，也可以：

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

预期结果：你手上有一个 zip 插件包（或克隆下来的源码目录）。

2. 打开 Calibre，进入“首选项 → 高级选项 → 插件”，点右下角的“从文件加载插件”，选择这个 zip。 预期结果：插件列表里出现 NoTrans。

3. 重启 Calibre，并在插件列表中确认 NoTrans 处于启用状态。 预期结果：工具栏出现 NoTrans 按钮，菜单里包含“配置”和“刷新书库”两项。

最快验证插件是否生效的方法

先看本地书库：加入一本中文书名的书，书库目录下新建的文件夹应是中文作者名，而不是拼音。再连接 USB 设备或安卓手机，把这本书同步过去，设备端路径应呈现“作者名/书名.epub”的形式。

前后对比很直观：启用前，设备端路径是拼音；启用后，新同步的文件是中文。已经传输过的文件不会被自动改名，重新同步一次才能看到新路径。

NoTrans 四个关键配置项说明 ⚙️

插件配置就是四个复选框，默认全部勾选，勾选表示“该通道的路径不翻译”：

四项默认值定义在 config.py 中，改动后保存即持久化；配置界面与刷新书库的逻辑在 ui.py。如果你只走 USB 传输，勾着 USB 一项、其余关闭即可。

遇到问题时：三个常见现象的排查方法

1. 传输后路径仍是拼音 可能原因：对应通道的选项没有勾选，或修改配置后没有重启 Calibre。 解决办法：在插件配置中勾上对应项，重启 Calibre，再重新发送这本书。

2. 改了书库选项，已有书籍目录还是拼音 可能原因：选项只影响新添加的书，不会自动改写库里已有书的路径。 解决办法：在工具栏 NoTrans 菜单中执行“刷新书库”。它只处理当前书库，不影响其他书库，也不会动设备上已经传输的文件。

3. 加载插件后工具栏没有入口 可能原因：插件未勾选启用，或 Calibre 没有重启。 解决办法：在“首选项 → 插件”中启用 NoTrans，重启 Calibre，再到工具栏设置里添加按钮。

幕后原理：NoTrans 实际做了什么

Calibre 在保存书库和发送文件时，会把路径交给一个“清洗”流程，把非英文字符转成 ASCII（拼音）。NoTrans 不改 Calibre 源码，而是把这个流程换成一个“只去掉非法字符、保留中文”的版本，相当于在信件寄出前拦住它，声明照原写法投递。最核心的替换点是书库数据库的路径入口ascii_filename，勾选对应选项后它被换成sanitize_file_name，直接返回原始 Unicode 路径；取消勾选时，原函数逐条还原，Calibre 的其他功能不受影响。

如果你的需求只有“中文路径别动”，这个插件只做这一件事。装好之后你几乎可以忘记它的存在，只在想调整通道时才打开配置。

【免费下载链接】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