Screendrop非破坏性编辑的工程秘密:sidecar文件与原子文件事务如何做到零数据丢失
Screendrop非破坏性编辑的工程秘密sidecar文件与原子文件事务如何做到零数据丢失【免费下载链接】ScreendropA beautiful screenshot screen recording Loom alternative - all native, self hostable and free.项目地址: https://gitcode.com/gh_mirrors/sc/ScreendropScreendrop 是一款原生 macOS 的截屏与录屏工具Loom 的免费替代品它的标注编辑器采用非破坏性编辑无论你在截图上画了多少箭头、打码了多少隐私原始像素始终原封不动。本文拆解它背后的两套核心机制——sidecar 旁路文件与原子文件事务看看零数据丢失到底是怎么工程化实现的。为什么截图加标注很容易把文件搞坏传统截图工具的做法是存即压扁flattening画一个箭头就把箭头像素直接画进图片里。这样带来两个麻烦想改就来不及了箭头画歪了只能撤销一旦保存标注就成了图片的一部分无法单独移动、删除想还原也没法原图像素已经被覆盖除非一开始就另存了一份。Screendrop 的答案很直接原图、渲染结果、编辑数据三者分开存放。sidecar 文件把原图和编辑内容拆开存每次编辑一张截图后Screendrop 会在同一目录下生成这样一组文件文件角色例子显示图你看到的渲染结果原图标注合成Screendrop_2026.pngbase 图未被触碰的原图每次编辑都从它重新渲染Screendrop_2026.base.pngsidecar 文档可再编辑的标注状态JSONScreendrop_2026.png.screendrop命名规则就写在 ScreenshotHistoryStore.swift 里显示图加一个.screendrop后缀就是 sidecar文件主干加.base就是原图备份。sidecar 的内容是一个带版本号的 JSON 文档结构定义在 AnnotationDocument.swift标注形状shapes、箭头吸附绑定bindings、背景/水印/透视等效果background以及它引用的 base 图文件名。正因为编辑状态是数据而不是像素重新打开截图时 Screendrop 能完整恢复你上次的所有标注继续修改。保存流程同样体现了非破坏的原则核心逻辑在 commitAnnotations首次编辑时才惰性备份 base 图不浪费磁盘用 base 原图 当前标注渲染出新的合成图合成图覆盖显示图sidecar 文档写到旁边下次再编辑时依然从 base 原图重新渲染——标注永远不会叠在旧标注上。如果把你画的标注全部删光并保存Screendrop 反而会走 removeAnnotations 把 base 原图还原回显示图位置并删除 sidecar——彻底回到截图刚拍下的样子。原子文件事务一次保存要么全成功要么全回滚问题在于一次保存要同时动三个文件base 图、显示图、sidecar。写到一半断电、磁盘满、权限出错就会留下半新半旧的残局。Screendrop 用一个 60 行的小工具类解决它——ScreenshotEditFileTransaction.swift整个流程分四步第 1 步暂存区staging在目标目录里创建一个.screendrop-save-UUID临时目录先把所有新文件复制进来new-0、new-1……。此刻磁盘上的原文件一个字节都没动。第 2 步备份现场把每个即将被覆盖的旧文件复制为original-0、original-1。从此无论后面发生什么旧数据都有退路。第 3 步正式安装逐个把暂存的新文件替换到目标位置。替换用的是replaceItemAt同卷原子替换目标不存在时用moveItem移动即落地见 install。第 4 步失败即回滚任何一步抛错就按逆序把已经动过的文件从备份还原如果还原本身也失败keepBackup为 true则保留整个暂存目录作为恢复文件并在错误信息里直接告诉用户恢复文件在哪里见 apply 的 catch 分支。这套设计的关键取舍是宁可多占一点临时空间也要保证任何时刻磁盘上要么全是旧状态、要么全是新状态不存在中间态。最后一道防线提交锁与失败时编辑器不关文件事务保证磁盘安全但应用层还要防住两个人同时保存。在 AnnotationEditorModel.commitEdits 中isCommitting标志位保证 Done、Save、Upload、关闭提示框等所有退出路径都走同一个提交入口且相互之间不能并发冲突提交失败时编辑器保持打开、改动不丢用户可以重试——而不是静默丢弃工作成果sidecar 文档先用.atomic选项写入临时文件再交给事务统一替换避免写出半个 JSON。配合前面暂存目录的保留恢复文件策略Screendrop 把数据丢失从一种可能变成了工程上被层层拦截的事件备份、回滚、恢复目录、不关编辑器四重保险。同样的思路也用于录屏与云端分享这套 sidecar 思想并不止于截图录屏工程每个录屏是一个非破坏性会话包.screendroprec屏幕原片、摄像头原片、事件数据光标/点击/按键各自独立存放编辑只改项目文档见 RecordingProject.swift云端分享上传视频后Screendrop 会追加尽力而为的云端 sidecar——标题、海报图、映射到剪辑后时间轴的字幕、拖动预览用的雪碧图见 CloudSidecarUploader.swift分享页随 sidecar 到达逐渐变丰富而主上传不受影响。小结Screendrop 用两个朴素的工程手段兑现了零数据丢失的承诺sidecar 旁路文件原图、渲染图、编辑数据三文件分离编辑永远是数据而非像素可反复修改、彻底还原原子文件事务暂存 → 备份 → 原子替换 → 逆序回滚 → 保留恢复文件让多文件保存要么整体成功、要么整体回退。这套方案代码量很小事务核心不到 70 行却是非破坏性编辑器里最容易被忽略、也最值钱的保险丝。【免费下载链接】ScreendropA beautiful screenshot screen recording Loom alternative - all native, self hostable and free.项目地址: https://gitcode.com/gh_mirrors/sc/Screendrop创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

Android 软键盘与输入框对不齐?聊聊输入交互里的坐标问题

Android 软键盘与输入框对不齐?聊聊输入交互里的坐标问题

getGlobalVisibleRect 拿到的"全局可见区域",在输入框被键盘顶起来之后可能已经不准了——很多人在这上面栽了跟头。 前言 很多 App 都有这个交互:键盘弹着,用户点输入框外面的区域,键盘收起来。实现思路很简单——监听全局触摸事件,如果点击点不在输入框范围内…

2026/11/16 16:27:41 阅读更多 →
阿里金九银十Java面试突击指南全网首次公开!

阿里金九银十Java面试突击指南全网首次公开!

今年金三银四已过,不知道大家都拿到Offer没有,如果没有的话,希望大家不要怪LZ凡尔赛了(手动狗头)。LZ截止今天为止已经收到了第9家公司的Offer,这张的Offer的话给到28k*14薪。由于个人原因,LZ没…

2026/11/9 15:04:58 阅读更多 →
【有源码】基于Spring Boot和Vue的在线考试与交流系统-教育信息化背景下在线考试与交流一体化平台

【有源码】基于Spring Boot和Vue的在线考试与交流系统-教育信息化背景下在线考试与交流一体化平台

注意:该项目只展示部分功能,如需了解,文末咨询即可。 本文目录1 开发环境2 系统设计3 系统展示3.1 功能展示视频3.2 页面3.3 分析页面3.4 基础页面4 更多推荐5 部分功能代码1 开发环境 发语言:python 采用技术:Spark、…

2026/11/10 20:37:10 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