鸿蒙 PC × Electron:快捷键、右键菜单、输入法、单实例
欢迎加入开源鸿蒙PC社区:https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
配套工程源码(墨记 MoJi):https://atomgit.com/gcw_TvBBemqt/moji-electron-ohos
验证环境:HUAWEI MateBook Pro S(MOR-M1),HarmonyOS 7.0.0.111(SP15C00E101R9P2),API 26,aarch64(2in1),HongMeng Kernel 1.13.0。运行时 Electron 40.0.1-release / Chromium 144.0.7559.76 / Node 24.11.1。应用版本 v1.1.0,实测时 8–12 篇笔记(不同测试时点)。
这一篇处理四个容易混在一起的问题:键盘快捷键到底绑了哪些,右键菜单有没有,中文输入法在搜索框和编辑器里是不是一回事,单实例到底是不是单实例。结论先放前面:快捷键有 9 个入口(8 个组合键加 Esc,含 v1.1 新增的 Ctrl+0 缩放复位);右键菜单在 v1.1 已实现 9 个动作;中文输入在搜索框里实测可用、编辑器里未单独测;单实例锁已实现,连续 4 次 aa start 后只剩 1 个主进程,secondInstance.count=4;系统打印也已打通,Ctrl+P 打开系统打印对话框,回调 success=true,耗时 3523 ms。笔记内查找仍未做。
快捷键、右键、打印和单实例这些看起来依赖系统的部分,这一篇都在鸿蒙 PC 上逐项点过;开发、构建、装机、调试没有换机器,在鸿蒙 PC 上开发鸿蒙应用这条键盘链路是通的。
1. 结论表
| 项目 | 状态 | 依据 |
|---|---|---|
Ctrl+N 新建 | 已实现 | onKeydown 分支 |
Ctrl+S 保存 | 已实现 | flushSave(true) |
Ctrl+F 聚焦搜索 | 已实现 | focusSearch() |
Ctrl+B 粗体 | 已实现,仅编辑器焦点 | activeElement === el.editor |
Ctrl+I 斜体 | 已实现,仅编辑器焦点 | 同上 |
Ctrl+Shift+P 预览切换 | 已实现 | 编辑/分栏/预览三态切换 |
Ctrl+P 系统打印 | 已实现 | webContents.print,3523 ms |
Ctrl+0 缩放复位 | 已实现 | setZoom(1),写回 settings.zoom |
Esc 关闭弹层 | 已实现 | 按层级从内到外 |
| 右键菜单 | 已实现,9 个动作 | contextmenu + 自绘菜单 |
| 「更多操作」菜单 | 已实现,9 项 | 更多操作菜单图 |
| 搜索框中文输入 | 实测可用 | 搜索中文图,「窗口」3 条结果 |
| 编辑器中文输入 | 未单独测 | 无输入法专项数据 |
| 单实例锁 | 已实现 | 4 次 aa start,1 个主进程 |
| 应用内多窗口 | 已实现 | 双窗口图,两个窗口 |
| 窗口间同步 | 已实现,约 3 ms | note:changed 广播 |
| 笔记内查找 | 未实现 | Ctrl+F 聚焦的是全局搜索 |
这张表里有两组容易被误读的对应关系。第一组是 Ctrl+F 和「笔记内查找」:很多编辑器里 Ctrl+F 是在当前文档里找,墨记的 Ctrl+F 是把焦点放到左侧全局搜索框,搜的是标题、正文和标签,结果会替换中间的笔记列表。第二组是 Ctrl+P 和「打印」:v1.0 的 Ctrl+P 直接调用 exportNote('pdf'),不弹打印框;v1.1 改成先调 webContents.print({ silent: false }),系统打印对话框出现,回调 success=true,耗时 3523 ms,失败才回退 printToPDF。导出 PDF 仍保留在「⋯」和右键菜单里。这两组都不是 bug,是版本和产品选择,但写快捷键文档时必须写清楚,否则用户会按桌面习惯预期错误的结果。
2. 快捷键的实现
2.1 一个入口,九条分支
所有快捷键都收在 document 的 keydown 上,没有用 Electron 的 globalShortcut,也没有用菜单 accelerator。原因是鸿蒙 PC 上应用菜单被置空,Menu.setApplicationMenu(null) 之后 accelerator 不会生效;用 DOM 键盘事件更直接,也方便按焦点判断。
function onKeydown(event) {
if (event.key === 'Escape') {
if (closeTopOverlay()) event.preventDefault();
return;
}
const mod = event.ctrlKey || event.metaKey;
if (!mod) return;
const key = event.key.toLowerCase();
if (key === 'n' && !event.shiftKey) { event.preventDefault(); newNote(); }
else if (key === 's') { event.preventDefault(); flushSave(true); }
else if (key === 'f') { event.preventDefault(); focusSearch(); }
else if (key === 'b' && document.activeElement === el.editor) { event.preventDefault(); applyFormat('bold'); }
else if (key === 'i' && document.activeElement === el.editor) { event.preventDefault(); applyFormat('italic'); }
else if (key === 'p' && event.shiftKey) { event.preventDefault(); setMode(mode === 'preview' ? 'split' : 'preview'); }
else if (key === 'p') { event.preventDefault(); doPrint(); }
else if (key === '0') { event.preventDefault(); setZoom(1); }
}
mod 同时接受 ctrlKey 和 metaKey,是为了兼容以后可能出现的 Command 键设备;当前这台机器上实际按的是 Ctrl。key 统一转小写,避免 Caps Lock 或 Shift 改变匹配。Ctrl+N 额外排除了 Shift,因为 Ctrl+Shift+N 在桌面端通常是「新建窗口」,这一版没有绑,留给以后。Ctrl+0 是 v1.1 加进来的缩放复位:调 setZoom(1),把 settings.zoom 写回 1 并更新状态栏的「100%」,和设置面板里的缩放是同一个函数。
匹配顺序有讲究。Ctrl+Shift+P 的判断必须放在 Ctrl+P 前面,否则 Ctrl+Shift+P 会先命中 key === 'p' 的普通分支,直接去调系统打印。代码里就是这么排的:先判断 event.shiftKey,再判断普通 p。同理,Ctrl+N 的 !event.shiftKey 让 Ctrl+Shift+N 落到「没有匹配」而不是「新建笔记」。
2.2 Ctrl+B / Ctrl+I 只在编辑器里生效
这两个是格式化快捷键,不是全局快捷键。判断条件是 document.activeElement === el.editor。焦点在搜索框时按 Ctrl+B,不会给笔记加粗,也不会触发浏览器默认的书签栏(Electron 没有书签栏),而是什么都不发生。
这样做的理由很实际:Ctrl+B 在很多场景里是「加粗」,但在搜索框里没有意义;如果做成全局,用户在搜索框里误按会把当前笔记改掉,而且要撤销。限制在编辑器焦点,代价是用户必须先点一下正文,收益是不会误改。
applyFormat('bold') 走的是 wrapSelection('**', '**', '粗体'):有选区就包住选区,没有选区就插入 **粗体** 并把「粗体」选中。Ctrl+I 同理,用单个星号。斜体的正则匹配在 markdown.js 里有边界条件,单个 * 不会误伤 **。
2.3 Ctrl+S 不是「保存一次」而是「立刻落盘」
Ctrl+S 调 flushSave(true),force 为 true 时会跳过 state.dirty 检查,直接发一次 note:save。正常输入时,500 ms 防抖已经会自动保存;Ctrl+S 的作用是「我现在就要确认写下去了」,比如准备关窗、准备导出、准备切到别的应用。
flushSave() 内部用 state.saveChain 串行化:上一次保存没回来,下一次排在它后面。这样即使用户连续按 Ctrl+S,也不会出现两个 writeFileSync 同时写同一个文件。代价是保存慢时按多次会排队,状态栏会连续显示「保存中…」。这一版没有做「合并重复请求」,因为保存通常很快,排队比丢写安全。
2.4 Ctrl+F 的三步
focusSearch() 做三件事:如果列表被折叠,先展开;如果当前在回收站视图,先切回全部笔记;然后 focus() + select() 搜索框。
function focusSearch() {
if (el.app.classList.contains('list-collapsed')) setListCollapsed(false, true);
if (state.view === 'trash') switchView('all');
el.searchInput.focus();
el.searchInput.select();
}
先展开列表,是因为搜索框在列表头部,列表折叠时搜索框不可见;先切回全部,是因为回收站视图下搜索只搜回收站,用户按 Ctrl+F 通常想搜全部。select() 会选中已有文字,用户直接输入就替换,不用先全选删除。
搜索本身不是纯渲染层过滤。input 事件先做两件事:把 state.query 换成新值、把 state.searchIds 清空,然后 renderList()——这一步列表用的还是渲染层 matches() 的 includes 兜底,标题、标签、state.contents[id] 都会扫一遍,所以打字时结果立刻变。180 ms 之后才发真正的查询:api.searchQuery(query) 走 IPC search:query,主进程交给 SearchService 的 worker_threads(search-worker.js)查倒排索引,返回命中的 id 数组和 queryMs;渲染层把 id 存进 state.searchIds,再 renderList() 用 id 集合过滤。worker 不可用时 SearchService 会降级到主线程,搜索框下方那行状态会多出「主线程降级」,查询语义不变。
也就是说,同一串输入会经历两次渲染:一次是本地 includes 的即时结果,一次是 worker 索引的正式结果。索引还没建好时,第一次渲染兜住了「有结果」的体验;索引建好后,第二次渲染把结果收敛成倒排索引的精确命中。搜索框下方那行「索引 N 篇 / 建索引 X ms / 查询 Y ms」来自 search:status,notes、buildMs、lastQueryMs 都是主进程回报的,不是前端估算。

