claudecode/crates/lsp
fengmengqi d8d77824f4 feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力
将 claw-code/rust/crates 的完整实现合并到主 workspace,涵盖
  9 个 crate 的更新与 2 个新 crate 的引入。

  API 层:
  - 用原生 Anthropic 客户端(anthropic.rs)替换 claw_provider,
    新增 prompt cache 减少重复请求开销
  - 新增 HTTP 客户端构建器统一代理配置,OpenAI 兼容端增加
    DashScope/Qwen 支持与抖动重试
  - MessageRequest 扩展 temperature/top_p 等模型调参字段
  - SSE 解析器增加 provider 上下文感知的错误信息

  运行时(~11,000 行新增):
  - 新增 bash 命令安全校验、分支锁碰撞检测、配置文件校验
  - 新增会话存储与控制面、MCP 生命周期状态机与服务端实现
  - 新增权限执行引擎、策略引擎、插件生命周期管理
  - 新增 worker 启动编排、任务/定时任务注册表、信任解析器
  - 保留 Windows cmd /C fallback

  命令/插件/工具:
  - commands 大幅重写,扩展 sandbox、doctor、plan 等 slash 命令
  - plugins 新增 PostToolUseFailure hook 与宽容加载机制
  - tools 新增 PDF 提取与 lane 补全工具

  新增 crate:mock-anthropic-service(测试)、telemetry(遥测)

  适配 claw-cli/server:ClawApiClient→AnthropicClient 重命名,
  SlashCommand::parse 返回 Result,移除 session 级 Thinking 变体,
  TokenUsage/ConversationMessage 补充序列化支持
2026-04-13 14:39:17 +08:00
..
src feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力 2026-04-13 14:39:17 +08:00
Cargo.toml feat: Claw Code 重命名及架构升级 2026-04-02 15:14:31 +08:00
README.md feat: 添加 Web 前端及服务端 SSE 流式支持,扩展多模型兼容 2026-04-10 16:29:27 +08:00

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 等)。
  • 同步机制:处理文档的 didOpendidChangedidSave 消息,确保服务器拥有最新的代码视图。

实现逻辑

核心模块

  • 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 通知到达,模块会缓存这些信息供后续查询。

使用示例 (内部)

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());