Vortex
GitHub下载
5 min

Shelf 4

  • .aabapp-release.aab
  • .ipaBuild 42.ipa
  • mockup.png
  • .mdnotes.md

Clipboard

    免费开源的 Mac 刘海软件 · macOS 14+ · Apple 芯片

    Vortex让 MacBook 的刘海派上用场。

    计时器、剪贴板历史、文件暂存架、从屏幕截取的任务，还有 Claude Code 能用却看不到的密钥。悬停即开，天生离线。

    下载 Mac 版在 GitHub 上加星标

    版本 0.1.0 · 免费 · MIT 许可证

    指向刘海，Vortex 随即打开。计时器一眼可见，文件和复制的内容排在底部。

    指针移到刘海时，Vortex 会从中展开；指针移开，它又自己收回去。它只显示你一天要用上十几次的工具，别无其他。

    没有刘海？Vortex 就待在菜单栏里。

    Timer

    刘海里的专注计时器。在滚轮上选好分钟数，看着它倒数。

    双指拨动滚轮、拖动它或点按刻度，然后点按“Start”。你工作时，倒计时一直留在刘海里。时间一到，Vortex 会播放提示音，让刘海闪烁直到你看过来，并发送一条带“+5 min”按钮的通知。

    • 1 至 120 分钟
    • 快速开始：5、10、15、30、60 分钟
    • Vortex 重启后继续计时

    试一试拖动滚轮，然后点按“Start”。

    Clipboard

    剪贴板历史，悬停即见。最近十条复制记录，外加你固定的条目。

    你复制的文本、链接、图片和文件都会自动记下。点按一条即可再次复制，也可以把它拖进任意 App，或者固定下来以后再用。密码管理器标记为机密的内容会显示为圆点，仅保存在内存中，Vortex 退出后随即消失。

    • 最近 10 条，固定的排在最前
    • 文本、链接、图片、文件
    • 排除的 App 从不记录
    Clipboard

      试一试复制本页上的任意一句话。

      Shelf

      文件暂存架。拖到刘海上暂放，再拖进任意 App。

      工作时先把文件放到一边，稍后再拖出来：拖进浏览器、聊天窗口或上传工具。让 Vortex 监视你的构建文件夹，每个新的 .ipa、.apk 或 .aab 一旦完整写入，就会自动出现在暂存架上，刘海也会闪烁提醒你。

      • 文件留在原处
      • 监视构建文件夹
      • 未固定的文件一天后移出

      桌面

      Shelf

        把文件向上拖到刘海轻点文件，把它放到暂存架上

        你的上传工具
        拖入安装包即可上传
        ./gradlew bundleRelease && open -a Vortex app-release.aab

        试一试从桌面拖一个文件到刘海上。你的文件始终留在 Mac 上。轻点一个文件，把它送到刘海上。

        Tasks

        把屏幕上的任何内容变成任务。按快捷键，框选，再按 Return。

        按下快捷键，屏幕随即定格，框选时画面纹丝不动。按下 Return 键，Vortex 会保存框选的部分和整个屏幕，并记下 App、窗口标题和浏览器中的网页地址。两张图中的文字都在你的 Mac 上识别，所以搜索图中的任何字词，都能找到这个任务。

        • 画面定格，纹丝不动
        • 来源：App、窗口、网页
        • 本机 OCR：按图中任意文字搜索
        聊天 — 移动端团队

        Dana

        登录按钮在 iPad mini 上显示不全，截图如下：

        Sam

        还有，横屏时键盘会挡住密码输入框。

        Frame an area · Esc to cancel

        Priority

        聊天 — 移动端团队

        Tasks

          试一试点按“+”，然后框住那条消息，或点按“帮我框选”。

          Keys

          Claude Code 能用却看不到的密钥。数据库 URL、API 令牌和密码都留在你的钥匙串里。

          在 Vortex 里给密钥起个名字。Claude Code 在该填值的地方写上 {{name}}，Vortex 则通过本地 MCP 服务器，在你的 shell 中运行这条命令。密钥的值以变量形式传入，再从输出中剔除，所以 Claude 拿到的是结果，永远拿不到密钥。每个会话第一次用到某个密钥时，需要你在刘海上允许。

          • 值存放在 macOS 钥匙串中
          • 本地 MCP 服务器，凭令牌访问
          • 每个会话中，每个密钥只需允许一次

          告诉 Claude 每个密钥的类型

          • PostgreSQL
          • MySQL
          • MongoDB
          • Redis
          • GitHub
          • Anthropic
          • OpenAI
          • Slack
          • AWS
          • Stripe
          • JWT
          • 私钥
          • 以及其他任何令牌或密码
          它防不住什么
          • Claude 能看到命令返回的内容：那是你的数据，不是密钥。
          • 如果值被刻意编码，或只出现一部分，Vortex 就无法从输出中把它剔除。
          • 命令运行期间，你的其他程序可以从它的参数或环境变量中看到这个值。

          阅读指南：Keep secrets and .env files away from Claude Code（英文）

          ~/projects/shop — claude
          1. Claude Code
          2. MCP · 127.0.0.1
          3. Vortex
          4. 钥匙串
          5. 你的 shell

          值留在钥匙串里；Claude 拿到的输出已剔除这些值。

          试一试Claude 请求密钥时，点按“Allow”。

          Keyboard cleaning

          锁定键盘，安心清洁。所有按键暂停工作，直到你重新开启。

          Home 页上的一个按钮就能锁定所有按键：字母键、修饰键、Esc、功能键，以及调节亮度、音量和媒体的按键。鼠标和触控板照常工作，点按一下就能恢复键盘。

          • 需要“辅助功能”权限
          • 鼠标和触控板照常工作
          • Vortex 退出后按键随即恢复

          macOS 不允许任何 App 锁定 Touch ID 或 Caps Lock。

          阅读指南：How to lock a MacBook keyboard for cleaning（英文）

          Keyboard cleaning mode

          All keys are locked

          试一试先按几个键，再把它们锁住。

          贴合你的工作方式。有无刘海皆可，快捷键、脚本随你。

          • 没有刘海？没问题。

            在没有刘海的 Mac 或外接显示器上，Vortex 会在菜单栏图标下方打开，计时器显示在图标旁边。

          • 快捷键由你定。

            用你设定的快捷键打开 Vortex、跳到任意标签页或新建任务。默认不占用任何快捷键。

          • 从脚本调用。

            open -a Vortex <files> 会把文件放上暂存架，不会打开窗口。

          • 用不上的，关掉就好。

            关闭的功能会从边栏和 Home 页消失，Vortex 也不再请求它所需的权限。

          • 浅色与深色。

            Vortex 跟随 Mac 的外观，也可以固定使用你选的那一种。

          • 英语和乌克兰语。

            Vortex 的界面支持这两种语言：默认跟随 Mac 的语言，其他语言下显示英语；也可以在设置中自选。

          天生离线。Vortex 从不自行联网。

          没有统计分析，没有更新检查，也没有账户。网络流量只来自 Claude Code 用你的密钥运行的命令，而且要先经过你允许。

          你的数据
          ~/Library/Application Support/Vortex
          你的密钥
          你的登录钥匙串
          文字识别
          在你的 Mac 上完成
          唯一的监听服务
          供 Claude Code 使用的 MCP 服务器，仅限本机，需要令牌
          规则
          Keys 模块之外一旦出现网络代码，构建检查就会失败
          本网站
          无 Cookie、无统计分析、无第三方请求
          没有任何数据离开你的 Mac：没有统计分析，没有更新检查，没有账户。Claude Code 通过 127.0.0.1 访问 Vortex。Claude Code127.0.0.1Vortex你的 Mac统计分析更新检查账户互联网

          免费开源。MIT 许可证。随你阅读、构建和改造。

          Vortex 是用 Swift 6 和 SwiftUI 编写的原生 Mac App，基于 The Composable Architecture 构建。每个功能都是一个模块，自带标签页、Home 小组件、设置、数据表和文档。删掉某个功能的文件夹和登记它的那几行代码，其余部分照样能构建。

          brew install xcodegengit clone https://github.com/OrtexIsArtem/vortex.gitcd vortexmake install

          需要 Xcode。如何让权限在重新构建后保留下来，请参阅 README。

          在 GitHub 上阅读代码如何参与贡献

          下载 Mac 版 Vortex。免费。适用于搭载 Apple 芯片、运行 macOS 14 或更高版本的 Mac。

          下载 Vortex 0.1.0

          版本 0.1.0 · 来自 GitHub Releases 的 zip 文件 · MIT 许可证

          Vortex 需在 Mac 上运行。把链接发给自己，再到 Mac 上下载。

          在 GitHub 上加星标

          首次打开

          1. 解压后，将 Vortex 移到“应用程序”文件夹。
          2. 打开 Vortex。macOS 会拒绝打开：Vortex 未经 Apple 公证，而公证需要付费的开发者账户。点按“完成”；在 macOS 14 上则点按“取消”。
          3. 打开“系统设置”›“隐私与安全性”，滚动到“安全性”，点按 Vortex 相关提示旁边的“仍要打开”。在 macOS 14 上，也可以在“应用程序”中按住 Control 键点按 Vortex，然后选取“打开”。

          或者在“终端”中运行：

          xattr -dr com.apple.quarantine /Applications/Vortex.app

          每项权限都是可选的

          通知
          计时结束提醒，以及窗口关闭时 Claude 发来的密钥请求
          辅助功能
          键盘清洁
          录屏
          从屏幕截取任务
          自动化（每个浏览器分别授权）
          获取任务的网页地址；macOS 会在首次使用时询问
          从其他 App 粘贴
          剪贴板历史；仅在会询问此权限的 macOS 版本上需要

          首次启动时，Vortex 会引导你逐一设置。如果某个功能的权限未开启，它会显示黄色警告：点按警告即可开启该权限。

          常见问题。直截了当的回答。

          还有其他问题？到 GitHub 上提问。

          Vortex 免费吗？

          是的。Vortex 免费开源，采用 MIT 许可证，无需订阅，也无需账户。

          没有刘海的 Mac（比如 MacBook Neo）能用 Vortex 吗？

          能。在没有刘海的 Mac 或外接显示器上，Vortex 会在菜单栏图标下方打开，计时器和其他状态指示显示在图标旁边。

          Vortex 支持哪些 Mac？

          搭载 Apple 芯片（M1 及更新）、运行 macOS 14 Sonoma 或更高版本的 Mac。不支持搭载 Intel 处理器的 Mac。

          Vortex 会收集数据吗？

          不会。它从不自行联网：没有统计分析，没有更新检查，也没有账户。你的数据保存在 ~/Library/Application Support/Vortex，密钥保存在你的登录钥匙串中。

          为什么 macOS 拒绝打开 Vortex？

          Vortex 未经 Apple 公证，因为公证需要付费的开发者账户。打开“系统设置”›“隐私与安全性”，点按 Vortex 相关提示旁边的“仍要打开”。在 macOS 14 上，也可以在“应用程序”中按住 Control 键点按 Vortex，然后选取“打开”。

          Claude Code 怎样在看不到密钥的情况下使用它？

          你在 Vortex 中给密钥起个名字。Claude Code 在该填值的地方写上 {{name}}，再通过本地 MCP 服务器把命令发给 Vortex。Vortex 用钥匙串中的值在你的 shell 中运行命令，再把这个值从输出中剔除，所以 Claude 拿到的是结果，永远拿不到密钥。

          应该把生产环境的密钥放进 Vortex 吗？

          这由你决定。密钥的值永远不会到达 Claude，而且每个密钥在每个会话中都要先经你同意一次。但 Claude 能看到命令返回的内容；刻意编码过的值无法从输出中剔除；命令运行期间，你 Mac 上的其他程序也能看到这个值。

          Vortex 和 NotchNook、Boring Notch 等 Mac 灵动岛应用有什么区别？

          Vortex 围绕工作而设计：存放安装包和文件的暂存架、从屏幕截取的任务、给 Claude Code 用的密钥、计时器和剪贴板历史。它从不自行联网，并以 MIT 许可证开源。它没有音乐控制，也没有日历。另见三款应用的对比（英文）。

          如何更新 Vortex？

          退出 Vortex，用新版本替换“应用程序”中的旧版本，再按首次打开时的方法打开它。发布版本没有用开发者账户签名，所以 macOS 会把每个新版本都当作新的 App：它会再次请求“辅助功能”和“录屏”权限、控制各个浏览器的权限，以及访问 Vortex 钥匙串项目的权限。

          我能添加自己的功能吗？

          可以。复制 Features/_Template 并重命名，再在 Package.swift 和 Registry 中登记它。CONTRIBUTING.md 会一步步带你完成。