分享最近的改动和bug

[yu45020]

我按照个人喜好来做了一点点修改 （版本1.6.10)

一边用一边修bug，代码在这，暂时能用，没发现问题🤣。

Bug修复

启动时设置写入竞争/损坏

• 问题： 多次调用 save-setting 可能会损坏 setting.json（如启动时或切换语言时）。
• 修复： 合并写入 (Coalesce writes)；最后一次写入优先，但会保留缺失的设置。先写入 setting.json.tmp，然后重命名。
• 复现： 在设置页面，Trim Title RegExp 总是为空，因为并发保存。
• 补丁： code

7z的UTF-8编码与特殊文件名

• 问题： 非ASCII名称和以 - 开头的文件名在导致7z解压失败。
• 修复： 给7z参数添加 -sccUTF-8 和 --；输出解码为UTF-8。
• 复现： 用日文子文件夹和名为 -abc.jpg 的文件压缩文件夹。调用7z时失败。
• 补丁： code

扫描时重复文件处理

• 问题： 扫描(Scan)与强制重建(Forced Rebuild)时重复文件处理不一致。
• 修复： 发现重复时，使用数据库中的文件路径验证其存在性。如果不存在，则视为已迁移；否则作为新文件添加。
• 复现： 将文件复制到两个文件夹；扫描和强制重建结果不同。
• 补丁： code

其他小修复

• resultLists 可能为undefined code
• callback 可能为undefined code
• collectionList 可能不是数组 code1, code2

其他

• 在 getBookInfoFromHentag 中，使用 category: categoryOption.value[data.category-1]（索引从0开始）。code .

改进

并行扫描/重建/补丁，限速与中止

• 内容： 对读取压缩包和写入封面缩略图进行并发控制；批量数据库提交；可中止任务。

• 设计：

  • 文件分批处理；每批内：
    • 启动多个 7z (-mmt=1) 进程将文件加载到内存。
    • 用单独队列写入封面到磁盘。
    • 每批结束时提交数据库。
  • 中止控制器可取消正在进行的任务。
  • 设置页面新UI：并发读取（解压文件）和写入（封面缩略图）。默认值保守（读=4或最大CPU，写=2或最大CPU）。
  • 扫描时检查书籍是否存在；若缺失则分配“缺失”类别。

• 结果：

  • 强制重建含360文件（43.3GB）的库。App/dbs/cover文件夹在SSD；库文件夹在7200rpm CMR HDD。

    读	写	时间(s)
    4	2	21.77
    4	4	19.36
    6	4	14.13
    8	2	15.90
    8	4	11.36
    8	8	11.28
    16	4	11.10
    16	16	11.84

  • 更高的扫描/读取值未必提升性能，因封面写入和数据库提交成为瓶颈。

  • 在HDD上扫描28,521文件（2.68TB）：8读/4写≈2816s，4读/2写≈2732s。

• 注意： 某些杀毒软件会在进程退出后并行重新扫描所有被操作的文件，导致磁盘持续高负载。如Norton用 aswidsagent.exe 扫描所有被7z操作的文件，且无法关闭。长时间运行时建议将大型库文件夹加入白名单。

• 补丁：

  • Aborter
  • Extract files to RAM
  • load-book-list
  • force-gene-book-list
  • patch-local-metadata

启动加速（SQL）

• 内容： 在 loadBookListFromDatabase 中用SQL查询替换JS循环。
• 结果： 28,521文件：启动时间从3.61s降至0.39s。
• 补丁： code

分片封面文件夹

• 内容： 用封面哈希前两位十六进制分256子文件夹；文件名为 sha256(imageBuffer).webp。
• 原因： 单一大目录导致枚举和清理变慢。
• 方法：
  • 新路径：cover/<hh><hash>.webp，<hh>为哈希前两位。
  • 数据库存储封面哈希，迁移简单。
• 补丁 code

更快的库树

• 内容： 用二分查找构建文件夹树。
• 方法：
  • 路径排序和索引。
  • 计算并缓存上下界索引。
  • 用二分查找列出指定文件夹下所有书籍。
• 结果： 点击文件夹显示所有书籍时，数据库有28K行时新方法比旧方法快约2秒。
• 补丁： FolderTree.vue
  • build tree
  • list files for a folder

新分类搜索模式

• 内容： 用 cat:category$ 在搜索对话框筛选分类。
• 原因： 现有设计用 category$，会包含标题匹配分类名的书籍。
• 补丁： code

新UI功能

标签更新内置浏览器

