自动同步: 2026-03-17 02:10
This commit is contained in:
@@ -1,39 +1,40 @@
|
||||
# ERRORS.md - 错误记录
|
||||
|
||||
## 2026-03-10: kb-workflow 流程执行不完整
|
||||
## 2026-03-16: rclone sync 覆盖了用户更新
|
||||
|
||||
### 发生了什么
|
||||
用户请求"添加到知识库 + 链接",我启动了 kb-workflow 技能,但两次漏掉步骤:
|
||||
1. 第一次:只做了链接解析、元数据提取、内容提取,漏掉了深度分析
|
||||
2. 第二次:深度分析完成后,漏掉了归档步骤
|
||||
**问题描述**:
|
||||
- `~/work/zq` 已通过 `rclone mount` 挂载,实时同步到 NAS
|
||||
- 我在 18:25 执行了 `rclone sync ~/work/zq/ "nas-webdav:..."`(直接操作远程)
|
||||
- 这绕过了挂载点缓存,覆盖了用户 18:30 在 NAS 上的更新
|
||||
|
||||
### 根本原因
|
||||
1. **没有建立步骤检查清单** - SKILL.md 明确列出了8个步骤,但我没有逐项核对
|
||||
2. **并行子代理导致认知偏差** - 启动3个子代理处理后以为工作结束了
|
||||
3. **过早汇报完成** - 在步骤4完成后就向用户汇报,没有继续后续步骤
|
||||
4. **忘记归档是必须步骤** - 即使分析完成了,归档才是最终目标
|
||||
**根本原因**:
|
||||
- AGENTS.md 中没有明确禁止对已挂载目录使用 rclone sync
|
||||
- 误以为需要手动同步
|
||||
|
||||
### 正确做法
|
||||
```
|
||||
1. 执行技能前,先列出完整步骤清单
|
||||
2. 每完成一步,标记状态 [x]
|
||||
3. 全部完成后,再次核对清单
|
||||
4. 全部 ✅ 才能向用户汇报完成
|
||||
```
|
||||
**教训**:
|
||||
- **禁止对已挂载目录(~/work/zq)使用 rclone sync**
|
||||
- 直接读写挂载点即可,挂载点会自动同步
|
||||
|
||||
### kb-workflow 完整步骤清单(必须全部执行)
|
||||
| 步骤 | 内容 | 状态 |
|
||||
|------|------|------|
|
||||
| 1 | 环境变量检查 | [ ] |
|
||||
| 2 | 链接解析 (kb-link-parser) | [ ] |
|
||||
| 3 | 元数据提取 (kb-xxx-metadata) | [ ] |
|
||||
| 4 | 内容下载/提取 (kb-xxx-content) | [ ] |
|
||||
| 5 | 语音识别(视频才需要)| [ ] 或 [跳过] |
|
||||
| 6 | 深度分析 (kb-deep-analyzer) | [ ] |
|
||||
| 7 | 归档 (kb_workflow.py --archive-file) | [ ] |
|
||||
| 8 | NAS 同步 + 汇报完成 | [ ] |
|
||||
**已修正**:
|
||||
- 更新了 AGENTS.md,添加了明确的禁止规则
|
||||
|
||||
### 如何避免再犯
|
||||
- 每次执行 kb-workflow,必须使用上面的清单逐项核对
|
||||
- 最后一步"归档"没完成,不算完成
|
||||
- 用户问"为什么没XX"时,立即检查是否漏步骤
|
||||
---
|
||||
|
||||
## 2026-03-16: kb-workflow 技能缺少归档步骤
|
||||
|
||||
**问题描述**:
|
||||
- SKILL.md 文档描述了 5 步流程(parse → download → asr → analyze → archive)
|
||||
- 实际 `kb_workflow.py` 只实现了 4 步,缺少 archive 步骤
|
||||
- `KB_ARCHIVE_PATH` 环境变量被定义但未被使用
|
||||
|
||||
**影响**:
|
||||
- 处理后的文件留在 workspace 而非归档到工作区
|
||||
- 需要手动移动文件
|
||||
|
||||
**临时解决方案**:
|
||||
- 手动执行 `cp` 到归档目录(直接操作挂载点 ~/work/zq,不用 rclone sync)
|
||||
|
||||
**根本解决方案**(需修改技能代码):
|
||||
1. 在 pipeline 中添加 ArchiveProcessor
|
||||
2. 读取 `KB_ARCHIVE_PATH` 环境变量
|
||||
3. 按日期创建子目录并移动文件
|
||||
|
||||
Reference in New Issue
Block a user