feat(ci): add macOS DMG installers to release workflow

Add DMG disk image creation for both Apple Silicon and Intel Mac builds using hdiutil. DMGs include Applications symlink for drag-to-install. Updated both READMEs with DMG download links and macOS install section.

Made-with: Cursor

Author: OlaProeis

.github/workflows/release.yml

@@ -265,12 +265,25 @@ jobs:
           cp -R target/release/bundle/osx/Ferrite.app release/
           tar -czvf ferrite-macos-arm64.tar.gz -C release .
 
-      - name: Upload artifact
+      - name: Create DMG installer
+        run: |
+          mkdir -p dmg-staging
+          cp -R target/release/bundle/osx/Ferrite.app dmg-staging/
+          ln -s /Applications dmg-staging/Applications
+          hdiutil create -volname "Ferrite" -srcfolder dmg-staging -ov -format UDZO "ferrite-macos-arm64.dmg"
+
+      - name: Upload tar.gz artifact
         uses: actions/upload-artifact@v4
         with:
           name: ferrite-macos-arm64
           path: ferrite-macos-arm64.tar.gz
 
+      - name: Upload DMG artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ferrite-macos-arm64-dmg
+          path: ferrite-macos-arm64.dmg
+
   build-macos-intel:
     name: Build macOS (Intel)
     runs-on: macos-14  # Cross-compile to x86_64 from ARM64 runner
@@ -296,12 +309,25 @@ jobs:
           cp -R target/x86_64-apple-darwin/release/bundle/osx/Ferrite.app release/
           tar -czvf ferrite-macos-x64.tar.gz -C release .
 
-      - name: Upload artifact
+      - name: Create DMG installer
+        run: |
+          mkdir -p dmg-staging
+          cp -R target/x86_64-apple-darwin/release/bundle/osx/Ferrite.app dmg-staging/
+          ln -s /Applications dmg-staging/Applications
+          hdiutil create -volname "Ferrite" -srcfolder dmg-staging -ov -format UDZO "ferrite-macos-x64.dmg"
+
+      - name: Upload tar.gz artifact
         uses: actions/upload-artifact@v4
         with:
           name: ferrite-macos-x64
           path: ferrite-macos-x64.tar.gz
 
+      - name: Upload DMG artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ferrite-macos-x64-dmg
+          path: ferrite-macos-x64.dmg
+
   # NOTE: musl static build disabled - GUI apps with font rendering (freetype, fontconfig)
   # and graphics (X11/Wayland) dependencies cannot be easily built as static musl binaries.
   # The glibc build (Ubuntu 22.04) provides good compatibility across Linux distributions.
@@ -345,11 +371,21 @@ jobs:
         with:
           name: ferrite-macos-arm64
 
+      - name: Download macOS ARM64 DMG
+        uses: actions/download-artifact@v4
+        with:
+          name: ferrite-macos-arm64-dmg
+
       - name: Download macOS Intel artifact
         uses: actions/download-artifact@v4
         with:
           name: ferrite-macos-x64
 
+      - name: Download macOS Intel DMG
+        uses: actions/download-artifact@v4
+        with:
+          name: ferrite-macos-x64-dmg
+
       - name: Download signed PortableApps installer
         uses: actions/download-artifact@v4
         with:
@@ -374,6 +410,8 @@ jobs:
             ferrite-linux-x64.tar.gz
             ferrite-editor_amd64.deb
             ferrite-editor.x86_64.rpm
+            ferrite-macos-arm64.dmg
             ferrite-macos-arm64.tar.gz
+            ferrite-macos-x64.dmg
             ferrite-macos-x64.tar.gz
             FerriteMDPortable_*_English.paf.exe

README.md

