Joplin 3.3 版本解析桌面端多实例运行、快捷链接笔记对话框与 Whisper 离线语音输入【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplinJoplin 3.32025-04-28 发布围绕桌面端与移动端做了成体系的功能升级桌面端新增多实例并行运行、一键折叠/展开笔记本、ShiftAltL 快捷链接笔记对话框并将富文本编辑器升级至 TinyMCE v6移动端新增音频录音附件与基于 Whisper 的离线语音转文字能力。本文以该版本的发布说明为主线结合仓库中对应的源码实现逐项讲解这些特性的用法、限制与底层原理读完后可完整掌握 3.3 的新功能及其在代码层面的落点。版本总览3.3 带来了什么3.3 的更新集中在四个方向无障碍Accessibility增强桌面端与移动端均改进了键盘导航、读屏器支持与视觉对比度桌面端效率功能一键折叠/展开全部笔记本、链接笔记对话框、支持同时运行多个独立实例移动端能力扩展音频录音附件、基于 Whisper 的语音输入Beta、重新设计的“新建笔记”菜单安全与稳定性为富文本编辑器落地内容安全策略CSP本版本共修复 39 个桌面端缺陷与 17 个移动端缺陷。完整的逐项变更列表可查阅仓库内的各端更新日志目录 readme/about/changelog/本文仅对主线特性展开并给出源码级印证。桌面端可访问性改进3.3 的桌面端无障碍改进覆盖了键盘、读屏与视觉三个层面键盘导航新增快捷键与更清晰的控件标签label简化跨界面的交互路径“转到查看器”go to viewer菜单项将焦点从笔记编辑器移动到笔记查看器并且焦点会定位到查看器中与编辑器光标对应的位置而非简单地跳到顶部——这对依赖键盘或读屏器完成“编辑后回读”的用户尤为关键读屏器支持笔记列表note list与侧边栏sidebar等元素的切换与交互方式经过优化便于辅助技术用户操作视觉对比度URL、侧边栏、滚动条等 UI 组件的对比度提升改善低视力用户的可读性富文本编辑器代码块在键盘与触摸场景下的交互更顺畅。桌面端一键折叠/展开全部笔记本3.3 在侧边栏笔记本树上新增了一个“折叠/展开全部”Collapse/Expand All按钮需要定位某篇笔记时可展开全部笔记本层级追求整洁界面时则一键全部收起。从源码结构看该按钮实现于侧边栏的列表包装逻辑 useOnRenderListWrapper.tsx 中有几点实现细节值得注意按钮为状态自适应的通过allFoldersCollapsed属性判断当前状态图标在far fa-caret-square-right展开与far fa-caret-square-down折叠间切换title与aria-label也随之在Expand all notebooks/Collapse all notebooks之间变化保证读屏器能正确播报当前动作点击事件统一走onToggleAllFolders(allFoldersCollapsed)回调由上层状态管理批量更新文件夹折叠状态当不存在子笔记本hasSubFolders为 false时按钮被置为disabled避免无意义的操作出于无障碍考虑源码注释明确指出该切换按钮被放在roletree的列表区域之外这样辅助技术可以在不干扰树形结构遍历的情况下单独访问它——这正呼应了本版本“无障碍优先”的改进主题。桌面端链接笔记对话框ShiftAltL这是 3.3 桌面端最实用的效率特性之一按下macOS 上的 ShiftOptionL或Windows/Linux 上的 ShiftAltL即可唤起一个搜索框输入目标笔记标题链接立即插入当前笔记。快捷键的注册位于全局按键映射服务 KeymapService.ts 中分别以ShiftOptionLmacOS 分支与ShiftAltLWindows/Linux 分支映射到linkToNote命令。功能本体在 linkToNote.ts 中其调用链非常清晰以Mode.TitleOnly模式复用内置的Goto Anything对话框只按标题搜索始终显示帮助提示校验返回结果必须是笔记ModelType.Note否则记录警告并中止用markdownUtils.escapeTitleText与escapeLinkUrl转义标题和 ID拼出标题形式的内部链接再通过insertText命令插入编辑器当前光标处。该命令的启用条件enabledCondition为oneNoteSelected (markdownEditorPaneVisible || richTextEditorVisible) !noteIsReadOnly !noteIsDeleted即必须选中一篇笔记、Markdown 或富文本编辑器可见、且笔记非只读未删除。富文本编辑器工具栏中的“链接到笔记”按钮同样触发此命令见 TinyMCE.tsx。这也意味着快捷键与工具栏按钮、菜单项三条入口最终汇聚到同一个命令实现行为完全一致。桌面端支持同时运行多个 Joplin 实例3.3 起Joplin Desktop 允许同时运行多个独立实例每个实例拥有独立的设置、插件与笔记数据互不干扰。典型场景是把工作笔记与个人笔记分开或在不同虚拟桌面各开一个实例。主实例可通过菜单File → Open secondary app instance...打开第二个实例。仓库内多实例的实现链条完整可查命令入口openSecondaryAppInstance.ts 声明了openSecondaryAppInstance命令菜单标签即 “Open secondary app instance...”其enabledCondition为!isAltInstance——即在副实例内该菜单项会被禁用防止无限套娃进程拉起bridge.ts 中appLaunchCommand通过追加--alt-instance-id命令行参数构造启动命令launchAltAppInstance固定以alt1作为副实例 ID并以detached: true方式execCommand拉起独立进程使副实例与主实例生命周期解耦参数解析与隔离主进程入口 main.ts 用getFlagValueFromArgs(process.argv, --alt-instance-id, )解析该参数并传入determineBaseAppDirs据此计算应用数据目录——这正是“每个实例独立设置、插件与笔记”的来源不同实例落在不同的 profile 目录实例身份识别stateToWhenClauseContext.ts 中isAltInstance !!state.settings.altInstanceId供菜单可用性等条件判断使用功能取舍从 app.ts 的结构看剪贴板服务器ClipperServer会setEnabled(!Setting.value(altInstanceId))——副实例不启动剪贴板服务避免两个实例抢占同一剪贴板端口这是一个值得注意的实例间资源隔离细节。另外bridge.ts 中launchAppInstanceById要求 IPC 服务器已启动否则会提示 “Cannot launch another instance because IPC server could not start.” 并提供打开日志的选项副实例的重启也依赖主实例通过跨应用 IPC 消息restartAltInstance协助完成从源码注释可见这是针对relaunch()在副实例上失效的专门处理。使用方式与更多说明参见文档 readme/apps/multiple_instances.md。桌面端富文本编辑器升级至 TinyMCE v6 与 Markdown 自动替换3.3 对富文本编辑器Rich Text Editor做了多项改进与缺陷修复其中两点值得单独说明升级至 TinyMCE v6仓库中随项目维护了 TinyMCE 相关的图标包与列表定义见 Assets/TinyMCE/ 目录编辑器主体能力与上游 v6 对齐Markdown 自动替换auto-replacement在富文本模式下输入highlight等记号会被自动替换为对应格式例如生成高亮文本如不需要可在设置中关闭该行为。移动端无障碍改进移动端与桌面端同步做了一轮无障碍增强笔记操作菜单note actions menu与模态对话框的焦点处理改进读屏用户导航更顺滑默认模态关闭按钮变为可访问元素并修复了“不可见按钮却可获得焦点”的问题Markdown 编辑器中淡化显示的 URL 对比度提升低视力用户更易读加密配置界面encryption configuration screen的可访问性改进创建与编辑多用户资料Profiles的操作新增读屏器支持。移动端录音并作为音频附件插入笔记3.3 起可在笔记中直接录制并附加音频打开笔记的 kebab 菜单选择Record audio开始录音结束后应用自动将录音文件作为附件插入当前笔记适合快速记录灵感、提醒或补充语音信息。从源码看该入口位于移动端附件命令 attachFile.tsRecord audio作为附件操作项AttachFileAction.RecordAudio出现在按钮列表中点击后调用recordAudio()完成录制与附加。移动端Whisper 语音输入升级BetaAndroid 的语音输入voice typing在 2.11 引入后3.3 进行了实质性重构新版基于Whisper这一 AI 语音识别模型识别准确率显著提升并支持自动标点与段落格式。该特性的实现位于独立原生模块 packages/whisper-voice-typing/其 JS 侧 index.ts 通过 Nitro Modules 创建AudioRecorder音频采集与WhisperSession识别会话两个混合对象Session类封装了open()建会话并开始录音与convertNext(duration)等待指定时长音频数据后转换文本的核心流程源码中还有一处针对 whisper.cpp 的细节处理——识别前会把区域后缀如en_US中的_US从语言代码中剥离因为 whisper.cpp 不支持区域标识符。需要注意的适用前提与限制由于所依赖的 AI 模型资源占用较高该特性目前仍处于Beta阶段默认使用更小、精度较低的模型以兼容较老设备如需更高精度可手动下载并切换更大的模型功能完全离线运行录音与识别均在本地完成隐私录音不会发送到任何第三方服务器这也是相比 Google、Apple 同类方案的核心隐私优势同时意味着无网络连接时同样可用官方计划后续持续打磨待稳定性提升后逐步将默认模型切换为精度更高的版本。移动端重新设计的“新建笔记”菜单此前的“New Note”菜单只提供“新建笔记”与“新建待办”两个选项3.3 重设计后的菜单直接在浮动按钮中提供了多种创建方式拍照笔记Camera、附加文件Attachment、扫描笔记本Scan notebook、绘图Drawing、录音Recording分隔之后才是New to-do与New note。源码 NewNoteButton.tsx 展示了该菜单的完整构成与实现模式每个附件类菜单项通过makeNewNote(false, action)调用newNote命令并传入attachFileAction参数实现“建笔记 触发对应附件流程”的一步完成扫描笔记本则直接导航到DocumentScanner页面。菜单项还统一附带accessibilityHint如 “Creates a new note with an attachment of type %s”并通过AccessibilityActionInfo为读屏用户提供new-note、new-todo快捷动作——注释里特别说明这是为了绕过附件类菜单项排在焦点顺序前部、且无法调整顺序的限制。安全与稳定性富文本编辑器 CSP 与缺陷修复安全层面3.3 为富文本编辑器实现了内容安全策略Content Security Policy以抵御编辑器内加载恶意内容的风险——这与编辑器处理外部粘贴/导入 HTML 的攻击面直接相关。稳定性层面本版本共修复39 个桌面端缺陷与17 个移动端缺陷。完整明细见仓库内各端更新日志目录 readme/about/changelog/Desktop、Android、iOS 各自的 changelog 文件以及发布说明原文 readme/news/20250428-release-3-3.md。小结如何在 3.3 中快速上手桌面端用侧边栏顶部的折叠/展开全部按钮管理笔记本树用 ShiftAltLmacOS 为 ShiftOptionL在当前笔记中快速插入指向其他笔记的链接用 File → Open secondary app instance... 开出互不干扰的副实例注意副实例不占用剪贴板服务。移动端kebab 菜单选择 Record audio 直接录音频附件Android 上开启 Whisper 语音输入Beta纯离线获得带标点的转写文本用重新设计的新建笔记菜单一步完成拍照、录音、绘图等笔记的创建。通用富文本编辑器已升级到 TinyMCE v6支持highlight等 Markdown 自动替换且受 CSP 保护如不需要自动替换可在设置中关闭。【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
