0.4.72026-10-25
- 账号管理：「并发满时换用其他 Key」改名为「自动切换有效 Key」。勾选后，当前 API Key 并发已满、RH 币不足、钱包余额不足或限额已用完时，都会按「管理 Key」中的顺序换用下一个 API Key；未用上的 API Key 及原因显示在节点状态栏。详见使用文档。
- API Key 限额已用完时，提示「限额已用完」，不再提示「API Key 无效」。
- Rp M Paint、Rp M Paint Pass2 Upscale、Rp M Sharpen、Rp M Motion Fix、Rp M Remove 提交前会估算任务规模，超出模型一次能处理的上限时弹窗提示，并给出缩短帧范围、缩小画布等建议，可选择继续提交或取消。
- RunningHub 上保存的素材文件损坏导致任务失败时，提示会说明原因，再次提交时自动重新上传一份。
- 修复任务结束后偶尔仍占用同时运行名额 2～3 分钟、导致后续任务多排队的问题。
- 工程在网络盘上时，打开带裁切预览的节点面板、调整分辨率不再卡顿。
- 节点放在 Group 中、素材从 Group 的输入口接入时，修改 Group 外的上游后再提交，会使用新的画面（此前可能沿用旧的）。
- 工程另存到其他目录后，Rp M Paint Pass2 Upscale 不再提示找不到上一步的素材。
- 稳定性改进与问题修复。
0.4.62026-10-22
- 任务提交失败时的提示更清楚：RunningHub 的 RH 币不足、API Key 无效（填写错误或已在 RunningHub 删除）、RunningHub 平台暂时出错、连不上 RunningHub 或被公司网络拦截时，会直接说明原因；API Key 无效时不再反复重传素材。详见使用文档。
- 实时进度连接断开时，状态改为说明任务照常在跑、每 5 秒刷新一次进度。
- Rp M Remove、Rp M Motion Fix、Rp M Sharpen、Rp M Tile Upscale 新增「每次随机」（默认不勾选），勾选后每次提交自动更换种子。
- 「恢复生成节点」时自动取消「每次随机」，恢复出的节点保留当时使用的种子。
- 稳定性改进与问题修复。
0.4.52026-10-21
- 稳定性改进与问题修复。
0.4.42026-10-20
- 通过插件菜单「检查更新…」安装新版本时，不再需要关闭 Nuke：安装在后台完成，完成后会弹出提示。请保存工程并重启 Nuke（所有打开的 Nuke 都需要重启）后使用新版本；尚未重启的 Nuke 提交任务时会提示先重启。
- 从 0.4.3 及更早版本升级到本版本时，仍需按原方式关闭所有 Nuke。如果关闭全部 Nuke 窗口后仍提示「还有 Nuke 开着」，请在任务管理器中结束名称以 Nuke 开头的剩余进程（Nuke 的后台渲染进程有时不会自动退出），再点击「确定」。
0.4.32026-10-20
0.4.22026-10-20
- 团队多台电脑共用账号时，请所有电脑一起升级到 0.4.2：0.4.2 调整了新建 Rp M Paint Pass2 Upscale 节点的输入口顺序（source / mask / refs / control），在旧版插件上提交 0.4.2 新建的放大节点时，参考素材和遮罩可能被对调。
- 新增 Rp M Motion Fix：修复快速运动或镜头甩动造成的拖影与运动模糊，只重新生成模糊的几帧，其余帧保持原片。详见使用文档。
- 新增 Rp M Remove（实验性）：擦除 roto 范围内的人物或物体并补出背景，长镜头自动分段生成；擦除区域补出多余内容时可自动重新生成该段。详见使用文档。
- 各视频节点的面板与 Rp M Paint 统一：帧范围、fps 与传输质量排在同一行，fps 统一为下拉选择；各视频节点都有「读取上游帧范围」，并同时读取上游的 fps；单输入节点的输入口统一命名为 source。已有节点打开面板时自动换成新排版，fps 被其他节点的表达式引用时保持不变。
- Rp M Paint Pass2 Upscale：新建节点的输入口顺序调整为 source / mask / refs / control；勾选「直接接视频」时也可「读取上游帧范围」；「读取上一步的提示词」更名为「读取上游提示词」。
- 账号管理：「删除 Key」改为「管理 Key」，可调整多个 API Key 的使用顺序；保存了两个以上 API Key 时可勾选「并发满时换用其他 Key」（默认不勾选），当前 Key 并发已满时按顺序换用其他 Key 提交。消费级-会员与企业级-共享 API Key 均可使用。
- 提交任务时在任务归档中保存一份当时的工程副本，便于日后追溯；每个工程保留最近 30 份，「打包工程到…」不会带上这些副本。
- 机器列表中的编号改为本账号内的序号（#1、#2……）。
- Rp I Edit 新建节点默认勾选「每次随机」。
- 修复：使用 ACES 等 OCIO 色彩配置的工程中，拖入视频自动转码后建立的 Read 报「Invalid LUT selected」；二阶放大「用上一步的」遮罩预览显示为黑。
- 一键安装包、卸载程序与 Windows「设置 > 应用」中显示 pixRepaint 图标。
0.4.12026-10-18
- 云端任务进行中关闭 Nuke 或 Nuke 意外退出后，重新打开工程会自动接回未完成的任务：节点状态显示「接回平台任务」并继续显示进度，完成后照常生成结果节点。
- 任务进行中删除、剪切或移动了节点，或新建、打开了其他工程时，不再生成不完整的结果节点，改为弹窗说明成片的保存位置。
- 上传素材时网络中断、连接超时或服务器繁忙会自动重传（每个文件最多 4 次），状态中显示第几次；上传卡住时点击取消可立即停止。
- 任务完成后下载结果时网络中断，会持续重试约 5 分钟；成片文件被杀毒软件等程序短暂占用时自动重试。点击取消后云端任务未能取消时，节点状态中会给出任务 ID，便于到 RunningHub 网页手动取消。
- 修复：使用 ACES 等 OCIO 色彩配置的工程，提交时报「Invalid LUT selected」。
- 源片为非方形像素（如变形镜头）时，在「已提交」状态中提示先用 Reformat 转为方形像素，以免生成内容的比例不正确。
- 修复：禁用或启用上游节点后提交，仍使用改动前的缓存。修改工程的色彩管理设置后同样会重新渲染输入（安装本版后首次提交会重新渲染一次输入）。
- 「收集文件到工程」「打包工程到…」：修复只读素材拷出的副本无法再次覆盖、文件名含
[ ] $的素材相互覆盖；内容更换但大小不变的序列帧不再被当作已拷贝。 - 修复：Rp M Tile Upscale、Rp M Sharpen、Rp UltraSharp、Rp ColorMatch、Rp Control 在源片宽度为奇数时「快速」档提交失败。
- Rp M Refs 移除在云端不生效的「带音轨」选项；Rp I Edit 打开「显示高级参数」时不再出现不起作用的设置项。
- 英文界面：修复 Pass2 Upscale 状态中夹带中文、跨语言打开工程时 Rp I Edit「改写中…」未被识别；在「选项」中点击确定不再撤销刚切换、尚未重启生效的界面语言。
- 激活时填写了 API Key 但无法识别所属站点时，按「平台」选项激活，不再停在激活页面；国际站账号在账号窗口中查询队列与额度时使用国际站。
- 修复：设置文件被其他程序短暂占用时登录后窗口报错，或本机标识被重新生成、多占用一个席位；断网时偶尔无法提交。
- 一键安装包：英文 Windows 上的老用户在线更新后保持原来的界面语言；zip 包的
install.bat/uninstall.bat运行后恢复命令行窗口原来的编码。
0.4.02026-10-15
- 新增英文界面：菜单、节点面板、账号窗口、状态与报错信息均提供英文。一键安装包开头可选择界面语言（按 Windows 显示语言预选）；之后可在「登录…」「首次激活…」窗口或「选项…」中的「语言 / Language」切换，重启 Nuke 后生效。工程中已有的节点保持创建时的语言。升级的用户默认保持中文。
- 支持 RunningHub 国际站（runninghub.ai）账号：「首次激活…」新增「平台」选项，填写 API Key 时按 Key 自动识别所属站点；所有云端节点均可在国际站使用。「查看 RunningHub ID」「获取 API Key」按所选平台打开对应网页。国际站账号使用试用码 8888 激活，可免费试用 30 天。
- Rp I Upscale 新增「贴原图程度」：设置分块重绘时每块贴近原图的程度。默认 1 与此前结果一致；调低可增加细节，但人脸、文字等内容可能发生变化。
- zip 包中的「安装.bat」「卸载.bat」更名为
install.bat/uninstall.bat，提示按系统语言显示中文或英文；修复 zip 包解压路径中含有「&」时安装脚本无法运行。
0.3.12026-10-12
- 新增 Rp I Edit：单帧改图（云端运算）。用一句话描述要修改的内容，最多可接入 9 张参考图；接入遮罩时可只修改遮罩附近区域，并在画面上预览裁切范围；不接原画面时可按参考图或文字生成新画面。完成后生成结果节点，如需贴回原片，点击结果节点上的「创建回贴节点」。执行超过 30 分钟仍未完成的任务会自动在云端取消，以免持续计费。
- Rp M Paint Pass2 Upscale 新增「传输质量」：直接接入视频时选择「快速」可加快上传；云端生成的结果同样按所选档位回传。
- 「传输质量」新建节点默认改为「快速」，上传与回传更快；已有工程中的节点保持原设置。对颜色精度要求较高时（如色彩匹配）可改选「高质量」。
- 下载结果时显示下载速度和剩余时间（云端任务与局域网 Topaz 服务）。
- 云端任务的进度显示更稳定：进度推送连接失败或没有响应时自动重连，生成过程中的步数进度不再整段缺失。
- 修复：Rp M Paint「档位」选择后不生效；旧工程中手动修改过的步数在打开参数面板时被重算。
- 修复「对齐原片」：取消计算时卡住；使用 ACES / OCIO 色彩管理的工程无法使用；开启 Proxy 时的处理。再次对齐时原地替换上一次的结果，并沿用已调整的对齐强度。
- 修复：旧版本建立的 Rp Crop 节点刷新时裁切范围改变；恢复较早版本的生成结果时锚点取法、传输质量与原任务不一致；源片宽度为奇数时「快速」档无法提交；用过「对齐原片」后每次检查更新都下载完整安装包；运行 Topaz 网络服务时在线更新完成后不提示。
0.3.02026-10-10
- Rp Enhance（Topaz 引擎）新增「防抖」：去除手持拍摄的抖动，「平滑」0～16 可调（数值越大画面越稳，也越容易削弱有意的运镜）。默认自动裁去晃出的画面边缘并拉回输出尺寸；勾选「整帧补全（慢）」时补全边缘、不裁切，耗时明显增加。可与增强、慢动作同时使用，防抖至少需要 2 帧。使用局域网 Topaz 服务的，请在运行 Topaz 的电脑上也安装本版本并重新打开服务。
- 回贴节点新增「对齐原片」：贴回后遮罩边缘附近出现错位或抖动时，点击即在本机计算，将生成结果对齐到原片。所需运行库已随插件附带，无需另行安装。
- Rp M Paint 的锚点新增「取法」：「自动」「只取首帧」「用整段」，默认自动识别接入的锚点是单帧还是视频；视频锚点超出云端单段长度时自动拆段。
- Rp M Paint Pass2 Upscale：「结构控制」可选「不用」「用上一步的」「接 control 口」；接入遮罩时，遮罩以外的区域保持输入画面不变（云端运算）。
- 「参考图尺寸」选择「max」时，云端按参考图的原始尺寸处理：细节更多，但处理更慢、费用更高；参考图不大于生成画布时两档效果相同。Pass2 Upscale 沿用上一步的设置。
- Rp M Paint 移除在云端不生效的「加速」「强度」「shift」参数（云端始终使用加速模式，步数随之自动计算），Pass2 Upscale 移除「shift」；旧工程中的节点在打开参数面板时自动调整。
- 「收集文件到工程」「打包工程到…」：工程以网络盘符打开、素材使用 IP 或计算机名路径（或反之）时，可正确识别为同一位置，不再另行拷贝。
- 复制粘贴节点或「恢复生成节点」后，裁切设置不再被自动关闭；只有断开遮罩连接时，裁切方式才切换为「无」。
- 参数超出范围时（如 Pass2 Upscale 的「重画起点」「精修步数」、Rp Control 的 MLSD 参数、Rp M Tile Upscale 的放大比例）在提交前即提示，不再提交到云端后才报错。
- 提示词输入框打开即为完整高度（至少 8 行）；Rp M Tile Upscale 的面板排列与 Pass2 Upscale 统一；填写 RunningHub ID 与 API Key 的窗口新增「查看 RunningHub ID」「获取 API Key」链接。
- 云端任务查询进度时网络短暂中断，会在 10 分钟内自动重试，不再立即判为失败；Topaz 网络服务同样处理。
- 修复：设置了 HOME 环境变量的电脑上，不同版本的 Nuke 读取到两份不同设置的问题；使用安装.bat 升级时一并卸载已安装的 Topaz 网络服务的问题；跟随框裁切贴回后局部轻微抖动的问题；Topaz 慢动作结果接入下游时「读取上游帧范围」帧数不足的问题。
0.2.92026-10-02
- 新增 Rp M Tile Upscale：分块超采样放大，最高放大 4 倍，逐块重绘补充细节；可接入结构控制，较长镜头自动分段处理（云端运算）。
- 新增 Rp M Sharpen：整段锐化重绘，输出尺寸与帧数保持不变，提示词可调整（云端运算）。
- 新增 Rp UltraSharp：整段逐帧模型放大，最高 4 倍，不改变画面内容（云端运算）。
- 新增 Rp Crop：按遮罩裁切并回贴，不进行生成；节点本身即显示裁切范围预览，可一键建立裁切节点与回贴节点。
- Rp M Paint Pass2 Upscale 可直接接入视频（无需上一步的生成结果），并新增结构控制输入。
- Rp Control 新增「传输质量」选项。
- 带遮罩输入的节点：断开遮罩时，裁切方式自动切换为「无」；遮罩预览与裁切范围预览默认开启。
- 「收集文件到工程」新增「改为相对路径」选项（默认开启）：整个工程文件夹拷贝到其他电脑后可直接打开，生成节点的参数也可照常恢复。
- 新增「打包工程到…」：将当前工程用到的素材与生成结果整理拷贝到指定文件夹，另存一份全部使用相对路径的工程，原工程不受影响。
- 新增「检查更新…」：有新版本时可在 Nuke 中直接下载并安装，更新后登录状态与设置均保留；本机已有相同的视频组件时，仅下载插件本身的更新。
- 菜单调整：节点按系列分为「M 系列」与「通用」两个子菜单，Tab 搜索不受影响。
- 一键安装包（setup.exe）分为「Nuke 插件」与「Topaz 网络服务」两个组件，Topaz 网络服务只需在运行 Topaz 的电脑上安装。
- 修复：重新启动 Nuke 后直接打开已有工程时，部分节点的参数面板操作无响应的问题。
0.2.82026-09-27
- 支持统一插件目录：使用由 NUKE_PATH 指定、每个插件各占一个子文件夹的统一插件目录时，将 pixrepaint 文件夹整个放入该目录即可加载，无需修改 menu.py。详见下载与安装。
- 插件加载方式调整，不再影响同一 Nuke 中其他插件的加载。
- 重复安装提醒：同一台电脑装有多份 pixRepaint 时，Nuke 启动后会提示每一份的位置与版本；一键安装包（setup.exe）或安装脚本（安装.bat）完成安装后，如发现统一插件目录中另有一份，也会给出提醒。提醒不会删除任何文件，请您自行决定保留哪一份。
- Rp I Upscale 的进度改为从粗放大到分块重绘连续显示，不再分段跳动。
0.2.72026-09-27
- 账号体系更新：改为使用插件账号名 + 密码登录，原先直接填写订阅码激活的方式停用。菜单「Nodes › pixRepaint › 账号与许可证」下提供「首次激活…」「登录…」「账号管理…」三项：首次使用时在「首次激活…」中设置账号名与密码，并填写订阅码与 RunningHub ID；在其他电脑上通过「登录…」输入账号名与密码即可使用（同时在线的机器数以档位为准）。详见快速入门。
- 每个插件账号绑定一个 RunningHub ID，该账号首次在 RunningHub 上成功运行之前，可通过「改绑 ID」修改。续费或升档时，在「账号管理…」中点击「续费 / 升档」兑换新的订阅码，无需重新登录：同档续费的时长接在剩余时长之后；升档立即生效，原档位的剩余时长顺延。
- 「账号管理…」可查看档位、到期时间、在线机器数与并发数，并可「改密码」「下线其他机器」；登录窗口提供「忘记密码…」。登录时如在线机器数已达档位上限，插件会列出该账号的机器，选择一台下线后即可继续登录；闲置 1 小时的机器自动释放。
- API Key 仅保存在本机，仅发送至 RunningHub，我们的服务器不接收、不保存。同一账号可保存多个 API Key：在「账号管理…」中通过「添加 Key」「删除 Key」管理，并在下拉列表中切换当前使用的 Key（切换后点击「保存设置」生效）。所用 API Key 需属于账号绑定的 RunningHub ID。
- 「选项…」新增「使用代理」开关与代理地址：默认直连；需通过代理访问网络时勾选并填写地址，修改后立即生效，无需重启 Nuke。
- 向云端上传素材时，状态栏显示上传进度、传输速度与预计剩余时间。
- 新增 Rp Enhance 节点：调用您自行购买、安装并登录的 Topaz Video AI（第三方软件），对画面进行画质修复、放大与慢动作处理。Topaz Video AI 可位于本机，也可位于局域网内另一台电脑，后者需在那台电脑上启动插件附带的 Topaz 服务，并在「选项…」中填写 Topaz 服务地址与口令。
- 新增 Rp I Upscale 节点：单帧画面高清放大，放大倍数 1～4 倍可调。可自动识别画面内容写提示词，分块重绘补充细节，并保持原有结构不变；可选分块大小与采样步数，状态栏按分块显示进度。视频放大请使用 Rp M Paint Pass2 Upscale 或 Rp Enhance。
- Rp Depth 升级为 Rp Control：由原片或 3D 渲染生成深度图或线稿，「类型」可选「深度」「Canny」「HED」「MLSD」；结果可接入 Rp M Paint 的 control 输入口作为结构参考，深度图也可直接用于合成。旧工程中的 Rp Depth 节点可照常打开使用。
- Rp M Paint 新增 control 输入口（结构控制）：接入 Rp Control 生成的深度图或线稿，约束生成结果的空间结构；可调整「控制强度」，并可选「使用遮罩」（默认关闭）。
- Rp M Paint 新增「锚点 / 参考强度」参数，可适当放松参考图与锚点帧对生成结果的约束；云端可用的锚点帧上限由 4 个提高到 8 个。
- Rp M Paint 高级参数新增「模型」选项：新版（新建节点默认）与旧版；二阶放大自动沿用上一步的模型。升级前创建的 Rp M Paint 节点继续使用旧版。
- Rp M Paint 新增开头帧数参数（0～16），用于改善生成结果开头几帧颜色不稳定的问题；二阶放大自动沿用。使用该参数生成的结果，需 0.2.7 及以上版本的插件才能继续放大或恢复生成节点。
- Rp M Paint Pass2 Upscale 新增「实际画布」一行，提交前显示放大后的实际画布尺寸。
- 裁切模式生成的结果节点新增「创建裁切节点」「创建回贴节点」两个按钮，创建后自动接好原片、roto 与结果的连线。
- 点击「恢复生成节点（当时参数）」时，原参考素材节点如未改动则直接接回，不再另外复制一份。
- 「收集文件到工程」的确认与结果窗口改为可滚动列表，文件较多时也可完整查看。
- 修复：Rp ColorMatch 处理高分辨率长镜头时因显存不足导致任务失败或长时间无响应的问题。遮罩匹配改为分批计算，显存占用不再随镜头长度增加。
- Rp ColorMatch 新增第 4 个输入口「ref_roto」：参考画面与目标画面中人物位置不同时，可分别为两段素材指定采样区域（适用于 mkl 与 reinhard 模式）。
- Rp ColorMatch 新增「采样间隔」参数：统计颜色时每隔若干帧取一帧，长镜头的准备与计算明显加快；目标画面仍逐帧调色。
- Rp ColorMatch「预览遮罩」新增「看」选项：接入 ref_roto 时可切换查看 ref 一侧的采样区域；打开哪个遮罩节点的参数面板，预览即自动切换到对应一侧。
- Rp ColorMatch 遮罩匹配新增「逐帧稳定亮度 / 颜色」选项：素材本身逐帧亮度或色彩起伏时，先消除逐帧起伏，再统一调色。
- Rp ColorMatch 整帧匹配移除 reinhard_lab_gpu 模式；旧工程中使用该模式的节点，打开面板后自动改为 reinhard。
0.2.62026-09-21
- 维护更新：完善生成结果的识别逻辑，避免在个别情况下将输入素材误认为生成结果。功能与使用方式与 0.2.5 相同。
0.2.52026-09-19
- 云端任务的素材缓存与下载文件改为存放在工程文件所在目录下的 pixRepaint 文件夹中，成片归档后自动清理暂存文件，减少 C 盘占用。
- 提交前需先保存工程：工程未保存时，插件会提示先保存再提交。
- 修复：重新打开工程后，状态栏可能挤到提交按钮所在一行的问题。
- 账号面板中「平台用户 ID（个人中心里的数字）」一栏更名为「RunningHub ID」；余额一行改为显示当前 API Key 的可用额度。
0.2.42026-09-18
- 参考视频与参考音频在提交前统一转换规格（帧率、声道与封装格式），云端生成速度更快，结果更稳定。
- 云端排队时，状态栏分别显示账号下与本机的排队数量，并标出当前任务的位次。
- 账号面板显示当前插件版本号，便于反馈问题时核对。
- 一键安装包不再沿用上一次安装时的目录，避免用户目录变更后插件无法正常加载。
0.2.32026-09-18
- 新增 Rp Depth 节点：由素材生成深度图（云端运算），可用于合成。该节点自 0.2.7 起升级为 Rp Control。
- pixRepaint 菜单中的工具项改为中文名称（如「收集文件到工程」「选项…」），并移除不常用的菜单项；菜单与节点统一使用 pixRepaint 图标。
- Rp M Paint 面板布局调整：「读取上游帧范围」「读取上游提示词」两个按钮并排置于提示词框上方，提示词框可随面板拉高。
- 云端应用同步更新：0.2.2 及更早版本的插件需升级后方可继续提交云端任务。
0.2.22026-09-18
- 新增 Rp ColorMatch 节点：基于云端算力对两段素材进行色彩匹配，支持整帧匹配与按 roto 圈定区域的遮罩匹配。
- Rp M Paint、Rp M Paint Pass2 Upscale 与 Rp ColorMatch 新增「预览遮罩」勾选项：勾选后，节点输出画面将叠加半透明红色，用于提交前核对遮罩绘制是否正确。
- Rp M Paint 新增「预览裁切框」勾选项：裁切模式下可在提交前查看裁切框位置；裁切框的计算速度明显加快。
- 同一节点多次提交时，状态栏按任务分行显示；「取消」将停止该节点所有运行中的任务（两个及以上时先确认），上传、下载与格式转换阶段均可即时停止。
- 收集文件到工程的复制速度提升：多个文件并行复制，同一台文件服务器上的文件直接在服务器端复制、不再经本机中转，大文件复制中途可取消。
- 生成结果的归档文件夹统一命名为 pixRepaint，位于工程文件所在目录下。
- 修复：对放大结果点击「恢复生成节点（当时参数）」时无法接回上一步结果的问题。
0.2.12026-09-17
- 首个对外发布版本。
- 提供一键安装包（setup.exe）与 zip 手动安装包两种安装方式。
- Nuke 13、14、15 已完成代码层面适配（Python 3.7 及以上）；Nuke 16 已完成实测。
- 内置 ffmpeg，用于「传输质量」选择快速档位时的转码。
- 基于 RunningHub 云端完成生成：局部视频生成（Rp M Paint）与二阶放大（Rp M Paint Pass2 Upscale）。
- 二阶放大支持三种遮罩模式：整帧放大、沿用上一步遮罩、接入新遮罩。
- 支持参考图、锚点帧与参考视频，通过 Rp M Refs 接入重绘节点使用。
- 提供账号面板、服务状态指示灯、排队看板及生成进度显示。
- 生成结果以 ProRes 4444 格式回传至节点图。
0.2.1 之前的版本仅用于内部测试，未对外发布。