这张图证明 Ctrl+F 的落点是全局搜索,不是编辑器内查找。搜索框里是「窗口」,列表标题变成「搜索结果 3」,三条结果分别来自周会纪要、Electron 窗口模型和产品需求;右侧仍然显示当前打开的周会纪要。图右下角的输入法候选条也说明这次中文是输入法打进去的,不是粘贴的。
2.5 Ctrl+Shift+P 的三态
预览切换不是简单的开/关,是在 edit、split、preview 三态之间切。代码只处理了「当前是 preview 就回 split,否则去 preview」,没有处理「当前是 edit 去 preview」之外的第三种情况。实际效果是:
| 当前模式 | 按 Ctrl+Shift+P 后 | 说明 |
|---|---|---|
| 编辑 | 预览 | 隐藏编辑器,只看渲染结果 |
| 分栏 | 预览 | 从左右分栏变成纯预览 |
| 预览 | 分栏 | 回到默认分栏 |
这个顺序不是循环三态,是「预览/非预览」二态加一个默认回退。用户想从预览回编辑,需要再点顶部「编辑」,或者按两次 Ctrl+Shift+P(预览→分栏→预览,仍然回不到编辑)。这是一个可用性问题,不是 bug;这一版没有做「三态循环」的快捷键。
2.6 Ctrl+P 现在是系统打印
v1.0 的 Ctrl+P 分支是 exportNote('pdf'),PDF 不弹保存框,直接写 moji/exports/<标题>.pdf。v1.1 把这条分支换成了系统打印:先调 webContents.print({ silent: false }),系统打印对话框出现,打印机列表里能看到 Print to PDF,纸张 A4,右侧有预览;回调是 success=true reason=(empty),从按下到回调耗时 3523 ms。失败时才回退 printToPDF,把结果写进 exports。回调没有响应时按失败处理,超时是 12 秒——这一条是源码里的 setTimeout(..., 12000),实测这次 3523 ms 就回来了,没有走到超时分支。
这个改动的理由很直接:系统打印在鸿蒙 PC 上可用,就不该让用户先导出 PDF 再找阅读器。第 27 篇记录的是 v1.0 的边界;v1.1 已经把那条边界补上,但 PDF 导出没有删,仍然在「⋯」菜单和右键菜单里。用户按 Ctrl+P 得到打印对话框,想存 PDF 可以从打印机里选「Print to PDF」,也可以走菜单里的「导出 PDF」。

