MarkFlow 版本历史 - 11 个版本
小心旧版本！显示这些版本是为了测试和参考目的。您应该始终使用附加组件的最新版本。
最新版本
版本 0.7.2
发布于 2026年7月28日 - 188.02 KB适用于 firefox 109.0 及更高版本发布日期: 2026-07-28
- 侧边栏常驻搜索 (#52)
- 在
SidepanelHeader顶部新增搜索框，支持按关键词过滤标记、页面和标签。 - 搜索命中后默认保留完整 page 上下文，同页其他标记一并展示，便于用户确认上下文。
- 新增"仅显示匹配项"开关，开启后仅展示命中的标记，满足紧凑浏览需求。
- 多关键词默认 AND 匹配，支持 mark 文本、note、page 标题、tag 名称等字段。
- 输入防抖 150ms，避免频繁过滤造成卡顿。
- 新建标签交互优化
- 将原有常驻的新建标签输入框折叠为 "+" 按钮，点击后展开输入框。
- 创建成功后自动收起，为搜索框释放顶部空间。
- 标签记忆：新建标记默认预选上次标签 (#55)
- 新建标记时，Tooltip 自动预选上一次新建标记所选的标签集合——批量整理一篇长文到同一课题时无需反复点选同一标签。
- "空选保存也记空"：保存一个不选任何标签的新标记会清空记忆，作为显式的重置入口（无需额外按钮）。
- 仅"新建"分支更新记忆；编辑已有标记仍使用该标记原标签，互不影响。
- 标签被删除后，悬空的标签 id 在预选时由
filterExistingTags自动过滤，不会出现 ghost 选中。 - 记忆为本地偏好（不参与 Gist 同步），与默认高亮色同级。
- GitHub Gist 同步间歇性自动断开 (commit
420e2c4) - 症状：开启 Gist 同步后，设置页时不时弹出"身份验证失败或权限不足，请检查 Token 配置"，同步被自动关闭，需手动重连才能恢复。
- 根因：GitHub API 返回 403（主/次级速率限制、滥用检测、或网络代理/GFW 拦截）时，被错误地等同于 401 认证失败处理，触发了"自动禁用同步"的自我熔断逻辑——而 Token 本身始终有效。
- 修复：
- 新增
GitHubAPIError分类器，读取响应体与X-RateLimit-Remaining/Retry-After头，将错误细分为auth/rate-limit/not-found/storage-limit/unknown五类。 - 速率限制不再关闭同步：改为进入退避期（遵守
Retry-After，缺省 60 秒），期间跳过推送但同步保持开启，到期自动恢复。 - 只有确认的认证类错误（真实 401，或明确的权限 403）才会自动禁用同步。
- 设置页报错信息现在会显示真实原因（如"GitHub 请求频率受限，请 X 秒后重试"），下次再遇到问题可一眼定位是速率限制还是 Token 失效。
- 新增
- 新增 9 个单元测试覆盖错误分类逻辑（
sync.spec.ts由 16 增至 25 个用例）。 - Tooltip 点击"创建"按钮后标签未显示 / 无成功提示
- 症状：在 Tooltip 里输入新标签名，点击"创建"按钮，Tooltip 直接关闭，看起来标签没创建、也没有成功提示；但按 Enter 键正常，侧边栏也能看到新标签。
- 根因：
tooltip-card根元素只阻止了mousedown冒泡（@mousedown.stop），没阻止mouseup；鼠标点击按钮时，mouseup冒泡到document的handleMouseUp，启动selectionTimer→processSelection→hide()，在创建标签后立即关闭 Tooltip。 - 修复：为
tooltip-card根元素补加@mouseup.stop，与@mousedown.stop对称，阻止内部点击继续触发选区恢复流程。 - 影响文件：
src/contentScripts/views/Tooltip.vue
- 无限滚动页面恢复性能优化 (commit
7ffb9ff) monitor.ts以subtree:true监听document.body，导致 Twitter/Reddit/B 站等无限滚动页面下restoreHighlights每 300ms 触发一次完整扫描（跨上下文消息往返 + 每个已恢复标记一次 Shadow DOM 查询）。- 在
HighlightRestorer引入"恢复完成早退 + 5s 重验窗"：本页所有标记恢复完成后，monitor 触发的 restore 在窗内直接跳过消息往返；超过 5s 放行一次完整 pass 以捕获虚拟列表回收导致的标记丢失。 - 完成态封装在 restorer 实例内不污染共享 state；
refreshHighlights手动全量重扫会重置该状态。 - 净效果：连续滚屏期间 restore 调用频率从约每 300ms 降至约每 5s（约 16× 降频）。新增 3 个 TDD 用例（restorer.spec 5→8）。
- 过滤逻辑纯函数化：将
filterTagTree与isMarkMatch抽离到独立的searchFilter.ts，避免测试环境加载webextension-polyfill。 - 状态分离：在
useSidepanelData中分离实时输入searchQuery与防抖过滤状态debouncedSearchQuery，响应式逻辑更清晰。 - 测试共享化：提取
buildSampleTree等测试辅助函数到testUtils.ts，减少测试文件间重复。
源代码遵循 MIT 许可证 发布
较早版本
版本 0.7.1
发布于 2026年7月3日 - 185.24 KB适用于 firefox 109.0 及更高版本发布日期: 2026-07-03
- 修复首次同步覆盖远程数据的问题 (#51)
- 首次连接已有 GitHub Gist 时，现在会先拉取远程数据并与本地合并，再启用自动同步，避免本地空数据覆盖云端已有数据。
- 新增
getGistById拉取完整 Gist 内容，补全 GitHub/gists列表接口不返回文件内容的缺陷。 - 重构同步队列：拆出
performPullInternal，避免错误恢复路径中的嵌套队列死锁。 - 增加错误恢复冷却期（60 秒）与
canPush守卫，防止失败后的重复推送覆盖远程。 - 兼容 MV3 Service Worker：
triggerPull在webext-bridge超时时回退到原生browser.runtime.sendMessage。
- 高亮高度可配置：Options 设置页新增"高亮行高"选项，修改后实时广播并刷新所有页面高亮。
- 恢复失败上下文提示：当标记无法自动恢复时，Sidepanel 会展示原文上下文，帮助用户判断是否需要重新标记。
- Options 页面体验优化：新增粘性侧边栏导航，带滚动监听（Scroll Spy）和保存成功反馈。
- Popup 用户手势保留：直接从 Popup 调用
chrome.sidePanel.open，避免某些场景下侧边栏无法打开。 - CSP 合规：将内联主题脚本抽离为外部模块，符合扩展商店的内容安全策略要求。
- Service Worker 兼容：在 background 中防护
window和chrome访问，提升 MV3 稳定性。 - 恢复策略简化：移除 Level 3/4 自动恢复路径与歧义选择弹窗，降低误恢复风险。
源代码遵循 MIT 许可证 发布
版本 0.7.0
发布于 2026年6月8日 - 182.89 KB适用于 firefox 109.0 及更高版本🛡️ 稳定性提升修复存储竞态条件 (#45)：极端场景下并发写入可能导致数据覆盖，现已通过 ensureReady 守卫 + 超时拒绝机制彻底
解决。
Schema 一致性保障：优化 mergeDefaults 策略，确保关键数据结构在版本升级时自动补齐缺失字段。
🏗️ Sidepanel 架构重构全面模块化 (#47)：将 800+ 行的 Sidepanel.vue 拆分为 5 个 Composables 和 5 个独立组件，测试覆盖率与可维护
性大幅提升。
☁️ GitHub Gist 同步双向同步 (#41)：支持将本地标记数据同步到 GitHub Gist，并在多台设备间拉取合并。
无死锁设计：引入 isSyncing 标志位 + 统一写入队列，彻底消除同步竞态风险。
墓碑机制：删除的标记以墓碑形式保留，同步时正确传播删除状态。
✨ UI / UX 全面升级StorageManager 全新交互：底部面板支持展开/折叠，实时显示配额使用百分比。
Popup 品牌感优化：主操作按钮改用品牌蓝色，新增 SVG Logo。
DisambiguationModal 暗黑模式：全面适配暗黑主题。
滚动条彻底修复：Firefox 兼容 + 布局抖动消除，6px 细滚动条 + CSS 变量集中管理。
设置按钮 reposition：长列表时始终可访问。
清理未使用的 Prompt.vue，减少维护负担。
📊 可观测性增强高亮恢复失败统计、存储配额监控、同步 Payload 预警。
📝 文档与品牌README 重写：定位聚焦"精准跳转的网页文本标记工具"。
Landing Page 同步。源代码遵循 MIT 许可证 发布
版本 0.6.0
发布于 2026年5月23日 - 177.81 KB适用于 firefox 109.0 及更高版本[v0.6.0] - 2026-05-22- Feat: 内容关联与侧边栏三级架构 (标签 -> 网页 -> 标记) (#33, #37).
- Feat: 侧边栏手风琴式折叠、互斥展开与数量徽标 (#38, #39, #40).
- Feat: 优化 Markdown 导出 (平铺标题层级，更好的嵌入体验).
- Feat: 页面按最近活跃排序，标记按文档位置排序 (#35).
- Fix: 错误收集范围过滤 (仅限扩展错误) (#34, #36).
- Fix: 修复知乎等页面的恢复问题 (两阶段恢复与防抖弹窗).
- Fix: 侧边栏圆角恢复、模板嵌套错误修复及术语统一.
源代码遵循 MIT 许可证 发布
版本 0.5.2
发布于 2026年4月16日 - 170.83 KB适用于 firefox 109.0 及更高版本核心功能升级 (Major Features)- 全链路错误感知与反馈系统 (Error Collection & Export)
- 静默异常监控：在 Background 及 Content Script 层植入全局异常拦截器 (window.onerror &
unhandledrejection)，实现运行状态的实时感知。 - 智能化日志聚合：采用基于堆栈特征的去重与计数算法，在保证记录完整性的同时，有效防止存储空间溢出。
- 自助诊断反馈：在“设置 (Options)”页面新增“错误日志”模块。用户现在可以一键生成包含环境版本、详细错误堆栈的
JSON 报告。这不仅是开发排查的“瑞士军刀”，更构建了用户与开发团队之间高效的问题反馈桥梁。
- 静默异常监控：在 Background 及 Content Script 层植入全局异常拦截器 (window.onerror &
- 跨元素高亮恢复 (Cross-Element Restoration)
- 突破结构边界：标记恢复不再受限于单个
<p>或<div>容器。核心逻辑重构为基于 最小公共祖先 (LCA) 的跨节点覆盖，支持高亮跨越段落、列表及复杂 DOM 嵌套。 - 自愈式进化 (Self-healing Mechanism)：当标记匹配发生非完全吻合时（如页面局部增删），系统在手动校准后自动完成“标记进化”，将最新 DOM 结构写入元数据，确保存档标记永不过期。
- 突破结构边界：标记恢复不再受限于单个
- 多维共识恢复引擎 (Tiered Restoration Flow)
- 分级匹配算法：从 Level 1 (完美路径匹配) 到 Level 4 (歧义弹窗确认)，系统智能处理网页布局的细微漂移。
- 指纹共识搜索：通过选区前后各 20 字符的“上下文指纹”与全局滑动窗口比对，即使在动态网页中，标记也能实现高精度的“空间位置共识”。
性能与架构优化 (Performance & Robustness)- 动态页面专项加固：
- 针对 Bilibili、Reddit 等 SPA 页面，引入了 300ms 智能防抖与全局搜索兜底机制，解决了虚拟列表滚动时容器复用导致的标记失效问题。
- 重构了 DOM 遍历策略，从递归遍历升级为基于栈的迭代遍历，显著降低了长文页面的 CPU 与内存开销。
源代码遵循 MIT 许可证 发布
- 全链路错误感知与反馈系统 (Error Collection & Export)
版本 0.5.1
发布于 2025年12月31日 - 159.27 KB适用于 firefox 109.0 及更高版本修复，优化划词检测算法，防止双击/三击段落时误触发工具栏。源代码遵循 MIT 许可证 发布
版本 0.5.0
发布于 2025年12月31日 - 159.28 KB适用于 firefox 109.0 及更高版本新增：正式更名为 MarkFlow 并上线全新官方介绍页
修复：Shadow DOM 选区兼容性，优化 B 站等复杂页面的标注稳定性
调整：优化消息通信机制，提升 SidePanel 与页面间的响应速度源代码遵循 MIT 许可证 发布
版本 0.3.5
发布于 2025年12月16日 - 156.92 KB适用于 firefox 109.0 及更高版本新增，暗黑模式
修复，导出 markdown 对接结构性回顾内容
调整，移除部分图标源代码遵循 MIT 许可证 发布
版本 0.3.0
发布于 2025年12月15日 - 156.16 KB适用于 firefox 109.0 及更高版本新增，结构性回顾，不再是简单的线性列表，结构化回顾功能可以根据内容、标题结构或用户自定义标签，将同一页面的高亮内容自动或手动组织成逻辑清晰的分组。这有助于您从“点”的回顾升级到“系统”的回顾。
新增，支持展开、收起，标记文字默认收起。源代码遵循 MIT 许可证 发布
版本 0.2.0
发布于 2025年12月12日 - 150.38 KB适用于 firefox 109.0 及更高版本新增，按住 Alt 键 (macOS 上为 Option 键) 的同时，选中网页上的任意一段文字。
新增，增加暗黑模式
修复，zIndex层级失效源代码遵循 MIT 许可证 发布