canvas

用途

Renoise 视觉标注板（annotation board）是 Renoise 插件提供的可选用视觉意图输入界面，用于让用户明确指定图片或视频帧中需要修改的位置，并附带结构化说明。它被定位为输入面，而非节点图、时间线、创作工作区，也不会成为生成流程中的自动步骤。

主要能力

• 在已授权的项目目录内发起标注会话，返回 canvasSessionId 用于后续复用。
• 对图片或视频帧进行区域标注，记录源选择、相关标注、时间码与指令。
• 提交后将标注意图以 revisionIntentId 形式持久化，可通过 get_renoise_whiteboard_revision_intent 读取结构化结果，包含 interpretation、objects 与 AnnotationRecord 关系。
• 通过 prepare_renoise_whiteboard_references 准备标注引导图与权威源文件，并按 uploadPlan 匹配后上传。
• 与 Renoise MCP 工具链衔接：upload_files、estimate_cost、create_tasks、wait_tasks。

使用方式

1. 在任务范围内解析已存在的项目目录，不猜测更宽的路径。
2. 调用 render_renoise_whiteboard_widget，传入绝对 projectDir 创建新会话；已有活动会话时仅传 canvasSessionId 重新打开。新会话显示紧凑启动器，用户点击并确认路径后才打开；重新打开已授权会话会立即请求全屏，无需二次授权。
3. 用户提交标注后，widget 会发送包含 canvasSessionId 与 revisionIntentId 的消息。
4. 调用 get_renoise_whiteboard_revision_intent，使用返回的 interpretation.annotationBindings 映射标注与权威源、渲染引导图、归一化区域及视频的 sourceTimeMs。
5. 需要生成时调用 prepare_renoise_whiteboard_references，按 assetId 与 purpose 匹配 uploadPlan，并在一次 upload_files 中上传：annotation_guide 使用 scope: "mask"，authoritative_source 使用默认 scope（user）。
6. 完成模型路由与确定性提示词处理后，运行 estimate_cost，展示最终提示词、模型、类型、分辨率、时长/比例、材料 ID 与角色、预估积分与余额，结束回合等待用户明确批准。
7. 批准后仅创建一次任务，复用返回的 task ID 调用 wait_tasks，最终结果直接在当前对话返回。

适用场景

• 用户明确要求“打开标注板”或“我想圈出要改的位置”。
• 视觉歧义对结果有实质影响，需要用户在文本外提供区域或帧级说明。
• 对源视频某一时间点做局部修改，需要保留原始时长、音频、时序、镜头与未标注部分。
• 图片修订中需要区分权威源图与标注引导图的职责。

限制与规则

• 不因“标注可能有帮助”而自动打开标注板；请求清晰时直接经 Renoise 处理。
• 同一任务内复用已有 canvasSessionId，不让用户点击历史工具结果，也不用读/准备工具充当 UI 启动器。
• 提交标注仅批准结构化标注意图，不等于批准最终提示词或价格；此前的“直接生成”等表述不构成价格批准。
• 提示词、模型、参数、材料或价格变更会使批准失效，需重新提案并确认。
• 视频编辑默认以源视频为权威材料，标注帧 PNG 仅作说明；不得将同视频时间戳帧路由为独立图生视频或首尾帧插值，除非用户明确要求。
• 单标注时间点仍按源视频编辑处理；缺失时间边界时仅在实质影响路由、成本或输出时询问。
• Seedance 2.5 专用时间适配：为每个标注引导参考渲染整数秒后缀（如 @material:42 [4s]），不向其他模型应用。
• 标注引导图不得作为可复用用户素材暴露；scope=mask 仅隐藏工具中间物，不构成提供方遮罩。
• 会话过期时，重新授权同一项目并用新 canvasSessionId 恢复；revisionIntentId 丢失时可省略以读取最新持久化标注，不要求用户重画。
• 安全规则：不向插入工具传任意本地路径，不以项目根或主目录替代用户批准目录，材料路径视为短期只读输入，保留源媒体，不引入 HTML、Slides、tldraw、Excalidraw、React Flow 或第二套画布运行时。

暂未提供

该工具的收费模式、价格、具体支持模型清单、运行平台与安装步骤在现有资料中暂未提供。