这张图证明 Ctrl+P 走的是系统打印,不是应用内自绘的预览。对话框里同时出现「添加打印机」面板,说明系统打印服务在这个环境里是完整接管的;应用只负责把当前页面交给 webContents.print(),打印机发现、纸张、份数、预览都由系统处理。
2.7 Esc 的关闭顺序
closeTopOverlay() 按固定顺序检查:右键菜单 → 确认框 → 标签弹层 → 诊断页 → 性能面板 → OCR 文字识别面板 → 设置页 → 更多菜单。命中第一个可见的就关掉并返回 true,onKeydown 里 preventDefault();一个都没有就返回 false,不阻止默认行为。
function closeTopOverlay() {
if (el.contextMenu && !el.contextMenu.hidden) { hideContextMenu(); return true; }
if (!el.confirmOverlay.hidden) { closeConfirm(); return true; }
if (!el.tagOverlay.hidden) { el.tagOverlay.hidden = true; return true; }
if (!el.diagOverlay.hidden) { el.diagOverlay.hidden = true; return true; }
if (el.perfOverlay && !el.perfOverlay.hidden) { el.perfOverlay.hidden = true; return true; }
if (el.ocrOverlay && !el.ocrOverlay.hidden) { el.ocrOverlay.hidden = true; return true; }
if (!el.settingsOverlay.hidden) { el.settingsOverlay.hidden = true; return true; }
if (!el.moreMenu.hidden) { hideMoreMenu(); return true; }
return false;
}
顺序是「越靠前越先关」。右键菜单是最后打开、位置最靠外的一层,所以排在最前;确认框是模态的,必须紧跟其后;性能面板和 OCR 文字识别面板是 v1.1 新加的两个大弹层,放在诊断页之后、设置页之前;更多菜单最轻,最后关。这个顺序和视觉层级一致,用户按一次 Esc 关掉最上面那层,符合预期。
2.8 没有绑的键
| 按键 | 常见用途 | 墨记当前行为 |
|---|---|---|
Ctrl+Z | 撤销 | 交给 textarea 原生撤销 |
Ctrl+Y | 重做 | 交给 textarea 原生重做 |
Ctrl+A | 全选 | 交给 textarea 原生全选 |
Ctrl+Shift+N | 新建窗口 | 未绑定 |
Ctrl+W | 关闭窗口 | 未绑定,走系统关闭按钮 |
Ctrl+P | 打印 | 系统打印,失败回退 PDF |
F12 | DevTools | 主进程 before-input-event 尝试打开 |
Ctrl+Shift+I | DevTools | 未绑定 |
Ctrl+Z/Y/A 没有拦截是对的,textarea 自带的行为比自写好。Ctrl+W 没绑,是因为关窗要走 app:before-close 的保存握手,直接绑一个 win.close() 会绕过保存。F12 在主进程里试了 toggleDevTools(),但第 1 篇已经记录这台机器上打不开,这一版没有再验证。
2.9 快捷键之外还有一层界面入口
快捷键不是唯一入口。新建有左上角「+ 新建」,导入有列表头的下载图标,搜索有搜索框,导出有「⋯」菜单,设置和诊断在左下角和设置页里。快捷键只是把这些入口映射到键盘,不改变入口本身。

