fix(obsidian-kb): fix SKILL.md YAML format and restore files

This commit is contained in:
OpenClaw Agent
2026-02-07 05:50:00 +08:00
parent a0e43a5136
commit 1f76a40d1f
108 changed files with 9321 additions and 2503 deletions
+5 -204
View File
@@ -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: