refine: README simplification + Fun-ASR-Nano as explicit default
README (EN + ZH): - npx skills add: use HTTPS URL instead of SSH - Remove 'First use' uv sync section (agent handles setup, not user) - Remove 'Stock Material Search' section (workflow detail, belongs in SKILL.md) - Keep README focused on overview + workflow, not implementation details - Fun-ASR-Nano marked as default in Features SKILL.md: - Step 4: explicitly state Fun-ASR-Nano as recommended default model
This commit is contained in:
+6
-36
@@ -6,7 +6,7 @@
|
||||
|
||||
## 功能特性
|
||||
|
||||
- **音频转录** — 内置 [funasr-script](https://github.com/modelscope/FunASR),支持 Fun-ASR-Nano(高质量,中文优化)和 SenseVoice(快速预览)两种模型
|
||||
- **音频转录** — 内置 [funasr-script](https://github.com/modelscope/FunASR),默认使用 Fun-ASR-Nano(高质量,中文优化),SenseVoice 可用于快速预览
|
||||
- **按需抽帧** — 基于 ffmpeg 的片段剪辑(`-c copy`)+ 场景变化检测 + 均匀采样,优先使用硬件加速(CUDA/NVDEC)
|
||||
- **产物索引** — SQLite 数据库记录所有转录、剪辑片段和帧图片,避免跨会话重复处理
|
||||
- **视觉分析指引** — 二分查找式帧采样策略;兼容 agent 运行时提供的任何视觉模型
|
||||
@@ -31,13 +31,13 @@
|
||||
|
||||
```bash
|
||||
# 全局安装(跨项目可用)
|
||||
npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -y
|
||||
npx skills add https://git.nite07.com/nite/video-edit-planner-skill.git -g -y
|
||||
|
||||
# 安装到指定 agent
|
||||
npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -a claude-code -y
|
||||
npx skills add https://git.nite07.com/nite/video-edit-planner-skill.git -g -a claude-code -y
|
||||
|
||||
# 列出可用 skill(不安装)
|
||||
npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git --list
|
||||
npx skills add https://git.nite07.com/nite/video-edit-planner-skill.git --list
|
||||
```
|
||||
|
||||
支持 73+ agent 框架,包括 Claude Code、Codex、Cursor、OpenCode 等。
|
||||
@@ -45,21 +45,11 @@ npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git --list
|
||||
**方式二:`git clone`(手动)**
|
||||
|
||||
```bash
|
||||
git clone git@git.nite07.com:nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner
|
||||
git clone https://git.nite07.com/nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner
|
||||
```
|
||||
|
||||
Hermes Agent 用户克隆到 `~/.hermes/skills/media/`。其他 agent 请遵循各自的 skills 目录约定。
|
||||
|
||||
### 首次使用
|
||||
|
||||
转录脚本需要一次性依赖安装:
|
||||
|
||||
```bash
|
||||
cd ~/.hermes/skills/media/video-edit-planner/scripts/transcription && uv sync
|
||||
```
|
||||
|
||||
这会创建一个隔离的 venv,包含 `funasr`、`torch`、`torchaudio`。如果你之前通过 uv 安装过这些包,缓存会被复用——首次成本仅为链接步骤。
|
||||
|
||||
## 工作流程
|
||||
|
||||
```
|
||||
@@ -73,26 +63,6 @@ cd ~/.hermes/skills/media/video-edit-planner/scripts/transcription && uv sync
|
||||
8. 迭代——用户追问,规划逐步细化
|
||||
```
|
||||
|
||||
## 素材搜索(可选)
|
||||
|
||||
规划剪辑时,用户可能需要素材——贴纸、GIF、梗图视频片段、B-roll 等。skill 按需提供素材搜索指引。
|
||||
|
||||
### 素材来源
|
||||
|
||||
| 来源 | 网址 | 内容 | 适用场景 |
|
||||
|---|---|---|---|
|
||||
| 爱给网 | https://www.aigei.com/ | 中文梗图视频片段(热梗,4.2万+),免费下载 | 中文创作者(B站/抖音) |
|
||||
| B站素材酷 | https://cool.bilibili.com/ | 哔哩哔哩平台素材(视频、音频、BGM、模板、贴纸) | B站创作者;大量中文梗图 |
|
||||
| Tenor | https://tenor.com/ | GIF + 贴纸,支持 30+ 语言含中文,免费 API | 快速 GIF/贴纸搜索 |
|
||||
| GIPHY | https://giphy.com/ | 最大 GIF 库,30+ 语言,贴纸频道 | 英文/多语言 GIF 搜索 |
|
||||
| Klipy | https://klipy.com/ | 本地化 GIF/贴纸/片段 API,支持中文 | API 集成搜索,本地化 |
|
||||
|
||||
中文用户优先推荐爱给网和B站素材酷。
|
||||
|
||||
### B站素材酷搜索
|
||||
|
||||
B站素材酷没有内置搜索功能。可以使用 [bcut-resource-search](https://git.nite07.com/nite/bcut-resource-search) 油猴脚本添加搜索功能,或让 agent 直接查询 API。
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
@@ -105,7 +75,7 @@ video-edit-planner/
|
||||
│ │ ├── pyproject.toml
|
||||
│ │ ├── uv.lock
|
||||
│ │ ├── funasr_common.py # 共享:ffprobe、音频提取、模型运行
|
||||
│ │ ├── funasr_nano.py # Fun-ASR-Nano 入口(高质量)
|
||||
│ │ ├── funasr_nano.py # Fun-ASR-Nano 入口(默认,高质量)
|
||||
│ │ ├── funasr_fast.py # SenseVoice 入口(快速预览)
|
||||
│ │ └── funasr_regular.py # Paraformer 入口(对比用)
|
||||
│ ├── frames/
|
||||
|
||||
Reference in New Issue
Block a user