YCraft Mac 版 · 2026-10-23

本包从今天最新的三个插件源码重新适配：清理 0.5.8、导出 0.2.7、标注 0.2.22。
没有使用历史 Mac 安装包。此为待 Mac Photoshop 实机验证的试用版。

安装
1. 保存文件并完全退出 Photoshop。
2. 完整解压 ZIP，保留 plugins、scripts 等文件夹与校验文件。
3. 双击“安装全部插件.command”。按终端提示等待三个插件安装完成。
4. 在 Photoshop 的“窗口 → 扩展功能（旧版）”中打开 YCraft 清理、YCraft 导出、YCraft 标注。

Apple 芯片 Mac
这三个插件属于 CEP 扩展，Photoshop 需要以 Rosetta 模式运行。
Finder → 应用程序 → Photoshop 文件夹 → 选中真正的 Photoshop.app → Command+I → 使用 Rosetta 打开。
如果没有此选项，请先确认该 Photoshop 安装是否提供 Intel / Rosetta 运行方式。
Intel Mac 不需要 Rosetta。需使用仍支持 CEP 扩展的 Photoshop 版本。
Adobe 官方说明：https://helpx.adobe.com/download-install/apps/system-requirements/install-plug-ins-extensions-on-mac-apple-silicon.html

如果双击提示权限问题
打开“终端”，输入 /bin/bash 和一个空格，将“安装全部插件.command”拖进终端，再按回车。
如果系统安全提示阻止运行，核对来源后按 macOS 对该文件提供的允许打开流程处理。
无需 sudo、外部 Node.js、Python 或关闭系统安全功能。

安装位置和备份
安装到 ~/Library/Application Support/Adobe/CEP/extensions。
同 ID 旧版自动备份至 ~/Library/Application Support/YCraft/Backups。
已有更高版本会停止安装。发生错误时尝试恢复三个旧插件与 CEP 偏好。
安装器启用当前用户 CSXS.8 至 CSXS.12 的 PlayerDebugMode，以加载本地未签名 CEP；原值和类型保存在备份 preferences 中。
安装器不会关闭或重启 Photoshop，不修改 PSD，不安装 Rosetta，不联网下载依赖。
只校验不安装：/bin/bash 后拖入 scripts/install.sh，再输入空格 --check。

Mac 适配
保留今天的界面、功能与更新提醒；Mac 面板只获取 Mac 发布版本与 ZIP 下载链接。
修复插件路径中的开头斜杠、中文、空格和 URI 转义。
九宫使用 CEP 内置 Node 运行当前原算法，不调用 Windows BAT，也不需要系统 Node。
SVG 导出增加 macOS 应用包内脚本路径查找；说明标注使用苹方字体。
清理的 Windows 自动取消不兼容对象辅助不适用于 Mac。遇到不兼容效果弹窗，请手动选择“取消”；原有 Photoshop 提示保留。
九宫会处理选中目录中的 PNG，首次试用请选择文件副本目录。

验证边界
脚本语法、路径与桥接模拟、九宫算法一致性、隔离目录安装与失败恢复会在发布前检查。
当前制作环境为 Windows；未进行 Mac 真机安装、macOS defaults/ditto、Rosetta 或真实 Photoshop CEP 通道验证。
请先用测试文档确认清理、导出、标注、字体与更新功能，再用于正式文件。

下载页：https://ycraft-ps.pages.dev
在线教程：https://ycraft-ps.pages.dev/guide.html
教程主要介绍通用功能；Mac 安装方式以本说明为准。
