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还在为Calibre自动将中文书名转换为拼音路径而烦恼吗Calibre-do-not-translate-my-path插件为您提供终极解决方案让您的电子书库路径保持原生中文命名彻底告别混乱的拼音目录。这款专为中文用户设计的Calibre插件能够智能控制Calibre不再将各种路径拉丁化包括书库路径和发送到设备的文件实现真正的原生中文路径管理。 核心问题为什么需要中文路径插件问题场景重现当您在Calibre中添加一本名为《三体》的电子书时Calibre会自动将其存储路径转换为san-ti这样的拼音格式。这不仅让目录结构变得难以识别还在以下场景中带来困扰文件管理混乱无法通过中文名称快速定位文件设备同步问题发送到移动设备时路径被转换备份困难拼音路径与原始中文名称不对应技术原理剖析Calibre默认使用sanitize_file_name函数处理文件名该函数会将非ASCII字符转换为ASCII等价物。插件通过钩子Hook机制拦截这一过程让Calibre直接使用原生文件名。核心配置文件config.py定义了四个关键开关# config.py中的默认配置 prefs.defaults[db] True # 书库路径 prefs.defaults[usb] True # USB设备 prefs.defaults[mtp] True # MTP设备 prefs.defaults[app] True # 智能设备应用 安装与配置三步快速上手第一步获取插件git clone https://gitcode.com/gh_mirrors/ca/calibre-do-not-translate-my-path第二步安装插件打开Calibre → 首选项 → 插件点击右下角从文件加载插件选择项目中的插件文件重启Calibre完成安装第三步个性化配置插件提供了直观的配置界面您可以根据需求选择启用哪些路径转换控制✅ 书库路径控制添加书籍时的路径转换✅ USB设备包含U盘、SD卡等本地文件夹✅ MTP设备Android设备等媒体传输协议设备✅ 智能设备应用智能设备应用支持️ 高级功能刷新书库与路径管理刷新书库功能详解当您修改了插件配置后可能需要刷新现有书库的保存路径。插件提供了刷新书库功能该功能在ui.py中实现def do_refresh(self, db, notifications, log, abort): ids db.new_api.all_book_ids() for i, book_id in enumerate(ids): i i 1 meta db.new_api.get_metadata(book_id) notifications.put((i / len(ids), meta.title)) log.info(f{i}/{len(ids)} {meta.title}) db.new_api.set_metadata(book_id, meta)重要提示刷新操作仅影响当前书库不会影响其他书库也不会影响已发送到设备的文件。工具栏集成插件支持将功能添加到Calibre工具栏通过ui.py中的action_spec配置action_spec ( _(No Trans), images/icon.png, _(Configure No Trans), None, ) 性能优化与最佳实践配置优化建议按需启用如果主要使用本地书库可只启用书库路径选项设备兼容性对于Android设备建议同时启用MTP设备选项性能监控大型书库刷新时建议在空闲时间操作内存管理技巧插件采用轻量级钩子机制内存占用极低。但刷新大型书库时建议分批处理超过5000本书籍的书库可先备份数据库再进行刷新操作监控系统资源使用情况 故障排查指南常见问题与解决方案问题1插件安装后无效检查Calibre版本是否≥5.0确认插件已正确启用查看init.py中的版本兼容性问题2路径仍被转换检查config.py中的配置项确认对应设备类型的选项已启用重启Calibre使配置生效问题3刷新书库卡住检查书库大小大型书库需要较长时间查看prompt_output.txt中的日志确认有足够的磁盘空间调试技巧查看日志检查prompt_output.txt获取详细运行信息配置文件验证确认config.py中的默认设置版本检查查看version文件确认插件版本 高级定制与开发指南扩展插件功能如果您是开发者可以通过修改init.py中的Hook类来扩展插件功能class Hook(object): def __init__(self): # 数据库钩子 try: from calibre.db import backend self.db backend self.db_ori backend.ascii_filename except ImportError: self.db None自定义路径处理插件使用sanitize_file_name作为替代函数您可以根据需要实现自定义的路径处理逻辑def custom_sanitize(filename): # 实现自定义的路径处理逻辑 return filename # 返回原始文件名 版本兼容性与更新计划当前版本兼容性Calibre版本≥5.0Python 3操作系统Windows、macOS、Linux全平台支持Python版本Python 3.x未来更新方向更多设备支持扩展更多设备类型的路径控制智能路径优化根据文件系统特性自动优化路径批量操作增强提供更强大的批量路径管理功能 实用技巧与经验分享最佳使用场景个人书库管理保持中文书籍的原生路径结构团队协作统一团队成员的路径命名规范多设备同步确保不同设备间路径一致性性能优化建议定期清理配合Calibre的数据库清理功能使用增量刷新只刷新新增或修改的书籍备份策略重要书库操作前先备份数据库安全注意事项路径长度限制某些文件系统有路径长度限制特殊字符处理插件会保留原始文件名中的合法字符系统兼容性确保目标设备支持中文路径通过Calibre-do-not-translate-my-path插件您可以彻底解决中文电子书路径管理的问题让您的书库管理更加高效和专业。无论是个人使用还是团队协作这款插件都能为您提供稳定可靠的中文路径支持。【免费下载链接】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），仅供参考