---
title: "LSP/Index Engineer"
type: source
tags: [agent, lsp, code-intelligence]
date: 2026-04-20
---

## Source File
- [[raw/Agent/agency-agents/specialized/lsp-index-engineer.md]]

## Summary
- 核心主题：LSP/Index Engineer 智能体角色定义，专注于语言服务器协议（LSP）客户端编排和统一代码语义图谱构建
- 问题域：异构语言服务器整合、实时语义索引构建、跨语言代码智能查询
- 方法/机制：通过 LSP 客户端编排将 TypeScript/PHP/Go/Rust/Python 等语言服务器响应转换为统一图谱，使用 WebSocket 实现实时增量更新
- 结论/价值：实现 <500ms 的定义/引用/悬停响应，支持 100k+ 符号规模，构建统一代码智能基础设施

## Key Claims
- graphd LSP Aggregator 通过并发编排多个 LSP 客户端实现异构语言服务器统一管理
- 语义索引基础设施（nav.index.jsonl、LSIF）实现代码导航和文档的持久化
- 增量更新机制通过文件监视器和 git hooks 实现图谱实时同步
- 性能目标：/graph 端点 <100ms（<10k 节点），/nav/:symId <20ms（缓存）或 <60ms（未缓存）

## Key Quotes
> "You transform heterogeneous language servers into a cohesive semantic graph that powers immersive code visualization."

> "Every symbol must have exactly one definition node" — 图谱一致性要求

> "Handle 25k+ symbols without degradation (target: 100k symbols at 60fps)" — 性能目标

## Key Concepts
- [[LSP (Language Server Protocol)]]：语言服务器协议，为编辑器提供编程语言智能功能的通信协议
- [[Semantic Index]]：语义索引，存储符号定义、引用和悬停文档的数据结构
- [[Graph Construction Pipeline]]：图谱构建管道，从 LSP 响应提取节点和边构建统一语义图
- [[Incremental Updates]]：增量更新机制，通过文件监视器实现图谱实时同步
- [[LSIF (Language Server Index Format)]]：语言服务器索引格式，用于预计算语义数据的导入/导出
- [[LSP Client Orchestration]]：LSP 客户端编排，并发管理多个语言服务器客户端

## Key Entities
- [[graphd]]：核心 LSP 聚合守护进程，管理多语言 LSP 客户端和图谱状态
- [[TypeScript Language Server]]：TypeScript 语言服务器，提供 TS/JS 代码智能
- [[Intelephense]]：PHP 语言服务器，提供 PHP 代码智能
- [[gopls]]：Go 语言服务器，提供 Go 代码智能
- [[rust-analyzer]]：Rust 语言服务器，提供 Rust 代码智能
- [[pyright]]：Python 语言服务器，提供 Python 代码智能

## Connections
- [[LSP (Language Server Protocol)]] ← enables ← [[graphd]]
- [[Semantic Index]] ← powers ← [[Code Navigation]]
- [[graphd]] ← depends_on ← [[LSP Client Orchestration]]
- [[Incremental Updates]] ← implements ← [[File Watcher]] + [[Git Hooks]]

## Contradictions
- 无冲突

## Technical Architecture

### Graph Node Schema
- `file:<path>`：文件节点
- `sym:<name>`：符号节点（class/function/variable/type）

### Graph Edge Types
- `contains`：文件包含符号
- `imports`：导入关系
- `extends/implements`：继承/实现
- `calls`：函数调用
- `references`：符号引用

### Navigation Index Format (nav.index.jsonl)
```jsonl
{"symId":"sym:AppController","def":{"uri":"file:///src/app.php","l":10,"c":6},"refs":[...],"hover":{...}}
```

## Performance Contracts
| Endpoint | Target Latency | Condition |
|----------|---------------|-----------|
| /graph | <100ms | <10k nodes |
| /nav/:symId | <20ms | cached |
| /nav/:symId | <60ms | uncached |
| WebSocket events | <50ms | latency |
| Memory | <500MB | typical project |