test: 增加路由的集成测试

- 新增多个集成测试，涵盖认证、聊天、知识库和系统路由的API端点
- 更新测试环境变量配置，确保测试凭据的灵活性
- 移除冗余的测试文件，优化测试结构

Author: xerrors

.env.template

@@ -37,3 +37,7 @@ NEO4J_URI=
 NEO4J_USERNAME=
 NEO4J_PASSWORD=
 # endregion neo4j
+
+# Servies
+YUXI_SUPER_ADMIN_NAME=
+YUXI_SUPER_ADMIN_PASSWORD=

AGENTS.md

@@ -5,17 +5,6 @@ Yuxi-Know 是一个基于知识图谱和向量数据库的智能知识库系统
 
 文档中心在 `docs` 文件夹下面。
 
-
-# 核心服务与容器 (Core Services & Containers)
-
-项目使用 Docker Compose 管理多个服务，主要容器名称如下：
-- `api-dev` - FastAPI 后端服务
-- `web-dev` - Vue.js 前端开发服务器
-- `graph` - Neo4j 图数据库
-- `milvus` - 向量数据库，包含 etcd 和 MinIO 依赖
-- `mineru` - 可选的 MinerU OCR 服务（需要 GPU）
-- `paddlex` - 可选的 PaddleX OCR 服务（需要 GPU）
-
 ## 开发与调试工作流 (Development & Debugging Workflow)
 
 本项目完全通过 Docker Compose 进行管理。所有开发和调试都应在运行的容器环境中进行。使用 `docker compose up -d` 命令进行构建和启动。
@@ -32,7 +21,7 @@ Yuxi-Know 是一个基于知识图谱和向量数据库的智能知识库系统
 
 后端开发规范：
 
-- 项目使用 uv 来管理依赖
+- 项目使用 uv 来管理依赖，所以需要使用 uv run 来调试。
 - Python 代码要符合 Python 的规范，尽量使用较新的语法，避免使用旧版本的语法（版本兼容到 3.12+），使用 make lint 检查 lint。使用 make format 来格式化代码。
 
 其他：

Makefile

@@ -1,5 +1,7 @@
 
-.PHONY: start logs
+.PHONY: start stop logs lint format format_diff router-tests
+
+PYTEST_ARGS ?=
 
 start:
 	docker compose up -d
@@ -27,4 +29,7 @@ format:
 	uv run ruff check . --fix
 
 format_diff:
-	uv run ruff format --diff .
+	uv run ruff format --diff .
+
+router-tests:
+	docker compose exec -T api uv run --group test pytest test/api $(PYTEST_ARGS)

docs/changelog/contributing.md

@@ -60,16 +60,29 @@ chore: 构建过程或辅助工具的变动
 
 ### 测试要求
 
-::: info
- 部分测试脚本待补充
+::: tip 测试
+- `make lint` / `make format` 保持代码整洁
+- `cp test/.env.test.example test/.env.test` 配置测试凭据
+- `make router-tests` 运行集成路由测试，支持 `PYTEST_ARGS="-k chat_router"`
+- `uv run --group test pytest test/api` 可直接运行 pytest（容器内）
 :::
 
-- 确保所有测试通过
-- 添加新功能的测试用例
-- 验证现有功能不受影响
-- 测试不同环境下的兼容性
+<details>
+<summary>常用命令</summary>
+
+```bash
+# 全量路由测试
+make router-tests
+
+# 仅运行知识库相关用例
+make router-tests PYTEST_ARGS="-k knowledge_router"
+
+# 不经过 Makefile，直接调用 pytest
+uv run --group test pytest test/api -vv
+```
+
+</details>
 
 ## 许可证
 
 本项目基于 MIT License 开源，贡献的代码将遵循相同的许可证。
-

test/.env.test.example

@@ -5,8 +5,8 @@
 TEST_BASE_URL=http://localhost:5050
 
 # 测试用户凭据
-TEST_USERNAME=zwj
-TEST_PASSWORD=zwj12138
+TEST_USERNAME=
+TEST_PASSWORD=
 
 # 数据库连接（如果需要）
 # DATABASE_URL=sqlite:///test.db