PhotoCraft v0.10.0 更新：存储为 PDF、图像画笔笔尖与裁剪内容识别填充

v0.10.0 于 2026 年 10 月 18 日发布，距 v0.9.0 四天。官方更新日志列出了 263 个合并的 PR，来自 82 位贡献者，其中 28 位是第一次参与。README 里的工具数仍是 67 个。这一版可以存储 PDF，能把图像文件做成画笔笔尖，每个画笔动态控制都有了自己的响应曲线，裁剪工具在转动裁剪框后也能用内容识别填充补齐露出的区域。其余改动中，很多是让调整命令的结果与 Photoshop 一致、补上 Photoshop 的快捷键，以及让大文档保持流畅。PhotoCraft 仍处于早期 alpha 阶段，使用中难免遇到问题。

官方更新日志开头是项目自己的记分卡（docs/scorecard.md）摘要。工具清单从“完成 29 项、部分完成 13 项、缺失 1 项”变为“完成 33 项、部分完成 11 项、无缺失”；在文件兼容性清单中，PDF 存储从“缺失”变为“部分完成”。测试文件中渲染结果必须与 Photoshop 自身输出一致的最低数量，从 256 个中的 145 个提高到 188 个；psd-tools 的 309 个文件则从 236 个提高到 249 个。工作区清单没有变化，168 项设置中仍有 26 项不起作用。达到性能预算的场景仍是 3 个；新增的两个多图层场景已纳入跟踪，但还没有运行过。

主要变化

• 可以存储为 PDF：“另存为”“存储副本”“导出为”和 photocraft-cli 都能写出 .pdf 文件：文档会拼合成一页 8 位的 RGB、灰度或 CMYK 页面，并附带 ICC 配置文件。页面尺寸由像素尺寸和分辨率决定。多页 PDF、保留图层、矢量或文字输出以及打开 PDF 都还不支持（#3441）。
• 画笔：画笔面板和画笔预设选取器里的“导入画笔…”除了 .abr，也能读入图像文件，把它做成画笔笔尖（#3292）。每个画笔动态（大小、不透明度、流量、散布等）都有了自己的响应曲线，作用于钢笔压力、倾斜、光笔轮、旋转或渐隐等输入（#3302）。画笔面板成为独立面板，可以像其他面板一样停靠和浮动（#4603）。详见画笔指南。
• 裁剪时内容识别填充：裁剪工具的选项栏新增“填充：背景（默认）/ 内容识别填充”。选择内容识别填充后，拉直、转动或超出画布的裁剪所露出的区域，会用周围的图像内容补齐，并且与裁剪属于同一个撤销步骤（#3827）。
• “导出为”更完整：可以按像素输入确切的宽度和高度，锁定或不锁定长宽比；可以存储、应用和删除命名预设；在格式支持的情况下，还能选择保留文档的配置文件或转换为 sRGB、是否嵌入配置文件，以及不写元数据、只写 EXIF 和分辨率，或写入全部元数据（#5344）。
• 更多 Photoshop 快捷键：Ctrl/⌘+Shift+F1 和 F2 可以让界面变暗和变亮（#3709）。一个命令现在可以有第二个快捷键，所以 F2、F3、F4 可以剪切、拷贝和粘贴，Shift+F7 反选，Ctrl/⌘++ 放大（#3746）。用滚轮缩放时再按住 Shift，会逐级跳到 Photoshop 的缩放档位（#3695）。详见快捷键指南。
• 滤镜库智能滤镜可以编辑了：双击滤镜库智能滤镜，会打开滤镜库并填好原来的设置，在该滤镜下方的像素上预览。带有滤镜库“铬黄”智能滤镜的 PSD 文件，打开后这个滤镜也可以编辑，不再只是原样保留（#3426）。
• 动作：“按钮模式”把每个动作显示成一个彩色按钮，点一下就播放（#5213）；“批处理”和“图像处理器”可以“包含所有子文件夹”（#3758）。详见动作指南。
• 网页版下载更小：网页版的应用改为 gzip 压缩后的一个约 11 MiB 的部分，由一个很小的启动模块加载，而不再是一个 24 MiB 的 .wasm 文件，因此下载大小不再取决于服务器是否压缩（#5941）。详见下文“网页版”。
• 低延迟绘画：首选项 › 性能 › 低延迟绘画会关闭垂直同步，针对笔迹落后笔尖约 50 毫秒的情况。默认关闭（#5274）。

新工具与新功能

