PhotoCraft v0.19.0 更新：所有色块都用完整拾色器、在 VectorCraft 中编辑矢量智能对象、超大 TIFF

v0.19.0 于 2026 年 11 月 1 日发布，距 v0.18.0 一天半。官方更新日志列出了 32 个合并的 PR，来自 21 位贡献者，其中 9 位是第一次参与。其中一条是“集成批次” #10145，一次带入了 18 个 PR，其中 17 个在列表里也有单独一行。第 18 个是缩放输入框的改进（#6647），只经由批次合入；它在 GitHub 上仍显示为未关闭，但代码已在这一版中。这份列表把这一版说得稍多了一些：#8623 的多图层变换控制框在批次中被去掉了，因为 v0.18.0 的 #6590 已经实现了同样的功能，随它一起进来的只有几处小修复。#7621 的 .atn 切换文档功能早在 v0.13.0 就已发布；芬兰语和书面挪威语在 v0.18.0 中就有了，所以 #5666 和 #8072 只补上了之后新增的词条。#8371 只改了测试，#10420 只改了文档。列表中没有在打标签前被回退的 PR。README 里的工具数是 68 个，与 v0.18.0 相同。

这一版的新内容主要围绕颜色和矢量：形状的“填色”和“描边”色块改用 Photoshop 那样的弹出面板，所有颜色色块都会打开完整的拾色器，文字和渐变色标的拾色器在点“确定”之前就能在画布上预览；“编辑内容”可以把嵌入的 SVG、AI、PDF 或 EPS 智能对象交给 VectorCraft 等编辑器，并按原格式存回。超大的 TIFF 能打开了，移动工具拖动超大图层时不再卡死，程序启动时默认选中移动工具，画板在图层面板中也终于显示为画板。这一版的网页版仍然无法启动，详见下文“网页版”。PhotoCraft 仍处于早期 alpha 阶段，使用中难免遇到问题。

这次的更新日志没有记分卡部分。在项目的记分卡（docs/scorecard.md）中，不起作用的设置从 182 项中的 12 项变为 183 项中的 11 项。这并不是多了一项能用的设置：“图形处理器”设置一直是生效的，只是启动代码现在用统计脚本能识别的方式读取它（#9618）。TIFF 一项现在写明了超大单页图像的分段导入，其余没有变化。

主要变化

• 填色/描边弹出面板与完整的拾色器：选项栏和属性面板中形状的“填色”和“描边”色块，现在打开与 Photoshop 布局相同的弹出面板：顶部是“无颜色”“纯色”“渐变”“图案”，右上角是拾色器按钮，下面是“最近使用的颜色”和色板库的各个文件夹。“渐变”会把渐变预设应用到形状上；“图案”显示为灰色，因为形状暂时还不能用图案上色。拾色器按钮会打开完整的拾色器对话框（HSB、RGB、Lab、CMYK、十六进制、吸管和拾取屏幕颜色），标题为“拾色器（填充颜色）”或“（描边颜色）”，画布会实时预览颜色，点“确定”只算一个撤销步骤。其他所有颜色色块现在也都打开这个对话框，不再是一个简易的通用取色器：照片滤镜、黑白的色调、渐变映射的色标、内容识别填充的叠加颜色、滤镜库的发光颜色，以及“存储为 Web 所用格式”的颜色表；原来有实时预览的地方仍然有预览。“最近使用的颜色”保留最近 15 种（#8725）。
• 文字和渐变色标拾色器的实时预览：打开文字工具的“拾色器（文本颜色）”或渐变填充图层的“拾色器（色标颜色）”时，画布会在点“确定”之前就显示所选颜色，与 Photoshop 一样。点“取消”不会留下历史记录，点“确定”则把预览的结果作为一个步骤提交。渐变编辑器自己的渐变条和色块仍然要点“确定”后才更新（#9757）。
• 在 VectorCraft 中编辑矢量智能对象：对嵌入的 SVG、PDF 兼容的 AI、PDF 或 EPS 智能对象（包括 PSD 里的）执行 图层 › 智能对象 › 编辑内容 时，现在会询问用哪个程序编辑：VectorCraft、Adobe Illustrator（Windows 和 macOS）、你自己选择的其他程序，或者 PhotoCraft 自带的编辑器（仅限 SVG）。PhotoCraft 会以原格式打开一份私有的工作副本，你在那边每保存一次，智能对象（以及共用它的所有实例）就更新一次，并作为一个撤销步骤。AI、PDF 和 EPS 保留原文件的字节，PhotoCraft 另外在 .pcraft 和 PSD 文件中保存一份 SVG 预览。VectorCraft 是同一 ArtCraft 团队的另一个独立应用，并不随 PhotoCraft 附带；AI、PDF 和 EPS 的预览需要它旁边的 vectorcraft-cli，即使选的是其他编辑器也一样。上游说明，Windows 和 macOS 的启动方式只用模拟的应用包测试过，与 Adobe 软件之间能否完全无损往返也尚未验证，建议先在副本上试用。网页版不会启动其他程序（#8571、docs/embedded-vector-editing.md）。
• 同时编辑多个颜色通道：在通道面板中按住 Shift 单击多个颜色通道（例如红和蓝），之后的绘画、渐变、填充、色阶和曲线（多了一个 RB 选项）、其他调整以及支持的滤镜就只修改这些通道；RGB、CMYK 和 Lab 的 8、16、32 位都适用。移动和变换像素需要选中全部通道，Camera Raw 需要复合通道或单个通道（#9274）。
• 超大的 TIFF 和超大的图层：每边最多 300,000 像素的单页 TIFF 可以打开，按行分组解码到图层中；在项目的测试里，一张 117,504 × 22,464 像素的横幅 3.3 秒打开，峰值内存 11.45 GB。电脑内存不够时会给出提示，而不是崩溃。多图层的 TIFF 仍然整体解码（#8536）。使用移动工具时，像素超过 512 MiB 的图层不再在每次移动指针时复制一遍：拖动时只有轮廓跟着指针走，松开后图层一次移动到位，不会再卡住或耗尽内存（#6985）。
• 像 Photoshop 一样的画板：在图层面板中，画板这一行没有缩略图，名称加粗，行高更矮，背后还有一条淡淡的底色，不再像一个图层组（#10519）。在图层面板中把图层从一个画板拖到另一个画板时，它会保持在画板上的相对位置，不会再被裁掉看不见；在画布上用移动工具跨画板拖动的行为没有变化（#10489）。

