PhotoCraft v0.17.0 更新：艺术历史记录画笔、“更新并重启”与 Camera Raw 校准

v0.17.0 于 2026 年 10 月 28 日发布，距 v0.16.0 三天。官方更新日志列出了 145 个合并的 PR，来自 58 位贡献者，其中 19 位是第一次参与；这两个数字里都包括自动依赖更新机器人 Dependabot。其中有三条是“集成批次”，一共把 80 个 PR 一起合并进来（#9386 包含 37 个，#9775 包含 21 个，#9880 包含 22 个）；其中 76 个在列表里也有单独一行，两者合起来，共合并了 149 个 PR。列表中有 4 个 PR 在发布前已被撤回，其中包括可选的本地 AI 模型（见下文）；另有 2 个其实已在 v0.12.0 和 v0.16.0 中发布，只是因为后来又补了小改动才再次出现。README 里的工具数变为 68 个。这一版带来了艺术历史记录画笔（PhotoCraft 此前唯一缺少的 Photoshop 工具栏工具）、“更新并重启”提示、Camera Raw 的校准面板、形状渐变，以及 PSD 和 TIFF 兼容性的明显改进。PhotoCraft 仍处于早期 alpha 阶段，使用中难免遇到问题；另外请注意，v0.17.0 的网页版无法启动（见“网页版”一节）。

这次的更新日志没有记分卡部分。项目的记分卡（docs/scorecard.md）中：工具类现在有 36 项完成、9 项部分完成，新增的部分完成项就是艺术历史记录画笔；文件兼容类有 11 项完成、14 项部分完成、2 项缺失，之前是 9、13 和 5 项——分层 TIFF 和直接绘制智能滤镜蒙版已完成，raw 附属文件与有损 DNG、专色通道从缺失变为部分完成；181 项设置中有 12 项不起作用，之前是 177 项中有 20 项，主要因为 Camera Raw 默认值和“集成”设置开始生效。新增的 12 个性能场景已列入跟踪，但还没有运行；达标的 3 项和超出预算的 22 项没有变化。

主要变化

• 艺术历史记录画笔：位于历史记录画笔的弹出组（Y）中，用某个历史记录状态画出风格化的笔触，选项栏有“样式”“区域”和“容差”。有了它，Photoshop 工具栏上的工具已经一个不缺。不过它被标为部分完成：只有 Photoshop 10 种样式中的 8 种（缺少“紧绷卷曲长”和“松散卷曲长”），“区域”改变的是笔触间距而不是覆盖范围，只能以“正常”模式绘画，也还没有不透明度和压感（#1610，经 #9386 合入）。详见工具指南。
• 更新并重启：启动时的检查发现新版本后，会弹出提示，提供“更新并重启”“下载”和“稍后”；帮助 › 检查更新… 里也有同样的按钮。下载的文件会按发布中的校验值核对；只要还有未保存的文档，更新就不会开始。安装方式决定了它能否自动更新：macOS 应用、Windows 便携版 zip、AppImage、.deb 和 .rpm 包以及直接解压的 .tar.gz 都能自我替换；FreeBSD 只给出下载链接，Flatpak 版仍然完全不做检查；Windows MSI 安装版有一个问题，见“升级前需要知道的变化”（#9322）。
• Camera Raw 校准、自动与附属文件：Camera Raw 新增“校准”面板（阴影色调，以及红、绿、蓝原色的色相和饱和度），“亮”面板新增“自动”按钮。raw 文件的 .xmp 附属文件会填入打开时的对话框，并在打开后写回；首选项 › Camera Raw 默认值 中的每一项现在都会生效（#5128）。有损 DNG（以 JPEG XL 压缩的浮点 raw 数据）现在能作为 raw 打开，而不是只打开很小的内嵌缩略图（#8402）；Camera Raw 预览的大部分处理改在 GPU 上进行（#6923）。
• 绘画：混合器画笔在拖动时就显示混合后的颜料，松开后保留的正是你看到的结果（#3627）。仿制图章、图案图章、历史记录画笔、修复画笔和油漆桶有了“模式”菜单，油漆桶还多了“清除”（#5504）。与 Photoshop 一样，Shift+Alt（Mac 上为 Shift+Option）加字母键可以直接选择混合模式，例如 M 为正片叠底、S 为滤色（#5478）。详见画笔指南。
• 形状渐变：形状工具的填充和描边色块提供“无颜色”“纯色”和“渐变”，带色标编辑、预设、样式、角度和缩放，任何形状都可以有渐变描边（#7203）。
• PSD 兼容性：Photoshop 文件中的路径文字现在沿路径打开，并写回文件原有的文字数据，不再变成段落文字或点文字（#8175）。画框图层保留描边（#5890）。像素总量超过 2 GB、但实际文件更小的文档，会存为 PSD 而不是 PSB（#5287）。打开 PSD 时不再先把整个文件读入内存（#6583）。
• 历史记录：每个文档都会以打开时的状态自动生成第一个快照，单击即可回到该状态。按住 Alt 单击相机按钮会打开“新建快照”对话框，可设置名称和来源（#3567）。“历史记录选项…”新增“允许非线性历史记录”和“使图层可见性更改可还原”（#3535）。
• 面板与直方图：面板改用 Craft 系列应用共用的停靠系统。在桌面版中，浮动面板会在独立窗口中打开，可以移到主窗口之外（Wayland 下仍留在主窗口内）（#9366）。直方图面板经过重做，有紧凑、扩展和全部通道三种视图，提供明度和颜色、来源选择、拖选范围的统计数据，以及打开调整时的实时叠加显示（#9139）。

