degradation.md

# 降级与回退行为

> BM25 由 Phase 0.3 自动安装保证可用，无需降级。
> 本文件仅定义图片处理能力的降级。

---

## 能力分层

只有两层区别，取决于 Agent 是否具备视觉分析能力：

| 能力 | 能做的事 | 不能做的事 |
|------|---------|-----------|
| **无图像分析** | 文本搜索、PDF/PPTX/Excel 文字提取、全文检索 | 架构图/流程图/截图 → 如实标注能力局限 |
| **有图像分析** | 以上全部 + 架构图解析、图片内容理解 | — |

## 缓存与索引清理

BM25 索引和图片分析缓存保存在 skill 工作目录中，不会随原文件删除而自动清除：

| 内容 | 位置 | 如何清理 |
|------|------|---------|
| BM25 索引（含提取文字） | skill 工作目录下的 `.corpus/` | 删除该目录，下次搜索自动重建 |
| 图片分析缓存 | skill 工作目录下的 `cache/` | 删除该目录 |

**快速访问：** 原始文件夹中的 `.shortcut.lnk` 文件指向 skill 工作目录，双击即可进入。

如需完全移除知识库的所有残留数据，请同时删除上述目录。

## 行为规则

- **无图像分析时遇到图片：** 如实告知用户「该文件包含图片，无法自动解读」，基于可提取的文字内容继续回答
- **有图像分析时：** 当前模型自带视觉则执行图片分析；否则跳过并如实告知用户无法解读，基于可提取文字继续