# 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 技能,大大提升了使用体验。