update

src/main/utils/reveal.ts

@@ -0,0 +1,49 @@
+// src/main/utils/reveal.ts — 跨平台"在文件管理器中显示文件"helper
+//
+// 集中到共享层是因为同一份 3-way 分支(Win / Mac / Linux)之前在 library.ts
+// 与 notes.ts 各写一份,任何漂移(改 API、改日志、改错误形态)只能 grep 兜底,
+// 且 Linux 失败路径只有 library.ts 接住 reject,notes.ts 偶发仍是静默 no-op
+// (audit 2026-08-26 收口时未对齐)。共享 helper 把行为绑死:
+//
+//   - Windows / macOS: shell.showItemInFolder (Win32 SHOpenFolderAndSelectItems /
+//     NSWorkspace selectFile,最可靠)。Win 上 child_process.spawn('explorer.exe',
+//     ['/select,"..."'], ...) 在不少环境下被静默忽略(Node 命令行 quoting + explorer
+//     解析在某些路径/会话下不兼容),改用 Electron 官方 API 是推荐做法。
+//   - Linux: 无标准 reveal 语义,降级为打开父目录。shell.openPath 在 Linux 上
+//     经常返回非空错误字符串(xdg-open 缺失 / dbus 不可用 / 无默认文件管理器),
+//     不接住会让用户点了「在文件夹中显示」毫无反应 —— 这里把非空 err 翻译为
+//     LibraryError 让 caller 决定走 IPC 错误流。
+//
+// 注:helper 不做文件存在预检 —— 预检归 caller(notes.ts:204 先过
+//   utils/file-check.ts 的 assertFileExists,r24 起两域已收敛到该共享
+//   helper,「library.ts:assertFileExists / notes.ts 内联 fs.open」的旧
+//   分工已不存在;audit-r124 校正)。共享层只关心"文件存在就怎么 reveal"。
+
+import { dirname } from 'path';
+import { shell } from 'electron';
+import { LibraryError, errMsg } from './error';
+
+export async function revealInOSFileManager(absPath: string): Promise<void> {
+  if (process.platform === 'linux') {
+    // Linux: 无标准 reveal 语义,降级为打开父目录
+    const openErr = await shell.openPath(dirname(absPath));
+    if (openErr) throw new LibraryError('IO_ERROR', `openPath failed: ${openErr}`);
+    return;
+  }
+  // Windows / macOS - 走官方 API;caller 的 assertFileExists 已经保证文件存在
+  shell.showItemInFolder(absPath);
+}
+
+/**
+ * Wrap revealInOSFileManager 抛错 → IPC 错误流。
+ * notes.ts 旧实现把非 Linux 路径吞掉,Mac/Linux 上次抛错静默,这里统一 catch
+ * 后转 IO_ERROR,行为与 library.ts 收口对齐。
+ */
+export async function revealInOSFileManagerSafe(absPath: string): Promise<void> {
+  try {
+    await revealInOSFileManager(absPath);
+  } catch (err: unknown) {
+    if (err instanceof LibraryError) throw err;
+    throw new LibraryError('IO_ERROR', errMsg(err));
+  }
+}