能力矩阵与路线图

psdkit 把读取、可编辑保存、文件内保存的预览、实时重绘和显式近似分开报告。同一图层可能可以完整读取并原样保存，却不能实时重绘。“已完成”只适用于所述范围，不代表任意 Photoshop 文档兼容。

状态整理日期：2026-10-24。浏览器 Playground 的“能力目录”以运行时 system.capabilities 为准，列出全部可调用的 Go 入口。

Warp 预设整图与区域来源重绘已接通：已有横向 Arc Lower、4×2、仿射、零透视且无折叠的几何，可从实际来源输出整图、ROI、Tile、分块访问和单实例。逐次显式开启 ApproximateCustomWarp，零 bend 也一样；外链逐次映射。已验证编辑、PSD/PSB 四压缩保存、重开重绘和续编，以及 JSON、真实 Wasm与失败边界。任务进度59／141（42%），Warp6／9（67%）；来源替换和其他预设继续拒绝。

本矩阵对应 v0.3.0 的声明范围，变更见本版说明。安装固定版本时，应以该 Tag 的矩阵为准。2026-10-24 历史交付核验固定记录 v0.2.0，不覆盖后续新增的羽化阴影、智能对象效果和 Warp 编辑等能力。

33／17 等概览数字按大类的各个维度统计。一个大类新增了已验收子项后，只要仍有明确缺口，就会继续显示“部分支持”；这些数字不是功能总数或完成百分比。任务面板按明确子任务显示完成百分比，下方矩阵继续说明实际支持边界。

能力矩阵

[!NOTE] “保存预览”读取 PSD 内已保存的像素，速度快、覆盖面广，但可能是旧缓存；“实时重绘”由 Go 根据当前图层树重新计算，只在支持范围内输出，超出范围返回 unsupported，不会伪造图像。

明确限制

• 不承诺任意 PSD 与 Photoshop 逐像素一致；浏览器与原生 Go 一致不等于与 Photoshop 一致。
• 保存预览可能是旧缓存或占位图，不能当作实时重绘结果。
• 蒙版编辑后的自动保存预览限于支持范围内的 RGB8；16/32 位及部分 Knockout / 高级组合须提供准确的显式合成图，否则返回 unsupported。
• 不读取系统字体，不自动替换缺失字体；字体需显式提供。
• 外链只通过调用方显式映射解析，不读取 PSD 中的系统路径或任意 URL。
• 近似策略默认关闭，只在调用方显式开启时生效，不会为取得画面静默启用。
• 操控变形、任意 Warp 预设与未开放的几何 / 效果组合明确返回 unsupported。

项目基础

路线图

完整任务拆分、优先级、依赖与验收条件统一维护在任务面板，后续以子任务验收记录更新进度。

已有 Warp 预设几何的整图与区域来源重绘已验收：已认证的横向 Arc Lower 接入 RenderSource、RenderSourceTile、VisitSourceTiles 与 RenderSourcePlacedLayer，共用仿射、零透视、4×2 和无折叠几何及显式数学采样。每次都须开启 ApproximateCustomWarp，包括 bend 为0，外链也须本次明确映射；保存的实例栅格和合成图不充当实时来源。

独立原生控制记录的数学采样参考、正负原点、整图／区域／分块／单实例相位、滤镜 opacity window、原始尺寸／边界／变换 schema 唯一性及空区域无来源读取均通过。PSD/PSB 四压缩编辑、保存、重开重绘与继续编辑，以及 JSON、真实 Wasm、预算、取消和相关竞态验证通过。分块遍历按每个 tile 解析来源，以保持有界流式输出，不承诺整个遍历只解析一次。来源替换、其他预设及 Photoshop 原生像素精度仍未开放。进度为 59／141（42%），Warp 分组 6／9（67%）；下一项为删除智能滤镜实例，大类状态仍为部分支持。

Warp 预设控制参数编辑保存已验收：SetSmartObjectWarpPreset 修改已有横向 Arc Lower 的原生 doub bend，范围限4×2、仿射、零透视、完整且无重复的尺寸／边界字段、有限且绝对值小于100并通过无折叠认证的参数。仅改写原 bend 的8字节，保留预设类型、旋转、阶数、放置、未知放置字段、共享来源及其他实例；当前来源生成的未烘焙像素和参数一起提交。

