diff --git a/.github/workflows/plugin-api-v2.yml b/.github/workflows/plugin-api-v2.yml
new file mode 100644
index 0000000..7c1876b
--- /dev/null
+++ b/.github/workflows/plugin-api-v2.yml
@@ -0,0 +1,28 @@
+name: plugin-api-v2
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+        with:
+          repository: akashic-plugins/plugin-contracts
+          ref: 24543445c7b99ca63fcd90b5828f754a148b184c
+          path: .plugin-contracts
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Check Plugin API v2
+        env:
+          PYTHONPATH: .plugin-contracts
+        run: python -m akashic_plugin_contracts check plugin.py
diff --git a/plugin.py b/plugin.py
index a4d2c84..46adaaa 100644
--- a/plugin.py
+++ b/plugin.py
@@ -58,6 +58,7 @@ def _normalize_optional_text(cls, value: object) -> str:
 
 
 class QQBotPlugin(Plugin):
+    api_version = 2
     name = "qqbot"
     version = "1.0.0"
     desc = "官方 QQBot 渠道"