这张图证明快捷键对应的按钮都在界面上,而且状态是同步的。按 Ctrl+N 和点「+ 新建」走同一个 newNote(),按 Ctrl+F 和点搜索框走同一个 focusSearch(),按 Ctrl+S 和等 500 ms 自动保存走同一个 flushSave()。没有「只有快捷键能触发」的隐藏功能,也没有「只有按钮能触发」的快捷键。
这种一一对应减少了状态分叉。如果某个操作只有快捷键,用户没法用鼠标发现;如果某个操作只有按钮,键盘用户用不了。墨记的做法是先把按钮做出来,再把最常用的几个绑上键盘,快捷键表就是按钮表的一个子集。
3. 右键菜单:9 个动作
3.1 自绘菜单,和系统右键分开
v1.1 在笔记列表和编辑器上监听 contextmenu,preventDefault() 之后按鼠标坐标画一个 div.menu。菜单不调用系统原生菜单,样式和「⋯」菜单共用。动作包括收藏/取消收藏、复制正文、在新窗口打开、导出 Markdown、导出 HTML、导出 PDF、打印、移到回收站。测量记录记为 9 个动作;截图当前显示「取消收藏」,收藏项会按状态在「收藏/取消收藏」之间切换。

这张图证明右键菜单是应用内自绘的:它出现在笔记项右侧,贴着列表和编辑器的边界,背景、圆角、分隔线和「⋯」菜单一致。系统 uitest 没有右键注入命令,本机用长按触发 Chromium 的 contextmenu,和应用右键走同一个处理函数;原始鼠标 uinput 右击会把事件送到桌面或浏览器窗口,所以截图用长按完成。菜单的关闭有三条路径:点菜单项、点页面空白、按 Esc,另有滚动监听在列表滚动时收起。
3.2 等价操作收在「⋯」菜单
笔记的常用操作放在编辑器右上角的「⋯」按钮里,点开是一个绝对定位的 div.menu,不是系统菜单。v1.1 是九项,按分隔线分三组:
| 菜单项 | 命令 | 行为 |
|---|---|---|
| 在新窗口打开 | newwin | window:new,带当前笔记 id |
| 导出 Markdown | export-md | 保存对话框,.md |
| 导出 HTML | export-html | 保存对话框,.html |
| 导出 PDF | export-pdf | 直接写 exports,不弹框 |
| 复制正文 | copy | clipboard:write |
| 打印 (Ctrl+P) | print | print:now → webContents.print |
| 模拟 Ctrl+滚轮 | zoom-wheel | 注入 WheelEvent(ctrlKey) 验证缩放 |
| 性能面板 v1.1 | perf | 打开 #perfOverlay |
| 移到回收站 | trash | 确认后移入 trash/ |