每次编辑均显式开启 ApproximateCustomWarp，包括 bend 为0；外链每次明确映射。独立原生控制几何与数学采样参考、父蒙版／Fill／Opacity 不烘焙、PSD/PSB 四压缩两轮磁盘编辑保存重开续编、JSON、真实 Wasm及相关竞态均通过；非法 schema、其他预设、折叠、预算／取消和过期回调原子拒绝。普通受支持组合可直接保存当前生成像素，下一次参数编辑或来源重绘仍需明确策略；来源替换继续拒绝，活动效果保留准确合成图边界。本项不宣称原生像素等价，预设通用来源重绘在上方另项验收。

10×10／13×13 均匀 Warp 网格编辑保存已验收：SetSmartObjectWarp 接受既有100／169个控制点，只修改坐标数值，保留三次阶数、网格类型、切片位置与0／±0.6 guard；通过共用认证投影入口接入整图、区域、分块、单实例、滤镜 opacity window 和编辑候选来源。网格投影逐次显式选择 ApproximateCustomWarp，仍严格限制仿射放置、均匀切片和全局无折叠。

验证覆盖独立源坐标颜色参考、父蒙版／Fill／Opacity 不烘焙、共享来源与实例独立、偏移源域／guard、同尺寸来源替换、PSD/PSB 四压缩两轮保存重开续编、来源重绘／ROI，以及 JSON、真实 Wasm 和相关竞态。网格改变来源尺寸、透视、非均匀切片、非法 schema、预算／取消和过期回调原子拒绝；保存已有生成像素不等于默认开启下一次来源重绘。均匀网格子项独立验收，编辑保存及实时重绘大类仍为部分支持。

4×4 单片自定义 Warp 控制点编辑保存已验收：SetSmartObjectWarp 修改已有单片的16点，保持来源坐标域、放置四角和描述符布局，从当前来源重建该实例未烘焙像素；数学 projective 投影和外链解析每次显式提供。只更新明确的 mesh 数值字节，共享来源、其他实例及未知放置字段保持；来源替换与尺寸缩放／恢复后仍保留当前控制点。

验证覆盖独立解析曲线、原生固定像素与反向采样参考、非零坐标域、连续编辑、PSD/PSB 四压缩两轮磁盘保存重开续编、公开 JSON／真实 Wasm、外链事务与策略快照，以及非法几何／预算／取消原子性。普通受支持组合直接保存当前生成的实例像素，来源实时重绘与继续编辑不继承近似。单片子项与均匀网格、已声明预设参数编辑及来源重绘分别验收；任意 quilt、其他预设与其余组合继续保留缺口。

智能对象重绘结果＋阴影与颜色叠加已验收：从当前 SoLd／SoLE、共享来源字节、变换及严格支持的当前滤镜重建未着色像素，父层效果、像素蒙版、Fill 和 Opacity 后续各应用一次。纯阴影及 Normal 阴影＋颜色叠加逐次显式选择 ApproximateDropShadow；EffectsEditOptions.Render 仅提供本次编辑的来源策略，父阴影不自动开启递归来源近似。

验证包括独立混合参考、旧缓存禁读、画布外／ROI、共享来源与实例效果独立、来源替换、PSD/PSB 四压缩两轮磁盘保存重开续编、原始通道和来源字节保留、保存预览逐像素核对、回调重入／过期拒绝与策略快照，以及原生 JSON、真实 Wasm 和相关竞态。自动保存限定严格可重建的当前嵌入来源；外链每次映射，须先转嵌入或提供准确合成图，需要额外来源近似或字体时同样如此。图层效果分组已验收 7／21（33%）；完整类别继续标为部分支持。

已校准矢量／双蒙版羽化＋阴影已验收：普通 RGB8 Normal 栅格、单整数矩形、矢量羽化 0.5／1.5／3，活动像素蒙版沿用已有羽化模型。纯阴影和阴影＋颜色叠加均在编辑、重绘和保存时逐次显式选择 ApproximateDropShadow；未羽化的既有路径范围保持，新增羽化路径不放开任意几何或半径。

