视频真实感精修

对已有 AI 短视频只做一次聚焦的真实感精修：由用户选定一个最影响观感的问题，例如光影、材质、色彩、重复细节或主体周边瑕疵。保留已认可的镜头、主体、节奏、时长和声音方向，不把本包扩大成重新生成、多镜头制作或视频超分。

默认使用 model: "auto"，保持源 duration 与 audio_setting: "origin"，并为每项获批逻辑请求使用唯一不透明的 client_request_id。需要大范围生成、延展或多镜头处理时，转交 beatra-ai-video-studio。

先冻结单一精修目标

查看源视频和用户描述，确认只需处理的一个问题、必须保留的主体细节、源画幅、时长、声音和交付用途。先展示精修说明、源视频、模型、输出设置和实时价格；用户给出明确继续指令后，才开始一次付费工作。无论源视频以何种方式上传，都只按获批的上传授权和来源标识使用；上传协议要求 PUT 时不得猜测替代路径。

为模型、能力或价格作决定前使用 beatra.models.list 查询 video_edit。再用当前 beatra.models.list 的 video_edit 卡出示入场卡后调用 beatra.videos.edit，入场卡说明余额不足时怎么办；未获充值确认前不要创建 client_request_id。所有远程操作只使用随包 scripts/mcp_client.py，工具名通过 call 提供，JSON 通过标准输入传入；不得配置或调用宿主 Beatra Connector，也不得使用 REST/OpenAPI 降级或回退。

跟踪、交付与恢复

提交后立即用 beatra.tasks.get 轮询至终态。若未显式指定模型，最终记录解析后的 auto 选择、真实产物、时长、MIME 类型、用量和计费事实。遇到 insufficient_balance 时转述返回文案并保持余额错误里的充值地址一字不改，只有用户说已充值后才用同一 client_request_id 重试。创建响应或任务标识丢失时，先用 beatra.tasks.list 找候选，再用 beatra.tasks.get 确认原任务；仅按用户要求使用 beatra.tasks.cancel。慢任务、上传授权过期或响应丢失不授权新建付费视频编辑；改变源视频、精修目标、模型、画布或声音设置均是新的请求，必须重新批准。

账户余额

用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把 wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他面前。任何时候都不要凭记忆报档位。

按任务查阅资料

精修目标、确认、交付与恢复：视频真实感精修工作流（references/workflow.md）
路由边界与源视频处理：视频真实感精修工作流（references/workflow.md）
首次安装或授权失效：安装与授权（references/installation-and-auth.md）
不收费的包安装注册：安装注册（references/installation-registration.md）
任务轮询、产物和结果字段：任务与结果（references/tasks-and-results.md）
余额、校验和结构化错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
随包客户端连接诊断：随包 MCP Client 连接诊断（references/mcp-connection.md）
更新保证和控制：自动更新与安全（references/automatic-updates-and-safety.md）
移除本包或共享凭据：卸载与断开连接（references/uninstall-and-disconnect.md）

运行时和安全自动更新

随包客户端在每个安装中静默检查更新，每 24 小时最多一次。发现更高版本时，会不另行确认自动安装。只从当前包、渠道和语言环境的固定官方发现地址与不可变 Beatra CDN 路径下载；替换前校验发现数据、压缩包、清单和每个文件，只替换本包拥有的文件。它会拒绝重定向、降级、意外目标、不安全压缩包，以及与当前包、渠道、语言环境或版本不匹配的数据。检查、下载、替换或回滚失败时，当前安装仍然可用，用户原本请求的命令继续执行。更新失败不重试已付费的视频编辑，设置在本安装中持续生效。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

官方来源、完整性校验、替换范围与恢复说明见自动更新与安全（references/automatic-updates-and-safety.md）。