chore: make media assets lightweight tool manifest

Co-authored-by: Cursor <cursoragent@cursor.com>

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`。
 - 请勿将版权不明的音乐文件上传至本库。

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"
+        }
+      }
+    }
+  }
+}