|
|
发表于 2026-9-26 12:38:50
|
显示全部楼层
一、"卡壳/无反应"的根因(按可能性排序)
1. 整库放在一个 DB 事务里,且全程不让出事件循环 —— 最致命 noteExpressImport.js:830 importArticles:
4410 篇全部塞进一个 executeTransaction,循环里只有 await(微任务),XUL 的 UI 重绘发生在宏任务/下一帧,所以 _reportProgress(noteExpressImport.js:850 附近,40%→70%)改了 progressBar.value 也永远刷不出来——这就是"等了 5 分钟/12 分钟界面纹丝不动"的直接原因。提交一个几千条的写事务在 SQLite 上本身就是长时间主线程阻塞。
2、2. 全库被完整扫描两次,且和用户的选择无关
readPreviewData → readArticles(:582,SELECT * FROM reference 在 :524,再加 _groupNEAuxRows 对 4 张附表按 chunk=400 查询)
真正导入时 _importOpenedDatabase → readArticles 再来一遍(:207)
即使用户只勾"1 个文件夹 2 篇文献",预览和导入仍然把 4410 篇全读出来,再在前端 filter。所以"只导 2 篇"也照样卡十几分钟。
3. 附件/笔记阶段也是全表遍历 importAttachments 的 SQL(:1024)和 importNotes 的多条 relations 查询都没有按 selectedArticleIDs 下推过滤,先取全库再在 JS 里 Map.get 跳过。选 2 篇 ≠ 只处理 2 篇。
4. 模态 + 禁止取消,放大了观感 showImportDialog 用 'chrome,modal,...'(:66),主窗口被完全冻结;_disableUI 还把 Cancel 一起禁用了(noteExpressImportDialog.js:650),所以用户只能"强制关掉"。
二、"附件抓不过来"的根因
先说明:论坛管理员的判断("卡住了,附件没完成")与代码顺序一致——附件在 65% 才执行(noteExpressImport.js:221),任何一步卡死/强杀,结果就是"题录进了、附件 0"。但即使不卡,这里也有独立的脆弱点:
路径解析候选太窄:_resolveNdbAttachRoot(:388)只用 dbstrings.attach_dir,否则退到 ndb 同级的 FullText/;_buildNdbAttachmentCandidates(:427)只认 <AttachFilePath> 占位符和相对路径。若用户的附件目录被移动、attach_dir 为空、或 resource.url 是 Windows 绝对路径(D:\...),在 macOS 上全部解析失败。
表结构假设单一:只查 relations src_type=2 AND dest_type=4 JOIN resource,且只取 res.url;不同 NE 版本若用别的列/别的关联方式,会直接返回 0 条。
失败被静默吞掉:找不到文件只 Zotero.debug(:1057 附近),不写入 result.errors、不显示给用户,所以用户只看到"附件 0"却不知原因。
扩展名逻辑有 bug::1067 if (PathUtils.filename(attachFile).includes('.')) fileExt='',随后回退 _getFileExtension 默认返回 .pdf——源文件名带点但 title 不带扩展名时,会把 docx 之类错标成 .pdf。
三、导出一完成就卡住(帖子里 17# 的第二个 bug)
导入导出应是同一种写法(模态 + 同步收尾 + 不关窗)。1.2.8 的自定义导出对话框我在本机 1.2.5 的 omni.ja 里没找到对应模块,需要 1.2.8 的包才能精确定位;但从模式看,大概率是"导出逻辑同步阻塞 + 完成后没有 window.close()/没有让出事件循环"这一类问题。
四、最小修复建议
分批事务:把 importArticles 的那个大事务改成每 200–300 条一个 executeTransaction,批间 await Zotero.Promise.delay(0) 让出事件循环,让进度条能刷新、UI 不完全锁死。
只读选区:预览阶段就支持按 selectedFolderIDs 过滤;导入时复用预览已读数据,删除 :207 的第二次 readArticles;readArticles/importAttachments/importNotes 用 WHERE item_id IN (...) 把选择集下推到 SQL。
可取消:保留 Cancel,提供 abort(停止后续批次即可,已提交批次不回滚);完成后复位 _importing(现在 _showResult 后仍为 true,Done 按钮点击会被 doImport 直接 return,只能等 3 秒自动关)。
附件健壮化:扩充路径候选(绝对路径、相对 attach_dir 各前缀、大小写/分隔符变体)、对所有失败写进 result.errors 并在结果页显示;把附件做成独立、可重试的步骤,并提供"仅补抓附件"。修掉上面的扩展名判断。
验证方式:开 Zotero.debug 日志跑一次,重点看 Found N attachments 与 Skipped N attachments 两个计数——若 Found=0 是表结构/SQL 假设问题,若 Skipped 很大则是路径解析问题。
|
|