Update nexus wiki content

wiki/concepts/IncrementalGraphUpdate.md

@@ -0,0 +1,52 @@
+---
+title: "IncrementalGraphUpdate"
+type: concept
+tags: ["LSP", "code-intelligence", "incremental-update", "event-driven", "real-time"]
+sources: ["lsp-index-engineer.md"]
+last_updated: 2026-04-29
+---
+
+## Definition
+增量图谱更新（Incremental Graph Update）是一种通过文件监听器和 Git hooks 实时监听代码变化，仅对受影响的部分图谱进行增量更新而非全量重建的策略，确保图谱始终与代码库保持同步，同时保持 < 100ms 端到端响应时间。
+
+## Core Mechanism
+
+### 触发来源
+1. **文件监听器**（File Watcher）：监听文件系统的 `create/modify/delete` 事件
+2. **Git Hooks**：`pre-commit` / `post-commit` / `post-merge` 钩子检测代码变更
+
+### 增量更新流程
+1. 检测文件变更（新增/修改/删除）
+2. 定位受影响的符号节点和边
+3. 对该文件运行 LSP `textDocument/didChange` 通知
+4. 接收 LSP 的增量语义更新
+5. 更新相关图谱节点和边
+6. 通过 WebSocket 推送图谱差异（Graph Diff）到客户端
+
+### Graph Diff 推送
+```typescript
+interface GraphDiff {
+  added: GraphNode[];
+  removed: GraphNode[];
+  modified: GraphNode[];
+  addedEdges: GraphEdge[];
+  removedEdges: GraphEdge[];
+}
+```
+仅推送差异，不推送全量图谱，实现最小化网络开销。
+
+### 一致性保证
+- **原子性更新**：图谱更新是事务性的，要么全部成功要么全部回滚
+- **乐观锁**：并发更新时使用版本号检测冲突
+- **不变性约束验证**：更新前后验证图谱一致性不变量（符号唯一定义、边引用有效性等）
+
+## Performance Characteristics
+- 文件变更到 WebSocket 推送：< 50ms
+- 单文件增量更新：< 20ms
+- 100k+ 符号规模：仍保持增量更新性能
+
+## Connections
+- [[IncrementalGraphUpdate]] ← is_update_strategy_of ← [[GraphDaemon]]
+- [[IncrementalGraphUpdate]] ← triggered_by ← [[FileWatcher]]
+- [[IncrementalGraphUpdate]] ← streams_via ← [[WebSocket]]
+- [[IncrementalGraphUpdate]] ← replaces ← [[LSIF]]（LSIF 用于预计算，Incremental 用于实时）