feat: 添加 UserScript 元数据语义高亮和诊断功能 (#17)

* feat: 添加 UserScript 元数据语义高亮和诊断功能

- 实现语义高亮支持，高亮元数据块的键名和键值
- 添加元数据键名验证，检测拼写错误并提供智能建议
- 支持快速修复无效的元数据键名（如 @Nmae → @name）
- 添加语义高亮启用提示，引导用户获得更好的体验
- 新增 highlight 目录，统一管理高亮相关功能

* fix: 修复 Levenshtein 距离算法错误并移除重复的元数据键名

- 修正 Levenshtein 距离计算中删除操作的索引错误（matrix[i - 1][j] + 1）
- 移除 VALID_META_KEYS 中重复的 grant 和 noframes 键名

* 添加元素和修复带-带匹配问题

---------

Co-authored-by: 冰冻大西瓜 <1003582810@qq.com>
Co-authored-by: 王一之 <yz@ggnb.top>

Author: 3 people

package.json

@@ -30,6 +30,16 @@
         "path": "./snippets/scriptcat.json"
       }
     ],
+    "semanticTokenScopes": [
+      {
+        "language": "javascript",
+        "scopes": {
+          "metadata": ["markup.bold"],
+          "metaKey": ["entity.name.function", "keyword.control"],
+          "metaValue": ["string"]
+        }
+      }
+    ],
     "commands": [
       {
         "command": "scriptcat.target",

src/extension.ts

@@ -1,6 +1,9 @@
 import * as vscode from "vscode";
 import { metaProvideHover } from "./provide";
 import { Synchronizer } from "./sync";
+import { registerUserScriptHighlighter } from "./highlight/userScriptHighlighter";
+import { checkAndPromptSemanticHighlighting } from "./highlight/semanticHighlighting";
+import { registerUserScriptDiagnostics } from "./highlight/userScriptDiagnostics";
 import { existsSync, fstat } from "fs";
 import "fs";
 
@@ -45,6 +48,15 @@ export function activate(context: vscode.ExtensionContext) {
     }
   });
 
+  // 注册 UserScript 元数据高亮
+  context.subscriptions.push(registerUserScriptHighlighter());
+
+  // 注册 UserScript 元数据诊断
+  context.subscriptions.push(...registerUserScriptDiagnostics());
+
+  // 检查并提示用户启用语义高亮
+  checkAndPromptSemanticHighlighting();
+
   context.subscriptions.push(
     vscode.commands.registerCommand(signatureFileCommand, () => {
       const options: vscode.OpenDialogOptions = {

src/highlight/semanticHighlighting.ts

@@ -0,0 +1,40 @@
+import * as vscode from "vscode";
+
+const SEMANTIC_HIGHLIGHTING_CONFIG_KEY = "editor.semanticHighlighting.enabled";
+const PROMPT_CONFIG_KEY = "scriptcat.promptSemanticHighlighting";
+
+/**
+ * 检查语义高亮是否启用，如果未启用则提示用户
+ */
+export async function checkAndPromptSemanticHighlighting(): Promise<void> {
+  const config = vscode.workspace.getConfiguration();
+  const semanticHighlighting = config.get(SEMANTIC_HIGHLIGHTING_CONFIG_KEY);
+  const shouldPrompt = config.get<boolean>(PROMPT_CONFIG_KEY, true);
+
+  // 如果用户在设置中禁用了提示，则直接返回
+  if (!shouldPrompt) {
+    return;
+  }
+
+  // 如果已经启用，则直接返回
+  if (semanticHighlighting === true) {
+    return;
+  }
+
+  // 提示用户启用语义高亮
+  const action = await vscode.window.showInformationMessage(
+    "ScriptCat 建议启用语义高亮以获得更好的 UserScript 元数据高亮体验",
+    "立即启用",
+    "不再提示"
+  );
+
+  if (action === "立即启用") {
+    await config.update(SEMANTIC_HIGHLIGHTING_CONFIG_KEY, true, true);
+    vscode.window.showInformationMessage("语义高亮已启用！");
+  } else if (action === "不再提示") {
+    await config.update(PROMPT_CONFIG_KEY, false, true);
+    vscode.window.showInformationMessage(
+      "您可以随时在设置中搜索 Semantic Highlighting 为 true 来开启语义高亮功能。"
+    );
+  }
+}