这张图是 v1.1.0 的真机截图,九项都在:在新窗口打开、导出 Markdown、导出 HTML、导出 PDF、复制正文、打印、模拟 Ctrl+滚轮、性能面板 v1.1、移到回收站。菜单出现在「⋯」按钮下方,右侧贴着窗口边缘,位置由 getBoundingClientRect() 计算,宽度固定 200 px,超出视口就翻到按钮上方;截图里的两条分隔线也和 #moreMenu 的三组结构一致。
菜单的关闭有三条路径:点菜单项、点页面其它地方、按 Esc。document 上有一个 click 监听,判断点击目标不在菜单内也不在按钮内就隐藏;Esc 走 closeTopOverlay() 的最后一条分支。没有用 focusout,因为点菜单项时焦点会先离开按钮,focusout 会把菜单关掉,导致点击丢失。
3.3 右键菜单和「⋯」共用命令表
右键菜单和「更多操作」菜单有重叠,v1.1 没有维护两份命令表:两个入口最终都调到同一组处理函数,右键只多做两件事——按坐标定位、按当前笔记状态决定显示「收藏」还是「取消收藏」。这样新增动作时只改一处,不会出现「⋯」里有、右键里没有的分叉。
右键菜单需要处理的边界比「⋯」多:贴近窗口右边缘时向左翻,贴近底边时向上翻;点空白、按 Esc、滚动列表都要关闭;菜单宽度固定,文本过长时省略而不是撑破窗口。屏幕缩放后坐标用 clientX/clientY,不混用 screenX/screenY,避免 130% 缩放下菜单偏移。这些边界在 v1.1 的自绘菜单里已经处理,但没有做键盘方向键导航。
| 入口 | 触发 | 菜单类型 | 项数 | 实测 |
|---|---|---|---|---|
| 顶部「⋯」 | 左键点击 | 应用内 div | 9 | v1.1 真机截图 9 项 |
| 编辑器右键 | 右键/长按 | 应用内 div | 9 | 有截图 |
| 笔记列表右键 | 右键/长按 | 应用内 div | 9 | 有截图 |
| 系统标题栏右键 | 右键 | 系统窗口菜单 | 未知 | 未测 |
4. 输入法
4.1 搜索框:实测可用
搜索中文那张图里,搜索框是中文「窗口」,列表得到 3 条结果,屏幕右下角有输入法候选条。这是这一篇唯一一个中文输入的实测证据:输入法能把中文送进 <input>,input 事件能触发 state.query 更新,过滤逻辑能匹配中文。
这条链路里没有自定义输入法处理。搜索框是普通 <input type="text">,没有 compositionstart / compositionend 监听,也没有在 input 里判断 event.isComposing。中文输入过程中,每按一个拼音字母都可能触发 input,state.query 会变成拼音串,列表会短暂显示「没有找到匹配的笔记」,等选词后才恢复。这个闪烁在截图里看不到,但实际输入时存在。因为搜索是本地过滤,代价只是列表闪一下,不影响数据。
4.2 编辑器:没有专项测试
编辑器是 <textarea>,中文输入走 Chromium 的原生 IME。代码没有 composition 处理,onEditorInput() 在每次 input 时做四件事:置脏、更新状态栏、更新标题、安排预览和保存。
这意味着输入法组词过程中,input 事件也可能触发自动保存。比如输入「窗口」,拼音阶段可能先把 chuangkou 写进 state.contents,选词后再变成「窗口」。500 ms 防抖会减少中间保存的次数,但如果用户在一个词上停留超过 500 ms,中间态可能已经落盘。这个行为没有实测,不能断言一定会发生,也不能断言一定不会。要确认,需要在编辑器里输入一个长词组,观察 events.log 或状态栏的保存时间。这一版没有做这个实验。
4.3 Esc 和输入法的冲突
onKeydown 在最前面处理 Esc:如果有弹层,关弹层并 preventDefault()。输入法组词时按 Esc 通常是「取消候选」,但如果事件先到 document,可能会把设置页关掉,而不是取消候选。
浏览器通常会在 IME 组词时把 keydown 标记为 isComposing,但代码没有检查这个标志。实际顺序取决于 Chromium 和输入法的实现:有的输入法在组词时吞掉 Esc,页面收不到;有的会先发给页面。这一版没有测,所以不能写「Esc 不会误关弹层」。这是一个潜在冲突,不是已确认的 bug。
4.4 其它输入场景
| 场景 | 控件 | 中文输入 | 备注 |
|---|---|---|---|
| 全局搜索 | <input> | 实测可用 | 搜索中文图 |
| 正文编辑 | <textarea> | 未单独测 | 无 composition 处理 |
| 标签输入 | <input> | 未测 | 回车添加,Backspace 删最后一个 |
| 导出文件名 | 系统保存框 | 未测 | 由系统输入法处理 |
| 确认框 | 只读文本 | 不涉及 | 无输入 |
| 设置字号 | <input type="range"> | 不涉及 | 键盘方向键可调 |
标签输入的回车处理也值得记一笔:tagInput 的 keydown 里,回车会 preventDefault() 并 addTag(),不会提交表单;Backspace 在输入框为空时删除最后一个标签。没有 compositionend 判断,中文输入法选词的回车可能被当成「添加标签」,把拼音当成标签加进去。这一条同样未测。
4.5 字体和字号
编辑器字号 15 px,范围 13–18,设置持久化。中文字体优先 HarmonyOS Sans,等宽用 JetBrains Mono / Consolas。输入法候选框的字体由系统决定,不受页面 CSS 影响,所以候选框和正文的字号可能不一致。这是系统行为,应用层改不了。
字号变化会影响 textarea 的换行位置和预览的排版,但不影响输入法。设置面板里的字号滑块是 input 事件即时生效,180 ms 防抖后写 settings.json。拖动滑块时可能连续触发多次保存,但 saveSettings 是轻量 JSON 写,不会像正文保存那样排队。
4.6 字号与输入框高度
设置面板里字号是 15 px,范围 13–18,滑块左右两端标着 13 和 18:

