From 6d8e08ae953b420102c1728340b4e5f90e43428e Mon Sep 17 00:00:00 2001 From: chendelian <116870791@qq.com> Date: Wed, 3 Jun 2026 19:40:05 +0800 Subject: [PATCH] chore: make media assets lightweight tool manifest Co-authored-by: Cursor --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++------ manifest.json | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 80 insertions(+), 6 deletions(-) create mode 100644 manifest.json diff --git a/README.md b/README.md index a262e1a..32b7295 100644 --- a/README.md +++ b/README.md @@ -2,17 +2,55 @@ 匠厂（深圳匠厂科技）跨项目共享媒体资产库。 -供各技能（skill）的录制脚本使用，包含背景音乐、字幕字体、品牌水印等。 +本仓库只维护**轻量媒体资源**与**工具下载 manifest**，供各技能（skill）的录制脚本使用。 -## 目录说明 +## 仓库内容 + +| 类型 | 说明 | +|---|---| +| 背景音乐 | `music/` 目录 | +| 字体 | `fonts/` 目录 | +| 水印 | `watermark/` 目录 | +| 工具下载清单 | `manifest.json` | + +**本仓库不直接存放 `ffmpeg.exe` / `ffprobe.exe` 等大二进制工具。** + +## 目录结构 + +```text +media-assets/ + manifest.json + music/ + fonts/ + watermark/ +``` + +### 音乐子目录 | 目录 | 用途 | |---|---| | `music/calm/` | 舒缓类背景音乐，适合流程演示视频 | | `music/upbeat/` | 活力类背景音乐，适合功能展示视频 | | `music/corporate/` | 商务类背景音乐，适合对外宣传视频 | -| `fonts/` | 字幕渲染字体文件 | -| `watermark/` | 品牌 Logo / 水印图片 | + +## ffmpeg / ffprobe 获取方式 + +视频处理工具不由本仓库直接提供，而由 **`jiangchang-platform-kit`** 根据 `manifest.json` 按需下载、解压并缓存到用户数据目录： + +```text +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` 解析路径并选取音频文件。 ## 使用方式 @@ -22,9 +60,9 @@ 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`。 +- MP3、字体、图片等媒体文件通过 **Git LFS** 管理，clone 前请确认已安装 `git lfs`。 - 请勿将版权不明的音乐文件上传至本库。 diff --git a/manifest.json b/manifest.json new file mode 100644 index 0000000..5a4f42c --- /dev/null +++ b/manifest.json @@ -0,0 +1,36 @@ +{ + "name": "media-assets", + "description": "匠厂技能共享媒体资源库，包含背景音乐、字体、水印与视频处理工具下载清单。", + "version": "0.2.0", + "directories": { + "music": "music", + "fonts": "fonts", + "watermark": "watermark" + }, + "tools": { + "ffmpeg": { + "win32-x64": { + "package": "ffmpeg-release-essentials", + "archive_type": "zip", + "urls": [ + { + "name": "gh-llkk", + "url": "https://gh.llkk.cc/https://github.com/GyanD/codexffmpeg/releases/download/8.0/ffmpeg-8.0-essentials_build.zip" + }, + { + "name": "gh-proxy", + "url": "https://gh-proxy.com/https://github.com/GyanD/codexffmpeg/releases/download/8.0/ffmpeg-8.0-essentials_build.zip" + }, + { + "name": "gyan-official", + "url": "https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip" + } + ], + "archive_paths": { + "ffmpeg": "*/bin/ffmpeg.exe", + "ffprobe": "*/bin/ffprobe.exe" + } + } + } + } +}