下载 PhotoCraft Mac 版：安装教程
PhotoCraft macOS 版安装教程：已签名并公证的通用 DMG 支持 Apple 芯片和 Intel，附 Homebrew 安装、SHA256 校验、命令行工具配置和常见启动问题。
PhotoCraft 的 Mac 版只有一个通用（universal）DMG，同时原生支持 Apple 芯片和 Intel Mac，要求 macOS 11 Big Sur 或更高版本。应用使用 Developer ID 签名并经过 Apple 公证，打开方式和其他从网上下载的应用一样。上方表格直接链接到 GitHub 官方发布页。PhotoCraft 目前仍是早期 alpha 版本。
该下载哪个文件
| 你需要 | 选择 |
|---|---|
| 桌面应用（任何 Mac，Apple 芯片或 Intel 都行） | photocraft-<版本>-macos-universal.dmg |
| 命令行工具（脚本、批处理、MCP） | photocraft-cli-<版本>-macos-universal.zip |
DMG 是通用二进制，里面同时包含 Apple 芯片版和 Intel 版，所以应用只有这一个下载。普通使用不需要下载 CLI 压缩包。
系统要求： macOS 11 及以上（应用声明的最低系统版本为 11.0）。PhotoCraft 通过 wgpu 在 Metal 上用 GPU 绘制画布，GPU 路径失败时会退回 CPU 渲染。
用 DMG 安装
- 从上方表格下载
.dmg。 - 建议先校验（见下文）。
- 打开 DMG，会出现名为“PhotoCraft”的 Finder 窗口，里面有“应用程序”文件夹的快捷方式。
- 把 PhotoCraft 拖到 Applications 上，然后推出磁盘映像。
- 从启动台、聚焦搜索或“应用程序”文件夹打开 PhotoCraft。首次打开时，macOS 会询问是否打开从互联网下载的应用，这是正常提示。
应用和 DMG 都经过公证，公证票据已经“装订”（staple）在文件上，即使离线 Gatekeeper 也能验证。安装后可以自己确认：
spctl -a -vvv /Applications/PhotoCraft.app
输出应包含 accepted 和 source=Notarized Developer ID。如果 macOS 提示应用“已损坏”或“来自身份不明的开发者”，说明文件下载不完整或并非来自官方发布，请删除后从 GitHub 重新下载。
用 Homebrew 安装
Homebrew 官方的 homebrew/cask 仓库里已经有 PhotoCraft，不需要额外添加 tap：
brew install --cask photocraft
需要说明的是：这个 cask 由社区成员提交、由 Homebrew 维护（homebrew-cask#292191，2026 年 10 月 7 日合并），不是 PhotoCraft 团队发布的。它从 GitHub 官方发布页下载 DMG，校验 SHA-256 后把 PhotoCraft.app 装进 /Applications；截至 2026 年 10 月 9 日版本为 0.5.0，并已开启自动跟进新版本。cask 只安装应用，不包含 photocraft-cli。官方 tap（storytold/tap）的提议 #1060 尚未合并，Homebrew 相关请求 #342 也仍未关闭。
更新用 brew upgrade --cask photocraft，卸载用 brew uninstall --cask photocraft，加上 --zap 会顺带删除 PhotoCraft 的偏好设置 plist。
校验下载文件（SHA256）
每个版本都附带 SHA256SUMS.txt。把它和 DMG 放在同一文件夹，然后运行：
shasum -a 256 photocraft-0.5.0-macos-universal.dmg
grep macos-universal.dmg SHA256SUMS.txt
两个值必须一致。也可以让 shasum 自动比对：
grep macos-universal.dmg SHA256SUMS.txt | shasum -a 256 -c
# photocraft-0.5.0-macos-universal.dmg: OK
安装命令行工具
photocraft-cli 需要单独下载，同样是通用二进制，用同一个 Developer ID 签名并经过公证。单个可执行文件无法装订公证票据，所以第一次运行时 macOS 会联网查询公证状态，请在联网状态下先运行一次。按 README 的方法解压并验证：
ditto -x -k photocraft-cli-0.5.0-macos-universal.zip .
spctl --assess --type install -vv photocraft-cli-0.5.0-macos-universal/photocraft-cli
# ... accepted, source=Notarized Developer ID
再把它移到 PATH 里的目录，例如：
sudo mv photocraft-cli-0.5.0-macos-universal/photocraft-cli /usr/local/bin/
photocraft-cli --version
可以从 photocraft-cli batch --help 和 photocraft-cli mcp 开始，每个子命令都可以用 --help 查看说明。
更新
下载新版 DMG，把应用重新拖进“应用程序”替换旧版即可，设置会保留。截至 v0.5.0 还没有内置的检查更新功能（计划见 #220），可以关注本站的版本更新，或者用 Homebrew 管理。
卸载
- 退出 PhotoCraft，把
/Applications/PhotoCraft.app拖到废纸篓。 - 如需同时清除设置，删除
~/Library/Application Support/Photocraft（首选项、预设、崩溃恢复的自动保存）和~/Library/Preferences/ai.storyteller.photocraft.plist。 - 如果装过 CLI，把它从你放置的位置删除，例如
/usr/local/bin/photocraft-cli。
macOS 上的已知问题
老款 Mac 打开即退出：#600，未关闭。一台通过 OpenCore Legacy Patcher 运行 macOS 15 的 2013 年末 iMac（NVIDIA GTX 775M）上，0.5.0 启动时报 Wgpu(RequestDeviceError ... Device(Lost)) 并退出，加 --safe-gpu 也一样，目前没有解决办法。如果你的 Mac 打不开 PhotoCraft，可以在“终端”里运行它查看报错，并试试 CPU 渲染：
/Applications/PhotoCraft.app/Contents/MacOS/PhotoCraft
/Applications/PhotoCraft.app/Contents/MacOS/PhotoCraft --safe-gpu
然后把输出附到该 issue 里。
双显示器下颜色过饱和：#569，已关闭。Monitor Profile 设为 auto 时，0.2.0 可能在外接显示器上错用内置屏的色彩配置文件。v0.5.0 已修复：auto 会跟随每个窗口所在的显示器，编辑 › 颜色设置（Edit › Color Settings）里也能看到当前使用的配置文件。旧版本用户请升级。
没有压感：#79，未关闭。macOS 上目前使用的窗口库还拿不到数位板压力数据，笔画一律按满压力绘制，其他画笔动态仍然有效。网页版和 Windows 版支持压感。
其他问题见故障排除。
只从 GitHub 官方下载
photocraft.im 是非官方的社区指南，本站所有下载链接都指向官方 storytold/photocraft GitHub 发布页，官方的 getartcraft.com PhotoCraft 页面也链接到这里。请不要使用网盘转存的 DMG 或所谓“汉化版”“破解版”：PhotoCraft 本身免费开源，只有官方构建经过开发者签名和 Apple 公证。
官方版本已经内置简体中文界面，语言设为“自动”时会跟随系统语言，无需任何汉化补丁，切换方法见界面语言设置。