Hyper - 4.0.0

项目目标

本项目的目标是为命令行界面用户打造一个美观且高度可扩展的体验，基于开放的 Web 标准构建。初期我们将主要聚焦于速度、稳定性，以及为插件开发者提供正确、完善的 API。

未来，我们期待社区能够贡献更多创新功能，共同打造出可能是最简洁、最强大且经过充分测试的生产力终端界面。

使用方式

请下载最新版本！

Linux

• Arch 及其衍生发行版
  Hyper 已收录于 AUR。可使用 AUR 包管理器（如 paru）安装：
  paru -S hyper
• NixOS
  Hyper 可通过 Nix 包管理器安装，运行以下命令：
  nix-env -i hyper

macOS

使用 Homebrew Cask 安装：

brew update
brew install --cask hyper

Windows

使用 Chocolatey 安装（包信息）：

choco install hyper

注意：通过 Homebrew Cask、Chocolatey、Snapcraft 或 AUR 安装的版本可能不是最新版。如需最新功能，请考虑从官网直接下载。

参与贡献

无论你在哪个平台开发，都需要先安装 Yarn。若尚未安装，请访问：https://yarnpkg.com/en/docs/install。

安装必要依赖

• Windows
  请以管理员身份打开命令提示符，运行：
  yarn global add windows-build-tools
• macOS
  安装 Yarn 后即可跳过此步骤！
• Linux（可通过 cat /etc/os-release 查看发行版类型）
  • RPM 系（如 Fedora、CentOS）：
    GraphicsMagick、libicns-utils、xz（部分发行版默认已安装）
  • Debian 系（如 Ubuntu、Debian）：
    graphicsmagick、icnsutils、xz-utils

开始开发

1. 将本仓库 Fork 到你的 GitHub 账号，并克隆到本地；
2. 安装依赖：
   yarn
3. 构建代码并监听变更：
   yarn run dev
4. 在另一个终端标签页/窗口中运行 Hyper：
   yarn run app
5. 如果你使用 Visual Studio Code，可选择调试配置 “Launch Hyper” 来启动带调试器的新实例。

提示：若中断了 yarn run dev，每次测试前需重新运行它。Webpack 会自动监听文件变化并仅重建修改的部分（渲染层代码）。你只需再次运行 yarn run app 或使用 VS Code 启动任务即可重启 Electron 应用。

生成最终安装包

为确保代码在成品应用中正常工作，可执行以下命令生成二进制文件：

yarn run dist

生成的安装包将位于 ./dist 文件夹中。

开发中常见问题

1. 构建 node-pty 出错

若开发过程中出现与 node-pty 相关的弹窗错误，请手动重建该模块：

yarn run rebuild-node-pty

在 macOS 上，这通常是因为 Xcode 未接受许可协议。请在全新安装 Xcode 后运行：
sudo xcodebuild 并同意条款。

2. macOS 上运行 yarn 时 C++ 编译报错

如果执行 yarn 时出现编译器错误，请在终端中设置环境变量：

export CXX=clang++

3. macOS 上运行 yarn run dist 时 codesign 失败

若在打包时卡在代码签名步骤，可临时禁用自动签名（仅限本地开发）：

export CSC_IDENTITY_AUTO_DISCOVERY=false

在当前终端会话中执行后再运行 yarn run dist 即可。