# 其他配置

本文档介绍 Yuxi 的其他配置选项，包括内容安全、网页搜索和服务端口等。

## 内容安全

系统内置内容审查机制，帮助保障服务内容的合规性。

### 启用方式

在「系统设置」→「基本设置」页面中配置，可选择启用关键词过滤和 LLM 内容审查。

### 检测流程

系统会在以下时机进行检测：

1. **用户输入检测**：接收到用户消息后立即检测
2. **流式输出检测**：实时检测输出的关键词（仅关键词模式）
3. **输出完成检测**：流式输出结束后进行全面检测

### 检测模式

**关键词检测**

敏感词库位于 `backend/package/yuxi/config/static/bad_keywords.txt`，每行一个关键词。修改后实时生效，无需重启服务。

**LLM 检测**

使用大模型对内容进行审查，可以更好地识别提示词注入等复杂问题，但会增加响应延迟。

::: warning 性能考虑
LLM 检测会增加用户交互的延迟，请根据实际需求选择是否启用。
:::

## 网页搜索

系统集成了 Tavily 联网搜索能力，让大模型能够获取实时网页信息。

### 配置步骤

1. 访问 [Tavily 官网](https://app.tavily.com/) 注册并创建 API Key
2. 在 `.env` 文件中添加：
   ```env
   TAVILY_API_KEY=sk-xxxxxxxxxxxxxxxx
   ```
3. 重启服务：
   ```bash
   docker compose up -d api-dev web-dev
   ```

### 使用方式

配置完成后，在智能体的工具配置区域会看到 Tavily 搜索工具。模型会自动判断何时需要调用搜索来获取最新信息。

如需关闭，删除或清空 `TAVILY_API_KEY` 后重启服务即可。

## 服务端口

系统各服务通过以下端口提供访问：

| 端口 | 服务 | 说明 |
|------|------|------|
| 5173 | Web 前端 | 用户界面 |
| 5050 | API 后端 | 核心服务接口 |
| 7474 | Neo4j HTTP | 图数据库管理界面 |
| 7687 | Neo4j Bolt | 图数据库连接 |
| 9000/9001 | MinIO | 对象存储 |
| 19530/9091 | Milvus | 向量数据库 |
| 5432 | PostgreSQL | 业务数据库 |

### 可选服务端口

| 端口 | 服务 | 说明 |
|------|------|------|
| 30000 | MinerU | PDF 解析服务 |
| 8080 | PP-Structure-V3 | OCR 服务 |
| 8081 | vLLM | 本地推理服务 |

### 快速访问

- Web 界面：http://localhost:5173
- API 文档：http://localhost:5050/docs
- Neo4j 管理：http://localhost:7474
