docs: docs on how to install LSP

Author: Hoblovski

README.md

@@ -25,8 +25,6 @@ see [UniAST Specification](docs/uniast-zh.md)
 
 
 # Quick Start
-It is easiest to start with Golang. For other languages, see language specific installations below.
-
 ## Use ABCoder as a MCP server
 
 1. Install ABCoder:
@@ -41,13 +39,15 @@ It is easiest to start with Golang. For other languages, see language specific i
     abcoder parse {language} {repo-path} > xxx.json
     ```
 
-    For example:
+    For example, to parse a Go repository:
 
     ```bash
     git clone https://github.com/cloudwego/localsession.git localsession
     abcoder parse go localsession -o /abcoder-asts/localsession.json
     ```
 
+    To parse repositories in other languages, [install the corresponding langauge server first](./docs/lsp-installation-en.md).
+
 3. Integrate ABCoder's MCP tools into your AI agent.
 
     ```json
@@ -113,49 +113,17 @@ $ exit
 
 - NOTICE: This feature is Work-In-Progress. It only supports code analysis at present.
 
-
 # Supported Languages
 
 ABCoder currently supports the following languages:
 
 | Language | Parser      | Writer      |
 | -------- | ----------- | ----------- |
-| Go       | ✅           | ✅           |
-| Rust     | ✅           | Coming Soon |
-| C        | ✅           | ❌           |
-| Python   | Coming Soon | Coming Soon |
-
-# Language Specific Installations
-## Python
-* Install the language server: a custom pylsp (as a git submodule).
-  You might use conda or venv to keep a separate python package environment.
-```bash
-$ git submodule init
-$ git submodule update
-$ cd pylsp
-$ pip install -e .  # you might do this in a separate conda/venv environment
-$ export PATH=$(realpath ./bin):$PATH
-$ pylsp --version  # verify pylsp installation is successful
-```
-
-* Verify the installation:
-```
-# start from abcoder repository root dir
-$ go build
-$ ./
-```
+| Go       | ✅          | ✅          |
+| Rust     | ✅          | Coming Soon |
+| C        | ✅          | Coming Soon |
+| Python   | ✅          | Coming Soon |
 
-## Rust
-* Install the rust language via [rustup](https://www.rust-lang.org/tools/install).
-* Install the language server: rust-analyzer:
-```bash
-$ rustup component add rust-analyzer
-```
-* Verify installation:
-```bash
-$ go build
-$ ./abcoder parse rust testdata/rust2
-```
 
 # Getting Involved
 

docs/lsp-installation-cn.md

@@ -0,0 +1,44 @@
+# Language server 安装
+为了解析仓库中符号之间的依赖，abcoder parser 需要使用各语言的 language server。
+运行 parser 之前请安装对应的 language server。
+
+语言和 language server 的对应关系如下
+
+| 语言   | Language server              | 可执行文件    |
+| ---    | ---                          | ---           |
+| Go     | 不使用 LSP，使用内置 parser  | /             |
+| Rust   | rust-analyzer                | rust-analyzer |
+| Python | (修改后的) python-lsp-server | pylsp         |
+| C      | clangd-18                    | clangd-18     |
+
+按如下教程完成安装后，在运行 abcoder 前请确保 PATH 中有对应可执行文件
+
+## Rust
+* 先通过 [rustup](https://www.rust-lang.org/tools/install) 安装 Rust 语言
+* 安装 rust-analyzer
+  ```bash
+  $ rustup component add rust-analyzer
+  $ rust-analyzer --version  # 验证安装成功
+  ```
+
+## Python
+* 安装 Python 3.9+
+* 从 git submodule 安装 pylsp
+  ```bash
+  $ git submodule init
+  $ git submodule update
+  $ cd pylsp
+  $ pip install -e .  # 可以考虑在单独的 conda/venv 环境中执行
+  $ export PATH=$(realpath ./bin):$PATH  # 放到 .rc 文件里，或每次运行 abcoder 前都设置一下
+  $ pylsp --version  # 验证安装成功
+  ```
+
+## C
+* ubuntu 24.04 或以后版本: 可以直接从 apt 安装
+  ```bash
+  $ sudo apt install clangd-18
+  ```
+
+* 其他发行版：手动编译、或从 [llvm 官方网站](https://releases.llvm.org/download.html) 下载预编译的版本。
+  clangd 在 clang-tools-extra 中。
+

docs/lsp-installation-en.md

@@ -0,0 +1,43 @@
+# Language Server Installation
+
+To parse dependencies between symbols in a repository, the abcoder parser requires the use of language servers for various languages. Please install the corresponding language server before running the parser.
+
+The mapping between languages and language servers is as follows:
+
+| Language | Language Server                        | Executable      |
+| -------- | -------------------------              | --------------- |
+| Go       | Does not use LSP, uses built-in parser | /               |
+| Rust     | rust-analyzer                          | rust-analyzer   |
+| Python   | (Modified) python-lsp-server           | pylsp           |
+| C        | clangd-18                              | clangd-18       |
+
+Ensure the corresponding executable is in PATH before running abcoder.
+
+## Rust
+* First, install the Rust language via [rustup](https://www.rust-lang.org/tools/install).
+* Install rust-analyzer:
+  ```bash
+  $ rustup component add rust-analyzer
+  $ rust-analyzer --version # Verify successful installation
+  ```
+
+## Python
+* Install Python 3.9+
+* Install pylsp from the git submodule:
+  ```bash
+  $ git submodule init
+  $ git submodule update
+  $ cd pylsp
+  $ pip install -e . # Consider executing in a separate conda/venv environment
+  $ export PATH=$(realpath ./bin):$PATH # Add this to your .rc file, or set it before each abcoder run
+  $ pylsp --version # Verify successful installation
+  ```
+
+## C
+* Ubuntu 24.04 or later: Install directly from apt:
+  ```bash
+  $ sudo apt install clangd-18
+  ```
+
+* Other distributions: Use a manual installation.
+  Or download a pre-compiled version from the [LLVM official website](https://releases.llvm.org/download.html). clangd is in `clang-tools-extra`.