这张图证明字号是全局设置,不是每个笔记单独设置。applyFont() 把字号写到 CSS 变量 --note-size,编辑器和预览共用;输入框的行高、工具栏的高度由 CSS 自己算,不跟着字号变。字号调到 18 时正文变大,但工具栏按钮还是固定尺寸,这是有意的:工具栏是操作区,不该跟着正文缩放。
输入框的高度不随字号自动调整,textarea 始终填满编辑区。中文输入法的候选框位置由光标位置决定,字号变大时光标变高,候选框的锚点也会跟着变。这个行为没有测,只记录机制:候选框由系统输入法画,应用只能通过光标位置间接影响它。
5. 单实例:4 次启动,1 个主进程
5.1 已经接上 requestSingleInstanceLock
v1.1 主进程启动时先调 app.requestSingleInstanceLock()。拿不到锁的进程直接退出;拿到锁的进程监听 second-instance,把已有窗口恢复并聚焦,然后记一条事件。核心逻辑是:
const gotLock = app.requestSingleInstanceLock();
if (!gotLock) {
app.quit();
} else {
app.on('second-instance', () => {
secondInstanceCount += 1;
const win = mainWindow;
if (win && !win.isDestroyed()) {
if (win.isMinimized()) win.restore();
win.focus();
}
store.logEvent('info', `second-instance 第 ${secondInstanceCount} 次:${JSON.stringify({ focused: true, created: false })}`);
});
}
这段代码不是「防止多窗口」,而是「防止两个进程同时写同一份 index.json」。应用内多窗口仍然保留:windows 是一个 Set,window:new 往里加,closed 时删。两个窗口共享同一个主进程、同一个 Store 实例、同一个 index 数组,各自有独立的渲染进程和 state.contents 快照。
5.2 应用内多窗口的行为
「在新窗口打开」传当前笔记 id,新窗口加载 index.html?note=<id>。截图里主窗口和辅助窗口同时显示同一篇笔记:

