桌面应用AI 应用插件系统【免费下载链接】WoxA cross-platform launcher that simply works项目地址https://gitcode.com/gh_mirrors/wo/Wox点击查看免费下载本篇技术指南以 Wox 内置的浏览器书签系统插件Browser Bookmark为核心讲解如何通过标题或 URL 片段在 Wox 启动器中快速打开浏览器书签涵盖支持浏览器范围、插件设置、匹配机制、图标与 MRU 排序并结合 wox.core/plugin/system/browser_bookmark 下的 Go 源码剖析其底层实现帮助读者在理解使用方式的同时掌握其工作原理与排障思路。在 Wox 中通过书签关键词触发的搜索结果与操作面板包含书签栏Bookmarks Bar、其他书签Other Bookmarks以及打开浏览器书签设置入口。插件概览与快速上手Browser Bookmark 是 Wox 的一个全局插件global plugin它常驻索引浏览器书签你只需输入书签标题或 URL 的一部分Wox 就能直接返回匹配的书签并一键在默认浏览器中打开。其插件元数据定义在 plugin.go 中关键信息如下插件 ID95d041d3-be7e-4b20-8517-88dda2db280b触发关键词*全局触发与b书签专属触发支持平台Windows、macOS、Linux能力特性声明了MetadataFeatureMRU即参与 Wox 的 MRUMost Recently Used最近最常使用排序最低 Wox 版本2.0.0快速开始直接在 Wox 输入框中尝试以下查询github docs wox launcher github.com/Wox-launcher b github前四条是全局查询只要书签的标题或 URL 与输入内容匹配就会出现在结果中最后一条b github是书签专属查询以b开头加空格后输入关键词只会返回书签结果适合你明确只想搜书签的场景。为什么全局搜索不会淹没结果与原文档一致本插件在全局查询下采用了比普通文本搜索更严格的匹配策略避免每次查询都被大量书签刷屏。这一点在源码中有明确的实现依据——plugin.go 中的 matchBookmark 函数全局查询loose false时命中书名标题的最低分数阈值为50分且 URL 必须包含查询字符串才能命中专属查询loose true即b触发时最低分数阈值降为0并会对查询的每个单词分别在标题与 URL 上打分全部命中才返回。这解释了为什么相同关键词在全局搜索和b搜索下结果范围不同全局更挑剔专属更宽松。支持的浏览器与书签来源原文档明确支持 Chrome、Edge、Firefox 三类浏览器Safari 书签暂未被索引。从源码看每类浏览器都有独立的加载器loader通过registerBrowserBookmarkLoader注册到全局 map 中见 plugin.go并在init()中完成注册。Chrome读取本地 账户同步书签Chrome 加载器实现于 bookmark_chrome.go要点如下扫描的 profileDefault、Profile 1、Profile 2、Profile 3见chromeBookmarkProfiles各平台书签文件位置平台路径Windows%LOCALAPPDATA%\Google\Chrome\User Data\profile\macOS~/Library/Application Support/Google/Chrome/profile/Linux~/.config/google-chrome/profile/读取的文件Bookmarks与AccountBookmarks两个明文 JSON 文件chromiumBookmarkFileNames。源码注释指出Chrome 146 开启账户书签同步后真实书签存放在AccountBookmarks中而Bookmarks可能只是空骨架EncryptedBookmarks因采用操作系统级加密而无法读取。对应的单元测试 bookmark_chrome_test.go 验证了三个关键场景Bookmarks为空时能从AccountBookmarks读到书签、本地与账户书签能合并、缺失AccountBookmarks时不会报错。Edge与 Chromium 家族共用解析逻辑Edge 加载器实现于 bookmark_edge.go同样扫描Default~Profile 3Windows/macOS/Linux 分别读取平台路径Windows%LOCALAPPDATA%\Microsoft\Edge\User Data\profile\macOS~/Library/Application Support/Microsoft Edge/profile/Linux~/.config/microsoft-edge/profile/Edge 复用了 Chrome 的loadChromiumBookmarkFiles因为两者书签文件都是 Chromium 格式的明文 JSON——这是源码层面将两者归为Chromium 家族的直接证据。解析方式正则提取 URL 条目loadChromiumBookmarkFiles通过loadBookmarkFromFile读取文件并使用正则表达式提取书签(?ms)name: (?Pname[^]*),.*?type: url,.*?url: (?Purl[^]*)该正则同时兼容 Chrome 与 Edge 的书签 JSON 结构见 bookmark_chrome.go。注意解析过程中不会阻塞网络请求取图标而是优先使用缓存中的 favicon解析后还会通过strings.Clone复制字段避免大 JSON 字符串长期驻留内存。Firefox读取 places.sqlite 数据库Firefox 与 Chromium 家族不同书签存储在 SQLite 数据库places.sqlite中。加载器实现于 bookmark_firefox.go其流程分三步定位 Firefox 根目录平台候选根目录Windows%APPDATA%\Mozilla\FirefoxmacOS~/Library/Application Support/FirefoxLinux~/.mozilla/firefox、~/snap/firefox/common/.mozilla/firefox、~/.var/app/org.mozilla.firefox/.mozilla/firefox解析 profile 目录优先解析profiles.ini读取[Profile*]段的path与isrelative键拼接出绝对路径若解析失败则回退扫描根目录及Profiles子目录下所有包含places.sqlite的目录见resolveFirefoxProfileDirsByRoot与parseFirefoxProfilesIni。这样做的好处是能正确处理 Linux 上 Snap、Flatpak 安装的 Firefox 的隔离数据目录。只读查询书签以?modero_busy_timeout2000方式只读打开数据库避免写入锁与长时间阻塞然后执行SELECT b.title, p.url FROM moz_bookmarks b INNER JOIN moz_places p ON b.fk p.id WHERE b.type 1 AND p.url IS NOT NULL AND p.url 其中b.type 1表示 URL 类型书签区别于文件夹标题为空的书签会回退使用 URL 作为名称见 bookmark_firefox.go。插件设置选择要索引的浏览器打开设置 - 插件 - Browser Bookmark可以选择 Wox 应该索引哪些浏览器。如果你有大量重复书签建议只保留实际使用的浏览器以减少重复结果与索引开销。设置项在源码中体现为一个多选下拉框IsMulti: true其配置键为indexBrowsers见 plugin.go选项以全部选择为默认值DefaultValue: PluginSettingValueSelectOptionValueSelectAll选项列表来自browser.GetInstalledBrowsers()过滤出的可索引浏览器即已注册加载器的 chrome/edge/firefox见getBookmarkIndexableInstalledBrowsers设置是**平台相关IsPlatformSpecific: true**的即不同操作系统可以有不同的浏览器勾选状态浏览器 ID 在 browser.go 中定义为chrome、edge、firefox等常量设置值按逗号分隔存储解析时经NormalizeBrowserID规范化小写去空格。书签何时重新加载当浏览器书签文件发生变化时书签会自动重新加载Wox 重启时也会重新加载一次此外源码中通过OnSettingChanged监听indexBrowsers设置变更一旦用户改动浏览器勾选状态会立即触发reloadBookmarks重新构建索引见 plugin.go。Firefox 数据库锁问题如果 Firefox 正在运行且锁定了 profile 数据库Wox 可能读不到最新书签。原文档给出的建议是关闭 Firefox 一次后重试。源码采用_busy_timeout20002 秒忙等待缓解锁竞争但长期锁定时仍建议先关闭浏览器。图标预取与 MRU 排序后台预取 faviconWox 会在后台预取书签网站的 favicon 并缓存不会阻塞查询。预取逻辑在prefetchWebsiteIconsplugin.go其实现细节包括按域名去重同一域名只下载一次图标使用8 个并发 worker并行下载每个请求设置1.5 秒超时避免拖慢后台任务优先通过 Google 的 favicon 服务https://www.google.com/s2/favicons?sz96domain_url...下载 96px 图标同时维护http://与https://两套缓存键缓存文件以website_icon_md5.png形式存放在 Wox 图片缓存目录util.GetLocation().GetImageCacheDirectory()若缓存已存在则仅刷新访问时间imagecache.Touch不重复下载。查询时则通过system.GetWebsiteIconFromCacheOnly只读取缓存、绝不发起网络请求保证每次查询都瞬时完成plugin.go。MRU常用书签自动靠前插件声明了MetadataFeatureMRU特性并在初始化时注册OnMRURestore回调见 plugin.go。其效果是你频繁打开的书签会随着时间推移在结果列表中逐步上移handleMRURestore会校验该书签在当前书签快照中仍存在同名同 URL若已被删除则不会恢复恢复时若 MRU 记录没有图标会回退到缓存的 favicon 或默认书签图标plugin.go。每次打开书签时动作上下文ContextData会携带name与url供 MRU 系统记录与后续恢复使用打开动作本身调用shell.Open(bookmark.Url)即用系统默认浏览器打开链接。匹配与去重逻辑双维度打分匹配查询时Query方法遍历当前书签快照getBookmarksSnapshot带读写锁保护的拷贝对每条书签调用matchBookmark标题匹配使用plugin.IsStringMatchScore含拼音支持全局查询要求得分 ≥ 50URL 匹配使用plugin.IsStringMatchScoreNoPinYinURL 不参与拼音匹配全局查询要求 URL 必须包含查询串且得分 ≥ 50专属查询则按空格分词逐词匹配 URL。精确去重插件会对标题与 URL 完全相同的书签做精确去重removeDuplicateBookmarks以Name | Url作为唯一键plugin.go。因此完全重复同标题同 URL例如本地与账户同步各一份会被合并为一条相似但不相同的书签不同 profile 或不同 URL会保留——例如同一站点 http 与 https 两个版本、或标题相同但 URL 不同都会正常显示。常见问题排查书签缺失按以下顺序排查确认该浏览器已在插件设置中被启用indexBrowsers勾选确认书签位于受支持的 profileChrome/Edge 的Default~Profile 3Firefox 的任一 profile中如果浏览器刚同步或重写了书签数据库重启 Wox触发重新加载对于 Chrome如果开启了账户书签同步且本地Bookmarks文件为空请确认 Wox 能读取AccountBookmarks文件Chrome 146 的同步书签存放于此对于 Firefox若正在运行导致places.sqlite被锁定请关闭 Firefox 后重试。出现重复书签插件已按标题 URL精确去重因此标题与 URL 完全一致的多份副本如多 profile 同步只会出现一条来自不同 profile、或 URL 不同的相似书签会被保留属于预期行为可在设置中只保留实际使用的浏览器来减少这类结果。关联插件WebSearch 插件用于直接搜索网页Application 插件用于启动浏览器应用本身。两者与 Browser Bookmark 形成互补书签插件解决打开已收藏页面WebSearch 解决搜索未知内容Application 解决启动程序。浏览器相关的基础能力如已安装浏览器探测、浏览器 ID 规范化统一收敛在 wox.core/util/browser/browser.go 中供书签、WebSearch、窗口管理等模块共用。小结Browser Bookmark 插件的设计核心可以概括为三点严格匹配防刷屏、分浏览器加载器解耦、纯缓存图标零网络阻塞。通过*全局触发与b专属触发两种查询模式配合 MRU 排序与 favicon 预取它让输入标题片段直达收藏页面成为可能。理解其读取 Chromium JSON 与 Firefox SQLite 两条数据链路以及全局/专属两套匹配阈值将帮助你在实际使用中快速定位书签缺失、重复等问题的根源。赞分享桌面应用AI 应用插件系统【免费下载链接】WoxA cross-platform launcher that simply works项目地址https://gitcode.com/gh_mirrors/wo/Wox点击查看免费下载相关推荐Wox 浏览器书签插件使用指南索引 Chrome、Edge 与 Firefox 书签并实现全局快速检索Wox 浏览器书签插件使用指南索引 Chrome、Edge 与 Firefox 书签并实现全局快速检索 浏览器书签插件Browser Bookmarks是桌面应用AI 应用插件系统Wox 浏览器插件Browser Plugin深度指南上下文感知的标签页搜索与浏览器集成Wox 浏览器插件Browser Plugin深度指南上下文感知的标签页搜索与浏览器集成 Wox 的 Browser 插件源码位于 wox.core/p桌面应用AI 应用插件系统告别多浏览器书签混乱烦恼跨浏览器书签同步实用指南告别多浏览器书签混乱烦恼跨浏览器书签同步实用指南 你是否也遇到过这样的情况家里的Chrome存着常用学习网站公司的Edge收藏了工作资料手机上的Fire前端上一篇Karpenter for AWS 威胁模型详解RBAC/IAM 权限边界、标签驱动的实例所有权与威胁缓解策略下一篇ECC 死代码清理实战指南用 /refactor-clean 在测试验证下安全删除无用代码创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考