如何在 PhotoCraft 中打开 PSD 和 PSB 文件

PhotoCraft 用自己的 PSD 库读写 Photoshop 文档。项目称这个独立 crate 是依据 Adobe 公开规范编写的，支持 PSD（版本 1） 和 PSB（版本 2，大文档）。

打开文档

1. 选择 File › Open…（macOS 为 Cmd+O，Windows/Linux 为 Ctrl+O）。
2. 选择 .psd 或 .psb 文件。
3. 图层、组、蒙版、图层样式、文字和形状图层都会以可编辑图层打开。
4. 用 File › Save（Cmd/Ctrl+S）或 File › Save As…（Cmd/Ctrl+Shift+S）保存。

据 README，PSB、16 位与 32 位文件，以及 CMYK、Lab 文档均可原生打开；文字图层保持可编辑，并能通过 PSD 往返保存。

保真度如何？

项目公布了自己的测量数据，两组数据衡量的内容不同：

• 往返保存（README）： 在 psd-tools 测试集中，309 个文件里有 307 个打开再保存后渲染一致；在项目自有的 ag-psd/psd-tools 混合集中为 170 个里有 169 个。PhotoCraft 尚未建模的数据会被原样保留，而不是丢弃。
• 与 Photoshop 渲染一致（docs/gaps.md，2026-10-10 复核）： 由 Photoshop 生成的参照文件中，256 个有 133 个一致（52%）。项目把"PSD 保真度与 Photoshop 兼容性"列为进入 Beta 前的首要差距，并注明 PhotoCraft 写出的 PSD 并不总能被 Photoshop 接受。

实际建议： 保留原始 PSD；在依赖 Photoshop 的工作流里使用 PhotoCraft 之前，先测试一次往返保存。

内置安全限制

PSD 解析器设有明确上限：文档宽、高各不超过 300,000 像素，文档通道不超过 56 个，图层通道不超过 64 个，单次解码的通道数据不超过 2 GiB。项目安装文档建议把来源不明的 PSD、PSB 等输入文件视为可能含有恶意内容。

分层 TIFF 与其他格式

• 分层 TIFF： 可读写 TIFF 中的 Photoshop 图层数据，组、蒙版、图层样式、文字、形状、智能对象和调整图层的打开效果与 PSD 相同。
• 还能打开： Paint.NET PDN（只读）、OpenRaster .ora（读写）、SVG（作为形状图层打开），以及 Affinity 文档（.af、.afdesign、.afphoto、.afpub，只读）。
• 平面格式： PNG、JPEG、TIFF、WebP、GIF、BMP、TGA、ICO、QOI、PNM、OpenEXR、Radiance HDR，以及 PhotoCraft 原生的 .pcraft 格式。HEIC 只读（官方构建已包含）；AVIF 只能写出，需要可选构建特性；不支持 JPEG XL。

0.7.0 新变化：对平面图像进行分层编辑后，保存时默认存为 PSD。