DD Codex Mac 安装助手 · 源码开发包
版本：1.0.0 测试版（包含最后的 arm64 启动和 JXA 按钮/定时器回调修复）

1. 开发环境
Apple Silicon（M 系列）Mac，macOS 13 或以上。
直接启动界面使用 macOS 自带 osascript/JXA；构建压缩包需要 Node.js。
业务功能使用官方 Codex 已携带的 Node/LevelDB；TOML 依赖已在 src/vendor，无需 npm install。

2. 直接调试
解压后，用终端进入本文件所在目录，执行：
    bash ./调试启动.command
修改 src 后关闭助手，再执行同一命令即可；报错直接显示在终端。
界面初次启动会检测 Codex；测试安装、配置和中文时按原界面操作。

3. 构建完整 .app 安装 ZIP
    node build-mac.cjs
输出：dist/DDCodex-Mac-dev.zip。重复构建覆盖此开发 ZIP。
在 Finder 解压这个 ZIP 后，打开 DD Codex 安装助手.app。
也可在终端执行：
    ditto -x -k dist/DDCodex-Mac-dev.zip dist/unpacked
    open "dist/unpacked/DD Codex Mac 安装助手/DD Codex 安装助手.app"
运行的是上次打开的旧进程时，请先完全退出，再打开新构建。

4. 代码位置
src/helper-ui.js             Cocoa/JXA 界面、按钮事件、任务轮询
src/helper-core.cjs          API、配置、中文、启动入口、Computer Use
src/offline-chinese.cjs      离线中文缓存与诊断
src/run-task.sh              客户端检测、下载、挂载安装、调用业务组件
src/DDCodexInstallerHelper   .app 主启动脚本（arm64 osascript）
src/Info.plist              .app 元数据
src/vendor/                 已携带的 TOML 依赖与许可证
build-mac.cjs               生成 .app 结构和保留 Unix 权限的 ZIP

5. 调试信息
助手日志：~/Library/Logs/work.dingdong.ddcodex-helper/
Codex 日志：~/Library/Logs/com.openai.codex/
当前任务临时目录：macOS 临时目录下 DDCodexMac-*；成功后自动清理。
配置默认写入 ~/.codex，设置 CODEX_HOME 时使用其绝对路径；原文件会备份。

6. 验证与边界
业务源码与最后的 Mac 测试版逐文件一致；构建脚本仅调整开发输出及说明文件。
源码包已在 Windows 检查语法、依赖加载、构建内容和权限；Mac 原生界面仍需实机调试。
此包未签名或公证。源码启动可直接从终端查看 JXA 错误。
tests/legacy-windows-integration.cjs 是原版集成测试，依赖此前 Windows 参考资源路径，仅供参考，不能在 Mac 直接运行。
原版功能说明和历史验证记录位于 docs/。本包以这份 Mac 版本为基础，未同步后续 Windows 2.2.5 功能。
