fix(obsidian-kb): fix SKILL.md YAML format and restore files
This commit is contained in:
+5
-204
@@ -1,10 +1,3 @@
|
||||
---
|
||||
name: obsidian-kb
|
||||
description: Detect and process video/article links (Bilibili, YouTube, Zhihu) for Obsidian KB. Auto-trigger on URLs: /kb-add, /kb-process, /kb-inbox, /kb-status.
|
||||
version: 1.0.0
|
||||
author: OpenClaw
|
||||
---
|
||||
|
||||
# SKILL.md - Obsidian KB Skill
|
||||
|
||||
## 元数据
|
||||
@@ -14,203 +7,19 @@ author: OpenClaw
|
||||
- **描述**: 多源内容知识库维护系统,支持长视频分段分析
|
||||
- **作者**: OpenClaw
|
||||
|
||||
## 自动触发规则
|
||||
|
||||
当检测到以下内容时,本技能会自动激活:
|
||||
|
||||
### 触发模式
|
||||
|
||||
1. **B站视频链接**
|
||||
- 完整URL: `https://www.bilibili.com/video/BV*`
|
||||
- 短链接: `https://b23.tv/*` (会提示用户提供完整URL或BV号)
|
||||
- BV号: `BV*` (直接支持)
|
||||
|
||||
2. **YouTube视频链接**
|
||||
- 完整URL: `https://www.youtube.com/watch?v=*`
|
||||
- 短链接: `https://youtu.be/*`
|
||||
|
||||
3. **知乎文章链接**
|
||||
- 专栏文章: `https://zhuanlan.zhihu.com/p/*`
|
||||
- 回答: `https://www.zhihu.com/question/*/answer/*`
|
||||
|
||||
### 自动触发流程
|
||||
|
||||
当用户发送匹配上述模式的链接时:
|
||||
|
||||
1. **检测链接** → 识别内容类型(B站/YouTube/知乎)
|
||||
2. **提取元数据** → 获取标题、作者、时长等信息
|
||||
3. **显示预览** → 向用户展示内容概要
|
||||
4. **询问确认** → "是否添加到收件箱并处理?(y/n)"
|
||||
5. **用户确认后** → 自动执行 `/kb-add` 命令添加内容
|
||||
6. **可选处理** → 根据用户选择,是否立即执行 `/kb-process`
|
||||
|
||||
### 批量处理
|
||||
|
||||
支持一次发送多个链接,系统会:
|
||||
- 检测所有匹配的模式
|
||||
- 显示所有识别到的内容预览
|
||||
- 询问用户是否批量添加
|
||||
- 显示处理进度
|
||||
|
||||
### 短链接友好提示
|
||||
|
||||
检测到短链接时,显示引导信息:
|
||||
|
||||
**单个短链接:**
|
||||
```
|
||||
🔗 检测到短链接
|
||||
|
||||
⚠️ 由于反爬虫保护,短链接无法自动解析
|
||||
|
||||
📍 短链接: https://b23.tv/xxxxx
|
||||
|
||||
📱 手机用户:
|
||||
1. 点击/打开链接
|
||||
2. 在浏览器地址栏复制完整 URL
|
||||
3. 发送给助手
|
||||
|
||||
💻 桌面用户:
|
||||
1. 发送 BV 号(如:BV1jcFqz7EFW)
|
||||
2. 或使用完整 URL
|
||||
|
||||
💡 提示:完整 URL 格式为:https://www.bilibili.com/video/BVxxxxx
|
||||
```
|
||||
|
||||
**多个短链接:**
|
||||
```
|
||||
⚠️ 检测到短链接
|
||||
|
||||
[1] B站短链接: https://b23.tv/abc123
|
||||
需要完整URL或BV号
|
||||
|
||||
[2] bit.ly: https://bit.ly/test
|
||||
需要完整URL
|
||||
|
||||
💡 建议:
|
||||
- 在浏览器打开链接后复制完整URL
|
||||
- 或者直接发送BV号(仅限B站)
|
||||
```
|
||||
|
||||
**技术说明:**
|
||||
- B站短链接(b23.tv)有反爬虫保护,无法直接解析
|
||||
- 本技能使用 `shortlink_resolver.py` 模块检测短链接
|
||||
- 提供 Playwright 可选方案(需额外安装)
|
||||
```bash
|
||||
pip install playwright
|
||||
playwright install chromium
|
||||
```
|
||||
|
||||
## 命令列表
|
||||
|
||||
| 命令 | 描述 | 用法 |
|
||||
|------|------|------|
|
||||
| `/kb-add` | 添加单个视频/文章 | `/kb-add <URL> [--process] [--yes]` |
|
||||
| `/kb-subscribe` | 订阅内容源 | `/kb-subscribe <platform> <type> <id>` |
|
||||
| `/kb-inbox` | 查看收件箱 | `/kb-inbox [--limit N] [--sort score\|date]` |
|
||||
| `/kb-process` | 处理内容 | `/kb-process [content_id\|all]` |
|
||||
| `/kb-skip` | 跳过内容 | `/kb-skip <content_id> [--reason "..."]` |
|
||||
| `/kb-subscribe` | 订阅内容源 | `/kb-subscribe <source>:<type>:<id>` |
|
||||
| `/kb-inbox` | 查看收件箱 | `/kb-inbox [--limit N]` |
|
||||
| `/kb-process` | 处理内容 | `/kb-process [content_id]` |
|
||||
| `/kb-skip` | 跳过内容 | `/kb-skip <content_id>` |
|
||||
| `/kb-status` | 查看状态 | `/kb-status` |
|
||||
| `/kb-search` | 搜索知识库 | `/kb-search <query> [--in-tags]` |
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 方式1: 自动触发(推荐)
|
||||
|
||||
直接发送视频链接或文章链接,技能会自动识别并处理:
|
||||
|
||||
```
|
||||
# B站视频(完整URL)
|
||||
https://www.bilibili.com/video/BV1xx411c7mD
|
||||
|
||||
# B站视频(BV号)
|
||||
BV1xx411c7mD
|
||||
|
||||
# B站短链接(会提示完整URL)
|
||||
https://b23.tv/xxxxx
|
||||
|
||||
# YouTube视频
|
||||
https://www.youtube.com/watch?v=dQw4w9WgXcQ
|
||||
|
||||
# 知乎文章
|
||||
https://zhuanlan.zhihu.com/p/123456789
|
||||
```
|
||||
|
||||
### 启用字幕生成(可选)
|
||||
|
||||
如果视频没有字幕,可以启用本地字幕生成功能:
|
||||
|
||||
```bash
|
||||
# 1. 安装依赖
|
||||
pip install openai-whisper yt-dlp torch
|
||||
|
||||
# 2. 启用配置(编辑 config.yaml)
|
||||
subtitle:
|
||||
enabled: true
|
||||
model: base # 推荐使用 base 模型
|
||||
```
|
||||
|
||||
**说明:**
|
||||
- 使用 Whisper 本地模型,数据不上传,隐私安全
|
||||
- 首次使用会自动下载模型文件(~74MB)
|
||||
- 10分钟视频约需 2-5 分钟处理时间(取决于硬件)
|
||||
- 生成的字幕会自动缓存,重复使用无需重新生成
|
||||
|
||||
**详细文档:** 见 `SUBTITLE_FEATURE.md`
|
||||
|
||||
### 方式2: 使用命令
|
||||
|
||||
显式调用命令添加内容:
|
||||
|
||||
```bash
|
||||
# 添加单个视频
|
||||
/kb-add "https://www.bilibili.com/video/BV1xx411c7mD"
|
||||
|
||||
# 添加并立即处理
|
||||
/kb-add "https://www.bilibili.com/video/BV1xx411c7mD" --process
|
||||
|
||||
# 跳过确认提示
|
||||
/kb-add BV1xx411c7mD --yes
|
||||
```
|
||||
| `/kb-search` | 搜索知识库 | `/kb-search <query>` |
|
||||
|
||||
## 命令详解
|
||||
|
||||
### /kb-add
|
||||
|
||||
快速添加单个视频到收件箱。
|
||||
|
||||
**用法:**
|
||||
```
|
||||
/kb-add BV1xx411c7mD
|
||||
/kb-add "https://www.bilibili.com/video/BV1xx411c7mD"
|
||||
/kb-add "https://www.bilibili.com/video/BV1xx411c7mD" --process
|
||||
/kb-add BV1xx411c7mD --yes
|
||||
```
|
||||
|
||||
**参数:**
|
||||
- `<URL>` - 视频URL或BV号
|
||||
- 完整URL: `https://www.bilibili.com/video/BVxxxxx`
|
||||
- BV号: `BVxxxxx`
|
||||
- 短链接: `https://b23.tv/xxxxx`(显示友好提示)
|
||||
- `--process` - 添加后立即处理
|
||||
- `--yes` - 跳过确认提示
|
||||
|
||||
**输出示例:**
|
||||
```
|
||||
📥 正在添加视频: BV1xx411c7mD
|
||||
→ 标题: Python编程入门教程
|
||||
→ UP主: CodeMaster
|
||||
→ 时长: 3600秒
|
||||
→ 获取字幕... ✅
|
||||
|
||||
✅ 视频已添加到收件箱!
|
||||
Content ID: abc123def456
|
||||
|
||||
💡 使用以下命令处理:
|
||||
python3 src/cli.py process abc123def456
|
||||
或:
|
||||
python3 src/cli.py process all
|
||||
```
|
||||
|
||||
### /kb-subscribe
|
||||
|
||||
订阅一个内容源,支持自动获取更新。
|
||||
@@ -344,14 +153,6 @@ chunking:
|
||||
max_chunk_duration_seconds: 1800 # 最大分段时长
|
||||
long_video_threshold: 1800 # 长视频阈值 (30分钟)
|
||||
|
||||
# 字幕生成配置(新增)
|
||||
subtitle:
|
||||
enabled: false # 是否启用自动生成字幕
|
||||
model: base # Whisper 模型大小: tiny/base/small/medium/large
|
||||
language: null # 语言代码: zh/en/null(自动检测)
|
||||
cache_dir: cache/subtitles # 字幕缓存目录
|
||||
audio_cache_dir: cache/audio # 音频缓存目录
|
||||
|
||||
# 数据源配置
|
||||
sources:
|
||||
bilibili:
|
||||
|
||||
Reference in New Issue
Block a user