新工具与新功能

• 工具与选区：PhotoCraft 启动时现在和 Photoshop 一样选中移动工具，编辑文字时方向键也不会挪动图层（#5403）。Ctrl+Shift+Enter / ⌘⇧↩ 把路径添加到选区，Ctrl+Alt+Enter / ⌘⌥↩ 从选区中减去路径；与 Ctrl+Enter 一样，它们依次使用正在用钢笔绘制的路径、路径面板中选中的路径或工作路径（#8015）。有选框时对多个图层执行自由变换，会像 Photoshop 一样取消选区，共用的变换框也不会再吸附到它自己带着的图层边缘上（#8623）。详见快捷键指南。
• 图层：图层面板底部的“创建新的填充或调整图层”菜单新增“图案…”；如果选中的是一个空的、未锁定的像素图层，它会直接变成图案填充图层，而不是在上方再新建一个（#7716）。
• 文字：段落文字框装不下文字时，右下角放大的控制点里会显示一个红色的“+”，与 Photoshop 标记溢出的方式相同；把指针停在上面会提示如何处理。点击它不会像 Photoshop 那样串接出一个新的文字框（#8311）。
• 打印：在 Windows 上，“缩放以适合介质”会填满打印机驱动报告的可打印区域，所以无边距纸张可以满版打印，可打印区域也会随纵向或横向旋转。CUPS、IPP 和 PDF 打印没有变化（#7795）。
• 画笔和渐变文件：打开一个 .abr 或 .grd 文件，如果它的文件名和某个存放着你自己预设的组同名，以前会一声不响地替换掉整个组，而且无法撤销。现在 PhotoCraft 会先询问：作为新组导入（默认，命名为“Kit (2)”等）、替换或取消（#10658）。详见画笔指南。
• 缩放输入框：状态栏和导航器中的缩放输入框改为按 Enter 后才应用输入的数值，而不是每敲一个键就应用；按 Esc 放弃修改；可以输入 1/2 这样的比例；使用系统的小数分隔符；视图会平滑过渡到新的缩放比例（#6647）。
• 更新：帮助 › 检查更新 的结果现在显示在与更新提示相同的卡片里：检查时显示转圈动画，已是最新时显示提示，失败时显示错误、发布页链接和“再次检查”。手动检查时，之前忽略过的版本会再次提供（#10421）。

更多工具说明见工具指南。

文件格式

• PSD 内存上限：解码 PSD 之前，PhotoCraft 现在会先估算图层、蒙版、合成图像和图案需要的内存，超过 2 GiB（网页版为 1 GiB）就拒绝打开，并给出估算值和上限。这个估算偏保守，所以有些其实装得下的文件也会被拒绝。蒙版改为按一行图块逐段解码，多通道文件的转换也是如此（#10503、#10532、#10541）。
• PSD 文字：编辑导入的 PSD 中的文字时，会保留文件自己的字体记录（包括重复项和顺序），不再用默认值重建（#6169）。
• TIFF：超大的单页图像可以打开，详见“主要变化”（#8536）。
• 矢量智能对象：编辑过的 AI、PDF 或 EPS 智能对象在 .pcraft 和 PSD 文件中保留原始字节，并在 PSD 的一个私有数据块里存一份 SVG 预览；其他软件会忽略这个块，改用图层里存储的像素（#8571）。

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

界面语言

官方版本内置的界面语言仍是 27 种。在 v0.18.0 中经由 #10021 加入的芬兰语和书面挪威语，补上了此后新增的词条，由最初的译者提供（#5666、#8072）。设置方法见界面语言指南。

自动化（CLI 与 MCP）

