装好 tendedero 只需三步Release 下载、拖进 Applications、首次授权全流程【免费下载链接】tendederoScreenshots, hung out to dry. A tiny native macOS app that hangs every screenshot on a line at the top of your screen.项目地址: https://gitcode.com/gh_mirrors/te/tendedero如果你的 macOS 桌面常年被截图堆满——每按一次CmdShift5右下角先浮出缩略图五秒后才落盘成文件日积月累全是屏幕快照 2026-xx-xx 15.30.45.png——那么 tendedero 可能正是你缺的那一环。它不替代截图工具而是接管截图之后的归宿把每一张截图晾在屏幕顶端一根晾衣绳上悬停即见、移开即隐点击复制、按住标注、拖拽分享桌面从此不沾一张图。项目近日出现在 GitHub 日榜趋势速报中靠的正是这个极其聚焦的产品切口。安装它理论上只要三步但真正决定能不能顺利跑起来的往往不是拖拽那一下而是首次启动时与 macOS 的授权交互。本文结合仓库源码把三步拆开讲透。第一步从 Release 下载拖进 Applications下载与拖拽README 给出的官方路径很简单从最新 Release 下载磁盘映像disk image打开后将 tendedero 拖入 Applications 文件夹。整个应用只有 1.7 MB要求 macOS 14 Sonoma 及以上Apple 芯片与 Intel 均可仓库 README.md 的 Tech Specs 里写明它主要针对 macOS 27 设计同时兼容旧系统。打开 DMG 后你会发现窗口里有Tendedero.app和一个指向 Applications 的快捷方式——这不是 Finder 默认行为而是发布脚本刻意为之。scripts/make-dmg.sh 在构建 DMG 时显式执行了ln -s /Applications $STAGE/Applications把拖拽路径直接铺在你眼前。拖过去第一步就完成了。为什么必须放进 Applications很多人习惯把应用放在任意目录直接运行但 tendedero 的开机启动功能依赖应用位于 Applications 中。菜单栏里的Open at login通过SMAppService.mainApp.register()注册登录项失败时会弹出提示Move Tendedero to the Applications folder and try again.见 Sources/Tendedero/AppDelegate.swift。一个 1.7 MB 的常驻小工具放对位置才算装好。签名与公证打开时不会吓你一跳如果你从非官方渠道下载过 macOS 应用多半见过 Gatekeeper 的无法验证开发者警告。tendedero 的 Release 流程绕开了这一点scripts/make-dmg.sh 用 Developer ID 对 DMG 签名codesign --force --timestamp通过xcrun notarytool submit提交苹果公证再用stapler staple把票据打进镜像最后spctl --assess自检。因此 README 里那句opens like any other app不是宣传语是发布管线里写死的步骤。首次打开时你看到的是正常的确认对话框而不是安全警告。如果你更习惯命令行README 也提供了 Homebrew 备选brew install --cask alejandrobujan/tap/tendedero效果等价。第二步首次启动把两个关键授权处理干净装好后首次启动tendedero 会接连做两件事请求桌面文件夹访问权限然后询问是否接管你的截图。这两步都值得理解背后的原因因为它们直接决定截图能不能上绳。桌面文件夹权限监视而非截屏tendedero 自己从不截图。这是它的核心设计哲学代码注释写得很直白Tendedero never takes screenshots itself: you keep your usual shortcut (or CleanShot, or anything else) and the line just picks them up.Sources/Tendedero/ScreenshotWatcher.swift。它只是监视 macOS 保存截图的那个文件夹——默认就是桌面——一旦发现新文件就把它挂上晾衣绳。监视的实现方式是文件系统事件而非轮询open(folder.path, O_EVTONLY)拿到目录句柄后用DispatchSource.makeFileSystemObjectSource监听.write/.rename/.delete事件macOS 写入截图时会先写临时文件再重命名所以代码里留了 0.2 秒的延迟再扫描。这就是首次启动系统会弹窗请求桌面文件夹权限的原因——没有它应用无法看到桌面上新出现的截图文件。这里有一个很多人会踩的细节如果启动瞬间权限弹窗还没处理完会不会漏掉刚截的图不会。Sources/Tendedero/ScreenshotWatcher.swift 用launchDate记录启动时刻凡是启动之后创建的文件都算新截图即使它落在监视器就绪之前——注释里明确写了这是为了应对macOS may be asking for Desktop access at that moment。也就是说你可以先授权、后截图顺序随意不会丢图。一个额外的工程细节在桌面文件夹中只有带com.apple.metadata:kMDItemIsScreenCapture扩展属性的文件才会被挂上绳通过getxattr读取避免把桌面上的普通图片误认成截图而在 tendedero 自己的文件夹里任何图片都算数。接管截图询问Inbox 模式启动约 1.2 秒后tendedero 会弹出一个系统对话框Let Tendedero handle your screenshots?见 Sources/Tendedero/AppDelegate.swift 的offerInbox()只询问一次。接受后它进入 Inbox 模式做了两件事Sources/Tendedero/Inbox.swift把截图保存位置从桌面改到~/Library/Application Support/Tendedero/Screenshots/——写入的是com.apple.screencapture域下location和location-screenshot两个键后者是 macOS 27 新增的键名旧系统读前者所以两个都写关闭show-thumbnail浮动缩略图让截图文件即时落盘不再等五秒。关键设计是可逆修改前会把原始设置备份到 UserDefaults退出应用或从菜单栏关闭该选项时自动还原绝不让系统指向一个没人监听的文件夹。连SIGTERM/SIGINT/SIGHUP信号都挂了处理器保证即使被强杀也能恢复设置。另外还有一个双保险Inbox 模式下如果截图仍落在桌面比如某个 macOS 版本忽略了设置键后台会有第二个监视器兜底把它捞上绳。拒绝这个询问也完全没问题——tendedero 照样工作只是截图仍先存桌面、再上绳。之后随时可以在菜单栏的 Handle screenshots 选项里切换。哪些权限它不需要常见截图工具动辄要求屏幕录制权限tendedero 刻意绕开了两样屏幕录制权限因为应用从不自己截屏只监视文件夹自然不需要辅助功能Accessibility权限显示/隐藏晾衣绳的快捷键CtrlOptionT通过 Carbon 的RegisterEventHotKey注册全局热键Sources/Tendedero/HotKey.swift 的注释专门强调Unlike a global key monitor, it needs no Accessibility permission.所以首次启动你需要处理的授权本质只有一个允许它访问桌面文件夹。第三步验证截图是否成功上绳截一张图看它飞上去授权完成后按下你惯用的截图快捷键CmdShift5区域截图、整屏、窗口都行。区别于传统截图工具的缩略图tendedero 会读取截图文件上的com.apple.metadata:kMDItemScreenCaptureGlobalRect扩展属性还原出截图在屏幕上的精确位置然后让这张图从原位置出发沿着一段 30 点的柔和弧线飞向绳上自己的位置——飞行中同时完成缩小、倾斜、长出玻璃相框和夹子0.65 秒后无缝落位实现见 Sources/Tendedero/CaptureFlight.swift。下面这段演示 GIF 就是安装成功后的典型画面指针停在屏幕顶端绳滑落三张截图轻轻摆动点击复制一张指针离开后绳收回。三条验证路径路径一悬停唤出。把指针移到菜单栏区域停留约 0.25 秒绳从屏幕顶部滑出指针离开后 0.5 秒自动收回两个阈值常量revealDelay与retractDelay定义在 Sources/Tendedero/AppDelegate.swift。刚截完图时绳会自动探出 2.5 秒给你看一眼。路径二快捷键。CtrlOptionT手动显示/隐藏绳。注意这个热键走的是 Carbon 注册不依赖辅助功能权限。路径三首次启动引导。第一次打开时如果绳上还没有截图绳会主动垂下并显示一行提示Take a screenshot and it will hang here5 秒后若无新截图才收回。看到这行字就说明安装和授权都到位了。验证手势确认交互链路完整绳上的每张截图都支持一套完整手势README 中的操作表实现见 Sources/Tendedero/GrabArea.swift 与 Sources/Tendedero/Line.swift手势行为单击复制图片到剪贴板卡片下方会短暂出现 Copied 提示按住 0.45 秒打开系统 Markup 标注编辑器保存后绳上即时刷新双击在预览中打开拖入任意应用发送副本原图留在绳上拖入文件夹/桌面文件移走卡片离开绳拖到废纸篓 / 点左上角叉丢弃点击菜单栏任意处收起绳注意一个区分Inbox 模式下截图文件默认在 tendedero 自己的文件夹里所以丢弃是真删移入废纸篓防止文件夹被遗忘的截图堆满而从桌面挂上来的图丢弃只是取下原文件不动。右击卡片还能看到完整右键菜单Copy / Open / Markup / Show in Finder / Save to Desktop / Discard。两个成功感细节如果一切正常你会注意到两个刻意为之的小细节每张截图的倾斜角是随机的tilt Double.random(in: -2.5...2.5)像真实晾衣绳上随手挂上去的照片每隔 7 到 16 秒会有一阵微风让绳上的卡片轻轻摆动scheduleGust()Sources/Tendedero/Line.swift。绳本身是一条按抛物线方程绘制的曲线下垂量min(30, width * 0.018)随屏幕宽度变化Sources/Tendedero/LineView.swift。这些细节不是功能但它们是上绳成功最直观的视觉反馈。排查截图没上绳怎么办检查授权如果截图只出现在桌面、绳上没动静多半是桌面文件夹权限被拒。到 系统设置 → 隐私与安全性 → 文件与文件夹 中允许然后从菜单栏退出重开。检查 Inbox 状态菜单栏的 T 恤图标 → Handle screenshots 是否勾选。若开启后截图仍落在桌面个别系统版本忽略设置键内置的兜底监视器会自动捞图稍等片刻即可。全屏应用下正在播放视频或做演示的全屏 Space 中绳会主动隐藏退出全屏后自动恢复——这是 Sources/Tendedero/FullScreen.swift 通过窗口服务器私有接口判断 Space 类型实现的别误以为是故障。绳满处理绳上最多同时挂 8 张随屏幕宽度在 3–12 间自适应满了之后最老的截图自动从远端滑落。装好之后至此三步完成Release 下载拖入 Applications、完成首次授权、截图成功上绳。这套安装流程之所以能保持三步背后是发布脚本的签名公证、监视器的容错设计权限迟到不丢图、系统键失效有兜底和可逆的设置接管退出即还原三者共同兜底。值得一提的还有两点其一tendedero 的隐私设计是No account. No network. No analytics.完全本地运行截图像素不离开你的 Mac其二代码以 MIT 协议开源名称与图标除外如果你愿意自己构建README 提供了scripts/build-app.sh的从源码构建路径——唯一的差别是本地构建为 ad hoc 签名每次重新构建后 macOS 会再次询问桌面访问权限这恰好印证了本文第二步中授权机制的存在。装好后按下CmdShift5剩下的就交给那根绳了。【免费下载链接】tendederoScreenshots, hung out to dry. A tiny native macOS app that hangs every screenshot on a line at the top of your screen.项目地址: https://gitcode.com/gh_mirrors/te/tendedero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