• 画笔的细节：导入的图像中，深色像素会着色，白色和透明像素不着色，与“定义画笔预设”读取选区的方式相同。笔尖会裁到有着色的范围，每边最多 2500 像素，并以文件名命名。画笔设置中每个“控制”行都有一个曲线按钮，打开的编辑器与 首选项 › 工具 › 压力曲线 相同，并在全局压力曲线之后生效（#3292、#3302）。在 Studio、Adwaita 和 Breeze 主题下，画笔和橡皮擦的“大小”输入框不再停在 2500 像素，所以在所有主题下都能设到 5000 像素（#5709）。双重画笔会保持笔尖间距，并随主画笔一起缩放（#4856）。
• 路径与形状：使用钢笔工具时按住 Shift，下一个锚点会落在 45° 方向线上，方向手柄按 45° 一档转动（#3756）；用直接选择工具拖动锚点时按住 Shift 也是如此（#5498）。弯度钢笔工具可以编辑已完成的路径（#5197），实时矩形在画布上有了圆角半径手柄（#5276），“自动添加/删除”对正在绘制的路径也有效（#6172）。
• 参考线与变换：参考线可以选中，有了参考线右键菜单和“编辑所选参考线”（#3734）；按住 Alt 从标尺拖出的是另一方向的参考线（#5885）。连续的方向键微移合并为一个历史记录状态，首选项 › 工具 › 合并方向键微移 可以关闭这一行为（#2764）。有选区时，自由变换的定界框就是选区的范围，蚂蚁线也会跟着定界框移动（#5337）；置入图像后会自动进入自由变换（#5390）；调整大小的光标会随定界框一起转动（#5188）。
• 图层：画框工具除了像素图层，也能把文字、形状和智能对象图层放进画框（#4441）。图层面板新增按“种类”“名称”“模式”筛选的下拉菜单（#5268）和“将缩略图裁剪到图层边界”（#4312）；混合模式、不透明度、填充和锁定会作用于所有选中的图层（#5856）。曲线可以用在蒙版、Alpha 通道和快速蒙版上（#5448）。
• 滤镜与样式：光圈模糊、移轴模糊和旋转模糊的图钉和手柄直接放在图像上（#3822、#3829）；带随机种子的滤镜对话框有了“随机”按钮（#5886）；投影和内阴影可以直接在图像上拖动调整位置（#5893）；“斜面和浮雕”有了“方法”菜单（#5181）。
• 调整结果与 Photoshop 一致：渐变映射、阈值、色阶、16 位下的色调分离、两种模式的亮度/对比度，以及 Lab 和 CMYK 文档中的调整图层，都与 Photoshop 对比测量过，现在给出与它相同的结果（#5018、#5263、#5143、#5267、#4722、#5171、#4945）。在 32 位文档中，旧版亮度/对比度、通道混合器、照片滤镜和黑白的色调不再被截断（#5011）。
• 快捷键与菜单：键盘快捷键对话框新增 Photoshop 的“接受并转到冲突”和“撤消更改”，并会拒绝系统保留的按键（#5349）。在 Windows 和 Linux 上，按 Alt 或 F10 可以把键盘焦点移到菜单栏，Alt 加字母打开对应菜单，菜单里的字母会显示下划线（#5091）。
• 打开与保存：在 Windows 和 Linux 上，PhotoCraft 运行时再打开文件，会在已运行的窗口里以新标签页打开，而不是再启动一个程序（#3755）。打开一个已经打开的文件，会切换到它的标签页（#6630）。如果文件被其他程序改过，“存储”会先询问再覆盖（#6652），只读文件则拒绝覆盖（#6643）。“嵌入配置文件不匹配”提示会显示配置文件名称，并能记住你的选择（#5208）。
• 界面：重启后会记住上次选用的工具（#5043），首选项窗口可以调整大小（#5170），鼠标悬停在字体上即可预览（#5222），双击空白工作区会弹出 文件 › 打开（#5429）。
• 速度：图层超出 GPU 内存预算的文档中，隐藏一个大图层时窗口不再卡住约三分之一秒，打开后第一次绘制也不再卡住 1.6 秒（#5083）。独立显卡不再为文档像素扣除预算，首选项 › 性能 › GPU 内存 可以手动设置预算；在 PR 的测试中，150 个图层的文档里一次编辑从 2.6 秒降到 25 毫秒（#5973）。堆栈模式快了 8 到 17 倍（#6462），Photomerge 快了约 4 倍（#6489），Camera Raw 的“阴影”和“高光”快了 1.9 倍（#6247）。

