# LSP 模块 (lsp)

本模块实现了语言服务协议 (Language Server Protocol, LSP) 的客户端功能，允许系统通过集成的编程语言服务器获取代码的语义信息、错误诊断和符号导航。

## 概览

`lsp` 模块的主要职责是：
- 管理多个 LSP 服务器的生命周期（启动、初始化、关闭）。
- 与服务器进行异步 JSON-RPC 通信。
- 提供跨语言的代码智能功能，如：
  - **转到定义 (Go to Definition)**
  - **查找引用 (Find References)**
  - **工作区诊断 (Workspace Diagnostics)**
- 为 AI 提示词 (Prompt) 提供上下文增强，将代码中的实时错误和符号关系反馈给 LLM。

## 关键特性

- **LspManager**: 核心管理类，负责协调不同语言的服务器配置和文档状态。
- **上下文增强 (Context Enrichment)**：定义了 `LspContextEnrichment` 结构，能够将复杂的 LSP 响应（如诊断信息和定义）转换为易于 AI 理解的 Markdown 格式。
- **多服务器支持**：支持根据文件扩展名将请求路由到不同的语言服务器（如 `rust-analyzer`, `pyright` 等）。
- **同步机制**：处理文档的 `didOpen`、`didChange` 和 `didSave` 消息，确保服务器拥有最新的代码视图。

## 实现逻辑

### 核心模块

- **`manager.rs`**: 实现了 `LspManager`。它维护一个服务器池，并提供高层 API 来执行跨服务器的请求。
- **`client.rs`**: 实现底层的 LSP 客户端逻辑，处理基于 `tokio` 的异步 I/O 和 JSON-RPC 消息的分帧与解析。
- **`types.rs`**: 定义了本模块使用的专用数据类型，并对 `lsp-types` 库中的类型进行了简化和包装，以便于内部使用。
- **`error.rs`**: 定义了 LSP 相关的错误处理。

### 工作流程

1. 系统根据配置初始化 `LspManager`。
2. 当打开一个文件时，`LspManager` 启动相应的服务器并发送 `initialize` 请求。
3. `LspManager` 跟踪文档的打开状态，并在内容变化时同步到服务器。
4. 当需要对某个符号进行分析时，调用 `go_to_definition` 等方法，模块负责发送请求并解析返回的 `Location`。
5. 诊断信息异步通过 `textDocument/publishDiagnostics` 通知到达，模块会缓存这些信息供后续查询。

## 使用示例 (内部)

```rust
use lsp::{LspManager, LspServerConfig};

// 配置并初始化管理器
let configs = vec![LspServerConfig {
    name: "rust-analyzer".to_string(),
    command: "rust-analyzer".to_string(),
    ..Default::default()
}];
let manager = LspManager::new(configs)?;

// 获取某个位置的上下文增强信息
let enrichment = manager.context_enrichment(&file_path, position).await?;
println!("{}", enrichment.render_prompt_section());
```