新工具与新功能

• 文档与画板：文件 › 新建 有了“画板”复选框，勾选后新文档就是一个画板（#9258）；图层 › 新建 › 来自图层的画板… 可以指定尺寸，例如 1080 × 1350（#9262）。
• 图层与通道：选中两个或更多图层时，单击“新建组”按钮会把它们编为一组，按住 Alt 单击则打开“新建组”对话框；新图层会进入展开的组，并加入它的剪贴组（#4329）。在通道面板中可以拖动 Alpha 通道调整顺序（#9168）。智能对象的滤镜蒙版可以直接绘制、填充和应用滤镜，并能撤销（#3297）。
• 消失点：按住 Ctrl/Cmd 拖动平面的边缘，可以拉出一个 90° 的新平面；图章工具可按透视仿制，并实时预览（#3281）。
• 文字：字体菜单有了收藏、最近使用的字体、分类筛选（衬线、无衬线、手写等）、“显示相似字体”和实时预览（#6526）。字符面板的字号、行距和字距有了预设菜单（#3558）。用直接选择工具或钢笔修改路径时，路径文字会跟着路径走（#9321）。
• 裁剪与变换：在待确认的裁剪框上右键单击，会打开包含预设、叠加方式、“取消”和“裁剪”的菜单（#6620）；使用比例预设时按 X 会旋转裁剪框，而不是把它缩小（#7058）；“裁剪并拉直照片”只处理选区内的部分（#9298）。自由变换时按住 Ctrl/Cmd 会显示扭曲和斜切指针（#5405），宽高读数使用标尺单位（#9678）。
• 界面：首选项 › 界面 › 界面缩放 新增 105%、110%、115% 和 120%（#3316）。图像处理器、批处理、镜头校正、联系表和创建快捷批处理的文件夹字段有了“浏览…”按钮（#9360）。在滤镜库中，Ctrl/⌘ 加 +、− 和 0 可以缩放预览（#9107）。滚轮缩放重新变得平滑，受 首选项 › 常规 › 动画缩放 控制（#5547）。颜色面板的立方体模式会提示无法打印的颜色（#9154）。
• 速度：保存一个 36 MP 的文档，存为 .pcraft 快约 38%，存为 PSD 快约 24%，输出的字节完全相同（#9877）。扩展、收缩和边界只处理选区周围的区域，在大画布上处理小选区最多快约 40 倍（#9697）。内容识别缩放快了 1.65 到 3.6 倍，结果不变（#5236）。大尺寸笔尖改为多核绘制（#7218），deflate 压缩改用 zlib-rs（#7689）；在使用 NVIDIA 驱动的 Linux 上，图层很多的文档会继续留在 GPU 上处理（#9042）。