• 内容： 内嵌浏览器直接访问网站并应用标签。
• 原因： 现有搜索对话框只显示标题，结果常缺失。
• 设计：
  • 从书籍详情“手动获取元数据”打开。
  • 内置广告拦截；可编辑URL栏显示当前页面；确认按钮在支持的URL模式下激活。
    • ehentai: https://e-hentai.org/g/{gallery_id}/{gallery_token}/
    • exhentai: https://exhentai.org/g/{gallery_id}/{gallery_token}/
    • nhentai: https://exhentai.org/g/{gallery_id}
    • hentag: https://hentag.com/vault/
    • panda chaika: 将 Source metadata 粘贴到URL栏
  • 确认按钮：更新所有漫画标签。eh/ex/hentag用公共API；nhentai用内置爬虫。
  • 更新分类/作者/社团/角色按钮：ex/ehentai URL激活；无精确匹配时有用。
  • 需登录e-hentai才能访问exhentai。登录状态持久化。
• 补丁：
  • UI: SearchDialogBrowser.vue
  • Parent node: SearchDialog.vue

设置：移除缺失记录

• 内容： 按钮移除数据库缺失记录和未引用封面文件。
• 原因： 现有设计每次扫描库时移除缺失记录，库文件夹配置错误时易误删。
• 设计：
  • 按钮在设置→高级。
  • 点击后验证数据库所有书籍是否存在，标记缺失项，并缓存所有未被引用的封面缩略图。
  • 弹窗显示缺失书籍数、未引用封面数、数据库真空选项和确认按钮。
• 补丁
  • UI
  • On click
  • ipcMain

设置：库文件夹管理

• 内容： 设置页可添加/移除库文件夹。
• 原因： 现有设计只允许单一库根，新设计便于管理多个库文件夹。
• 设计：
  • 设置页General标签显示库文件夹，带管理按钮。
  • 管理库标签页可添加/移除文件夹。
  • setting.json 新增 'libraries': [path string]
  • 更新 scanLibraryFilesWithExclude 支持多库文件夹。
• 补丁：
  • Library folders in the general tab
  • Manage Library Tab

侧边栏：文件夹树/作者/社团/Parody标签

• 内容： 文件夹树支持多库文件夹；新标签页快速访问作者、社团、恶搞。
• 原因：
  • 旧文件夹树只允许一个库文件夹，管理多库不便。
  • 主窗口有标签/作者快捷方式，但不支持全库。
• 设计：
  • 文件夹树：
    • 顶部“All”节点显示所有书籍。
    • 展开/收起所有节点按钮。
    • 仅有一个子文件夹且无文件时收起顶层节点。
  • 作者/社团/Parody标签页：
    • 点击标签显示所有作者/社团/恶搞。
    • 点击项在主窗口显示书籍。
    • 按En/Jp/Zh/数量排序。
    • 按En/Jp/Zh搜索。
• 补丁： FolderTree.vue

移动文件：移动文件对话框

• 内容： 新对话框选择文件移动目标文件夹。
• 原因： 子文件夹多时难以选择目标。
• 设计：
  • 用系统文件管理器（ipcMain.handle('select-folder')）选文件夹。
  • 文件可移动到任意文件夹，不限于库文件夹。
• 补丁：
  • UI
  • Usage in parent node

UI微调

• 缺失文件分配“缺失”状态 code
• E-Hentai风格分类标签，保留 tag-failed 和 non-tag code
• “缺失”分类用于缺失文件。每次扫描都验证文件存在。code
• No Tag Only 过滤器
• 书籍详情（编辑标签）列出默认标签 code
• 鼠标前进/后退导航 code
  • home UI：
    • a. 后退按钮：
      • 当前页为首页时重置（同原行为）
      • 否则返回上一页
    • b. 前进按钮：如有下一页则前进
  • bookdetail UI：
    • a. 后退按钮：关闭书籍详情UI
    • b. 前进按钮：如有则查看下一个书籍详情
• Electron ≥ 30后设置页UI对齐
• 默认隐藏评论

环境

• Windows 11
• 应用版本：1.6.10
• 上游版本：23dc690c（2025年8月8日）

[SchneeHertz]

bro你这差不多都快重写了吧
国庆后我找个时间好好研究下

[wqc7741]

不会代码，只能说一声牛逼

[yu45020]

对了，能分享你的code style setting？ 我用JetBrains的设置，怎么调都对不上你的。 直接用你的设置再调整代码就方便你看

[SchneeHertz]

好像没什么特别的，我没有特地设置一个style
习惯的话是这样，camelCase变量命名，无尾随分号，2空格缩进，字符串用单引号。

[yu45020]

