Add macOS one-click release

.gitattributes

@@ -1,6 +1,8 @@
 * text=auto
 *.cmd text eol=crlf
 *.ps1 text eol=crlf
+*.sh text eol=lf
+*.command text eol=lf
 *.js text eol=lf
 *.mjs text eol=lf
 *.css text eol=lf

.github/workflows/test.yml

@@ -27,3 +27,24 @@ jobs:
           name: Codex-Native-Dock-Windows
           path: dist/Codex-Native-Dock-Windows-*.zip
           if-no-files-found: error
+
+  macos:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Test shared source contracts
+        run: npm run test:node
+      - name: Check JavaScript and CDP guards
+        run: npm run check
+      - name: Check macOS shell scripts
+        run: npm run check:macos
+      - name: Build the one-click macOS archive
+        run: npm run package:macos
+      - uses: actions/upload-artifact@v4
+        with:
+          name: Codex-Native-Dock-macOS
+          path: dist/Codex-Native-Dock-macOS-*.zip
+          if-no-files-found: error

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.0 - 2026-07-18
+
+- Add a one-click macOS installer, Desktop launchers, live verification, and
+  reversible uninstall for Apple Silicon and Intel Macs.
+- Validate the official Codex bundle signature and bind DevTools to loopback.
+- Reuse Codex's signed Node.js runtime when compatible, with a SHA-256-verified
+  portable Node.js fallback.
+- Build and test a permission-preserving macOS release archive in CI.
+
 ## 0.1.0 - 2026-07-18
 
 - Combine the local usage meter and lower-right quick controls into one

Install-Codex-Native-Dock.command

@@ -0,0 +1,4 @@
+#!/bin/bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")" && pwd -P)"
+exec "$ROOT/macos/scripts/install.sh"

NOTICE.md

@@ -5,5 +5,5 @@ with, endorsed by, or maintained by OpenAI. “OpenAI” and “Codex” are
 trademarks of their respective owner.
 
 The project injects a user-interface overlay through a loopback-only Chromium
-DevTools endpoint. It does not modify `WindowsApps`, `app.asar`, or Codex
-application files.
+DevTools endpoint. It does not modify `WindowsApps`, the macOS app bundle,
+`app.asar`, or Codex application files.

README.md

@@ -15,7 +15,9 @@
 - ChatGPT 模式保留快捷控制，但不显示额度条（ChatGPT 额度不在这里伪造为 100%）。
 - 账户额度从 Codex 已加载的本机账户状态读取；上下文 Token 从当前任务 JSONL 会话增量读取。数据不上传，也不扫描消息正文。
 
-## 一键安装（Windows 11）
+## 一键安装
+
+### Windows 11
 
 1. 从 [Releases](https://github.com/Alert886/Codex-Native-Dock/releases/latest) 下载 Windows ZIP 并完整解压。
 2. 双击 `Install-Codex-Native-Dock.cmd`。
@@ -25,9 +27,19 @@
 
 系统若没有 Node.js 22+，安装器会从 `nodejs.org` 下载便携版，并使用官方 `SHASUMS256.txt` 校验后再启用。
 
+### macOS
+
+1. 从 [Releases](https://github.com/Alert886/Codex-Native-Dock/releases/latest) 下载 macOS ZIP 并完整解压。
+2. 双击 `Install-Codex-Native-Dock.command`；若 macOS 首次阻止运行，请右键文件并选择“打开”。
+3. 安装器会验证 Codex 应用签名，必要时提示重启一次 Codex。
+
+支持 Apple Silicon 与 Intel Mac。安装后桌面会生成启动和恢复入口；Codex 更新或普通启动后未显示工具栏时，双击桌面的 `Codex Native Dock.command` 即可恢复。
+
+安装器优先复用 Codex 自带且签名有效的 Node.js；版本不满足要求时，才会下载并校验官方便携版。
+
 ## 恢复原生界面
 
-双击 `Restore-Codex-Native-Dock.cmd`。恢复只移除本项目的 DOM、后台进程、快捷方式和 `%LOCALAPPDATA%\CodexNativeDock`，不会修改 Codex 安装文件。
+Windows 双击 `Restore-Codex-Native-Dock.cmd`；macOS 双击桌面的 `Restore Codex Native Dock.command`。恢复只移除本项目的 DOM、后台进程、快捷方式和用户目录内的运行文件，不会修改 Codex 安装文件。
 
 ## 开发与验证
 
@@ -51,8 +63,8 @@ powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File scripts\verify.ps1
 
 ## 边界
 
-- 当前一键安装支持 Microsoft Store 版 Codex for Windows。
-- Codex 更新后，使用桌面快捷方式启动即可重新注入；无需修改或重打包 `app.asar`。
+- 当前一键安装支持 Microsoft Store 版 Codex for Windows，以及签名标识为 `com.openai.codex` 的官方 macOS 应用。
+- Codex 更新后，使用桌面快捷方式启动即可重新注入；无需修改或重打包应用文件。
 - 本项目不是 OpenAI 官方产品，详见 [NOTICE.md](NOTICE.md)。
 
 ## License

Restore-Codex-Native-Dock.command

@@ -0,0 +1,4 @@
+#!/bin/bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")" && pwd -P)"
+exec "$ROOT/macos/scripts/restore.sh" --remove-files --restart-codex

SECURITY.md

@@ -8,7 +8,9 @@ The installer deliberately:
 - validates the browser and page WebSocket identities before connecting;
 - downloads Node.js only from `nodejs.org` and verifies its SHA-256 against
   the official checksum list;
-- writes only below `%LOCALAPPDATA%\CodexNativeDock` plus two user shortcuts;
-- never modifies `WindowsApps`, `app.asar`, or the Codex installation;
+- writes only below `%LOCALAPPDATA%\CodexNativeDock` on Windows or
+  `~/Library/Application Support/CodexNativeDock` on macOS, plus user shortcuts;
+- validates the official macOS app signature before using its bundled runtime;
+- never modifies `WindowsApps`, the macOS app bundle, `app.asar`, or the Codex installation;
 - stops an injector process only when PID, executable, command line, script
   path, and process start time match the recorded state.