自动同步: 2026-03-17 02:10

This commit is contained in:
2026-03-17 02:10:06 +08:00
parent aa29721d99
commit e9e9df0297
58 changed files with 913 additions and 5961 deletions
@@ -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. 按日期创建子目录并移动文件