文件格式

• PSD：专色通道按 Photoshop 的方式存储，旧版 PhotoCraft 保存的 PSD 也能保留油墨（#8885）。能识别 Photoshop 的 MTrn 合成透明度标记（#8877）。“半调图案”智能滤镜在保存后得以保留（#9031），颜色查找图层会按载入时的原样保留 .3dl 或 .look 文件（#6723）。
• TIFF：Alpha 和专色通道作为 TIFF 附加样本写入和读取，最多 16 个，并保留名称、颜色和密度（#7415、#8878）。分层 TIFF 写入了 Photoshop 打开图层所需的全局图层蒙版块，不再只能打开合成图像；文字图层也按 Photoshop 的字节序写入（#9148、#9128）。
• Raw：除了有损 DNG，raw 解码也更快了：在集成批次的测试中，CR2 无损 JPEG 从 77 毫秒降到 57 毫秒，未压缩 DNG 从 45 毫秒降到 25 毫秒（#9449、#9451、#9452、#9386）。黑电平无效的 DNG 不会再导致崩溃（#9446）。
• 其他格式：Amiga IFF 现在可以保存，格式为 24 位 ILBM（#9080）；导出 DDS 会保留 Alpha 通道（#8776）；UTF-16 编码的 LUT 文件以及 .look、.3dl 的一些特殊写法都能载入了（#9129、#9210、#9215）。“存储为”列出 PhotoCraft 能写入的所有格式（#3609），批处理的文件夹来源接受它能打开的所有格式（#9097）。

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

界面语言

官方版本仍内置 22 种界面语言。为了新工具和新对话框，大多数语言的翻译表增加了 60 到 80 行；印地语仍只翻译了一部分。新的更新提示本身只有英文。设置方法见界面语言指南。

自动化（CLI 与 MCP）

• 新命令和参数：paint.artHistoryBrush（#1610）、file.new 的 artboard（#9258）、layer.new.artboardFromLayers 的 width 和 height（#9262）、history.options（#3535）、paint.bucket 的 mode（#5504），以及绘画、填充和滤镜可用的 "target": "filterMask"（#3297）。paint.stroke 加上 fill: true 会填充笔画围出的区域（#3779）。
• 首选项 › 集成 中的“允许代理控制”和“控制端口”现在会在启动时生效：设置了控制端口，不加 --control 也会打开控制通道；关闭“允许代理控制”时，--control 会被拒绝并给出说明（#4097）。
• 控制通道会拒绝请求路径中的 Windows 设备名，也不会替换写入目录里的非图像文件（#9425、#9445）。动作中的 Lab 明度通道按 Photoshop 的 Lght 保存和读取（#9385）。详见动作指南。

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

网页版

本站的在线编辑器仍运行 v0.16.0 网页版，因为 v0.17.0 网页版无法启动。它的 app/photocraft-web.js 引用了 ./snippets/…/inline0.js，但压缩包把 snippets 文件夹放在了根目录，而不是 app/ 里，浏览器请求这个文件时得到 404，页面就一直停在“Loading PhotoCraft…”。这个问题记录在 #10491、#10590 和 #10092 中，都还未解决，v0.18.0 也是一样；修复用的 #10248 还没有合并。

• 发布包中的网页版压缩包为 12,955,028 字节（12.4 MiB），v0.16.0 是 12,192,545 字节。应用本体是一个 gzip 压缩的分块 app/photocraft-web-*.part-aa，大小为 12,851,309 字节（12.3 MiB）；解压后为 28,982,124 字节（27.6 MiB），v0.16.0 是 26,454,256 字节。
• 更新提示只在桌面版中出现，浏览器里没有更新检查。
• 网页版仍然无法显示中文。 中日韩文字都会显示成空白方框（#1615，仍未解决）。需要处理中文文字时，请使用桌面版。

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

问题修复与稳定性

