LangBot/tests/unit_tests/COVERAGE_EXCLUSIONS.md

单元测试覆盖率排除说明

排除范围

以下外部适配器模块不纳入测试覆盖目标，因为它们需要实际外部环境才能测试：

1. 消息平台适配器 (platform/sources/)

• 路径: src/langbot/pkg/platform/sources/
• 模块: aiocqhttp, dingtalk, discord, feishu, gestep, kook, lark, slack, telegram, wecom, wechatpv, wechatmp, qqbot
• 排除原因: 需要真实消息平台账号和 webhook 连接，无法纯单元测试
• 测试方式: 需要 mock 平台 API 或集成测试环境
• 状态: 后续可补充 mock 测试

2. LLM Requester (provider/modelmgr/requesters/)

• 路径: src/langbot/pkg/provider/modelmgr/requesters/
• 模块: deepseek, openai, anthropic, gemini, moonshot, ollama, zhipuai 等 20+ 个 requester
• 排除原因: 需要真实 LLM API 密钥和网络请求，涉及付费 API 调用
• 测试方式: 需要 mock HTTP 响应或使用 fake LLM server
• 状态: 后续可补充 mock HTTP 测试

3. Agent Runner (provider/runners/)

• 路径: src/langbot/pkg/provider/runners/
• 模块: cozeapi, difysvapi, n8nsvapi, langflowapi, dashscopeapi, localagent, tboxapi
• 排除原因: 需要真实 Agent 平台（Coze、Dify、n8n 等）的 API 连接
• 测试方式: 需要 mock Agent 平台响应
• 状态: 后续可补充 mock 测试

4. 向量数据库 (vector/vdbs/)

• 路径: src/langbot/pkg/vector/vdbs/
• 模块: chroma, milvus, pgvector, qdrant, seekdb
• 排除原因: 需要真实向量数据库实例运行
• 测试方式: 需要 Docker 启动测试数据库或 mock
• 状态: 后续可补充 mock 测试

---

覆盖率计算（排除外部适配器）

统计方法

# 排除外部适配器后计算覆盖率
pytest tests/unit_tests/ --cov=langbot.pkg \
  --cov-fail-under=0 \
  -o "cov_exclude_patterns=platform/sources/*,provider/modelmgr/requesters/*,provider/runners/*,vector/vdbs/*"

当前覆盖率（排除后）

模块	覆盖率	状态
command	99%	✅ 完成
entity	99%	✅ 完成
vector	82%	✅ 完成
survey	84%	✅ 完成
pipeline	72%	✅ 核心流程
rag	70%	✅ 完成
config	70%	✅ 完成
discover	61%	✅ 完成
telemetry	63%	✅ 完成
storage	58%	✅ 完成
provider	57%	🔄 部分完成
utils	48%	🔄 部分完成
api	34%	🔄 需补充 controller
platform	35%	🔄 需补充 adapter base
core	30%	🔄 需补充 app 启动
plugin	28%	🔄 需补充 handler
persistence	24%	🔄 需补充 mgr

---

后续计划

可补充的 Mock 测试（优先级排序）

1. provider/modelmgr/requesters/ (优先级：中)

   • 使用 httpx mock 测试 API 响应解析
   • 测试重试逻辑、错误处理

2. provider/runners/ (优先级：中)

   • Mock Agent 平台响应
   • 测试 session 管理、错误处理

3. platform/sources/ (优先级：低)

   • Mock 平台 webhook 事件
   • 测试消息解析、事件处理

4. vector/vdbs/ (优先级：低)

   • Mock 向量数据库操作
   • 测试 CRUD、查询逻辑

---

测试文件结构

tests/unit_tests/
├── api/
│   └── service/
│       ├── test_knowledge_service.py  # 22 tests ✅
│       └── ...
├── core/
│   ├── test_taskmgr.py                 # 21 tests ✅
│   ├── test_load_config.py             # 19 tests ✅
│   └── ...
├── plugin/
│   ├── test_connector_static.py        # 8 tests ✅
│   ├── test_connector_pure.py          # 7 tests ✅
│   ├── test_connector_methods.py       # 24 tests ✅
│   └── test_extract_deps.py            # 7 tests ✅
├── rag/
│   ├── test_i18n_conversion.py         # 8 tests ✅
│   ├── test_kbmgr.py                   # 39 tests ✅
│   └── ...
├── survey/
│   └── test_survey_manager.py          # 22 tests ✅
├── telemetry/
│   └── test_telemetry.py               # 14 tests ✅
├── utils/
│   ├── test_platform.py                # 7 tests ✅
│   ├── test_funcschema.py              # 9 tests ✅
│   └── ...
└── persistence/
    ├── test_serialize_model.py         # 6 tests ✅
    ├── test_database_decorator.py      # 7 tests ✅
    └── ...

---

总结

• 总测试数: 1082 passed
• 总体覆盖率: 28.3%
• 核心模块覆盖率: 45.5% (5659/12425 语句) - 排除外部适配器
• 外部适配器覆盖率: 5.6% (535/9483 语句) - 不纳入目标

核心模块覆盖率详情

模块	覆盖率	语句数	说明
command	99%	93	✅ 完成
entity	99%	335	✅ 完成
vector	82%	139	✅ 完成
survey	84%	95	✅ 完成
pipeline	72%	1761	✅ 核心流程
rag	69%	347	✅ 完成
storage	58%	170	✅ 完成
provider	57%	854	🔄 部分完成
telemetry	63%	70	✅ 完成
discover	61%	188	✅ 完成
config	70%	198	✅ 完成
utils	48%	478	🔄 部分完成
api	34%	4061	🔄 需补充 controller
platform	35%	433	🔄 需补充 adapter base
plugin	27%	815	🔄 需补充 handler
core	28%	1289	🔄 需补充 app 启动
persistence	24%	1099	🔄 需补充 mgr

外部适配器测试需要 mock 环境或集成测试，不属于纯单元测试范畴。