文件格式

• PDF 存储为拼合后的一页，详见上文。Lab、索引颜色等模式会提示先转换为 RGB（#3441）。
• 可以打开柯达 Cineon（.cin）电影帧（只读），按 10 位读入，不做对数到线性的转换，与 DPX 读取器的做法相同（#4691）。
• TIFF 可以读写 CIE L*a*b*：Photoshop 存的 Lab TIFF 会以 Lab 文档打开，Lab 文档也会存成 Lab TIFF，不再变成 sRGB（#4949）。
• Raw：有损（JPEG 压缩）DNG 按文件自身的色阶解码（#5112）；尼康 NEF 文件的有损和紧凑格式解码以及裁切区域都有修复（#3238）。
• EXR：首选项 › 文件处理 › 将无色彩空间信息的 EXR 以 ACEScg 打开，会把没有声明色彩空间的渲染图以 ACEScg 打开，而不是线性 sRGB（#4908）。在 v0.10.0 中它只对部分打开方式生效，详见文末。
• PSD：合成图数据损坏的文件，仍能打开可读取的图层（#6170）；智能对象的滤镜蒙版在打开文件时就会显示（#5005）。
• 其他小修复：HEIF 网格图像会沿用其分块的 ICC 配置文件（#5553），RLE 压缩的 Targa 文件能正确解码（#6386），灰度 WebP 导出会做色彩管理（#5875），32 位 FITS 存储时会限制在 0–1 并给出警告，重新打开时与保存时一致（#5628）。

各格式能否打开、保存，详见文件格式指南。

界面语言

官方版本仍内置 21 种界面语言。西班牙语补齐了动态界面文字的翻译（#4306），意大利语补译了其他语言已经添加的 103 条标签（#4860），匈牙利语按翻译规范统一了用词（#5434）。阿拉伯语和希伯来语的图层名称在图层面板和标题栏中按从右到左显示（#5385）。设置方法见界面语言指南。

自动化（CLI 与 MCP）

• layer.list 以只读方式列出图层树：ID、名称、种类、可见性、边界，以及哪些图层被选中，可按嵌套或扁平形式输出（#5148）。
• image.detectFaces 用 libfacedetection 的纯 Rust 移植版检测人脸，返回边框、置信度和五个特征点。它只是一个命令，没有菜单项（#4513）。
• 凡是能导出的地方都能写 PDF，所以 photocraft-cli 的转换和批处理也能输出 .pdf（#3441）。image.crop 新增 contentAware 参数（#3827）。
• 快捷键可以不经界面列出、设置、导入和导出：界面命令和工具已移到引擎中，edit.keyboardShortcuts 会拒绝系统保留的按键（#5801）。
• 动作按图层名称录制“选择图层”，所以在一张照片上录制的动作，能在另一张照片上选中同名图层（#2441）。录进去的、对单图层文件执行的 文件 › 存储，会存储正在播放动作的那个文件（#3537）。
• 控制通道会断开 10 秒内没有完成认证的连接（#5229），并拒绝其他用户可读的令牌文件（#5459）。智能滤镜中存储的设置也遵守自动化的读取边界（#5684）。
• photocraft --help 会打印用法，未知选项会报错（#6435）。图层 ID 或名称不存在时，错误信息会列出文档中的图层（#5133）。

配置和示例见 MCP 与 CLI 指南。

网页版

本站的在线编辑器运行的不是这一版，而是更新的版本。v0.10.0 的网页版压缩包为 10.9 MiB。

• 应用的 WebAssembly 现在经过 gzip 压缩并切分成若干部分，由一个很小的启动模块加载，这样网站里没有哪个文件会接近常见静态托管服务的上传上限（#5941）。目前只有一个部分，大小为 11,332,767 字节；解压后的 wasm 为 24,748,731 字节（23.6 MiB），比 v0.9.0 的 25,033,027 字节略小。
• 在启用了 mod_mime_magic 的 Apache 服务器上，这一版无法启动：服务器给 gzip 压缩的部分加了标记，浏览器会抢先解压，应用就读不了了。v0.12.0 已能处理这种情况（#7639）。
• “置入嵌入对象”可以使用浏览器的文件选择器，拖到画布上的图像也会被置入（#5585、#5817）。
• 网页版仍然无法显示中文。 文字图层和界面中的中日韩文字都会显示成空白方框，因为网页版目前还没有附带中日韩字体（#1615，仍未解决）。需要处理中文文字时，请使用桌面版。

