docs: 新增双语插件 API 参考与版本对照，指南改为中英双语并按最新 preview 修正

contract/v1/fixtures/build-providers/build-configuration.json

@@ -0,0 +1,34 @@
+{
+  "format": "litheBuildConfiguration",
+  "version": 1,
+  "sources": [
+    {
+      "id": "user",
+      "scope": "user",
+      "uri": "file:///fixture/user/settings.xml",
+      "revision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "writable": true,
+      "fields": [
+        {
+          "id": "localRepository",
+          "kind": "directory",
+          "value": null,
+          "effectiveValue": "/fixture/repository",
+          "effectiveSource": "installation"
+        },
+        {
+          "id": "activeProfiles",
+          "kind": "stringList",
+          "value": [
+            "ci"
+          ],
+          "effectiveValue": [
+            "ci",
+            "offline"
+          ],
+          "effectiveSource": "commandLine"
+        }
+      ]
+    }
+  ]
+}

contract/v1/fixtures/build-providers/build-connection-debug-options.json

@@ -0,0 +1,46 @@
+{
+  "format": "litheBuildRunOptions",
+  "version": 1,
+  "launchOptions": {
+    "execution": "service",
+    "runtimeArguments": [
+      "-Dmessage=hello world",
+      "-Dquote=\"value\"",
+      "-Dpath=C:\\Users\\example"
+    ],
+    "arguments": [
+      "--message=hello world",
+      "雪",
+      ""
+    ],
+    "environment": {
+      "EXAMPLE": "hello world"
+    },
+    "workingDirectory": "tools",
+    "entrypoint": "example.Main",
+    "debug": {
+      "adapterID": "dev.lithe.plugin.java-support/java",
+      "configurationType": "java",
+      "target": {
+        "kind": "connection",
+        "host": "127.0.0.1",
+        "port": 51235
+      }
+    }
+  },
+  "result": {
+    "executable": {
+      "kind": "command",
+      "value": "engine"
+    },
+    "arguments": [
+      "serve",
+      "--root",
+      "app"
+    ],
+    "workingDirectory": "tools",
+    "environment": {
+      "EXAMPLE": "hello world"
+    }
+  }
+}

contract/v1/fixtures/build-providers/build-provider-configuration.plugin.json

@@ -0,0 +1,178 @@
+{
+  "schemaVersion": 2,
+  "id": "dev.lithe.fixture.build-provider-configuration",
+  "displayName": "Native Configuration Fixture",
+  "version": "0.1.0",
+  "pluginAPIVersion": 3,
+  "requires": {
+    "buildProviders": 7,
+    "buildSystems": 1,
+    "serverProcess": 1,
+    "settings": 1
+  },
+  "vendor": {
+    "id": "org.example",
+    "displayName": "Example",
+    "signatureRequirement": "publisherPackage"
+  },
+  "permissions": [
+    "languageServer.launch",
+    "process.build"
+  ],
+  "activationEvents": [
+    "onBuildSystem:gradle"
+  ],
+  "languages": [],
+  "settings": [
+    {
+      "id": "providerHeapMB",
+      "type": "integer",
+      "title": "Provider memory",
+      "description": "Upper bound of the Gradle provider's heap.",
+      "default": 1024,
+      "minimum": 256,
+      "maximum": 8192,
+      "unit": "MB"
+    }
+  ],
+  "buildSystems": [
+    {
+      "id": "gradle",
+      "displayName": "Gradle",
+      "detection": {
+        "markers": [
+          "build.gradle",
+          "build.gradle.kts",
+          "settings.gradle",
+          "settings.gradle.kts"
+        ],
+        "nesting": "outermost",
+        "priority": 60
+      },
+      "invocation": {
+        "executables": [
+          {
+            "kind": "projectFile",
+            "path": "gradlew",
+            "requires": [
+              "gradle/wrapper/gradle-wrapper.properties"
+            ],
+            "platforms": [
+              "macos",
+              "linux"
+            ]
+          },
+          {
+            "kind": "projectFile",
+            "path": "gradlew.bat",
+            "requires": [
+              "gradle/wrapper/gradle-wrapper.properties"
+            ],
+            "platforms": [
+              "windows"
+            ]
+          },
+          {
+            "kind": "command",
+            "command": "gradle"
+          }
+        ],
+        "runtimeDependencies": [
+          {
+            "id": "java",
+            "minimumVersion": "17"
+          }
+        ],
+        "globalArguments": [
+          "--console=plain",
+          "${optionArguments}"
+        ]
+      },
+      "provider": {
+        "launch": {
+          "kind": "runtime",
+          "tool": "java",
+          "minimumVersion": "17",
+          "runtimeArguments": [
+            "-Xmx${setting:providerHeapMB}m"
+          ],
+          "entry": "provider/gradle-tooling-provider.jar"
+        },
+        "arguments": [
+          "--stdio",
+          "--cache",
+          "${workspaceStateDir}/tooling"
+        ],
+        "initializationOptions": {
+          "initScript": "${pluginDir}/provider/lithe-model.init.gradle"
+        },
+        "executesProjectCode": true,
+        "mayUseNetwork": true
+      },
+      "options": [
+        {
+          "id": "offline",
+          "displayName": "Offline",
+          "kind": "boolean",
+          "arguments": [
+            "--offline"
+          ]
+        }
+      ],
+      "model": {
+        "source": "provider"
+      },
+      "tasks": [
+        {
+          "id": "build",
+          "displayName": "Build",
+          "group": "build",
+          "scopes": [
+            "workspace",
+            "project",
+            "target"
+          ],
+          "source": "provider",
+          "arguments": []
+        },
+        {
+          "id": "custom",
+          "displayName": "Custom",
+          "group": "other",
+          "scopes": [
+            "workspace"
+          ],
+          "source": "provider",
+          "requiresUserArguments": true,
+          "arguments": []
+        }
+      ],
+      "dependencies": {
+        "source": "provider",
+        "scopes": [
+          "workspace",
+          "project"
+        ]
+      },
+      "sync": {
+        "watch": [
+          "build.gradle",
+          "build.gradle.kts",
+          "gradle.properties",
+          "gradle/libs.versions.toml",
+          "settings.gradle",
+          "settings.gradle.kts"
+        ]
+      },
+      "layout": {
+        "excluded": [
+          ".gradle",
+          "build"
+        ]
+      },
+      "configuration": {
+        "source": "provider"
+      }
+    }
+  ]
+}