PhotoCraft v0.16.0 更新：区域文字、.asl 样式库与更新检查

v0.16.0 于 2026 年 10 月 25 日发布，距 v0.15.1 两天。官方更新日志列出了 122 个合并的 PR，来自 69 位贡献者，其中 24 位是第一次参与。其中有两条是“集成批次”，一共把 54 个 PR 一起合并进来（#8663 包含 44 个，#9167 包含 10 个）；其中 42 个在列表里也有单独一行，两者合起来，这一版共合入了 134 个 PR。README 里的工具数仍是 67 个。在两个以安全加固为主的小版本之后，这一版重新以新功能为主：区域文字、Photoshop 的 .asl 样式库、内置的更新检查、12 位 JPEG、导出文件保留精确的 CMYK 油墨值，以及在 DirectX 12 上更快的启动。其余许多小改动修复了工具、动作和 PSD 文件的问题。PhotoCraft 仍处于早期 alpha 阶段，使用中难免遇到问题。

这次的更新日志没有记分卡部分。项目的记分卡（docs/scorecard.md）从 v0.13.0 到 v0.15.1 一直没变，这一版中：文字类现在有 5 项完成、5 项部分完成，新增的那一项部分完成就是区域文字；工作区与界面类有 15 项完成、2 项缺失，之前是 14 项和 3 项；177 项设置中有 20 项不起作用，之前是 176 项中有 21 项；发行类因为有了更新检查，一项从缺失变为部分完成。新增的 4 个性能场景已列入跟踪，但还没有运行；达标的 3 项和超出预算的 22 项没有变化。

主要变化

• 区域文字：使用文字工具时，把鼠标移到闭合路径或形状图层上，指针会变化；单击后输入文字，文字会在形状内部自动换行。与 Photoshop 一样，形状中的孔洞和凹陷会被避开，相互重叠的形状部分（例如对话气泡和它的尾巴）会作为一个整体排文。放不下的文字会被隐藏。整个操作是一个撤销步骤，.pcraft 文件会完整保存它；导出 PSD 时，目前仍会写成覆盖路径外框的普通段落文字，并给出警告（#6230）。详见工具指南。
• 更新检查：帮助 › 检查更新… 会向 GitHub 查询最新的正式版本，并在一个小窗口里显示结果和下载页链接。桌面版每次启动时也会检查一次，可以在 首选项 › 常规 › 自动检查更新 中关闭。它不会自己下载或安装任何东西。Flatpak 版不做检查，因为 Flatpak 自己负责更新（#5485）。
• .asl 图层样式库：样式面板的“…”菜单新增“导入样式…”“导出所选样式…”和“导出样式…”，.asl 文件也可以通过 文件 › 打开 或直接拖进窗口来导入。样式库里的图案会加入图案库，图案叠加和纹理都能正常显示。PhotoCraft 尚未支持的效果会被略过，并给出注明样式名称的警告。导入功能目前只用 PhotoCraft 自己生成的文件测试过，还没有用 Photoshop 保存的样式库验证（#4049）。
• 12 位和算术编码的 JPEG：一些扫描仪、医学和科研软件会使用这些 JPEG 变体，现在都能打开；12 位文件会以 16 位文档打开（#9195）。
• 导出文件保留精确的 CMYK 油墨值：分层的 CMYK 文档导出为 TIFF 或 JPEG、CMYK PSD 的合成图像，以及拼合图像、合并/盖印可见图层和合并拷贝，现在都直接按油墨值混合图层。印刷中常用于文字和线稿的单黑（C0 M0 Y0 K100）会保持单黑，不再变成四色黑。需要在 RGB 下混合的图层组合（例如“色相”“颜色”混合模式或图案效果）仍走 RGB 路径，现在导出时会给出警告。画布上显示的仍是 RGB 合成结果（#3356，经 #8663 合入）。
• 打开损坏的 PSD 前先询问：如果 PSD 或 PSB 中有些图层、像素或蒙版无法读取，PhotoCraft 会先询问是否继续打开，并提醒覆盖保存原文件可能会永久丢弃无法读取的数据，建议另存副本（#6658）。
• 在 DirectX 12 上启动更快：GPU 合成器改为并行编译着色器。在 PR 作者的测试中（Windows 11，RX 6900 XT），这一步从 13.2 秒缩短到 7.3 秒；Vulkan 本来就很快（#8118，属于 #6419 的一部分）。在集成显卡上，项目的基准测试中，150 个全画布图层里改动一个图层的不透明度或可见性，耗时从约 730 毫秒降到 68 毫秒（#8547）。
• 用上次的设置打开调整命令：与 Photoshop 一样，在调整命令的快捷键上加按 Alt/⌥（例如色阶的 Alt+Ctrl+L / ⌥⌘L、曲线的 Alt+Ctrl+M / ⌥⌘M），或者按住它从 图像 › 调整 中选择命令，对话框会以上次点“确定”时的设置打开。这些设置重启后仍然保留（#8969）。详见快捷键指南。

