knowledge-extension-ecosystem-lsp-code-intelligence

Module Structure

LSP 配置按 source project 解析并冻结，SessionRuntime 再以 execution workspace 创建私有 manager；语言服务器按目标文件扩展名懒启动，语义查询和写后诊断共享同一连接。

Directory Layout

• packages/cli/src/lsp/ — LSP client、Session manager 与 Workspace 资源快照
• packages/cli/src/config/lspSettings.ts — LSP server 配置规范化和硬边界
• packages/cli/src/tools/builtin/lsp/ — ReadOnly LSP 工具与协议结果格式化
• packages/cli/src/ide/ — IDE 检测和 Blade IDE 扩展安装入口
• docs/reference/lsp-session-intelligence.md — Session LSP 行为契约与资格要求

Key Entry Points

• resolveWorkspaceLspResources() in packages/cli/src/lsp/WorkspaceLspResources.ts — 合并用户、项目和插件服务器并冻结快照
• LspSessionManager.query() in packages/cli/src/lsp/LspSessionManager.ts — 执行语义查询
• LspSessionManager.afterToolUse() in packages/cli/src/lsp/LspSessionManager.ts — 写后同步并回注新诊断
• LspClient.start() / LspClient.stop() in packages/cli/src/lsp/LspClient.ts — 管理 stdio JSON-RPC 与 owned process tree
• createLspTool() in packages/cli/src/tools/builtin/lsp/lsp.ts — 将 manager 暴露为统一只读工具

API Surface

Workspace LSP Resources

• resolveWorkspaceLspResources(projectRoot, base) — 合并 Workspace 配置和插件 .lsp.json
• snapshotWorkspaceLspResources(resources) — 规范化、深拷贝并冻结 Session 配置

LspSessionManager

• available — 仅在存在启用服务器、Session 非 ACP remote 且未 dispose 时为真
• query(input, signal) — 路由 definition、references、hover、symbols、implementation、call hierarchy 或 diagnostics
• afterToolUse(toolName, params, result, context) — 同步成功写操作并把新诊断追加到 ToolResult
• getStatus() — 返回服务器状态、重启次数、扩展映射和最近错误
• dispose() — 解除 waiter、发送 shutdown/exit 并回收所有服务器进程

LspClient

• start(options) / initialize(params, timeout, signal) — 建立 stdio transport 与协议握手
• request(method, params, timeout, signal) — 带 JSON-RPC cancellation 和本地 timeout 的请求
• stop(timeout) — 尝试协议关闭后以 owned process tree 作为最终回收边界

Usage Examples

Session 创建私有 Manager (packages/cli/src/agent/runtime/SessionRuntime.ts)

this.lspManager = new LspSessionManager({
  sessionId: this.sessionId,
  workspaceRoot: this.workspaceRoot,
  environment: this.sessionEnvironment,
  servers: this.lspResources.servers,
});