欢迎加入开源鸿蒙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 msnote: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
F12DevTools主进程 before-input-event 尝试打开
Ctrl+Shift+IDevTools未绑定

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 是九项,按分隔线分三组:

菜单项命令行为
在新窗口打开newwinwindow:new,带当前笔记 id
导出 Markdownexport-md保存对话框,.md
导出 HTMLexport-html保存对话框,.html
导出 PDFexport-pdf直接写 exports,不弹框
复制正文copyclipboard:write
打印 (Ctrl+P)printprint:now → webContents.print
模拟 Ctrl+滚轮zoom-wheel注入 WheelEvent(ctrlKey) 验证缩放
性能面板 v1.1perf打开 #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 的自绘菜单里已经处理,但没有做键盘方向键导航。

入口触发菜单类型项数实测
顶部「⋯」左键点击应用内 div9v1.1 真机截图 9 项
编辑器右键右键/长按应用内 div9有截图
笔记列表右键右键/长按应用内 div9有截图
系统标题栏右键右键系统窗口菜单未知未测

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 start4 次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. 边界与踩坑

#现象原因当前处理
1Ctrl+Shift+P 误导出 PDF分支顺序错会先命中 p先判断 shift,再判断普通 p
2搜索框里按 Ctrl+B 没反应只在编辑器焦点生效设计如此,避免误改
3预览回不到编辑只做预览/非预览二态再点顶部「编辑」
4右键菜单和「⋯」重复两个入口同一组命令共用处理函数,右键只做定位
5中文输入时列表闪没有 isComposing 判断未处理,代价可接受
6组词时 Esc 可能关弹层没有 composition 检查未测,潜在冲突
7标签输入回车加拼音没有 compositionend 判断未测
8两个进程写同一索引无锁会丢更新单实例锁已挡住
9两个窗口同时编辑广播不是冲突合并后写仍会覆盖先写
10Ctrl+W 不能关窗未绑定走系统关闭按钮
11Ctrl+P 打印回调失败打印机/系统服务异常已回退 printToPDF
12弹层打开后 Tab 能跑出去没有焦点陷阱未处理

v1.1 已经补上右键菜单、系统打印、单实例锁和窗口间同步;仍未做笔记内查找、输入法 composition 处理、快捷键自定义和焦点陷阱。它们不影响「能写、能搜、能导出」这条主线,但会影响重度键盘用户和中文输入场景的体验。

下一篇拆桥接层:preload 暴露了哪些方法、IPC 通道怎么对应、返回值为什么有的抛异常有的返回 {ok:false}、关窗握手为什么需要 1.5 秒。


参考

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