feat: third party lsp support

[fltLi]

概述

本 PR 为 Terre 的脚本编辑器引入第三方语言服务器（LSP）支持。用户可通过简单的启动脚本，将自行实现的 LSP 服务器（不限语言，如 Rust、Node.js 等）接入编辑器，用以增强或替换现有的补全、诊断等语言功能。

背景与动机

Terre 内置的语言服务虽稳定可靠，但其提供的补全、诊断等能力相对基础，难以满足跨文件引用分析、更精准的语义高亮等进阶需求。通过开放 LSP 接入机制，社区成员可自由为 Terre 构建功能更丰富的语言服务。

核心设计

稳定的切换机制

切换 LSP 时，前端会自动保存所选配置并触发页面刷新，以彻底重置所有连接与状态。该设计虽然简洁，但能有效规避复杂重连逻辑可能引入的各类边界问题，保证切换过程的可靠性。刷新后编辑器会自动恢复此前打开的文件，保持工作连续性。

通用请求转发

在第三方模式下，所有非控制类 LSP 请求（如补全、悬停、定义跳转、语义高亮等）均被透明转发至外部 LSP，无需维护显式白名单。这一机制使第三方 LSP 可完整提供其所支持的全部功能，且未来新增的 LSP 方法将自动获得支持，无需修改 Terre 自身代码。

URI 映射

Monaco 编辑器内部使用 inmemory:// 等虚拟 URI 方案，而标准 LSP 协议要求 file:// 格式的真实文件路径。代理层负责两者之间的透明转换，使第三方 LSP 无需关心 URI 格式差异。

动态工作区更新

当用户在 Terre 中切换编辑不同项目时，代理会主动向第三方 LSP 发送工作区变更通知，并传递新的工作区信息，无需用户手动重新加载编辑器。

内置扩展协议

代理层内置了对常见文件操作请求的支持，如 workspace/fs/readFile、readDirectory、exists，使第三方 LSP 能够安全地访问项目文件。所有文件访问均经过严格的路径校验，防止越权访问。

接入方式

要接入自定义 LSP，需完成以下步骤：

1. 在 ~/.webgal_terre/third-party-ls/<服务器名称>/ 目录下放置 start.js 文件。
2. 该文件需导出一个实现以下接口的对象：

interface LspLauncher {
  start(): Promise<{ reader: MessageReader; writer: MessageWriter }>;
  stop?(): Promise<void>;
}

3. 在 Terre 的设置面板中选择对应的服务器，编辑器将自动刷新并连接，随后即可使用该 LSP 提供的各项功能。

第三方开发者仅需掌握标准 LSP 服务器编写方法，并提供一个十余行的启动脚本，而无需深入了解 Terre 内部实现，接入门槛较低。

已有适配器示例

为验证该机制的可行性，我已为 WebGAL 语言服务器项目实现了 Terre 适配器：

• 仓库：https://github.com/fltLi/webgal-lsp/tree/feat/terre-adaptor
• 当前支持语法高亮、补全、诊断、格式化等能力。

实际运行效果如下：

影响范围

本次改动仅针对脚本编辑器（基于 Monaco 的文本编辑区域），图形编辑器及其他模块不受任何影响。在不使用第三方 LSP 的情况下，脚本编辑器的所有行为与之前完全一致。

涉及文件

• 新增 third-party/types.ts 与 third-party/scanner.service.ts（后端）
• 大幅重构 webgalLsp.ts，采用通用转发与动态切换
• 新增 thirdPartyLanguageServer.ts 与 nativeLanguageServer.ts，分离两种模式
• 调整前端 lsp.ts（增加刷新切换机制）、TextEditor.tsx、AppSettingsDialog.tsx

---

此 PR 描述由 AI 生成