开发文档

配置说明

当前项目里与业务功能直接相关的配置入口和维护原则。

配置分层

当前项目的业务配置大致分成三层：

  • 环境变量：密钥、地址、服务端口、外部依赖
  • config/autoload/：后端模块级配置
  • 系统设置或业务配置表：运营可调整的参数

重点配置主题

文件与共享盘

  • 路径模板
  • 上传大小限制
  • 允许上传的扩展名
  • 区域到共享路径的映射规则

本地网关

  • 网关地址
  • 服务间共享密钥
  • Worker 地址
  • 回调和推送相关配置

飞书集成

  • FEISHU_APP_ID
  • FEISHU_APP_SECRET
  • FEISHU_VIDEO_STATUS_NOTIFY_ENABLED
  • FEISHU_VIDEO_STATUS_NOTIFY_CHAT_ID

脚本拆解

  • Whisper 模型大小
  • 共享盘拆解目录
  • 回调鉴权密钥

本地网关关键环境变量

这几项基本决定了本地链路能不能跑通：

  • VIDEO_COLLAB_DISK_ROOT
  • VIDEO_COLLAB_VERSION_ROOT
  • VIDEO_COLLAB_LOCAL_GATEWAY_REGION
  • VIDEO_COLLAB_GATEWAY_SIGNATURE_SECRET
  • VIDEO_COLLAB_PUSH_CLOUD_BASE_URL
  • VIDEO_COLLAB_PUSH_GATEWAY_ID
  • VIDEO_COLLAB_PUSH_GATEWAY_SHARED_SECRET
  • LOCAL_GATEWAY_WORKER_SHARED_SECRET

飞书通知相关开关

成片状态通知至少要确认这些值：

FEISHU_APP_ID=
FEISHU_APP_SECRET=
FEISHU_VIDEO_STATUS_NOTIFY_ENABLED=true
FEISHU_VIDEO_STATUS_NOTIFY_CHAT_ID=oc_xxx
FEISHU_VIDEO_STATUS_NOTIFY_RECEIVE_ID_TYPE=chat_id
FEISHU_VIDEO_STATUS_NOTIFY_MENTION_ID_TYPE=open_id

配置维护原则

  • 密钥类配置优先走环境变量
  • 业务可调参数尽量不要硬编码
  • 路径模板统一维护，避免各模块重复拼接
  • 修改配置后要同步验证异步任务和本地网关链路