102 lines
2.8 KiB
Markdown
102 lines
2.8 KiB
Markdown
# SkillBug.md
|
||
|
||
## 问题记录
|
||
|
||
### 2026-02-10: 子代理权限问题
|
||
|
||
**问题：** `sessions_spawn` 调用子代理时返回 `forbidden` 错误。
|
||
|
||
**原因：** OpenClaw 配置中 allowlist 为空，Python 脚本没有权限调用子代理。
|
||
|
||
**解决方案：** 改用 Prompt-based 模式（方案B）。
|
||
|
||
---
|
||
|
||
## 架构重构
|
||
|
||
### 之前（Script-based）
|
||
|
||
```
|
||
kb_workflow.py (Python脚本)
|
||
↓
|
||
sessions_spawn() # ❌ 失败（脚本没有权限）
|
||
```
|
||
|
||
### 之后（Prompt-based）
|
||
|
||
```
|
||
主代理读取 SKILL.md
|
||
↓
|
||
按照指导调用 sessions_spawn # ✅ 成功（主代理有权限）
|
||
```
|
||
|
||
### 文件变更
|
||
|
||
| 文件 | 变更 | 说明 |
|
||
|------|------|------|
|
||
| `SKILL.md` | 重写 | 详细定义 workflow 步骤，主代理直接读取执行 |
|
||
| `kb_workflow.py` | 简化 | 保留为辅助工具函数库（查重、归档、Git） |
|
||
| `skill_main.py` | 简化 | 只做触发检测，返回指导信息 |
|
||
| `SkillBug.md` | 更新 | 记录架构变更 |
|
||
|
||
### SKILL.md 结构
|
||
|
||
```
|
||
1. 触发条件
|
||
2. 步骤 1: 查重
|
||
3. 步骤 2: kb-link-parser
|
||
4. 步骤 3: 元数据技能
|
||
5. 步骤 4: 内容下载
|
||
6. 步骤 5: OCR（30分钟超时）
|
||
7. 步骤 6: 深度分析
|
||
8. 步骤 7: 归档和 Git
|
||
9. 步骤 8: 汇报完成
|
||
10. 目录结构
|
||
11. 支持平台
|
||
12. 注意事项
|
||
```
|
||
|
||
### kb_workflow.py 保留的函数
|
||
|
||
```python
|
||
extract_platform(filename) # 从文件名提取平台
|
||
extract_base_name(filename) # 从文件名提取基础名称
|
||
get_knowledge_base_path() # 获取知识库根目录
|
||
ensure_directories(base_path) # 确保目录存在
|
||
check_duplicate(url) # 查重
|
||
archive_and_git(analyzed_file) # 归档和 Git
|
||
generate_summary(...) # 生成汇报
|
||
```
|
||
|
||
---
|
||
|
||
### 2026-02-12: B站视频下载失败 - 403 Forbidden
|
||
|
||
**问题：** 使用 kb-bilibili-content 下载视频时返回 403 Forbidden 错误。
|
||
|
||
**原因：**
|
||
1. 视频可能需要B站会员权限
|
||
2. 或者需要登录cookie才能下载
|
||
3. 当前未配置 `BILIBILI_COOKIE` 环境变量
|
||
|
||
**复现场景：**
|
||
- 链接：https://www.bilibili.com/video/BV1Z9nXzUEhv
|
||
- 下载命令：`python3 bilibili_content.py --id "BV1Z9nXzUEhv" --type video`
|
||
- 结果：返回403错误页面，文件只有548字节
|
||
|
||
**影响：** 无法进行后续的OCR处理和深度分析
|
||
|
||
**建议解决方案：**
|
||
1. 配置 `BILIBILI_COOKIE` 环境变量
|
||
2. 或提供cookies文件路径
|
||
3. 或跳过OCR步骤，使用元数据+简介进行深度分析
|
||
|
||
**当前进度：**
|
||
- ✅ 步骤1：环境变量检查完成
|
||
- ✅ 步骤2：链接解析成功（bilibili_BV1Z9nXzUEhv）
|
||
- ✅ 步骤3：元数据提取成功（标题：新加坡分区漫游指南...）
|
||
- ❌ 步骤4：视频下载失败（403）
|
||
- ⏸️ 步骤5：OCR处理（阻塞）
|
||
- ⏸️ 步骤6：深度分析（阻塞）
|
||
- ⏸️ 步骤7：归档（阻塞）
|