@zhin.js/adapter-qq 1.0.84 → 1.1.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/adapter-qq",
-  "version": "1.0.84",
-  "description": "Zhin.js adapter for QQ Official Bot",
+  "version": "1.1.2",
+  "description": "Zhin.js QQ Official adapter for Plugin Runtime (WebSocket gateway)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -34,53 +34,106 @@
     "directory": "plugins/adapters/qq"
   },
   "dependencies": {
-    "qq-official-bot": "^1.1.2"
-  },
-  "devDependencies": {
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "lucide-react": "^1.16.0",
-    "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.77",
-    "@zhin.js/console": "2.0.24",
-    "zhin.js": "1.0.81"
+    "qq-official-bot": "^1.3.0",
+    "@zhin.js/adapter": "1.1.14",
+    "@zhin.js/agent-feature": "1.1.1",
+    "@zhin.js/core": "1.1.37",
+    "@zhin.js/feature-kit": "1.1.1",
+    "@zhin.js/host-http": "1.1.1",
+    "@zhin.js/im-contract": "1.1.1",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/permission": "1.1.1",
+    "@zhin.js/skill": "1.1.1",
+    "@zhin.js/tool": "1.1.1"
   },
   "peerDependencies": {
-    "@zhin.js/client": "1.0.18",
-    "@zhin.js/console": "2.0.24",
-    "@zhin.js/http": "1.0.74",
-    "@zhin.js/logger": "0.1.63",
-    "zhin.js": "1.0.81"
+    "zod": "^4.0.0",
+    "@zhin.js/adapter": "^1.1.14",
+    "@zhin.js/command": "^1.1.1",
+    "@zhin.js/core": "^1.1.37",
+    "@zhin.js/middleware": "^1.1.1",
+    "zhin.js": "^1.1.2"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/client": {
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "@zhin.js/middleware": {
       "optional": true
     },
-    "@zhin.js/http": {
+    "zhin.js": {
       "optional": true
     },
-    "@zhin.js/console": {
+    "zod": {
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/host-http": "1.1.1",
+    "zhin.js": "1.1.2"
+  },
   "files": [
+    "adapters",
+    "commands",
+    "middlewares",
+    "plugin.js",
+    "schema.json",
     "src",
     "lib",
-    "client",
-    "dist",
-    "skills",
-    "plugin.yml",
+    "tools",
+    "agents",
     "README.md",
-    "node",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/adapter",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/middleware",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "zhin build",
-    "clean": "rimraf lib dist",
-    "build:node": "tsc"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/qq/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin } from 'zhin.js';
+import { permissionHostToken } from '@zhin.js/permission';
+import { checkQqPlatformPermit } from "./lib/platform-permit.js";
+import { createQqRuntimeState, qqRuntimeStateToken } from "./lib/qq-runtime-state.js";
+export default definePlugin({
+    name: 'qq',
+    metadata: {
+        displayName: 'QQ Official WebSocket Adapter',
+    },
+    setup(context) {
+        context.resources.provide(qqRuntimeStateToken, createQqRuntimeState());
+        if (context.resources.has(permissionHostToken)) {
+            const host = context.resources.use(permissionHostToken);
+            return host.registerPlatform('qq', checkQqPlatformPermit);
+        }
+    },
+});

package/schema.json

@@ -0,0 +1,158 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "mode": {
+      "type": "string",
+      "enum": [
+        "websocket",
+        "webhook",
+        "middleware"
+      ],
+      "default": "websocket",
+      "description": "WebSocket gateway (default). webhook/middleware use httpHostToken POST."
+    },
+    "sandbox": {
+      "type": "boolean",
+      "default": false
+    },
+    "botKind": {
+      "type": "string",
+      "enum": [
+        "public",
+        "private"
+      ],
+      "default": "public",
+      "description": "公域/私域：均含 GROUP_AND_C2C_EVENT；频道消息分别为 PUBLIC_GUILD_MESSAGES / GUILD_MESSAGES。未显式配置 intents 时按此展开"
+    },
+    "master": {
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "框架 master（endpoint 管理命令、AI/工具权限）；openid。endpoints[i].master 可逐项覆盖"
+    },
+    "trusted": {
+      "type": "array",
+      "items": {
+        "type": [
+          "string",
+          "number"
+        ],
+        "description": "Trusted openid"
+      },
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+    },
+    "intents": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "WebSocket Identify intents；省略时按 botKind 自动生成（public→含 PUBLIC_GUILD_MESSAGES）"
+    },
+    "accessTokenUrl": {
+      "type": "string"
+    },
+    "gatewayUrl": {
+      "type": "string"
+    },
+    "webhookPath": {
+      "type": "string",
+      "default": "/qq/webhook",
+      "description": "POST path on httpHostToken for webhook/middleware modes."
+    },
+    "endpoints": {
+      "type": "array",
+      "minItems": 1,
+      "description": "多账号：每项定义一个 endpoint，id/appid/secret 必填，其余字段覆盖实例默认值",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "appid": {
+            "type": "string",
+            "description": "QQ official bot app ID"
+          },
+          "secret": {
+            "type": "string",
+            "description": "QQ official bot secret"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "websocket",
+              "webhook",
+              "middleware"
+            ]
+          },
+          "sandbox": {
+            "type": "boolean"
+          },
+          "master": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "本 endpoint 的框架 master（openid）；覆盖顶层 master"
+          },
+          "trusted": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Trusted openid"
+            },
+            "description": "本 endpoint 的 trusted 列表"
+          },
+          "botKind": {
+            "type": "string",
+            "enum": [
+              "public",
+              "private"
+            ],
+            "description": "覆盖顶层 botKind（公域/私域），用于按 endpoint 生成 intents"
+          },
+          "intents": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "覆盖顶层 intents"
+          },
+          "accessTokenUrl": {
+            "type": "string"
+          },
+          "gatewayUrl": {
+            "type": "string"
+          },
+          "webhookPath": {
+            "type": "string"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string",
+            "description": "QQ bot name"
+          }
+        },
+        "required": [
+          "id",
+          "appid",
+          "secret"
+        ]
+      }
+    },
+    "commandPrefix": {
+      "type": "string",
+      "default": "",
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+    }
+  },
+  "required": [
+    "endpoints"
+  ]
+}

package/src/client.ts

@@ -0,0 +1,16 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+import type { QqInboundMessage } from './protocol.js';
+import type { QqBotTransport } from './ws.js';
+
+export type QqClientEventMap = Record<string, QqInboundMessage | unknown>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly qq: {
+      readonly client: QqBotTransport;
+      readonly events: QqClientEventMap;
+    };
+  }
+}
+
+export const qqClient = defineEndpointClient<QqBotTransport, QqClientEventMap>('qq');