我指code formatter。 比如vscode 和JetBrains都有Prettier和默认的formatter 。 我写代码的时候自动reformat code，总是把你的改动了你的代码，比如加了空格，分行等。如果你有什么软件自动reformat的话，我可以直接套用你的设置。 除了命名，我没有固定习惯代码习惯的，看的顺眼就可以。

[SchneeHertz]

我指code formatter。 比如vscode 和JetBrains都有Prettier和默认的formatter 。 我写代码的时候自动reformat code，总是把你的改动了你的代码，比如加了空格，分行等。如果你有什么软件自动reformat的话，我可以直接套用你的设置。 除了命名，我没有固定习惯代码习惯的，看的顺眼就可以。

没有使用自动reformat。

[yu45020]

多了一点点新的功能，我直接放在这里。 处于能用的状态。

重新设计的搜索栏

• 功能概述： 模糊建议 + 布尔查询。
• 设计：
  • 内联搜索提示
  • 使用 fuse 生成标签索引与建议
  • liqe + 自定义解析器，支持多条件布尔查询
  • 参见 Searcher 文档

举几个栗子

• 找页数对不上，模糊配对要确认： pagediff + status:need-verify
• 找2022年1月后上传，非Manga， tag不带 lol*: ptime:>2022-01 - category:Manga - tags:lol*
• 作者开头是kan的画集： a:kan + other:artbook

批量元数据更新

• 功能概述： 一个统一面板，用于批量元数据更新与校验。

• 设计：

  • 方法：
    • 图像哈希 → Ex / ExHentai
    • 通过 api_dump.sqlite 进行精确 / 模糊匹配
    • 使用 EhViewer 本地文件夹信息 → 匹配 api_dump.sqlite 或 Ex 公共 API
  • 主窗口中的“快捷操作”下拉菜单
  • 提供校验页面以人工确认模糊匹配
  • 新增状态 need-verify（当由 api_dump.sqlite 更新时）

• 模糊匹配流程：

  • 使用文件名表 + FTS 虚拟表初始化 api_dump.sqlite（约需 1 分钟）。
  • 先对规范化后的文件名做精确匹配。
  • 若精确匹配结果 > 1，设置 need-verify。
  • 否则使用 bm25 排序候选并进行模糊匹配；仍设置 need-verify。
  • 由独立进程管理工作线程池以并行匹配。

• 结果：

  • 28496 本书约 210 秒 完成模糊匹配。

• 补丁位置：

  • ./src/main/matcher
  • 详细实现

统一管理批量更新，支持多个 api_dump.sqlite。

---

标签翻译

• 功能概述： 统一的按需标签翻译。

• 原因：

  • 翻译数据集具备分类感知（同一术语在不同分类下含义不同）。此前将结构扁平化为 {term: {name, intro}} 容易导致误译。

• 设计：

  • 在主进程加载或下载翻译文件并进行非扁平化解析。代码
  • 在 pinia.js 中新增 translate 函数，在启用翻译时自动翻译标签。
  • 查询时采用分层检索并带缓存：若已知标签分类则优先检索该分类；未知则在其他分类中查找。

• 补丁： 参见 src/main/translation

通过缓存加速启动

• 功能概述： 启动时加载应用缓存，减少构建 this.bookList 与侧边面板数据的时间。
• 原因： 当资料库未变化时跳过磁盘扫描，从而提升启动速度。
• 设计：
  • 在 database.sqlite 与 metadata.sqlite 中创建 meta 表；meta 表通过触发器跟踪插入 / 更新 / 删除操作（变更痕迹）。代码
  • 启动时校验数据库是否变化；未变化则使用缓存。代码
  • 在 loadCollectionList 中镜像（同步）appCache；该函数会在 scan、forced rebuild、patchLocalMeta 之后调用。代码
  • 程序退出前，判断是否需要更新缓存。代码
• 结果：
  • 28K 条记录的库，启动时间由 3.5 s 降至 1.4 s。

重大变更（Breaking Changes）

• 元数据抓取器：图像哈希查询仅支持 E-Hentai / ExHentai（每个哈希唯一匹配）。
• sqlite3：固定为 5.1.6 以使用预编译二进制（撰写时 5.1.7 需要从源码构建）。
• i18n：openMangaLocation → revealInFolder（“在文件夹中显示”）。
• 启动流程：启动时不再校验文件是否存在；如需校验，请使用 Scan / Rebuild / Patch。
• 标签索引：仅在“书籍详情”中手动编辑标签时重建。此前，打开编辑对话框会按分类重建；现在批量更新 / 删除 / 手动搜索不再触发重建。仅当 bookDetailDialog 中出现新的手动更改时才重建标签索引。