Auto-sync: 2026-04-21 00:02

wiki/concepts/LSP-Client-Orchestration.md

@@ -0,0 +1,45 @@
+---
+title: "LSP Client Orchestration"
+type: concept
+tags: [lsp, concurrency, architecture]
+last_updated: 2026-04-20
+---
+
+## Definition
+LSP Client Orchestration 是指并发管理多个语言服务器客户端的架构模式，使异构编程语言的代码智能在统一平台协同工作。
+
+## Core Pattern
+```typescript
+class LSPOrchestrator {
+  private clients = new Map<string, LanguageClient>();
+  private capabilities = new Map<string, ServerCapabilities>();
+
+  async initialize(projectRoot: string) {
+    await Promise.all([
+      this.initializeClient('typescript', tsClient),
+      this.initializeClient('php', phpClient),
+      this.initializeClient('go', goClient),
+      this.initializeClient('rust', rustClient),
+      this.initializeClient('python', pyrightClient)
+    ]);
+  }
+
+  async getDefinition(uri: string, position: Position): Promise<Location[]> {
+    const lang = this.detectLanguage(uri);
+    const client = this.clients.get(lang);
+    if (!client || !this.capabilities.get(lang)?.definitionProvider) {
+      return [];
+    }
+    return client.sendRequest('textDocument/definition', { textDocument: { uri }, position });
+  }
+}
+```
+
+## Key Challenges
+- 能力协商：不同语言服务器能力差异巨大，需动态检测
+- 生命周期管理：每个客户端需独立经历 initialize → initialized → shutdown → exit
+- 请求路由：根据文件扩展名路由到正确的语言服务器
+
+## Connections
+- [[LSP (Language Server Protocol)]] ← 基于 ← [[LSP Client Orchestration]]
+- [[graphd]] ← 实现 ← [[LSP Client Orchestration]]