claude_dev
421b3ada3b
- 连字符扩展：multi-agent → multi agent 提升搜索召回率 - 中文同义词支持：添加中英文混合查询扩展 - Snippet 高亮预留：为 FTS5 snippet 功能预留接口 - YAML 解析增强：支持 HTML 实体解码 - 标签关联维护：自动维护 wiki_page_tags 关联表 - 缓存失效优化：支持智能前缀匹配 - 设计文档更新：汇总近期改动 (v1.3) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
sanguo_llmwiki 测试指南
测试结构
tests/
├── unit/ # 单元测试
│ ├── test_database.py # 数据库层测试
│ └── test_services.py # 服务层测试
└── integration/ # 集成测试
└── test_mcp_tools.py # MCP 工具集成测试
运行测试
运行所有单元测试（默认）
pytest
运行集成测试
需要设置环境变量 RUN_INTEGRATION=1：
RUN_INTEGRATION=1 pytest tests/integration/
运行特定测试
# 运行特定文件
pytest tests/unit/test_database.py
# 运行特定类
pytest tests/unit/test_database.py::TestDatabaseBasics
# 运行特定测试方法
pytest tests/unit/test_database.py::TestDatabaseBasics::test_upsert_and_get_page
生成覆盖率报告
pytest --cov=mcp_server --cov-report=html
覆盖率报告将生成在 htmlcov/ 目录。
运行并显示详细输出
pytest -v --tb=long
测试标记
unit: 单元测试（不需要外部依赖）integration: 集成测试（需要RUN_INTEGRATION=1）e2e: 端到端测试（需要完整的 MCP 环境）slow: 慢速测试
按标记运行
# 只运行单元测试
pytest -m unit
# 跳过慢速测试
pytest -m "not slow"
环境变量
| 变量 | 说明 | 默认值 |
|---|---|---|
RUN_INTEGRATION |
启用集成测试 | 未设置 |
WIKI_VAULT_PATH |
Wiki vault 路径 | /Volumes/KnowledgeBase/wiki-vault |
WIKI_INDEX_PATH |
索引文件路径 | ~/.sanguo-llmwiki/index.db |
编写新测试
- 单元测试放在
tests/unit/ - 集成测试放在
tests/integration/ - 使用适当的 pytest 标记
- 测试文件名以
test_开头 - 测试类以
Test开头 - 测试方法以
test_开头
单元测试模板
"""测试模块描述"""
import pytest
from mcp_server.module import ClassToTest
@pytest.fixture
def setup():
"""测试fixture"""
obj = ClassToTest()
yield obj
# 清理（如果需要）
class TestClassToTest:
"""类测试"""
@pytest.mark.asyncio
async def test_method(self, setup):
"""测试方法"""
result = await setup.method()
assert result == expected
集成测试模板
"""集成测试描述"""
import pytest
pytestmark = pytest.mark.skipif(
not os.environ.get("RUN_INTEGRATION"),
reason="需要 RUN_INTEGRATION=1"
)
@pytest.mark.asyncio
async def test_integration_flow():
"""测试集成流程"""
# 测试代码
assert True