新工具与新功能

• 裁剪、切片与变形：在裁剪工具的默认模式下，拖动裁剪框下方的图像时，现在会对齐到画布中心、图层、参考线和网格，并显示洋红色对齐线；按住 Ctrl 可暂时关闭对齐（#8622）。切片工具的“样式”菜单新增“固定比例”和“固定大小”，与选框工具一样（#8638）。操控变形的图钉和透视变形的四边形会准确停在拖动的位置，不再被吸附（#8217）。透视裁剪的 ⇄ 按钮能交换宽度和高度了（#7060），“删除裁剪像素”会让文字图层和智能对象保持完整（#7117）。
• 选区与取样：拖动选区的过程中按住 Shift，移动方向会锁定为 45° 的倍数（#6254）；磁性套索在边缘明暗反转时也能贴住边缘（#3415）；吸管工具的取样圆环改为 Photoshop 那样带灰色外圈的大圆环，在任何颜色上都看得清（#7021）。
• 颜色：颜色面板在所有主题中外观一致，通过它的 ☰ 菜单选择 Photoshop 的各种模式：色相立方体、亮度立方体、色轮，以及灰度、RGB、HSB、CMYK、Lab 和 Web 颜色滑块（#6055）。手持形状或文字工具时，在颜色面板、色板面板或拾色器中选的颜色会直接应用到所选的形状或文字图层（#5842）。拾色区域按下即取色，细微的拖动也能跟上（#7822）。
• 调整、样式与参考线：曲线图会随属性面板变大，曲线对话框可以调整大小，并在下次以同样大小打开（#8998）。渐变叠加新增“方法”菜单：平滑、感知、线性和经典（#7335）。“新建参考线布局”的宽度和高度字段可以输入带单位的长度，例如 2 cm 或 10%（#8719）。
• 界面：所有主题都显示完整的选项栏；以前只有 Pro 系列主题才显示裁剪、选框、套索、移动和油漆桶工具的选项（#4221）。没有选中图层时，图层面板会保留混合模式、不透明度、填充和锁定控件，只是显示为灰色（#8904）；“眼睛”一列在整个宽度内都能点击（#8496）。液化、内容识别填充、滤镜库和自适应广角现在与 Camera Raw 一样是模态的，macOS 菜单栏会等你点“确定”或“取消”（#9061）。
• 速度：在 24 MP 图层上，晶格化快了约 4 倍，点状化快了约 3 倍（#6200）。液化、多种颜色的文字和 Camera Raw 的曝光滑块也更快了（#8855、#8716、#8465）。

文件格式

