Auto backup before evolver run - 2026年 03月 10日 星期二 19:00:50 CST

skills/kb-workflow/SkillBug.md

@@ -0,0 +1,101 @@
+# 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：归档（阻塞）