dootask/resources/ai-kb/zh/howto/system-setting/video-process.md

id, title, type, feature, scope, locale, aliases, prerequisites, related_tools, related_pages, negative, last_verified

id	title	type	feature	scope	locale	aliases	prerequisites	related_tools	related_pages	negative	last_verified
system-setting.video-process.howto	视频转码与压缩设置	howto	system-setting	admin	zh	视频转换怎么开 视频压缩开关 convert_video compress_video MOV 转 MP4 视频自动压缩	需要系统管理员权限 服务器已具备 ffmpeg 等转码工具（容器化部署默认包含） 部署环境变量 SYSTEM_SETTING 不为 disabled			不会回溯处理历史上传的视频，只对新上传文件生效 转码 / 压缩失败时回退保留原文件，不会丢消息 不能选目标分辨率 / 码率，参数固定	v1.7.90

视频转码与压缩设置

入口

桌面端：左上角头像 →「系统设置」→「系统设置」标签 →「消息相关」→「视频转换」/「视频压缩」。

涉及字段：

• convert_video — 视频转码开关，默认 close
• compress_video — 视频压缩开关，默认 close

各自作用

字段	作用	触发条件
convert_video	把 MOV、WEBM 格式视频转成 MP4，提升跨端兼容性	上传的视频后缀为 mov 或 webm
compress_video	对 MP4 视频做压缩，减小体积	上传 / 转码后产物为 MP4

两者可独立开关，组合关系：

• 只开 convert_video：MOV/WEBM → MP4（原始码率，体积不变）
• 只开 compress_video：MP4 直接压缩；MOV/WEBM 不动
• 都开：MOV/WEBM 先转 MP4 再压缩
• 都关：原文件直接保存，不做任何处理

开启代价

• 服务端需要 ffmpeg；转码会占 CPU 与临时磁盘
• 用户上传后会有一段"处理中"的等待时间，处理完才能预览或发送

对原视频影响

原文件被处理后产物（转码后 MP4 / 压缩后 MP4）替代原文件入库，原始 MOV / WEBM 不保留。开关推送给前端后会在聊天预览处显示「视频处理中」气泡。

操作步骤

1. 进入「系统设置」→「系统设置」→「消息相关」
2. 「视频转换」「视频压缩」分别选「开启」或「关闭」
3. 「提交」保存，立即对后续上传生效

不支持

• 不能按文件大小阈值触发（小视频也会被压）
• 不支持自定义分辨率 / 码率 / 编码器
• 不能针对单个会话或单条消息关闭