• PSD：又有八种 Photoshop 智能滤镜能以可编辑的形式打开和保存：挤压、极坐标、波纹、球面化、旋转扭曲、波浪、水波和反相（#5249）。置入图层经过“替换内容”或“重新链接”后仍保留 Photoshop 的“圆柱体”变形（#5769）。带透明度的图案现在写在 Photoshop 期望的位置，这类文件在 Photoshop 里又能打开了，重新保存旧版本生成的文件也会修复它（#8756）。形状填充的透明度在 PhotoCraft 中往返保存后不再丢失（#6868）。
• 按 Photoshop 的原样保留：Photoshop 2026 的“光线”调整图层，以及输入范围自定义的颜色查找表，现在会原样保留并给出警告，而不是被错误解读（#6815、#8879）。旧版 PSD 中的点文字会落在 Photoshop 原来的位置（#6094）；使用可变字体命名实例（例如 Bahnschrift Light Condensed）的文字会保持该实例（#8909）。
• PSD 中的链接文件：只有当链接的智能对象文件是 PhotoCraft 能打开的图像时，才会把它嵌入；否则该图层以像素写入并给出警告（#9161）。
• GIMP XCF：含有链接图层的文件不会再报“文件提前结束”而打不开（#8865）。详见 GIMP XCF 指南。
• DPX、Cineon 和 WebP：把 16 位或 32 位文档存为 10 位、12 位 DPX 或 Cineon 时，现在会提示位深会被降低（#8793）。导出 WebP 会保留分辨率（#8775）。
• 图像资源：文件 › 生成 › 图像资源 现在需要先在 首选项 › 插件 中勾选“启用生成器”，与 Photoshop 一样默认关闭（#5598）。画板资源会保持整个画板的尺寸（#8254）。

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

界面语言

官方版本内置 22 种界面语言，与 v0.13.0 相同。简体中文补译了最后几条未翻译的状态消息和预览标签，并经过母语者审阅（#8872）；土耳其语修正了 35 行（#8871）；图层面板中图层效果行的名称也有了翻译（#8754）。设置方法见界面语言指南。

自动化（CLI 与 MCP）

• photocraft-cli 改用 clap 解析参数：每个子命令都有自己的 --help，Linux 和 FreeBSD 的打包脚本还会附带手册页（man page）和 shell 补全。参数检查也更严格：重复给出只接受一个值的选项、取值或 JSON 不合法，都会作为用法错误以退出码 2 结束（以前是 1）；version 不再是子命令（请用 --version）；--bridge 7878 表示 127.0.0.1:7878；PHOTOCRAFT_CONTROL_PORT 可以为 serve 和 mcp 设置控制端口（#9167、#9194）。
• photocraft-cli run 的 --out 指向输入文件本身时，除非加上 --in-place，否则会拒绝执行（#7455）；mcp 和 serve 会拒绝它们用不到的选项（#8035）；无头 TCP 服务器在 30 分钟没有客户端后会释放端口（#3914）。
• doc_export_layers 会列出跳过的图层及原因（#8713）；type.edit 传入新文字时，没有改动的文字保留原来的样式（#8766）；view.newGuideLayout 支持单位（#8719）；模态工作区打开时，ui.menu.invoke 会等待（#9061）。
• 动作：导出的色阶和曲线步骤按 Photoshop 的方式命名复合通道，在 Photoshop 里可以正常播放（#8686）；只设置了部分数值的色彩平衡或色相/饱和度步骤，在严格模式导出 .atn 时会被拒绝，而不是在 Photoshop 里把其余数值重置（#8701）；录制的图层面板拖动按名称记录放置目标，在其他文档里也能播放（#8781）。黑白、可选颜色、应用图像、存储为、变换插值方式以及 Photoshop 的混合模式名称，经过 .atn 往返时也更准确（#8527、#7681、#8180、#7202、#8698、#8502）。详见动作指南。

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

网页版

本站的在线编辑器运行的就是 v0.16.0 网页版。发布包中的网页版压缩包为 12,192,545 字节（11.6 MiB），v0.15.1 是 12,058,467 字节。与 v0.10.0 以来一样，应用由一个小型引导模块启动，应用本体是一个 gzip 压缩的分块 app/photocraft-web-*.part-aa，大小为 12,092,579 字节（11.5 MiB）；解压后为 26,454,256 字节（25.2 MiB），v0.15.1 是 26,160,337 字节。

• 区域文字、.asl 样式库和 12 位 JPEG 在浏览器里同样可用。更新检查只在桌面版中运行。
• 网页版仍然无法显示中文。 文字图层和界面中的中日韩文字都会显示成空白方框（#1615，仍未解决）。需要处理中文文字时，请使用桌面版。

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