@@ -176,8 +176,10 @@ Download the latest release for your platform from [GitHub Releases](https://git
 | **Linux (Debian/Ubuntu)** | `ferrite-editor_amd64.deb` | For Debian, Ubuntu, Mint, Pop!_OS |
 | **Linux (Fedora/RHEL)** | `ferrite-editor.x86_64.rpm` | For Fedora, RHEL, CentOS, Rocky |
 | Linux | `ferrite-linux-x64.tar.gz` | Universal - works on any distro |
-| **macOS (Apple Silicon)** | `ferrite-macos-arm64.tar.gz` | For M1/M2/M3 Macs |
-| **macOS (Intel)** | `ferrite-macos-x64.tar.gz` | For Intel Macs |
+| **macOS (Apple Silicon)** | `ferrite-macos-arm64.dmg` | Recommended - drag to Applications (M1/M2/M3) |
+| macOS (Apple Silicon) | `ferrite-macos-arm64.tar.gz` | Alternative - contains Ferrite.app bundle |
+| **macOS (Intel)** | `ferrite-macos-x64.dmg` | Recommended - drag to Applications |
+| macOS (Intel) | `ferrite-macos-x64.tar.gz` | Alternative - contains Ferrite.app bundle |
 
 <details>
 <summary><strong>Windows Installation</strong></summary>
@@ -277,6 +279,33 @@ tar -xzf ferrite-linux-x64.tar.gz
 
 </details>
 
+<details>
+<summary><strong>macOS Installation</strong></summary>
+
+#### DMG Installer (Recommended)
+
+Download the `.dmg` for your Mac:
+- **Apple Silicon** (M1/M2/M3/M4): `ferrite-macos-arm64.dmg`
+- **Intel**: `ferrite-macos-x64.dmg`
+
+Open the DMG and drag `Ferrite.app` to the **Applications** folder. Launch from Launchpad or Spotlight.
+
+#### From tar.gz (Alternative)
+
+```bash
+# Apple Silicon
+tar -xzf ferrite-macos-arm64.tar.gz
+cp -R Ferrite.app /Applications/
+
+# Intel
+tar -xzf ferrite-macos-x64.tar.gz
+cp -R Ferrite.app /Applications/
+```
+
+> **Gatekeeper Note:** If macOS shows "app can't be opened because it is from an unidentified developer", right-click `Ferrite.app` and select **Open**, then click **Open** in the dialog. This is only needed once — macOS remembers your choice.
+
+</details>
+
 <details>
 <summary><strong>Build from Source</strong></summary>
 

README.zh-CN.md

@@ -88,7 +88,7 @@ Ferrite **不会**访问密码、浏览器数据，也不进行网络连接。
 |------------|------------|----------|
 | ![Raw Editor](assets/screenshots/raw-dark.png) | ![Split View](assets/screenshots/split-dark.png) | ![Zen Mode](assets/screenshots/zen-dark.png) |
 
-> ✨ **v0.2.7（即将发布）：** **维基链接**与**反向链接面板**。**Vim 模式**。首次启动**欢迎页**。**GitHub 风格提示框**。**Ctrl+滚轮缩放**。**格式化后保持选中**。**前言编辑器**。预览中渲染图片。**格式工具栏**与**侧边面板切换**。**Nix/NixOS flake 支持**。Linux 门户对话框错误处理。macOS .app 包。20+ 问题修复，包括自动换行滚动、大选区崩溃、IME 退格键等。详见 [CHANGELOG.md](CHANGELOG.md)。
+> ✨ **v0.2.7（最新）：** **维基链接**与**反向链接面板**。**Vim 模式**。首次启动**欢迎页**。**GitHub 风格提示框**。**Ctrl+滚轮缩放**。**格式化后保持选中**。**前言编辑器**。预览中渲染图片。**格式工具栏**与**侧边面板切换**。**Nix/NixOS flake 支持**。新安装包：**.deb**、**.rpm**、macOS **.dmg** 与 **.app** 包。**单实例**文件打开。20+ 问题修复。详见 [CHANGELOG.md](CHANGELOG.md)。
 
 > 📦 **v0.2.6 亮点：** 全新自定义编辑器引擎与虚拟滚动（80MB 文件约 80MB 内存）、多光标编辑、代码折叠、IME/CJK 输入改进。
 
@@ -176,8 +176,10 @@ Ferrite **不会**访问密码、浏览器数据，也不进行网络连接。
 | **Linux (Debian/Ubuntu)** | `ferrite-editor_amd64.deb` | Debian、Ubuntu、Mint、Pop!_OS |
 | **Linux (Fedora/RHEL)** | `ferrite-editor.x86_64.rpm` | Fedora、RHEL、CentOS、Rocky |
 | Linux | `ferrite-linux-x64.tar.gz` | 通用 — 适用于多数发行版 |
-| **macOS (Apple Silicon)** | `ferrite-macos-arm64.tar.gz` | M1/M2/M3 |
-| **macOS (Intel)** | `ferrite-macos-x64.tar.gz` | Intel  Mac |
+| **macOS (Apple Silicon)** | `ferrite-macos-arm64.dmg` | 推荐 — 拖入"应用程序"即可 (M1/M2/M3) |
+| macOS (Apple Silicon) | `ferrite-macos-arm64.tar.gz` | 替代 — 包含 Ferrite.app |
+| **macOS (Intel)** | `ferrite-macos-x64.dmg` | 推荐 — 拖入"应用程序"即可 |
+| macOS (Intel) | `ferrite-macos-x64.tar.gz` | 替代 — 包含 Ferrite.app |
 
 <details>
 <summary><strong>Windows 安装</strong></summary>
@@ -277,6 +279,33 @@ tar -xzf ferrite-linux-x64.tar.gz
 
 </details>
 
+<details>
+<summary><strong>macOS 安装</strong></summary>
+
+#### DMG 安装包（推荐）
+
+根据 Mac 类型下载 `.dmg`：
+- **Apple Silicon**（M1/M2/M3/M4）：`ferrite-macos-arm64.dmg`
+- **Intel**：`ferrite-macos-x64.dmg`
+
+打开 DMG，将 `Ferrite.app` 拖入**应用程序**文件夹。从启动台或 Spotlight 启动。
+
+#### 从 tar.gz（替代）
+
+```bash
+# Apple Silicon
+tar -xzf ferrite-macos-arm64.tar.gz
+cp -R Ferrite.app /Applications/
+
+# Intel
+tar -xzf ferrite-macos-x64.tar.gz
+cp -R Ferrite.app /Applications/
+```
+
+> **Gatekeeper 提示：** 若 macOS 显示"无法打开，因为它来自身份不明的开发者"，右键点击 `Ferrite.app` 并选择**打开**，然后在对话框中点击**打开**。此操作仅需一次。
+
+</details>
+
 <details>
 <summary><strong>从源码构建</strong></summary>