为 ai-ShaderToy 项目的 .stoy 自定义 shader 描述格式提供 VSCode 语法高亮支持。
功能
外层 DSL 语法高亮
- 关键字：
global_setting、inner_vars、texture、common、pass、init、code - 类型：
float4 - 布尔常量：
true、false - 内置变量：
iResolution、iTime、iTimeDelta、iFrame、iFrameRate、iMouse、iDate、iSampleRate - 配置属性：
filter、wrap、type、format、msaa、vsync、resolution_scale - 实体名称：
pass/texture后面的标识符 - 字符串：
"..."双引号字符串 - 数字：整数和浮点数
- 注释：
--Lua 风格单行注释
嵌入式 HLSL 语法高亮
code [=[ ... ]=] 和 common [=[ ... ]=] 长字符串内部提供 HLSL 语法高亮：
- 复用外部 HLSL 扩展（
source.hlsl）的完整语法规则，安装任意 HLSL 扩展即可获得完整的 HLSL 着色 .stoy内置变量（iTime、iResolution等）优先匹配，在 HLSL 代码中也会特殊高亮- 通过
embeddedLanguages配置，嵌入区域自动适配 HLSL 的括号匹配、注释切换（//）和代码片段 - 如果未安装 HLSL 扩展，内置变量仍然高亮，HLSL 部分退化为纯文本颜色
语言配置
- 括号匹配：
{}、()、[] - 行注释切换：
-- - 自动闭合括号和引号
- 基于花括号的代码折叠
安装方法
方法 1：符号链接（开发推荐）
将插件目录链接到 VSCode 扩展目录：
Windows（管理员权限 CMD）：
mklink /D "%USERPROFILE%\.vscode\extensions\stoy-syntax" "path\to\stoy-vscode-plugin"
macOS / Linux：
ln -s /path/to/stoy-vscode-plugin ~/.vscode/extensions/stoy-syntax
然后重启 VSCode 或执行 Developer: Reload Window。
方法 2：直接复制
将 stoy-vscode-plugin/ 整个目录复制到 VSCode 扩展目录：
- Windows：
%USERPROFILE%\.vscode\extensions\stoy-syntax\ - macOS：
~/.vscode/extensions/stoy-syntax/ - Linux：
~/.vscode/extensions/stoy-syntax/
方法 3：VSIX 打包安装
cd stoy-vscode-plugin
npx @vscode/vsce package
code --install-extension stoy-syntax-1.0.0.vsix
文件格式参考
详见项目文档：
Docs/stoy文件格式设计.md— 格式设计文档Docs/stoy_grammar.bnf— BNF 语法规范assets/stoys/— 示例 .stoy 文件