独立羽化积分与标量阴影参考验证各自塑形／最终隐藏、默认链接与显式阶段、密度反相、Fill／Opacity 和效果顺序；区域、画布外来源、共享几何和半径、预算边界、取消及未知标记均有回归。PSD/PSB 四压缩完成两轮真实磁盘编辑保存重开，原始像素、蒙版采样及未知块保留，保存预览与当前合成一致；原生 JSON、真实 Wasm 和相关竞态检查通过。阴影仍是显式近似，图层效果大类继续标为部分支持。

远端 CI／在线发布交付已验收：核对远端 main、annotated Tag、Release、三类 Actions 运行和实际站点，均对应 dd482b7。公共代理与校验和服务安装的 v0.2.0 在独立项目和全新缓存中通过 PSD/PSB 保存重开、继续编辑及像素验证；线上 Playground 完成下载、重新导入和续编后再次下载。工程分组已验收 3／6（50%）。该任务不增加图像算法或改变矩阵大类状态。

文字编辑后自动更新像素已验收：TextEditOptions.Render 使用调用方显式提供的字体，并且只运行明确选择的 ApproximateText 或 ApproximateOpenTypeText。先更新当前 TySh／EngineData，再按原画布、DPI 和变换生成完整画布的源像素；透明度、蒙版与效果保留到后续合成，不读取旧文字栅格。准确 Pixels 路径继续保留，自动路径没有扩大既有字体与排版算法的范围。

验证覆盖两条文字策略、PSD/PSB 四压缩、两轮磁盘保存重开续编、保存预览、空文清除后继续编辑、显式多行排版、当前元数据与未知字段保留、字体缺失或释放、选项快照、字体回调重入、过期提交拒绝、预算／读取失败／取消和关闭原子性，以及原生 JSON 与真实 Wasm。文字分组已验收 3／10（30%）；完整文字类别仍如实标为部分支持。

独立画板中的实时智能对象来源已验收：RenderArtboard / RenderArtboards 默认重建严格支持范围内的嵌入来源，ArtboardRenderOptions.Render 接入外链解析器及显式投影、Warp、滤镜等策略。每次请求都须明确映射外链；共享来源在同次输出内复用，实例自身的变换、蒙版及效果保持独立。只选择一个画板时，不解析其他画板的来源；隐藏来源不触发解析。

验证覆盖各画板背景和裁剪隔离、已保存坐标与零起点输出、过时实例像素和预览不参与结果、来源失败不返回部分图像、嵌套与工作预算、取消和关闭、PSD/PSB 四压缩两轮编辑保存重开，以及原生和 Wasm JSON 调用链。画板分组已验收 3／9（33%）。画板近似列现列出可显式选择的既有子来源策略，未新增或默认开启近似算法；背景和裁剪规则保持。

替换智能对象来源时同步重算活动智能滤镜已验收：每个共享实例从新来源出发，使用当前 SoLd/SoLE 中的变换、滤镜参数和各自原滤镜蒙版计算一次，不在旧缓存上重复套用滤镜。嵌入替换、外链转嵌入和保留外链更新使用相同事务路径；父图层蒙版、效果、Fill 和透明度仍在后续合成中应用。

默认只运行已有严格子集，其他算法必须逐次通过 SmartContentsOptions.SmartFilters 显式选择近似，外链回调也不能改变调用时捕获的策略。验证覆盖共享实例独立参数、当前参数保留、尺寸变化、原编码字节及未知字段、滤镜蒙版、预算和取消原子性、PSD/PSB 四压缩保存重开续编，以及原生和 Wasm JSON 调用链。智能对象分组已验收 4／7（57%） 项。

默认覆盖像素蒙版上新增矢量蒙版已验收：普通、未标记为生成覆盖的用户蒙版可保留无采样状态，与新增矢量几何同时参与覆盖。不新增 -2／-3 通道，不把默认色烘焙成采样；保存重开后修改 DefaultColor 仍作用于整个无采样覆盖场。生成覆盖标记和真实用户蒙版归属保持分开，未知或歧义布局继续拒绝。

验证覆盖默认值、反相、密度、羽化和禁用属性、空及画布外边界、矢量增改删与再次新增、原元数据尾部保留、预算／取消／读取失败原子性、PSD/PSB 四种压缩保存与重开后续编；源文档完整解码、整图／区域重绘及原生、Wasm JSON 调用链保持一致。蒙版混合分组已验收 7／13 项。

