@zhin.js/adapter-lark 4.0.3 → 5.0.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @zhin.js/adapter-lark
 
+## 5.0.0
+
+### Patch Changes
+
+- 7db69c1: 命令前缀改为适配器配置项：`MessageDispatcher` 不再硬编码 `/`，默认按消息所属适配器实例 config 的 `commandPrefix` 解析（默认 `''` 无前缀，任意文本按命令匹配），`endpoints[i].commandPrefix` 逐项覆盖；`ImRuntime({ commandPrefix })` 仍可设全局静态前缀。全部 20 个平台适配器 schema 新增 `commandPrefix` 属性。
+
+  BREAKING（行为变化）：未配置时命令不再需要 `/` 前缀——原 `/zt` 写法不再命中，直接发 `zt` 即可；需要斜杠风格的适配器请在配置里显式设 `commandPrefix: '/'`。
+
+- 713445c: 适配器配置格式定稿（不兼容旧格式）：`plugins.<adapter>` 顶层仅共享字段 + `commandPrefix`，`endpoints[i]` 携带 endpoint 级字段（`name` + 凭据，各 schema 已类型化），`endpoints` 为必填（icqq 另需顶层 `master`）；icqq 新增 `trusted` 列表（顶层/逐项均可）。scaffold-wizard 全部字段式与自定义 configure() 产出改为新格式，examples（full-bot / qq-games-bot）与 20 个适配器 README 同步迁移。
+- Updated dependencies [7db69c1]
+- Updated dependencies [e5c84ed]
+- Updated dependencies [3ea84a0]
+- Updated dependencies [1ddcd70]
+- Updated dependencies [ac9da66]
+  - @zhin.js/core@1.4.0
+  - @zhin.js/adapter@1.1.0
+  - @zhin.js/plugin-runtime@1.1.0
+  - @zhin.js/agent@1.0.5
+  - @zhin.js/host-http@1.0.2
+  - zhin.js@5.0.0
+
 ## 4.0.3
 
 ### Patch Changes

package/README.md

@@ -36,7 +36,7 @@ pnpm add @zhin.js/adapter-lark
 3. 启用机器人能力并配置事件订阅 URL：`https://your-domain/lark/webhook`
 4. Runtime Host（`http`）须已 listen，Webhook 才可达
 
-必填字段：`appId`、`appSecret`。
+必填字段（`endpoints[i]`）：`name`、`appId`、`appSecret`。
 
 ## 最小配置
 
@@ -44,14 +44,15 @@ pnpm add @zhin.js/adapter-lark
 # zhin.config.yml（Plugin Runtime）
 plugins:
   lark:
-    name: my-lark-bot
-    appId: ${LARK_APP_ID}
-    appSecret: ${LARK_APP_SECRET}
     webhookPath: /lark/webhook          # 可选，默认 /lark/webhook
-    encryptKey: ${LARK_ENCRYPT_KEY}     # 可选
-    verificationToken: ${LARK_VERIFY_TOKEN}  # 可选
     isFeishu: true                      # 可选，默认 true
     # apiBaseUrl: https://open.feishu.cn/open-apis
+    endpoints:
+      - name: my-lark-bot
+        appId: ${LARK_APP_ID}
+        appSecret: ${LARK_APP_SECRET}
+        # encryptKey: ${LARK_ENCRYPT_KEY}          # 可选
+        # verificationToken: ${LARK_VERIFY_TOKEN}  # 可选
 ```
 
 根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-lark`（`instanceKey: lark`）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-lark",
-  "version": "4.0.3",
+  "version": "5.0.0",
   "description": "Zhin.js Lark/Feishu (飞书) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,20 +34,20 @@
     "directory": "plugins/adapters/lark"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.0.1",
-    "@zhin.js/core": "1.3.5",
-    "@zhin.js/host-http": "1.0.1",
+    "@zhin.js/adapter": "1.1.0",
+    "@zhin.js/core": "1.4.0",
+    "@zhin.js/host-http": "1.0.2",
     "@zhin.js/logger": "1.0.75",
-    "@zhin.js/plugin-runtime": "1.0.1"
+    "@zhin.js/plugin-runtime": "1.1.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.0.1",
-    "@zhin.js/agent": "1.0.4",
-    "@zhin.js/core": "1.3.5",
-    "@zhin.js/host-http": "1.0.1",
-    "@zhin.js/plugin-runtime": "1.0.1",
-    "zhin.js": "4.1.3"
+    "@zhin.js/adapter": "1.1.0",
+    "@zhin.js/agent": "1.0.5",
+    "@zhin.js/core": "1.4.0",
+    "@zhin.js/host-http": "1.0.2",
+    "@zhin.js/plugin-runtime": "1.1.0",
+    "zhin.js": "5.0.0"
   },
   "peerDependenciesMeta": {
     "zhin.js": {
@@ -65,8 +65,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.0.4",
-    "zhin.js": "4.1.3"
+    "@zhin.js/agent": "1.0.5",
+    "zhin.js": "5.0.0"
   },
   "files": [
     "adapters",

package/schema.json

@@ -3,23 +3,59 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "name": {
-      "type": "string",
-      "default": "lark-bot"
-    },
-    "appId": { "type": "string" },
-    "appSecret": { "type": "string" },
-    "encryptKey": { "type": "string" },
-    "verificationToken": { "type": "string" },
     "webhookPath": {
       "type": "string",
       "default": "/lark/webhook"
     },
-    "apiBaseUrl": { "type": "string" },
+    "apiBaseUrl": {
+      "type": "string"
+    },
     "isFeishu": {
       "type": "boolean",
       "default": true
+    },
+    "endpoints": {
+      "type": "array",
+      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（name 必填，其余覆盖顶层）",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Lark bot name"
+          },
+          "appId": {
+            "type": "string",
+            "description": "Lark app ID"
+          },
+          "appSecret": {
+            "type": "string",
+            "description": "Lark app secret"
+          },
+          "encryptKey": {
+            "type": "string",
+            "description": "Lark encrypt key"
+          },
+          "verificationToken": {
+            "type": "string",
+            "description": "Lark verification token"
+          }
+        },
+        "required": [
+          "name",
+          "appId",
+          "appSecret"
+        ]
+      }
+    },
+    "commandPrefix": {
+      "type": "string",
+      "default": "",
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
     }
   },
-  "required": ["appId", "appSecret"]
+  "required": [
+    "endpoints"
+  ]
 }