HangDry Vibe 项目

项目简介

HangDry 是一款专为 macOS 设计的"文件临时挂载 + 一键归档"工具,作者在 Vibe Coding 助手(Claude Code)协助下完成,灵感来自 Alejandro Buján 的 Tendedero(把截图挂到屏幕顶端的绳子上)。它把工作过程中散落的文件(生成的视频片段、渲染输出、人声干音、封面参考、歌词字幕)统一挂到屏幕顶部一根虚拟绳子上,项目结束可一键按类型归档到指定文件夹,并保留原始路径日志。MIT 协议开源,macOS 14 Sonoma+ 可用。

核心功能

1. 拖拽即挂:把文件或图片拖到屏幕顶部,虚拟衣架滑出,卡片自动落入,绳子带物理下坠动画。
2. 复制即挂:在任何 App 中复制文件或图片(⌘C、浏览器"拷贝图像"、截图)即自动挂载,文本与密码管理器剪贴板自动忽略。
3. 监听文件夹:指向下载 / 渲染输出文件夹,新文件写入完成自动挂载。
4. 重排与排序:卡片可沿线拖拽重排,或按类型 / 创建日期 / 修改日期 / 名称排序。
5. 改名与归档改名:为卡片设显示名而不动原文件;归档时可选使用显示名。
6. 撤销与删除:只解除链接 / 把原文件丢入废纸篓 / 一键全部取下,均有 5 秒撤销窗口。
7. 一键归档:把所有卡片按类型(Videos/ Audio/ Images/ Documents/ Projects/)归入指定文件夹,冲突文件名自动加后缀,JSON 记录每个文件原始路径。
8. 物理动画:绳子随重量下垂,有东西落地时泛起涟漪,卡片在图钉上轻摇;静止时动画完全停止(≈0.3% CPU)。
9. 多语言:英语 / 简体中文 / 繁体中文 / 日语 四种界面。
10. 菜单栏常驻 + 开机启动:无 Dock 入口,菜单栏 👕 图标常驻,支持 Open at Login 开机启动。

技术实现

HangDry 使用 Swift 语言 + SwiftUI / AppKit 混合开发,macOS 14 Sonoma+ 系统要求与 Xcode 26+ 构建环境。物理动画通过 Metal 渲染 + Core Animation 实现,绳子的下垂、涟漪、卡片摆动均为数学模型驱动的真实物理模拟;静止时主动停帧,通过动态 FPS 调节做到空载 0.3% CPU 占用。

菜单栏常驻(👕图标),无 Dock 入口;支持"Open at Login"开机启动;全局快捷键 ⌃⌥H 保持开 / ⌃⌥K 归档 / ⌃⌥⌫ 一键取下 / ⌃⌥1-4 排序。

签名:用 Developer ID 签名 + Apple 公证,普通双击即可打开,无 Gatekeeper 警告。构建系统使用 XcodeGen 自动从 project.yml 生成 .xcodeproj,项目使用本地签名,自定义签好后变更交付版本可设置 DEVELOPMENT_TEAM。

快速上手

1. 下载 DMG:从 https://github.com/ansonsiva/HangDry/releases/latest 下载最新 HangDry-x.y.z.dmg,拖入 Applications。
2. 隐私授权:首次复制文件 / 图片时,macOS 询问是否允许 HangDry 读取剪贴板,选 "Always Allow"。
3. 拖入文件:任意文件或图片拖到屏幕顶部,虚拟衣架滑出,松手即挂。
4. 复制挂载:在 Finder / 浏览器 / Premiere / DaVinci 复制文件或图片,自动挂载。
5. 排序:沿线拖动卡片或用菜单中的排序命令或 ⌃⌥1-4。
6. 归档:菜单 → "Bring In" 或 ⌃⌥K,选文件夹,文件按类型归入子文件夹。
7. 一键取下:菜单 → "Take All Down" 或 ⌃⌥⌫,5 秒内可撤销。

适用人群

• AI 视频 / 音乐 MV 制作人:生成片段、渲染输出、干音、字幕多,需要统一管理
• 设计师:不同来源的参考图、素材、文档,工作项目结束一次性收好
• 重度拖放 / 剪贴板用户:习惯 ⌘C 操作系统的 macOS 重度用户
• 喜欢物理动画与精美交互的 Mac 极客玩家
• 想找一个轻量、不打扰的文件暂存 / 占位整理的独立开发者