简体中文 | English

灵动终端

灵动终端（DynamicTerminal）是一款面向 macOS 的原生终端应用。它位于屏幕顶部中央，可与 MacBook 刘海配合使用，并提供可展开的真实终端会话，让你在当前工作空间中随时使用 Shell。

主要功能

• 刘海感知的顶部终端，支持悬停、固定和全局快捷键
• 通过 SwiftTerm 提供真实 Shell、PTY、ANSI/TUI 和滚动缓冲
• 多标签页、终端配置（Profiles）、安全关闭会话和可分离终端窗口
• SSH 配置（使用 macOS 系统 OpenSSH）和基于 tmux 的本地持久会话
• 拖放到终端、多桌面空间和多显示器支持，以及后台任务完成通知

界面说明

应用在屏幕顶部中央提供可展开的终端界面；支持刘海屏和无刘海显示器。仓库目前没有随 README 发布的截图。

系统要求

• Apple Silicon Mac
• macOS 14 或更高版本

SSH 连接使用 macOS 自带的 OpenSSH。持久本地会话需要安装 tmux。从源码构建需要完整的 Xcode；SwiftTerm 由 Swift Package Manager 获取。

安装

1. 前往 GitHub Releases 下载 DynamicTerminal-1.0.0-arm64.dmg。
2. 打开磁盘映像，将应用拖到 Applications 文件夹。
3. 从“应用程序”文件夹启动“灵动终端”。

Unsigned Community Build

可下载的社区版本未经签名，也未经 Apple 公证；它未使用 Apple Developer ID。

如果 macOS 首次阻止启动，请在 Finder 中右键点击应用并选择“打开”。必要时前往“系统设置 → 隐私与安全性”允许打开。

从源码构建

1. 克隆此仓库。
2. 在 Xcode 中打开 DynamicTerminal.xcodeproj 并等待 Swift Package 依赖解析完成。
3. 选择 DynamicTerminal scheme 和 Apple Silicon Mac 目标，然后构建并运行。

项目使用 Automatic Signing。如果 Xcode 要求为你的克隆选择签名团队，请选择自己的开发团队；项目不要求作者的证书或配置描述文件。

SSH 与 tmux

SSH 配置通过系统 /usr/bin/ssh 启动，继承用户的 SSH config 和 agent。tmux 持久会话仅适用于本地配置；需要系统已安装 tmux。SSH 配置不与 tmux 模式组合使用。关闭应用后，只有仍存在的 tmux 会话连接入口可以恢复；普通 Shell 和 PTY 内容不会恢复。

已知限制

刘海、多显示器、Spaces、登录启动、SSH、tmux 及复杂界面交互仍有部分场景需要更多真实硬件验证。后台完成通知不检测 tmux pane 内部命令的结束。完整列表见项目状态。

License

本项目采用 MIT License。第三方许可证及原文见 THIRD_PARTY_LICENSES.md。

贡献

欢迎提交 Issue 和 Pull Request。请先阅读贡献指南及安全政策。