996 M2 脚本开发助手 (VS Code 专用扩展) - v1.0.4
专为 996传奇引擎 量身定制的高性能开发辅助插件。基于原生 Rust LSP 语言服务器 (996m2-lsp) 驱动，内存占用极低（仅 10~25MB），响应毫秒级。
核心特性
秒级代码排版与格式化 (Shift+Alt+F)
- 原生集成 LSP
textDocument/formatting 引擎；
- 自动将
[@段落] 标签强制顶格对齐；
#IF、#ACT、#ELSEACT、#SAY、#OR 关键字顶格排齐；- 逻辑块与动作命令自动缩进 4 个空格；
- 自动压缩清理连续多余空行，保持代码清爽规范。
Hero 经典风格高对比度主题 (内置全语言 Dark+ 兼容，Lua 配色绝不丢失)
- 完美复刻 Hero 引擎辅助工具的经典调色盘：
- 粉红高亮：
S$admin, <$USERID>, 转生冲榜 等系统与自定义变量；
- 品红粗体：
<$STR(...)>, <$HUMAN(...)> 取值函数；
- 深红粗体：
[@段落] 与 @标签引用；
- 金黄方括号：
[ 与 ]；
- 亮橙粗体：
#IF, #ACT, #ELSEACT, #CALL, BREAK 预处理关键字；
- 亮蓝粗体：989 条全量 M2 指令（大小写不限）；
- 亮青绿类型：
Integer, String, Int 等数据类型；
- 金黄与浅青：
<Button|...>, <Text|...> 996 UI 富文本控件。
- Lua 完美共存：主题完整内嵌 VS Code 官方 Dark+ 全套语法规则，同时编写 M2 与 Lua 脚本时，Lua 关键字、函数、表名、字符串绝对不丢色！
智能注释切换 (Ctrl+/)
- 按
Ctrl+/ 即可对单行或多行选区一键添加/移除 ; 注释符号。
毫秒级段落标签跳转 (Go to Definition)
- 按住
Ctrl 点击 goto @标签名、NPC 菜单 <文字/@标签> 或头部触发器 (@buy @sell)，直达定义；
- 支持跨文件跳转：智能解析
#CALL [\QuestDiary\子模块.txt] @子段落，自动向上追溯父级 Envir/QuestDiary 目录。
全工程引用查找 (Shift+F12)
- 光标停在任意段落标签上按
Shift+F12，秒级列出整个工程中所有调用该标签的位置。
实时静态代码诊断 (Diagnostics)
- 实时拦截中文全角标点逗号（
， -> ,）；
- 实时拦截命令缺少必填参数；
- 实时拦截悬空跳转不存在的段落；
- 实时拦截无效的
#CALL 脚本路径。
989 条官方 M2 指令全量补全与中文悬停文档
- 输入命令自动联想并生成参数骨架，悬停即看官方详细中文用法。
快捷键速查表
| 快捷键 |
功能说明 |
适用场景 |
Shift + Alt + F |
文档一键格式化 |
自动对齐段落标签与命令缩进 |
Ctrl + / |
行注释 / 反注释 |
快速切换 ; 注释 |
F12 或 Ctrl + 点击 |
跳转到定义 |
段落、NPC菜单、跨文件 #CALL |
Shift + F12 |
查找所有引用 |
查看该段落被何处调用 |
Ctrl + Space |
代码提示与补全 |
989 条命令、@ 标签、#CALL 路径 |
安装方法
- 打开 VS Code。
- 按快捷键
Ctrl+Shift+X 打开扩展面板。
- 点击扩展面板右上角的
... 菜单，选择 “从 VSIX 安装...” (Install from VSIX...)。
- 选择本项目根目录下的
vscode-996m2-helper-1.0.4.vsix。
- 提示安装成功后，选择主题 “996 M2 Hero Style (经典高对比)” 即可享用！
| |
