专为 macOS 设计的高性能原生剪贴板管理工具

官网 · 下载最新版本 · 问题反馈

• 🚀 零延迟启动 - 原生 Swift 实现，毫秒级响应
• 🪟 原生玻璃拟态 - 使用 macOS 原生 Material 效果
• 📍 四向停靠 - 支持屏幕底部、顶部、左侧、右侧停靠
• 🎯 智能识别 - 自动识别文本、图片、链接、颜色、代码、文件
• ⚡ 自动粘贴 - 一键粘贴到当前应用
• 📝 笔记功能 - 快速创建和管理轻量笔记
• ☁️ iCloud 同步 - 多设备无缝同步（可选）
• ⌨️ 全局快捷键 - 默认 ⌘B 快速唤出
• 🔄 自动更新 - 内置更新检测，一键升级

1. 前往 Releases 页面
2. 下载 EchoFlow-x.x.x.dmg
3. 打开 DMG，将 EchoFlow 拖入 Applications 文件夹
4. 首次运行时，右键选择"打开"以绕过 Gatekeeper

git clone https://github.com/kebenart/EchoFlow.git
cd EchoFlow
open EchoFlow.xcodeproj

在 Xcode 中按 ⌘R 运行。

• 应用启动后会显示在 菜单栏（状态栏）
• 不会在 Dock 中显示图标

• 快捷键: ⌘B（可在设置中自定义）
• 鼠标: 点击菜单栏图标

首次使用自动粘贴功能时，需要授予辅助功能权限：

1. 打开 系统设置 → 隐私与安全性 → 辅助功能
2. 找到并启用 EchoFlow
3. 重新启动应用以使权限生效

遇到权限问题？ 查看 权限帮助指南 获取详细帮助。

点击菜单栏图标，选择「设置」打开设置面板：

• 通用 - 停靠位置、复制行为、历史保留时间等
• 规则 - 去重设置、链接预览、颜色采样算法
• 快捷键 - 自定义全局快捷键
• 关于 - 版本信息、检查更新

• Swift 5.9+ - 现代 Swift 特性
• SwiftUI - 声明式 UI 框架
• SwiftData - 现代化数据持久层
• CloudKit - 苹果原生云同步
• AppKit - 高级窗口管理

EchoFlow/
├── App/
│   ├── EchoFlowApp.swift      # 应用入口
│   └── AppDelegate.swift      # 生命周期管理
├── Core/
│   ├── Models/                # 数据模型
│   ├── Managers/              # 核心管理器
│   └── Utils/                 # 工具类
├── UI/
│   ├── Components/            # UI 组件
│   └── Screens/               # 主要视图
├── scripts/                   # 自动化脚本
│   ├── release.sh             # 完整发布脚本
│   ├── quick-release.sh       # 快速发布脚本
│   └── clean-git-history.sh   # Git 历史清理
└── .github/workflows/         # GitHub Actions

使用内置脚本快速发布：

# 快速发布
./scripts/quick-release.sh 1.0.1 "修复问题"

# 完整发布（带交互）
./scripts/release.sh 1.0.1

# 测试发布流程
./scripts/release.sh 1.0.1 --dry-run

详见 scripts/README.md

• 完善分类系统
• 自定义标签功能
• 数据导出/导入（备份功能）

• iCloud 云同步完善
• 多设备实时同步状态
• Markdown 笔记支持

• 📱 iPhone / iPad 版本
• 🤖 Android 版本
• 🖥️ Windows 版本
• 🔄 多端数据同步
• ☁️ 云端备份与恢复

详见 CHANGELOG.md

• 快速开始指南 - 详细的安装和使用说明
• 权限帮助指南 - 权限授权和问题解决
• 构建指南 - 如何构建安装包
• 脚本说明 - 自动化脚本使用说明

MIT License

• 感谢 Apple 提供优秀的开发框架
• 感谢所有贡献者和测试用户