3.0.0

2025-09-28 10:08:45 +08:00
parent dc713e6893
commit 4385652791
11 changed files with 886 additions and 172 deletions
@@ -1,7 +1,80 @@
-# TSL-Devkit
+# TSL Tools for VSCode

-`tsl`的`vscode`插件工具集
+<p align="left">
+  <strong>强大的 TSL 语言开发工具集</strong><br>
+  为 VSCode 提供完整的 TSL 语言支持
+</p>

- 支持`textMate`语法高亮
- 支持`LSP`补全
+## ✨ 功能特性

+- 🎨 **语法高亮** - 基于 TextMate 语法的智能代码着色
+- 🔧 **语言服务器协议 (LSP)** - 提供智能代码补全、错误检查、跳转定义等功能
+- 📝 **代码片段 (Snippets)** - 快速插入常用代码模板
+
+## 📦 安装方式
+
+### 方式一：通过 VSIX 文件安装（推荐）
+
+直接使用预编译的扩展包：
+
+```bash
+# 命令行安装
+code --install-extension tsl-tools-3.0.0.vsix
+```
+
+或者在 VSCode 中：
+
+1. 打开命令面板 (`Ctrl+Shift+P` / `Cmd+Shift+P`)
+2. 输入 `Install from VSIX`
+3. 选择 `tsl-tools-3.0.0.vsix` 文件
+
+### 方式二：从源码构建
+
+```bash
+# 克隆仓库
+git clone https://git.mytsl.cn/csh/tsl-devkit.git
+cd tsl-devkit
+
+# 安装依赖
+npm install
+
+# 打包扩展
+npx vsce package
+
+# 安装生成的 VSIX 文件
+code --install-extension tsl-tools-3.0.0.vsix
+```
+
+### 方式三：手动安装
+
+将扩展文件夹复制到 VSCode 扩展目录：
+
+| 操作系统 | 扩展目录路径                       |
+| -------- | ---------------------------------- |
+| Windows  | `%USERPROFILE%\.vscode\extensions` |
+| macOS    | `~/.vscode/extensions`             |
+| Linux    | `~/.vscode/extensions`             |
+
+## ⚙️ 配置选项
+
+在 VSCode 设置中配置 TSL 扩展：
+
+### 语言服务器配置
+
+| 配置项 | 类型 | 默认值 | 描述 |
+| --- | --- | --- | --- |
+| `tsl.server.executable` | `string` | `""` | TSL 语言服务器可执行文件路径<br>_留空自动检测_ |
+| `tsl.server.arguments` | `string[]` | `["--log=trace", "--log-stderr"]` | 语言服务器启动参数<br>_使用 `./tsl-server --help` 查看所有选项_ |
+| `tsl.interpreter.executable` | `string` | `""` | TSL 解释器路径<br>_用于识别 funcext 下的 .tsf 文件_ |
+
+### 配置示例
+
+```json
+{
+  "tsl.server.executable": "/usr/local/bin/tsl-server",
+  "tsl.server.arguments": ["--log=info", "--log-stderr"],
+  "tsl.interpreter.executable": "/usr/local/bin/tsl"
+}
+```
+
+> ⚠️ **注意**: `tsl.interpreter.executable` 与服务器参数 `--interpreter=PATH` 冲突，请只使用其中一个