This repository has been archived on 2026-02-15. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
openclaw-skills/skills/obsidian-kb/AUTO_TRIGGER.md
T
OpenClaw Agent 7a1ad6088a feat(obsidian-kb): 实现自动触发机制
- 更新 SKILL.md:添加 frontmatter 元数据和自动触发规则说明
- 创建 handler.py:实现链接检测和预览生成
- 支持多种 URL 模式:B站(完整/BV号/短链接)、YouTube、知乎
- 智能去重避免重复显示
- 短链接显示友好提示
- 支持批量检测多个链接
- 添加 AUTO_TRIGGER.md 实现文档
- 更新任务文件:标记任务1已完成

测试通过:
✅ B站完整 URL、BV号、短链接
✅ YouTube 视频
✅ 知乎文章
✅ 批量检测和去重
2026-02-06 21:05:20 +08:00

196 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# obsidian-kb 自动触发机制
## 概述
已实现 obsidian-kb 技能的自动触发机制,当用户通过 WhatsApp/Telegram 等渠道发送视频或文章链接时,技能会自动识别并提示处理。
## 实现方式
### 1. SKILL.md 更新
添加了 frontmatter 元数据和详细的触发规则说明:
```yaml
---
name: obsidian-kb
description: Automatically detect and process video/article links...
version: 1.0.0
---
```
在文档中添加了:
- 自动触发规则章节
- 触发模式说明
- 自动触发流程
- 批量处理支持
- 短链接友好提示
### 2. Handler 脚本
创建了 `handler.py` 脚本,功能包括:
- **链接检测**: 使用正则表达式匹配多种 URL 模式
- **元数据提取**: 识别平台、内容类型和 ID
- **预览生成**: 格式化显示识别到的内容
- **智能去重**: 避免重复检测相同的链接
- **短链接处理**: 对 b23.tv 等短链接显示友好提示
## 支持的 URL 模式
### B站视频
- 完整 URL: `https://www.bilibili.com/video/BV*`
- 短链接: `https://b23.tv/*`
- BV号: `BV*`
### YouTube 视频
- 完整 URL: `https://www.youtube.com/watch?v=*`
- 短链接: `https://youtu.be/*`
### 知乎文章
- 专栏文章: `https://zhuanlan.zhihu.com/p/*`
- 回答: `https://www.zhihu.com/question/*/answer/*`
## 使用流程
### 自动触发模式(推荐)
1. 用户发送链接
2. 系统自动检测链接
3. 显示内容预览
4. 询问用户确认
5. 用户确认后添加到收件箱
6. 可选:立即处理
### 示例
```
用户: https://www.bilibili.com/video/BV1xx411c7mD
助手: 🔍 检测到内容链接:
📺 [1] B站视频
URL: https://www.bilibili.com/video/BV1xx411c7mD
ID: BV1xx411c7mD
是否添加到收件箱并处理?(y/n)
```
### 短链接示例
```
用户: https://b23.tv/oLBZZfK
助手: 🔍 检测到内容链接:
📺 [1] B站视频
URL: https://b23.tv/oLBZZfK
⚠️ 短链接,需要用户提供完整URL或ID
🔗 检测到短链接
⚠️ 由于反爬虫保护,短链接无法自动解析
📱 手机用户:
1. 打开链接
2. 在浏览器地址栏复制完整 URL
3. 发送给助手
💻 桌面用户:
1. 发送 BV 号(如:BV1jcFqz7EFW)
2. 或使用完整 URL
💡 提示:完整 URL 格式为:https://www.bilibili.com/video/BVxxxxx
其他链接是否立即处理?(y/n)
```
## 批量处理
支持一次发送多个链接:
```
用户: 这几个视频不错:
https://www.bilibili.com/video/BV1xx411c7mD
BV2yy522c8nE
https://www.youtube.com/watch?v=dQw4w9WgXcQ
助手: 🔍 检测到内容链接:
📺 [1] B站视频
URL: https://www.bilibili.com/video/BV1xx411c7mD
ID: BV1xx411c7mD
📺 [2] B站视频
URL: https://www.bilibili.com/video/BV2yy522c8nE
ID: BV2yy522c8nE
▶️ [3] YouTube视频
URL: https://www.youtube.com/watch?v=dQw4w9WgXcQ
ID: dQw4w9WgXcQ
是否将上述 3 个内容添加到收件箱?(y/n)
```
## 测试结果
已测试所有 URL 模式:
✅ B站完整 URL: `https://www.bilibili.com/video/BV1xx411c7mD`
✅ B站 BV号: `BV1jcFqz7EFW`
✅ B站短链接: `https://b23.tv/oLBZZfK` (显示友好提示)
✅ YouTube 视频: `https://www.youtube.com/watch?v=dQw4w9WgXcQ`
✅ 知乎文章: `https://zhuanlan.zhihu.com/p/123456789`
✅ 重复检测: 正确去重,避免重复显示
## 文件变更
```
skills/obsidian-kb/
├── SKILL.md [修改] 添加 frontmatter 和触发规则
├── handler.py [新增] 自动触发处理器
└── AUTO_TRIGGER.md [新增] 本文档
```
## 与 OpenClaw 集成
handler.py 可以通过以下方式集成:
1. **手动调用**: 使用 CLI 测试和调试
```bash
python3 handler.py "text with link"
```
2. **Agent 调用**: AI Agent 在接收到用户消息后,调用 handler 检测链接
3. **插件集成**: 未来可创建 OpenClaw 插件,自动监听消息并触发 handler
## 验收标准
- [x] SKILL.md 添加了触发规则
- [x] Handler 能够检测各种 URL 格式
- [x] 显示友好的预览信息
- [x] 短链接显示友好提示
- [x] 支持批量检测多个链接
- [x] 智能去重避免重复显示
- [x] 所有 URL 模式测试通过
## 后续工作
### 短链接解析(P2 优先级)
当前短链接仅显示提示,下一步可实现:
- 使用浏览器自动化(Playwright)解析短链接
- 实现代理池和请求头伪装
- 缓存解析结果
### YouTube 和知乎支持(P1 优先级)
当前仅 Bilibili 有完整适配器:
- 实现 YouTube 适配器
- 实现知乎适配器
- 添加相应的提取和处理逻辑
## 总结
自动触发机制已基本完成,用户现在可以通过简单的发送链接来触发 obsidian-kb 技能,大大提升了使用体验。