50 lines
2.5 KiB
TypeScript
50 lines
2.5 KiB
TypeScript
// 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));
|
|
}
|
|
}
|