全景图修复

全景图修复页：在全景原图上框选要修复的区域，用绿色笔刷涂抹出 Mask，选好模型并填写修复描述后交给 AI 修复，修复结果可保存为新作品。

1. 页面信息

网页地址：https://9kvr.cn/capture/records/retouch
所属模块：全景拍摄
页面用途：从草稿箱或作品列表点「修复」进入本页。顶部是标题「全景图修复」与作品名，下面是三步进度条：选范围 → 涂抹 Mask → 看效果。第一步在全景原图上拖动框选要修复的区域，点「截取修复区域 →」进入下一步；第二步用绿色笔刷涂抹要修复的部分（可调笔刷大小、可「清除重画」），选好「修复模型」、必要时填入自己的 API Key 并保存，再写一段修复描述，点「开始 AI 修复」；第三步预览修复后的全景图，可「继续修复其他区域」或「保存为新作品」。
适用用户：想用 AI 修复全景图局部瑕疵的作者
访问条件：需登录后访问

控件 / 入口	类型	取值来源	限制 / 说明
全景图修复（标题）+ 作品名	只读标题	当前记录	副标题在无名称时显示「局部 AI 修复」
选范围 / 涂抹 Mask / 看效果	步骤指示	固定三步	当前步骤高亮
拖动框选	框选手势	用户在全景图上的拖动	选区过小会提示「请在全景图上拖动框选需要修复的区域」
截取修复区域 →	按钮	当前选区	进入涂抹步骤
绿色笔刷涂抹	画笔手势	用户涂抹	未涂抹区域会保留原样
笔刷大小滑块	滑块	用户拖动	范围 8-96 px
清除重画	按钮	当前 Mask	清空已涂抹内容重来
修复模型	下拉选择	平台可用模型与自有 Key 模型	未配置 Key 的自有模型会标注「未配置」；不可用的模型不可选
输入该模型的 API Key / 保存 Key	密码输入 + 按钮	用户填写	仅自有 Key 模型需要
移除该模型 API Key	按钮	当前配置的 Key	用于取消自有 Key 配置
修复描述	多行文本	用户填写	默认文案「自然修复涂抹区域，与周围环境、光线和全景透视无缝融合，不改变未涂抹区域。」
开始 AI 修复	主按钮	当前 Mask 与模型	运行中显示阶段进度文案
继续修复其他区域	按钮	修复结果	回到选区继续处理别的区域
保存为新作品 / 完成并保存新作品	主按钮	修复结果	保存为新作品，原图不变

点「开始 AI 修复」前会做三项检查：必须先用绿色笔刷涂抹要修复的区域，否则提示「请先用绿色笔刷涂抹要修复的区域」；服务端模型配置必须支持 Mask 修复，否则提示「当前服务端模型配置不支持 Mask 修复」；选区必须有效，否则提示「请在全景图上拖动框选需要修复的区域」。

修复结果不会覆盖原作品：保存时会新建一条作品记录，名称为「{原作品名}（AI 修复）」，并把修复后的全景图上传保存。保存成功后提示「修复作品已保存 / 已作为新作品加入作品列表，原图保持不变。」