RunLogosIDE Partial 语言服务安装指南
当 RunLogos 的源码编辑区显示 IDE Partial 时，通常表示 TypeScript / JavaScript 或部分语言服务已经可用，但某些项目语言的 LSP 还没有安装、没有被 GUI 进程看到，或已经检测到但尚未启动。这个页面用于安装和排查 Python、Go、Rust、Java 的语言服务。
什么是 IDE Partial
RunLogos 会根据项目文件自动检测语言服务，并在 IDE 状态栏展示总体状态：
| 状态 | 含义 |
|---|---|
IDE Ready | 当前项目需要的语言服务已经启动，可提供诊断、补全、跳转等能力 |
IDE Partial | 部分语言服务可用，部分语言服务缺失、未启动或需要重新检测 |
IDE Offline | 当前没有可用语言服务，或状态查询失败 |
单个语言会显示更细的状态：
| 状态 | 含义 | 下一步 |
|---|---|---|
ready | 语言服务已启动并可处理请求 | 直接使用 |
available | 已检测到语言服务器，但当前尚未启动 | 点击 Restart / Start |
unavailable | 没有检测到对应语言服务器 | 先安装运行时或 LSP，再点击 重新检测 |
RunLogos 内置面板只保留短说明、当前诊断和快速动作；即使离线时仍能让用户知道下一步。官网文档负责承载完整安装步骤、分平台命令、常见 PATH 和错误排查。
Python / Pyright
Python 语义能力由 Pyright 提供。RunLogos 检测的是 pyright-langserver 可执行文件。
| 项目 | 说明 |
|---|---|
| 前置运行时 | Node.js / npm |
| LSP | pyright-langserver |
| RunLogos 支持动作 | 复制命令、重新检测、Restart / Start |
| 常见 macOS 路径 | /opt/homebrew/bin、/usr/local/bin |
| 常见 Windows 路径 | %APPDATA%\npm |
macOS：
npm install -g pyright
pyright-langserver --version
Windows：
npm install -g pyright
pyright-langserver --version
如果安装后仍显示 available，先点击 Restart / Start。如果仍显示 unavailable，确认 npm config get prefix 对应的全局 bin 目录已经加入系统 PATH，并重新打开 RunLogos。
Go / gopls
Go 语义能力由 gopls 提供。安装前需要先安装 Go toolchain。
| 项目 | 说明 |
|---|---|
| 前置运行时 | Go toolchain |
| LSP | gopls |
| RunLogos 支持动作 | 复制命令、重新检测、Restart / Start |
| 常见 macOS 路径 | ~/go/bin |
| 常见 Windows 路径 | %USERPROFILE%\go\bin |
macOS：
go version
go install golang.org/x/tools/gopls@latest
gopls version
Windows：
go version
go install golang.org/x/tools/gopls@latest
gopls version
如果缺少 go，先安装 Go 并确认 go version 可用。如果缺少 gopls，运行安装命令后把 ~/go/bin 或 %USERPROFILE%\go\bin 加入 PATH，再点击 重新检测。
Rust / rust-analyzer
Rust 语义能力由 rust-analyzer 提供。推荐通过 rustup 安装组件。
| 项目 | 说明 |
|---|---|
| 前置运行时 | rustup / Rust toolchain |
| LSP | rust-analyzer |
| RunLogos 支持动作 | 复制命令、重新检测、Restart / Start |
| 常见 macOS 路径 | ~/.cargo/bin |
| 常见 Windows 路径 | %USERPROFILE%\.cargo\bin |
macOS：
rustup --version
rustup component add rust-analyzer
rust-analyzer --version
Windows：
rustup --version
rustup component add rust-analyzer
rust-analyzer --version
如果缺少 rustup，先安装 Rust toolchain。若组件不可用，确认当前 toolchain 已安装并处于可用状态，再运行 rustup update 后重试。
Java / Eclipse JDT LS
Java 语义能力由 Eclipse JDT LS 提供。RunLogos 当前不自动安装 JDT LS，只提供指南、复制命令和路径说明。
| 项目 | 说明 |
|---|---|
| 前置运行时 | JDK |
| LSP | Eclipse JDT LS / jdtls |
| RunLogos 支持动作 | 复制命令、重新检测、Restart / Start |
| macOS 建议 | Homebrew 安装，或手动安装 JDK + JDT LS |
| Windows 建议 | 手动安装 JDK 和 JDT LS，并把 jdtls 所在目录加入 PATH |
macOS：
java -version
jdtls --version
Windows：
java -version
jdtls --version
如果 jdtls --version 不可用，请先安装 JDK，再安装 Eclipse JDT LS，并把 jdtls 所在目录加入 PATH。JDT LS 会使用 workspace / cache 目录保存索引和项目状态，这些目录不需要提交到仓库。
安装后如何让 RunLogos 重新检测
按这个顺序处理：
- 在终端验证对应命令可用，例如
gopls version、pyright-langserver --version、rust-analyzer --version、jdtls --version。 - 回到 RunLogos 的 IDE Language Services 面板，点击
重新检测。 - 对状态为
available的语言点击Restart/Start。 - 如果仍不可见，完全退出并重新打开 RunLogos，让 GUI 进程读取新的 PATH。
- macOS 检查
/opt/homebrew/bin、/usr/local/bin、~/go/bin、~/.cargo/bin。 - Windows 检查
%APPDATA%\npm、%USERPROFILE%\go\bin、%USERPROFILE%\.cargo\bin。
不要把 License Key、项目源码、Prompt、环境变量密钥或私有仓库内容发给 AI 或写入仓库。排查语言服务时只需要确认命令、版本、PATH 和 RunLogos 状态。
常见错误
| 错误 | 含义 | 处理方式 |
|---|---|---|
package-manager-missing | 缺少 npm、go、rustup 等安装工具 | 先安装对应运行时，再重试安装 LSP |
network-unavailable | 包管理器无法下载依赖 | 检查网络、代理或镜像源 |
permission-denied | 全局安装目录没有写入权限 | 切换用户级安装目录，或修复目录权限 |
post-detect-failed | 安装后重新检测仍失败 | 检查 PATH 是否被 GUI 进程读取，重新打开 RunLogos |
lsp-start-failed | LSP 可执行文件存在但启动失败 | 在终端运行版本命令，确认运行时和依赖完整 |
LSP exited with code 127 | 进程启动时找不到二进制或依赖 | 优先检查 PATH、运行时安装和 shell / GUI 环境差异 |
如果终端里命令可用，但 RunLogos 仍不可见，通常是 GUI PATH 与终端 PATH 不一致。把对应 bin 目录加入系统级 PATH 后，完全退出并重新打开 RunLogos。