自行部署的方法见网页版页面。

问题修复与稳定性

• Windows：在 GL 适配器只显示黑色窗口的系统上（例如部分 VMware 虚拟机），PhotoCraft 现在会优先使用 WARP 软件渲染器而不是 GL（#5309）。崩溃恢复用的自动保存文件移出了漫游配置文件（#6412）。
• macOS：打包的应用会保留自己的程序坞图标（#5879），打开对话框时也能拖动窗口了（#5860）。
• Linux：Flatpak 版可以通过 CUPS 的 IPP 套接字或打印门户使用 文件 › 打印（#3017）。在“另存为”里选择的文件类型会决定扩展名（#6151）；自称是手写笔的虚拟键盘不再迫使窗口走 Xwayland（#5295）；Wayland 在小数缩放比例下，画笔轮廓与实际笔迹一致（#5796）；AppImageLauncher 跳过时，AppImage 会自己安装菜单项，在 AM 或 AppMan 下也不会重复添加（#5551、#6394）。
• 修饰：内容识别填充去掉细长物体后，不再在周围留下虚边或物体的颜色（#5290）；“选择主体”会保留与背景颜色相近的主体部分（#4462）。
• “全部关闭”“关闭其他”和“退出”会对提示期间又被改动的文档再询问一次（#5079）；第二次启动不再改动正在运行的实例的日志（#6478）。
• 安全：链接的智能对象、“打包”和在文件管理器中显示文件的命令只会沿存储的路径访问本机文件或文档所在的共享位置（#7149）；ICC 解析器会检查运算是否溢出（#5227）；依赖 ruzstd 升级到 0.9.1，修复 RUSTSEC-2026-0344（#5225）；PSD、Affinity、DNG 和矢量输入加了更多内存限制，在分配内存前就拒绝恶意构造的文件。

更多已知问题和解决办法见故障排查指南。

升级前需要知道的变化

• 所有文件都在同一个窗口里打开。 在 Windows 和 Linux 上，PhotoCraft 运行时打开的文件会交给已运行的窗口。想单独启动一个进程，可以加 --new-instance，或设置 PHOTOCRAFT_NEW_INSTANCE=1。便携版、PHOTOCRAFT_CONFIG_DIR 和 --control 启动仍各自独立运行，Flatpak 版暂时还不会转交文件（#3755）。
• 这一版的 ACEScg 选项并不完整。 它只对 file.openAs 生效，对桌面版的 文件 › 打开、拖放、打开最近文件以及“打开 EXR 分段”都不起作用，所以在这些情况下打开它没有任何效果。v0.11.1 修复了这个问题（#6783）。
• 部分结果有意改变。 渐变映射、阈值、色阶、色调分离、亮度/对比度、色彩平衡，以及 Lab 和 CMYK 调整图层，现在都与 Photoshop 一致。重放以前录制的动作，得到的图像可能不一样。
• 低延迟绘画默认关闭，下次启动时生效。它会关闭垂直同步；除非笔迹明显落后于笔尖，否则不必打开（#5274）。
• Windows 上崩溃恢复的自动保存文件换了位置，从 %APPDATA%\Photocraft\Recovery 移到 %LOCALAPPDATA%\Photocraft\Recovery。旧的自动保存文件会在启动时移过去（#6412）。
• 标题栏上的 Discord 按钮去掉了。 帮助菜单里的“加入 ArtCraft 的 Discord 社区…”、开始屏幕和“关于”里仍有链接（#1737）。
• 自行部署网页版：请按原样提供 app/*.part-* 文件，不要加 Content-Encoding，因为它们本身已经是 gzip 压缩的；详见压缩包里的 HOSTING.md（#5941）。
• Windows 7 和 8：PhotoCraft 仍然需要 Windows 10 或更新版本（#2310），v0.10.0 的 MSI 安装包依然不会检查系统版本。

如何升级

前往下载页获取 v0.10.0：Windows、macOS、Linux 或网页版。这次发布的 26 个文件与 v0.9.0 相同，其中包括 SHA256SUMS.txt。请只从官方 GitHub Release 下载，不要使用第三方镜像或转载的安装包。如果你是从 v0.8.2 或更早的版本升级，也请看看 v0.9.0 的更新说明。

完整更新日志（含全部合并的 PR）：GitHub 上的 PhotoCraft v0.10.0。