• 编辑：从另一个文档复制的像素会粘贴到画布中央，而不是原来的位置（#9353）；以文本形式复制的 SVG 图形可以粘贴为像素（#7154）；图像旋转 › 任意角度 会一并旋转未链接的图层蒙版（#9203）；“显示全部”会忽略已擦除的完全透明像素（#9380）；从路径建立选区后会取消选择该路径（#6353）；定义和导入的图案重启后仍然保留（#9318）。
• 绘画与滤镜：硬边圆形预设不再出现笔尖叠加的轮廓（#8846）；移除工具的轨迹会覆盖一笔要移除的全部区域（#8923）；“去朦胧”不再在暗色物体旁留下亮边（#9316）；在裁剪时使用内容识别填充，会保留未删除裁剪像素时隐藏的部分（#8179）。
• 界面：使用任何工具时，单击色板都会给所选的文字和形状换色（#9253）；斜面和浮雕的高光模式和阴影模式重新成为两个独立菜单（#9370）；用 Alt 缩放后按空格键不会再打开 文件 › 新建（#8679）；“选择并遮住”除非开启“记住设置”，否则从默认值开始（#9444）；高分辨率屏幕上的 CPU 像素网格线条恢复纤细（#9199）。
• 界面工具包升级到 egui 0.37，桌面版仍按系统语言选择中日韩备用字体（#9363、#9518）。
• 安全：值过多的 .pcraft 清单、尺寸超过文件大小的图像头、嵌套过深的 XML 和 SVG，以及有问题的插件清单，现在会被拒绝，不会耗尽内存或导致崩溃（#8893、#8704、#9421、#9398、#9442、#9680）。Windows 签名客户端固定了版本并会校验（#3938）。

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

升级前需要知道的变化

• 没有本地 AI 模型。 更新日志里列出了“可选的本地模型”（#1199），但它在发布前已被撤回，维护者希望本地模型改由单独的集成项目提供。v0.17.0 不包含这部分代码，因此无论官方版还是自行编译的版本，首选项里都没有模型下载。“选择主体”和“移除背景”与 v0.16.0 相同，详见移除背景指南。另外三个被撤回的 PR 是：动画效果跟随系统设置（#4573）、带 1D 预变换的 .cube 文件（#9183），以及一个尚无地方调用的 raw 预览辅助函数（#9454）。
• Windows MSI 安装版的“更新并重启”。 更新库只在 v0.17.0 安装程序并不使用的文件夹里识别 MSI 安装，因此会把 MSI 安装当作便携版文件夹处理。有一份尚未解决的报告称，在 Windows 上点击“更新并重启”后，PhotoCraft 会重启但什么也没安装，随后再次提示更新（#10477）。遇到这种情况，请从 Windows 下载页 下载新的 MSI。
• Windows 安装程序会先问为谁安装。 新安装默认选择“仅为我安装”，装在 %LOCALAPPDATA%\Programs\ArtCraft\PhotoCraft，不需要管理员权限；选择“此电脑的所有用户”则装在 Program Files\ArtCraft\PhotoCraft。升级时沿用原有的文件夹和安装范围，想改变范围需要先卸载（#9756）。
• 面板布局会先恢复一次默认。 旧版本保存的布局第一次会以默认布局打开；所有面板仍可从“窗口”菜单打开（#9366）。
• “新建组”会把所选图层编组。 选中两个或更多图层时，直接单击“新建组”按钮会把它们编为一组，由图层创建的组默认折叠（#4329）。
• 网页版无法启动，原因见上文。自行部署请暂时继续使用 v0.16.0，等待修复后的版本。
• 没有 FreeBSD aarch64 版本（craft-common-actions#39，仍未解决）。FreeBSD x86_64 版本照常提供。
• Windows 7 和 8：PhotoCraft 仍然需要 Windows 10 或更新版本。

如何升级

前往下载页获取 v0.17.0：Windows、macOS 或 Linux。这次发布的 28 个文件与 v0.16.0 相同，可以用 SHA256SUMS.txt 校验，但其中的网页版无法启动。v0.18.0 已于 10 月 31 日发布，你也可以直接安装它，见 v0.18.0 的更新说明。请只从官方 GitHub Release 下载，不要使用第三方镜像或转载的安装包。如果你是从 v0.15.1 或更早的版本升级，也请看看 v0.16.0 的更新说明。

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