这张图证明的是应用内多窗口,不是单实例。两个窗口都在同一个应用进程里,任务栏只有一个应用图标,辅助窗口没有独立的窗口状态持久化。
v1.1 加了保存广播:一个窗口保存成功后,主进程用 webContents.send('note:changed') 把笔记 id、标题和最新内容发给其他窗口。实测另一窗口的 syncLatency={latency:3,id:"n_20261115_93abe9",title:"electron框架30篇文章规划"},接收窗口字数从 597 变成 599,列表摘要也变成「粗体」。这解决的是显示同步,不是冲突合并:两个窗口同时编辑同一篇,仍然没有版本号、没有 updatedAt 比较、没有冲突提示,后写会覆盖先写。对照阅读和「一个窗口改、另一个窗口看」已经可用,双向同时编辑仍然要避免。
5.3 单实例锁挡住的是并发写
假设没有锁,两个进程各自 new Store(dataDir),各自读 index.json,各自持有内存索引。A 写入新笔记,index.json 变成 6 条;B 还持有 5 条,下一次保存会把 index.json 覆盖回 5 条。文件级原子写保证「不会写坏」,但不保证「不丢更新」。这就是单实例锁的意义:不是防止窗口多开,是防止两个进程同时写同一份索引。
v1.1 在鸿蒙 PC 上实测了 4 次重复启动:应用运行中连续执行 hdc shell aa start -a EntryAbility -b com.example.ohosnotes,v11-metrics.json 记录 singleInstance.lock=true、secondInstance.count=4、result={"focused":true,"created":false},事件日志最后一条是 second-instance 第 4 次:{"focused":true,"created":false};ps 里只有 1 个 com.example.ohosnotes 主进程(PID 13794)。第二次启动没有新建主进程或窗口,只把已有窗口提到前台。
| 层级 | 是否有约束 | 证据 |
|---|---|---|
| 进程级单实例 | 有 | requestSingleInstanceLock,lock=true |
| 应用内多窗口 | 有,windows Set | 双窗口图 |
| 窗口状态持久化 | 只有主窗口 | attachWindowState 只在 isMain 时调用 |
| 索引写入互斥 | 同进程内串行,跨进程由单实例锁挡住 | saveChain + 单实例锁 |
重复 aa start | 4 次 | 1 个主进程,secondInstance.count=4 |
| 第二实例聚焦 | 有 | result={"focused":true,"created":false} |
| 窗口间同步 | 有广播 | syncLatency.latency=3 |
5.4 关窗不是简单的 close()
主窗口的 close 事件被 attachCloseGuard() 拦住:先 preventDefault(),给渲染层发 app:before-close,渲染层保存正文、保存设置、上报窗口尺寸,最后调 app:close-ready;主进程收到后清掉 1.5 秒定时器,设 __allowClose = true,再 close()。如果渲染层 1.5 秒没回,主进程自己关,避免卡死。
这个握手和单实例无关,但和「关最后一个窗口是否退出」有关。window-all-closed 里 process.platform !== 'darwin' 就 app.quit();鸿蒙的 platform 是 openharmony,不是 darwin,所以最后一个窗口关闭后应用退出。主窗口关了但辅助窗口还在时,应用不退出,因为 windows 还不为空。这个行为是按代码推的,没有单独截图验证。
5.5 怎么验证单实例:这次做了
验证单实例需要三步:先启动应用并记下主进程 PID,再从桌面或命令行第二次启动,最后看进程表里是一个还是两个同名进程、任务栏是一个图标还是两个。v1.1 在鸿蒙 PC 上按这个步骤做了 4 次:每次 aa start 都返回成功,secondInstance.count 从 1 加到 4,ps 始终只有 1 个主进程,窗口没有被新建。result 里的 created:false 说明第二次启动走的是「聚焦已有窗口」分支,不是「新建窗口」分支。
这个实验也解释了为什么之前不敢把它写成「支持」:如果系统复用已有 Ability,第二次启动可能只是把窗口提到前台,不产生新进程;如果系统允许并行,才会出现两个进程。现在有 lock=true、count=4、ps 一个主进程三组证据,可以确认这条 API 在鸿蒙 PC 上的语义和桌面端一致。
从产品角度,单实例锁还应该和「打开文件」一起设计。用户双击一个 .md 文件时,系统可能用新参数启动应用;如果已有实例,应该把文件导入到已有窗口,而不是再起一个进程抢索引。v1.1 没有接文件关联,也没有在 second-instance 里处理文件参数,所以这个场景还没有入口。锁已经在了,等做文件关联时只需要在 second-instance 回调里读参数,不用再补锁。
6. 焦点与弹层
6.1 焦点放在哪
| 动作 | 焦点去向 | 代码 |
|---|---|---|
| 新建笔记 | 编辑器末尾 | focus() + setSelectionRange(len, len) |
| 选笔记 | 编辑器(noFocus 时不动) | selectNote |
| 打开标签弹层 | 标签输入框 | tagInput.focus() |
| 打开确认框 | 确认按钮 | btnConfirmOk.focus() |
| 打开设置 | 不强制 | 无 focus() |
| 打开诊断 | 不强制 | 无 focus() |
| 搜索 | 搜索框并全选 | focus() + select() |
selectNote 有一个 noFocus 参数,点击列表时传 true,键盘回车时也传 true,只有新建和导入后需要把焦点送进编辑器。这样点列表不会把光标从搜索框抢走,用户可以在搜索框里连续输入、用方向键选结果。方向键选结果这一版没有实现,列表项只支持 Enter/Space。
6.2 弹层的关闭路径
| 弹层 | Esc | 点遮罩 | 关闭按钮 | 其它 |
|---|---|---|---|---|
| 设置 | 是 | 是 | 是 | — |
| 诊断 | 是 | 是 | 是 | 底部「关闭」 |
| 标签 | 是 | 是 | 是 | 取消 |
| 确认 | 是 | 是 | — | 取消 |
| 更多菜单 | 是 | 是(点外面) | — | 点菜单项 |
设置和诊断的遮罩点击判断是 event.target === el.overlay,只有点遮罩本身才关,点内容不关。标签和确认也一样。更多菜单没有遮罩,用 document 的 click 判断目标是否在菜单或按钮内。
6.3 键盘可达性
笔记列表项是 div,带 role="button" 和 tabindex="0",keydown 里处理 Enter 和 Space。这是这一版唯一做了键盘可达性的列表。工具栏按钮是原生 <button>,Tab 能到,Enter/Space 能触发。菜单项也是 <button>。
没有做焦点陷阱(focus trap)。设置页打开时,Tab 仍然可以走到后面的编辑器;确认框打开时,Tab 也可能跑到背景。aria-modal="true" 写了,但没有配套的焦点限制。无障碍树由 app.setAccessibilitySupportEnabled(true) 打开,实际读屏效果没有测。
7. 边界与踩坑
| # | 现象 | 原因 | 当前处理 |
|---|---|---|---|
| 1 | Ctrl+Shift+P 误导出 PDF | 分支顺序错会先命中 p | 先判断 shift,再判断普通 p |
| 2 | 搜索框里按 Ctrl+B 没反应 | 只在编辑器焦点生效 | 设计如此,避免误改 |
| 3 | 预览回不到编辑 | 只做预览/非预览二态 | 再点顶部「编辑」 |
| 4 | 右键菜单和「⋯」重复 | 两个入口同一组命令 | 共用处理函数,右键只做定位 |
| 5 | 中文输入时列表闪 | 没有 isComposing 判断 | 未处理,代价可接受 |
| 6 | 组词时 Esc 可能关弹层 | 没有 composition 检查 | 未测,潜在冲突 |
| 7 | 标签输入回车加拼音 | 没有 compositionend 判断 | 未测 |
| 8 | 两个进程写同一索引 | 无锁会丢更新 | 单实例锁已挡住 |
| 9 | 两个窗口同时编辑 | 广播不是冲突合并 | 后写仍会覆盖先写 |
| 10 | Ctrl+W 不能关窗 | 未绑定 | 走系统关闭按钮 |
| 11 | Ctrl+P 打印回调失败 | 打印机/系统服务异常 | 已回退 printToPDF |
| 12 | 弹层打开后 Tab 能跑出去 | 没有焦点陷阱 | 未处理 |
v1.1 已经补上右键菜单、系统打印、单实例锁和窗口间同步;仍未做笔记内查找、输入法 composition 处理、快捷键自定义和焦点陷阱。它们不影响「能写、能搜、能导出」这条主线,但会影响重度键盘用户和中文输入场景的体验。
下一篇拆桥接层:preload 暴露了哪些方法、IPC 通道怎么对应、返回值为什么有的抛异常有的返回 {ok:false}、关窗握手为什么需要 1.5 秒。
参考
- 框架仓库:https://atomgit.com/CPF-Electron/Electron
- 预编译包:https://atomgit.com/CPF-Electron/Electron/releases/tag/v40.0.1
- 第 1 篇:从 367MB 预编译包到第一个能开窗的 HAP
- 第 3 篇:自由窗口、DPI、多屏与自绘标题栏
- 第 4 篇:沙箱目录、选择器 URI 与拖拽导入
- 开源鸿蒙 PC 社区:https://harmonypc.csdn.net/
更多推荐



所有评论(0)