feat: 添加油猴API的TypeScript类型定义支持

1. 安装@types/tampermonkey包提供官方类型定义\n2. 创建src/types/tampermonkey.d.ts实现自定义类型扩展\n3. 更新tsconfig.json，添加typeRoots配置\n4. 更新userscript-headers.js，添加必要的@grant声明

Author: CC11001100

package-lock.json

@@ -14,6 +14,7 @@
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^22.13.1",
+    "@types/tampermonkey": "^5.0.4",
     "@types/webpack": "^5.28.5",
     "ts-loader": "^9.5.2",
     "typescript": "^5.7.3",

package.json

@@ -0,0 +1,78 @@
+# 油猴API的TypeScript类型定义
+
+本项目已集成了油猴API的TypeScript类型定义，使您能够在开发过程中获得完整的类型检查和智能提示支持。
+
+## 类型定义来源
+
+类型定义通过以下方式提供：
+
+1. `@types/tampermonkey` npm包 - 提供了官方的油猴API类型定义
+2. 本地类型扩展 - 在`src/types/tampermonkey.d.ts`文件中
+
+## 如何使用
+
+### 1. 在代码中使用油猴API
+
+您可以直接在代码中使用油猴API，TypeScript将自动识别这些API的类型：
+
+```typescript
+// 存储数据
+GM_setValue('key', 'value');
+
+// 读取数据
+const value = GM_getValue('key', 'default');
+
+// 注册菜单
+GM_registerMenuCommand('菜单项', () => {
+  console.log('点击了菜单项');
+});
+
+// 发送XHR请求
+GM_xmlhttpRequest({
+  method: 'GET',
+  url: 'https://example.com',
+  onload: (response) => {
+    console.log(response.responseText);
+  }
+});
+```
+
+### 2. 使用Promise风格的API (GM.*)
+
+如果您更喜欢使用Promise风格的API，可以这样使用：
+
+```typescript
+// 存储数据
+await GM.setValue('key', 'value');
+
+// 读取数据
+const value = await GM.getValue('key', 'default');
+
+// 注册菜单
+GM.registerMenuCommand('菜单项', () => {
+  console.log('点击了菜单项');
+});
+```
+
+### 3. 检查API可用性
+
+由于油猴脚本可能在不同的环境中运行，建议在使用API前检查其可用性：
+
+```typescript
+if (typeof GM_setValue !== 'undefined') {
+  GM_setValue('key', 'value');
+} else if (typeof GM !== 'undefined' && GM.setValue) {
+  await GM.setValue('key', 'value');
+} else {
+  console.warn('GM存储API不可用');
+}
+```
+
+## 示例代码
+
+请查看 `src/gm_api_example/gm_api_usage.ts` 文件，其中包含了各种油猴API的使用示例。
+
+## 注意事项
+
+1. 确保在`userscript-headers.js`文件中添加了所需的`@grant`声明，否则相应的API将不可用。
+2. 如果您需要使用未在`@types/tampermonkey`中定义的API或自定义扩展，可以在`src/types/tampermonkey.d.ts`文件中添加自定义类型定义。 

src/types/README.md

@@ -0,0 +1,22 @@
+/// <reference types="tampermonkey" />
+
+/**
+ * 全局油猴API类型定义
+ * 这个文件导出了所有油猴API的类型，使它们在项目中全局可用
+ */
+
+// 重新导出tampermonkey包中的所有类型
+export {};
+
+// 确保油猴API在全局范围内可用
+declare global {
+  // 这里可以添加任何额外的自定义类型或扩展
+  
+  /**
+   * 自定义油猴API扩展示例
+   * 如果您使用了某些特定的油猴API扩展或自定义函数，可以在这里定义
+   */
+  // interface TampermonkeyExtensions {
+  //   customFunction(): void;
+  // }
+} 

src/types/tampermonkey.d.ts

@@ -2,7 +2,7 @@
   "compilerOptions": {
     "target": "ES6",
     "module": "ESNext",
-    "lib": ["DOM", "ES6"],
+    "lib": ["DOM", "ES6", "ES2015.Promise"],
     "allowJs": true,
     "checkJs": true,
     "outDir": "./dist",
@@ -15,7 +15,8 @@
     "resolveJsonModule": true,
     "isolatedModules": true,
     "noEmit": false,
-    "sourceMap": true
+    "sourceMap": true,
+    "typeRoots": ["./node_modules/@types", "./src/types"]
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules"]

tsconfig.json

@@ -7,4 +7,17 @@
 // @author       ${author}
 // @match        *://*/*
 // @run-at       document-start
+// @grant        GM_getValue
+// @grant        GM_setValue
+// @grant        GM_deleteValue
+// @grant        GM_listValues
+// @grant        GM_registerMenuCommand
+// @grant        GM_unregisterMenuCommand
+// @grant        GM_xmlhttpRequest
+// @grant        GM.getValue
+// @grant        GM.setValue
+// @grant        GM.deleteValue
+// @grant        GM.listValues
+// @grant        GM.registerMenuCommand
+// @grant        GM.xmlHttpRequest
 // ==/UserScript==