media-assets

匠厂（深圳匠厂科技）跨项目共享媒体资产库。

本仓库只维护轻量媒体资源与工具下载 manifest，供各技能（skill）的录制脚本使用。

仓库内容

类型	说明
背景音乐	music/ 目录
字体	fonts/ 目录
水印	watermark/ 目录
工具下载清单	manifest.json

本仓库不直接存放 ffmpeg.exe / ffprobe.exe 等大二进制工具。

目录结构

media-assets/
  manifest.json
  music/
  fonts/
  watermark/

音乐子目录

目录	用途
music/calm/	舒缓类背景音乐，适合流程演示视频
music/upbeat/	活力类背景音乐，适合功能展示视频
music/corporate/	商务类背景音乐，适合对外宣传视频

ffmpeg / ffprobe 获取方式

视频处理工具不由本仓库直接提供，而由 jiangchang-platform-kit 根据 manifest.json 按需下载、解压并缓存到用户数据目录：

D:\jiangchang-data\shared\media-assets\bin\win32-x64\

说明：

• 用户不需要手工安装 ffmpeg，也不需要依赖系统 PATH。
• 用户电脑没有 Git 也可以工作：kit 会通过 HTTP ZIP 下载 media-assets 与 ffmpeg essentials 包。
• Windows x64 默认使用 ffmpeg-release-essentials（非 full build）。
• manifest.json 中配置了国内镜像与 gyan.dev 官方源；kit 会按顺序尝试。

背景音乐

背景音乐仍从本仓库的 music/ 目录读取。各技能可通过 jiangchang_skill_core.media_assets 解析路径并选取音频文件。

使用方式

各技能录制脚本通过环境变量 MEDIA_ASSETS_ROOT 定位本库：

MEDIA_ASSETS_ROOT = os.environ.get("MEDIA_ASSETS_ROOT", r"D:\OpenClaw\client-commons\media-assets")

未设置环境变量时，kit 默认使用 {JIANGCHANG_DATA_ROOT}/shared/media-assets（例如 D:\jiangchang-data\shared\media-assets）。

注意

• MP3、字体、图片等媒体文件通过 Git LFS 管理，clone 前请确认已安装 git lfs。
• 请勿将版权不明的音乐文件上传至本库。