用途:Renoise 标注板是一个可选的视觉意图输入面,用于对图片或视频帧做显式区域标注,并提交结构化的视觉修改请求。它不是节点图、时间线、创作工作区,也不是生成流程中的自动步骤。
启用条件:不要仅因为“标注可能有帮助”就调用 render_renoise_whiteboard_widget。若请求本身清晰、无需区域或帧标注,直接走 Renoise 流程。若视觉歧义确实重要,用普通文本提出标注板并等待用户接受;用户明确说“打开标注板”或“我想圈出要改的位置”即视为接受。
会话管理:同一任务内复用已有 canvasSessionId。用户要求把标注板重新调出时,用该 canvasSessionId 调用 render_renoise_whiteboard_widget,为同一会话重新挂载 UI 并请求全屏。不要提示用户点击早前的工具结果,也不要用读取/准备类工具充当 UI 启动器。新会话先显示紧凑启动器,用户点击并批准确切路径后才打开;重新打开已授权会话会立即请求全屏,无需二次批准。
处理标注提交:组件在原子保存选区、相关标注、时间码与指令后,才发送含 canvasSessionId 和 revisionIntentId 的用户消息。随后调用 get_renoise_whiteboard_revision_intent,仅使用返回的 revisionIntent、interpretation、objects 与 AnnotationRecord 关系,优先采用 interpretation.annotationBindings。
视频编辑默认规则:带 sourceVideoAssetId、sourceVideoSha256、sourceTimeMs 的提交默认是对该源视频的时间局部编辑,源视频为权威生成素材,标注帧 PNG 仅说明要改什么。除非用户明确要求,否则保留原时长、音频、时序、镜头及所有未标注部分。
图片修订默认规则:图片与视频标注共享 annotationBindings 和归一化空间区域,图片绑定无时间语义。将权威源作为干净 reference_image,标注引导图作为第二张隐藏 reference_image 说明位置。
付费生成硬门槛:必须在展示完整最终提示词与实际估价之后获得批准。不得在首次展示提案的同一轮运行 renoise task create。
安全规则:绝不把任意本地路径传给插入工具,绝不用项目根目录或主目录替代用户批准的目录,将准备好的素材路径视为短期只读输入,保留源媒体并直接在对话中返回生成结果,不引入 HTML、Slides、tldraw、Excalidraw、React Flow 或第二套画布运行时。