WebGAL LSP

WebGAL 语言基础设施。

🚧 项目仍在开发中，欢迎试用和反馈。

• 语言解析：提供 WebGAL 语法解析与数据结构支持
• 自动补全：语句、参数、资源路径、标识符等智能提示 -> 详细说明
• 静态检查：语法、资源依赖、格式规范等实时检查 -> 详细说明
• 动态诊断¹：通过后台模拟脚本执行，检测逻辑问题 -> 详细说明
• 语义高亮：语句类型、参数、注释等色彩渲染
• 悬浮文档：悬停查看语句、参数的详细说明 -> 详细说明
• 代码编辑：提供轻量级编辑器，集成上述语言服务 -> 详细说明
• 快照打包：生成 WebGAL 项目精简压缩包，便于归档和传播

核心语言服务，提供 WebGAL 语法解析、自动补全、静态检查、语义高亮等 LSP 能力。

cargo build -p webgal-language-server

语言服务器支持两种通信模式，根据客户端类型选择：

• 💻 stdio 模式（默认）：适用于 VS Code 等桌面客户端。

  cargo run -p webgal-language-server

• 🌐 WebSocket 模式：适用于浏览器环境（如 Monaco）。

  cargo run -p webgal-language-server -- --port 8765

  服务器将监听 ws://127.0.0.1:8765，接受一个 WebSocket 连接。

日志输出到 stderr，所有参数均为可选：

• 日志：--log-level <LEVEL>（error/warn/info/debug/trace，默认 error），--log-format <FORMAT>（plain/text/json，默认 plain）
• 功能开关：--disable-{diagnose,hover,highlight,complete,format} 可分别禁用对应能力（默认全部开启）
• 诊断调优：--diagnostic-delay <MS>（批处理延迟，默认 500ms），--diagnostic-timeout <MS>（生成超时，默认 10000ms）

示例：

cargo run -p webgal-language-server -- --log-level debug --disable-hover --disable-complete --diagnostic-delay 300

基于 Tauri 2 + React + Monaco + Fluent UI 的 WebGAL 桌面场景编辑器，内置上述语言服务与实时预览，开箱即用。

在 VS Code 中打开项目根目录，选择 Launch Ink Editor 启动配置（按 F5，或运行同名任务）即可启动开发模式（首次运行会自动安装依赖并编译）。

编辑器特性：

• 多标签场景编辑、自动保存、最近项目；
• 内置 LSP：语义高亮、自动补全、诊断、格式化、悬浮文档等；
• 实时预览、资源浏览、深浅色主题与编辑器设置；
• 快照打包：一键生成精简压缩包，并可实时查看进度。

⚠️ 该扩展仅用于调试，不会发布到扩展市场。

扩展源码位于 packages/vscode-extension。

1. 安装依赖：

   cd packages/vscode-extension
   npm install

2. 在 VS Code 中打开项目根目录，按 F5 并选择 Launch VSCode Extension 调试配置，将自动编译语言服务器并启动扩展开发窗口。

WebGAL 解析器的在线演示工具，支持实时解析和语义高亮。

• 在线预览：https://fltli.github.io/webgal-lsp
• 本地运行：在 VS Code 中打开项目根目录，按 F5 并选择 Launch Parse Playground 调试配置，将自动编译运行并打开网页。

将开发中的 WebGAL 项目打包为精简压缩包：游戏资源仅打包被调用的部分（从初始场景递归收集语句与配置引用的资源，并展开立绘关联资产），其余资源全部保留。可通过命令行或 Ink 编辑器使用。

cargo build -p webgal-snapshot --release

# 打包一个或多个项目，默认输出至各项目目录下的 <项目名>.zip
webgal-snapshot [选项] <项目路径>...

常用选项（完整参数见 webgal-snapshot --help）：

• -o <输出.zip>：自定义输出压缩包路径
• -c <方式>：压缩方式（stored / deflated / deflate64 / bzip2 / zstd / lzma / ppmd）
• -f：跟随符号链接遍历目录

Ink 编辑器顶栏的快照打包按钮同样提供该功能（选择输出位置后实时显示进度与结果）。

• Code: MPL-2.0, 2026, fltLi
• Built-in documentation: MPL-2.0, derived from OpenWebGAL/WebGAL_Doc, located at crates/webgal-language-service/data/document.json