feat(obsidian-kb): 实现短链接解析功能

- 新增 shortlink_resolver.py 模块
  * 检测 B站短链接(b23.tv)和其他短链接服务
  * 提供友好的用户引导信息
  * 支持 Playwright 浏览器自动化解析(可选)

- 集成到 handler.py
  * 短链接自动检测和提示
  * 智能区分短链接和完整 URL

- 更新 add_video.py
  * 支持短链接解析
  * 添加 --playwright 参数启用浏览器解析

- 新增 test_shortlink.py 测试脚本
  * 测试单个短链接检测
  * 测试多个短链接检测
  * 测试混合内容场景
  * 所有测试通过

- 更新文档
  * SKILL.md: 添加短链接说明
  * AUTO_TRIGGER.md: 添加短链接章节
  * obsidian-kb-improvements.md: 标记任务2为已完成

功能特点:
- 方案A(用户引导):已实现并作为默认行为
- 方案B(浏览器自动化):提供 PlaywrightResolver 类,可选使用
- 方案C(代理池):未实现(复杂度高,收益低)

验收标准达成:
✅ 短链接能够友好处理(显示引导信息)
✅ 用户不会感到困惑
✅ 支持 b23.tv 和其他短链接服务(检测)
✅ 集成到 handler.py
✅ 测试各种短链接场景
This commit is contained in:
OpenClaw Agent
2026-02-06 21:22:45 +08:00
parent 7a1ad6088a
commit fbcc3df2cf
7 changed files with 746 additions and 77 deletions
+66 -5
View File
@@ -176,12 +176,73 @@ handler.py 可以通过以下方式集成:
## 后续工作
### 短链接解析(P2 优先级)
### 短链接解析(P2 优先级) ✅ 已完成
当前短链接仅显示提示,下一步可实现:
- 使用浏览器自动化(Playwright)解析短链接
- 实现代理池和请求头伪装
- 缓存解析结果
已完成短链接解析功能(2026-02-06):
#### 已实现功能
1. **短链接检测模块** (`shortlink_resolver.py`)
- 检测 B站短链接(b23.tv)
- 支持其他短链接服务(bit.ly, t.cn, dwz.cn 等)
- 提供友好的用户引导信息
2. **用户引导(方案A)**
- 检测到短链接时显示清晰的操作指南
- 分别针对手机用户和桌面用户提供建议
- 支持单个短链接和多个短链接的不同提示格式
3. **浏览器自动化(方案B - 可选)**
- 提供了 PlaywrightResolver 类
- 需要额外安装 Playwright:
```bash
pip install playwright
playwright install chromium
```
- 可在 `add_video.py` 中使用 `--playwright` 参数启用
4. **集成到现有流程**
- `handler.py` 集成短链接检测
- `add_video.py` 支持短链接解析
- 短链接会优先显示帮助信息,不会自动处理
#### 使用示例
**handler.py 自动触发:**
```bash
python3 handler.py "Check this: https://b23.tv/oLBZZfK"
```
**add_video.py 手动添加:**
```bash
python3 add_video.py "https://b23.tv/oLBZZfK"
python3 add_video.py "https://b23.tv/oLBZZfK" --playwright # 使用浏览器解析
```
**shortlink_resolver.py 独立测试:**
```bash
python3 shortlink_resolver.py "Test link: https://b23.tv/abc"
python3 shortlink_resolver.py "https://b23.tv/abc" --playwright # 浏览器解析
```
#### 文件变更
```
skills/obsidian-kb/
├── SKILL.md [修改] 添加短链接说明
├── handler.py [修改] 集成短链接检测
├── add_video.py [修改] 支持短链接解析
├── shortlink_resolver.py [新增] 短链接解析模块
└── AUTO_TRIGGER.md [修改] 添加短链接章节
```
#### 验收标准
- [x] 短链接能够友好处理(显示引导信息)
- [x] 用户不会感到困惑
- [x] 支持 b23.tv 和其他短链接服务(检测)
- [x] 集成到 handler.py
- [x] 测试各种短链接场景(单个、多个、混合)
### YouTube 和知乎支持(P1 优先级)