• 重新导入画笔和渐变默认不再替换：brush.presets.importAbr 和 gradient.presets.importGrd 的 replace 默认改为 false；组名已被占用时，会导入为 <组名> (2) 等，返回结果中会写明实际使用的组。需要以前的行为时请传入 "replace": true。新的询问框是普通对话框：ui.dialog.confirm 作为新组导入，先 ui.dialog.set {"choice":"replace"} 再 ui.dialog.confirm 则替换（#10658）。
• path.addToSelection 和 path.subtractFromSelection 以名称指定文档中的路径（#8015）。file.print 和 file.printOneCopy 接受可选的 printable 可打印区域，格式与 file.print.page 返回的相同（#7795）。带 layers 的 edit.transform 会在同一次编辑中取消选区（#8623），ui.inspect 的快照中新增 typeBoxOverflow（#8311）。
• 智能体可以在内存中导出和替换 SVG 智能对象的内容（layer.smartObjects.exportSvg、updateSvg），但自动化永远不会启动外部编辑器（#8571）。
• 动作：录制的“切换到上一个/下一个文档”现在按文档打开的顺序计算，而不是按标签顺序，所以拖动标签不会再改变动作切换到哪个文档（#7621）。详见动作指南。

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

网页版

v0.19.0 网页版同样无法启动。 它的压缩包结构与 v0.17.0 和 v0.18.0 相同：app/photocraft-web.js 会从 app/snippets/… 加载一个小脚本，但 snippets/ 文件夹只放在压缩包的根目录，浏览器请求时得到 404，页面就一直停在“Loading PhotoCraft…”。#10092、#10487、#10491 和 #10590 都还未解决，修复用的 #10248 也还没有合并。据报告者说，把 snippets/ 复制到 app/ 里就能启动。

因此，本站的在线编辑器继续运行 v0.16.0 网页版。

供参考：v0.19.0 网页版压缩包为 13,433,636 字节（12.8 MiB），v0.18.0 是 13,331,007 字节。应用本体是一个 gzip 压缩的分块 app/photocraft-web-*.part-aa，大小为 13,328,607 字节（12.7 MiB）；解压后为 29,891,631 字节（28.5 MiB），v0.18.0 是 29,647,620 字节。自行部署的方法见网页版页面。

问题修复与稳定性

• 画笔：选择一个笔尖文件丢失或损坏的画笔预设时，当前的画笔、预设和前景色都保持原样，不会再只改掉其中一部分（#10288）。
• 画布：蚂蚁线现在像 Photoshop 一样画在参考线和网格之上，选区边缘上的参考线不会在某些缩放比例下把它遮住（#10681）。
• 存储为 Web 所用格式：指针在预览上移动时，对话框不会再慢慢变大，缩放比例也不会跟着漂移（#10685）。
• 面板：色板、渐变和图案面板底部的按钮改用与图层面板相同的图标和大小（#10672）。
• 智能滤镜：双击一个智能对象上的智能滤镜时，如果该智能对象不是当前图层，会先选中它；以前在重新打开的滤镜里点“确定”会失败，液化的笔触也会丢失（#10145）。

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

升级前需要知道的变化

• PhotoCraft 启动时默认选中移动工具，不再是画笔（#5403）。
• 较大的 PSD 可能被拒绝。 按 PhotoCraft 偏保守的估算，图层、蒙版和图案需要超过 2 GiB 像素内存的 PSD 不会打开，提示中会给出估算值（#10503）。
• 重新导入画笔或渐变会新增一个组。 依赖重新导入来替换组的脚本和 MCP 智能体，现在必须传入 "replace": true（#10658）。
• 矢量编辑需要 VectorCraft。 它需要单独下载，AI、PDF 和 EPS 的预览还需要 vectorcraft-cli；保存时，VectorCraft 不支持的特性可能会改变。请保留一份 PSD 副本（#8571）。
• 暂时没有新的 Flatpak 安装方式。 新增的辅助脚本会把 Flatpak 打包成 OCI 镜像，发布流程也把镜像推送到了 GitHub 的容器仓库，但这个镜像不能公开拉取，上游也没有说明如何从它安装。请继续使用 Linux 下载页上的 .flatpak 包（#10567）。
• 网页版无法启动，本站的在线编辑器暂时继续使用 v0.16.0，详见上文“网页版”。
• Windows MSI 安装版的“更新并重启”。 点击后只重启、什么也没安装的问题（#10477）仍未解决。遇到这种情况，请从 Windows 下载页 下载 v0.19.0 的 MSI 手动安装一次。
• Windows 7 和 8：PhotoCraft 仍然需要 Windows 10 或更新版本。

如何升级

前往下载页获取 v0.19.0：Windows、macOS、Linux 或网页版（目前无法启动）。这次发布的 32 个文件与 v0.18.0 相同，可以用 SHA256SUMS.txt 校验。请只从官方 GitHub Release 下载，不要使用第三方镜像或转载的安装包。如果你已经在用 v0.18.0，它的更新提示可以直接为你安装 v0.19.0。如果你是从 v0.17.0 或更早的版本升级，也请看看 v0.18.0 的更新说明。下一版 v0.20.1 让更多 Photoshop 动作步骤可以播放，并为直线工具加上了箭头。

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