问题修复与稳定性

• GPU：出现显存不足错误后，PhotoCraft 会自动重建 GPU 画布（每次运行最多三次），不再一直用 CPU 绘制，直到你手动选择“重试 GPU”（#8774）。CPU 画布在 100% 缩放时保持清晰（#8354），滤镜预览也能在 CPU 画布上显示，例如在水平翻转的视图中（#8978、#8994）。
• 颜色与混合：32 位文档中的曲线会延伸到 0 和 1 以外，与 Photoshop 一致（#8782）；黑白调整保留 32 位文档中高于 1 的数值，最高到 16（#8748）；暗背景上的“柔光”遵循 Photoshop 的曲线，在 PR 的测试中与 Photoshop 的差距从最多 20 级降到 4 级（#8817）；“外部”描边不再渗进不透明像素（#5937）。
• Windows：路径中带空格的文件，也能在资源管理器中正确定位并选中（#8518）。
• 保存与退出：保存后如果无法把文件夹写入磁盘，会如实报告，而不是显示保存成功（#5420）；窗口的 GPU 设备丢失后，即使恢复用的保存一直失败，也能正常退出（#8620）。
• 编辑：粘贴的图像会保持在画布范围内（#6798）；切换文档时，操控变形、液化和自由变换中的扭曲会被取消，不会再串到其他文档（#5447）；在额外内容隐藏时打开 视图 › 显示 › 网格，会同时恢复额外内容，网格随之显示（#8962）；单击最底层图层的智能滤镜又能选中它们了（#8974）；编辑文字时连续按 Tab 不会跳出文字（#9030）。
• 打印：CUPS 以不常见的顺序发送打印机信息时，也能完整显示（#8828）。
• 安全：延续 v0.14.0 和 v0.15.1 的加固，为画笔步进、稀疏图层、脚本和批处理、Affinity 压缩包、文本框和颜色解析加上限制（#8957、#8955、#8954、#9257、#8722、#8657）。

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

升级前需要知道的变化

• 更新检查默认开启。 桌面版每次启动时会访问一次 GitHub 的 API。可以在 首选项 › 常规 › 自动检查更新 中关闭（#5485）。
• 老用户也改为用 Shift 切换工具。 Photoshop 的“使用 Shift 键切换工具”从 v0.8.2 起就是 PhotoCraft 的默认设置，但旧的设置文件一直保存着“关闭”。现在旧设置文件也会改为开启：再次按工具的字母键会保持当前工具，按 Shift 加字母键才会在同组工具间切换。如果更习惯原来的方式，可以在 首选项 › 工具 中关闭（#5878）。
• 图像资源需要启用生成器。 请在 首选项 › 插件 中勾选“启用生成器”，否则保存时不会再生成资源（#5598）。
• 区域文字与旧版本：更早的 PhotoCraft 版本无法打开含有区域文字的 .pcraft 文件，PSD 文件里则是普通的段落文字（#6230）。
• photocraft-cli 更严格了。 重复给出选项、传入不合法的值或调用 photocraft-cli version 的脚本现在会失败，用法错误的退出码为 2（#9167）。
• “选择并遮住”还没有工作区。 它的引擎部分在 v0.15.1 中加入，工作区本身尚未推出。
• 没有 FreeBSD aarch64 版本（craft-common-actions#39，仍未解决）。FreeBSD x86_64 版本照常提供。
• Windows 7 和 8：PhotoCraft 仍然需要 Windows 10 或更新版本，v0.16.0 的 MSI 安装包依然不会检查系统版本。

如何升级

前往下载页获取 v0.16.0：Windows、macOS、Linux 或网页版。这次发布的 28 个文件与 v0.15.1 相同，可以用 SHA256SUMS.txt 校验。请只从官方 GitHub Release 下载，不要使用第三方镜像或转载的安装包。如果你是从 v0.14.0 或更早的版本升级，也请看看 v0.15.1 的更新说明。从 v0.16.0 起，只要不关闭更新检查，桌面版会在有新版本时自己提醒你。

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