DD Codex 安装助手 · Mac 1.0.0 测试版

适用范围
当前官方 Mac 下载包：Apple Silicon（M1/M2/M3/M4 等 M 系列），macOS 13 或更新版本。
助手使用 macOS 自带 Cocoa 界面和官方 Codex 已携带的 Node.js/LevelDB 组件；客户不需要安装 Homebrew、Python、npm 或开发工具。
本次在 Windows 开发机完成了 Mac 安装包资源分析及隔离组件测试；Mac 原生界面、安装、权限和最终中文效果仍需 Mac 实机验收。因此此包明确标为测试版。

打开方式
1. 在 Mac 解压 ZIP，打开“DD Codex 安装助手.app”。不要直接在压缩包内运行。
2. 此测试版暂未使用 Apple Developer ID 签名或公证。如果系统提示开发者无法验证，先确认这是您收到的原始测试包，然后在“系统设置 → 隐私与安全性”里找到此助手，按系统提示点击“仍要打开”。不要关闭 Gatekeeper 或 SIP。
3. 包内另有“启动助手.command”，用于打开原生助手；双击会显示终端。它不修改系统安全设置。

使用方式
1. “获取 API 密钥”打开 https://api.dingdong.work/sign-up。
2. 粘贴 DD 平台生成的 sk- 开头 API 密钥，点击“开始安装与配置”。官方客户端未安装时自动下载；已安装时跳过下载。安装位置优先 /Applications，无写入权限时使用当前用户 ~/Applications。不会覆盖同名其他应用。
3. 开始配置前请完全退出 Codex。助手不会强制结束任务或注销客户账号。
4. 配置写入后会创建桌面 Codex.app 启动入口，并准备离线简体中文。默认模型为 gpt-6.1-sol，DD API 地址为 https://api.dingdong.work/v1。
5. 打开 Codex 验证中文与 API 连接。已安装客户可以单独点击“启用离线中文”“检查中文状态”“创建桌面启动入口”，这些按钮不用输入 API 密钥。
6. 若仍英文，保持 Codex 打开，点击“检查中文状态”，再点“复制日志”。诊断检查当前和已有旧 Electron 缓存目录、语言设置、语言错误数量及运行目录；不输出密钥、登录令牌或原始进程参数。
7. 安装 Computer Use：先打开 Codex 插件页面一次以初始化官方本地插件库，完全退出，然后点击“安装 Computer Use”。重开新建聊天，要求用 Computer Use 打开计算器，并按客户端提示授权。
8. “屏幕录制权限”“辅助功能权限”可打开 Mac 系统设置对应页面。给客户端提示的“Codex Computer Use”等官方组件授权，不需要给安装助手授予屏幕控制权限。系统权限需要客户自己确认；组织或地区限制仍由 Codex 判断。

配置、备份和日志
- 配置位置默认 ~/.codex/config.toml；已有 CODEX_HOME 时使用指定位置。
- 凭据位置为上述目录的 auth.json。文件与备份权限限制为当前用户读写（0600）。密钥仅从助手输入框经标准输入交给配置组件，不进入命令参数或日志。
- DD API 配置明确使用官方支持的 cli_auth_credentials_store = "file" 与 forced_login_method = "api"，避免已有钥匙串/登录方式设置让客户端忽略助手写入的凭据。管理员强制要求仍由 Codex 执行，助手不修改这些要求。
- Mac GUI 应用可直接读取 Codex 凭据文件，本助手不往客户 .zshrc/.bashrc 写入密钥或修改已有 shell 配置。
- 修改前保存 .dd-类型-backup-时间 备份。TOML 重写保留其他设置的值，但会规范化格式；原始注释保存在备份中。
- 当前缓存目录：~/Library/Application Support/Codex/web/Codex/Default/Local Storage/leveldb（当前 owl 客户端）。已有旧 Electron 缓存也独立处理：~/Library/Application Support/Codex/Local Storage/leveldb。两处各自保留启动标识，不复制其他电脑账号或缓存。
- CODEX_ELECTRON_USER_DATA_PATH 指定时使用该数据目录。未知新客户端读取格式会停止，不会把缓存写入报告为界面验收通过。
- Codex 日志：~/Library/Logs/com.openai.codex。助手日志：~/Library/Logs/work.dingdong.ddcodex-helper/YYYY-MM-DD.log。界面支持复制和清空。

说明
- 下载与模型请求需要网络；离线中文使用官方客户端本机中文资源，不下载汉化包、不改客户端签名资源。已关闭 Codex 分析存储时保留客户隐私设置并提示该离线缓存方法不适用。
- 启动入口采用指向正式安装位置的符号链接；已存在无关同名项目时改用 DD Codex.app，重复操作不会覆盖用户的其他项目。
- Computer Use 通过官方插件接口安装并回读启用状态，不修改组织要求、应用白名单或系统权限数据库。
- Mac 自身签名校验、Gatekeeper、屏幕录制和辅助功能授权不能由“安装成功”日志替代；首个 Mac 客户需要按下面的验证说明实机验收。

参考
https://learn.chatgpt.com/docs/quickstart
https://learn.chatgpt.com/docs/computer-use
https://learn.chatgpt.com/docs/reference/troubleshooting
https://support.apple.com/en-us/102445