已校准矩形矢量羽化与纯颜色叠加已验收：普通 RGB8 Normal 栅格、单整数矩形、0.5／1.5／3 像素羽化、无活动像素蒙版，直接使用 SetEffects，不需要额外合成图或新近似选项。禁用像素蒙版的采样与元数据仍保留，重新启用后恢复组合资格检查。

本项复用已有原生羽化 Alpha 采样点，并以独立卷积和预乘混合参考验证叠加组合；不宣称新增完整 Photoshop 组合图的逐像素认证。验证覆盖区域外羽化来源、密度与反相、部分透明度和效果顺序、预算与取消、PSD/PSB 四压缩两轮编辑保存重开，以及原生与 Wasm 的 JSON 调用链。其余组合按当前矩阵继续报告边界。

活动矢量蒙版与阴影组合已补齐：普通 Normal 栅格上的纯阴影或阴影＋颜色叠加，支持无羽化矢量蒙版和像素／矢量双蒙版。lmgm、vmgm 分别决定两类蒙版参与塑形还是遮住最终效果；缺省按原链接状态，显式值优先。塑形覆盖缓存包含阴影实际来源，整图与区域重绘保持一致。

验收覆盖默认拒绝与显式近似、两个蒙版阶段的交叉组合、部分透明度、密度／反相、多效果顺序、负坐标和画布外来源、当前蒙版生命周期，以及 PSD/PSB 四种压缩下的编辑、自动保存、重开与继续编辑。真实 Wasm 已完成两轮编辑、下载和重新导入，并核对下载文件的像素；浏览器 JSON 桥接同样通过。没有增加新的效果族或默认近似。

已补齐两项常用效果组合：无羽化活动矢量蒙版（含像素／矢量双蒙版）上的纯颜色叠加，以及活动像素蒙版上的颜色叠加＋投影。后者复用显式阴影近似模型，保留蒙版作用阶段、部分透明、Fill／Opacity、内部混合及多效果顺序；没有扩大 Photoshop 私有算法的精度承诺。

两项分别验证 PSD/PSB 四种压缩下的编辑、自动保存、重开和继续编辑，并覆盖当前蒙版新增／修改／删除、未知块保留、预算和取消失败的原子性；图层效果的其余组合继续按边界报告为部分支持。

智能滤镜自动更新像素已经接通：从当前智能对象来源和当前变换重绘一次，保留原始滤镜蒙版，成功后一起提交参数与像素。整个栈或全部有效滤镜关闭时恢复来源投影；共享实例、来源字节和未知字段保持。失败不会留下部分参数或像素更新。

验收覆盖严格默认子集、五类显式近似、外链解析、滤镜蒙版、PSD/PSB 四种通道压缩、磁盘保存、重开继续编辑及浏览器 JSON 调用桥接。实际 Wasm Playground 已完成编辑、下载、重新导入及继续编辑后再次下载，并独立核对两份文件的像素和参数。未提供对应近似策略时仍拒绝超出默认范围的参数。此项补齐编辑工作流，未增加滤镜算法；智能滤镜整体仍为部分支持。

现有顶层 RGB8 画板内的图层编辑也已支持自动合成与保存，无需额外提供 CompositeImage；画板自身几何、增删和嵌套编辑仍未开放。

接下来按风险和实现复杂度推进，每项都先验证编辑、保存重开及失败原子性：

1. 删除智能滤镜实例：先补齐首项、末项、唯一项和全部删除，重建索引并从当前来源更新像素，验证保存重开和继续编辑。
2. 剩余效果与填充组合：逐项验证组效果、其他效果族、普通图案缩放与旋转，建立独立参考。
3. 复杂几何、文字、高位深与 ICC：分开推进其他 Warp 预设／quilt、多样式排版、16/32 位合成及色彩组合。
4. 工程与发布：维护性能、预算及平台一致性；后续新版本在审核提交、CI、Pages 与可公开示例后发布。

尚未完成：任意输入的全部 Photoshop 功能与逐像素兼容；独立素材的公开分发审核；移动端与无障碍的完整人工验收。旧版长文档及原生验收记录保留在外部 psdkit-verification，不作为在线文档依赖。