PS 插件局部重绘为什么提示没有选区？它不会自动改整张，提交前先框选范围

局部重绘提示“请先建立选区”时，最重要的结论是：这次请求会被挡在提交前，不会悄悄退化成修改整张图。因为局部重绘需要两个不同的输入：一份当前文档的画面，和一份说明“哪些像素允许改动”的选区蒙版。

这两个输入不是同一个东西。当前文档的合成画面回答“拿什么作为原图”，Photoshop 选区回答“只改哪里”。先把这条边界弄清楚，再排查提示，就不会一直重复点生成按钮。

先判断是没打开文档，还是没有选区

点击提交时，插件会即时读取 Photoshop 的当前状态，而不是靠面板里一项过期的勾选结果。当前实现把前置状态分成三类：

状态	提示的含义	下一步
没有活动文档	Photoshop 里没有可供读取的画板	先打开一张图片或新建画板
有文档、没有有效选区	画板存在，但没有明确的修改范围	用选框或套索工具圈出要改的区域
无法读取画板状态	UXP 读取状态时发生异常	确认插件已在 Photoshop 中打开，再重试

第二行是最常见的“没有选区”。它不是提示词写得不对，也不是服务端把选区丢了；在选区真正建立前，提交函数会直接返回。即使你只想改一个小图标，也要先让 Photoshop 的选区边界可被读取。

origin 取的是当前文档合成图，不是某个活动图层

通过前置检查后，插件在一次 Photoshop 模态事务中导出局部重绘输入。第一步是把当前活动文档保存成一份 PNG 副本，作为 origin。这里的“当前文档”指画布此刻的合成外观，不等于当前选中的单个图层，也不等于某个智能对象的源文件。

因此，提交前要先确认这些内容已经出现在当前画布上：

1. 需要保留的图层可见性和排版已经调整好；
2. 画布显示的尺寸和方向就是本轮要修改的版本；
3. 你没有在检查后切换到另一份文档。

当前实现把读取文档、导出 origin 和读取选区放在同一个模态事务里。这样可以避免你在两次导出之间切换文档，导致“画面来自 A 文档、范围却来自 B 文档”的错配。它也解释了为什么文章里说的是“当前文档合成图”，而不是“当前活动图层”。

mask 取的是 Photoshop 选区，白色改、黑色保留

第二份输入是 mask。插件把当前选区导出为黑白 PNG：白色区域是允许局部重绘的范围，黑色区域保持不变。矩形选区和套索等非矩形选区都会走相应的导出分支，但它们表达的仍是同一件事——把修改边界变成与画布等大的蒙版。

可以把一次提交理解成下面的关系：

当前活动文档的合成画面 ──> origin（要参考的原图）
Photoshop 当前选区      ──> mask（白色可改，黑色保留）
origin + mask + 提示词 ──> 局部重绘任务

这也说明了两个容易混淆的判断：

• 只打开文档但没有选区，只有 origin 的候选，没有合法的 mask，所以不能提交；
• 选区存在但你后来切换了文档，新的单事务检查会重新读取状态，不会把旧选区硬套到新画面上。

提交前按这个顺序做预检

不必先改提示词，按下面的顺序检查更快：

1. 确认在 Photoshop 插件环境

局部重绘槽位要求在 Photoshop 插件环境中使用。浏览器页面或其他非 UXP 容器不会把当前 Photoshop 画板当作输入，换环境重试不能解决“没有选区”。

2. 打开目标文档，再建立选区

先激活本轮要处理的文档，再用选框、套索等工具圈住需要改动的区域。选区不用等于整层，也不要因为怕漏边就把整张画布都圈进去；范围越大，模型可改动的像素越多，越难保持其余内容不变。

3. 在点击生成前检查选区仍在

插件是在点击提交的瞬间读取选区。如果你在面板打开期间取消了选择、切换了文档，或切换工具后选区已经消失，就会再次收到前置提示。重新建立选区后再点“立即生成”即可。

4. 检查画布尺寸和任务参数

导出的画布宽高需要在 64–4096 像素范围内；选区存在不代表尺寸校验一定通过。尺寸、提示词和模型选择都通过后，插件才会并行上传 origin 与 mask，再以“原图在前、蒙版在后”的顺序提交任务。

这几种“看起来像选区”的东西不能混用

图层透明区域、快速蒙版的显示状态、当前活动图层边界，都不自动等于本次局部重绘的选区。局部重绘读取的是 Photoshop 的活动选区；没有明确边界时，插件不会猜测你想改哪里。

同样，不要把旧文章里“局部重绘适合改小范围细节”的经验，理解成“任何小图层都能直接提交”。局部重绘能改什么、哪些地方容易穿帮讲的是任务适配和结果检查；本文补的是提交前输入链路。想把结果放回原文件并保留可回退结构，可以再看PS 插件图层与蒙版的无损整理方法。

一句话记住 origin 和 mask

如果只记一条：先在当前文档里看准画面，再在同一份文档里框选范围。当前文档的合成 PNG 是 origin，选区生成的黑白 PNG 是 mask；没有选区时，插件宁可停止提交，也不会替你决定整张图都要改。

准备好 Photoshop 画板和选区后，可以从图叮局部重绘功能页了解能力边界，再进入图叮 PS AI 插件入口完成实际操作。