@zhin.js/adapter-slack 4.1.1 → 5.0.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 5.0.0
+
+### Patch Changes
+
+- 7db69c1: 命令前缀改为适配器配置项：`MessageDispatcher` 不再硬编码 `/`，默认按消息所属适配器实例 config 的 `commandPrefix` 解析（默认 `''` 无前缀，任意文本按命令匹配），`endpoints[i].commandPrefix` 逐项覆盖；`ImRuntime({ commandPrefix })` 仍可设全局静态前缀。全部 20 个平台适配器 schema 新增 `commandPrefix` 属性。
+
+  BREAKING（行为变化）：未配置时命令不再需要 `/` 前缀——原 `/zt` 写法不再命中，直接发 `zt` 即可；需要斜杠风格的适配器请在配置里显式设 `commandPrefix: '/'`。
+
+- 1ddcd70: Console/契约扫尾批：
+
+  - adapter：多 endpoint record name 改为 entry.name（Console 展示/resolve/inbox 按名唯一命中）；`expandEndpointConfigs` 增加缺名/非法字符/重名校验与告警；slack endpoint 补 `name` getter；inbox-installer / agent-host 解析 `slot~entry` 展开 id（activity-feedback 随之恢复）。
+  - host-http：`schema:get`/`config:get` 兼容 `data.plugin`；extended RPC 参数顶层与 `data` 合并（cron 写操作修复）；请求审批认 `requestId`、已读认单值 `id`；`endpoint:requests`/`inboxRequests`/`inboxNotices` 行补 camelCase/扁平别名；cron 列表补 `expression/running/plugin/nextExecution/createdAt/context`。
+  - cli：装配 `setOrchestrationRuntime`/`setSessionTreeRuntime`（agent-sessions/orchestration 页恢复）；`/api/stats` 补 commands/components 计数；console REST databaseHost.started 改动态 getter；`wrapModel` 支持 orderBy/limit 链式查询；接线 SystemLog 模型 + 日志 transport（logs 页有真实数据，带 7 天/1 万条清理）。
+  - plugin-runtime：`DatabaseHostModel.select` 升级为链式 `DatabaseHostSelection`；新增 `system-log`（SystemLog 表定义/写入助手）。
+  - agent：导出 `asPrivate`（Runtime Host 装配 session tree runtime 用）。
+
+- 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 同步迁移。
+- f32c424: 适配器配置统一为 endpoints 数组格式：`plugins.<adapter>` 为该 adapter 所有 endpoint 的通用配置，`plugins.<adapter>.endpoints[i]` 为单个 endpoint 的特殊配置（逐项覆盖，`name` 必填）。slack / github schema 新增 `endpoints` 属性；icqq / qq / slack 顶层必填改为 `anyOf`（单 endpoint 字段或 `endpoints` 数组二选一，兼容 Ajv strictRequired）。
+- 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.1.1
 
 ### Patch Changes

package/README.md

@@ -44,10 +44,25 @@ pnpm add @zhin.js/adapter-slack
 # zhin.config.yml（Plugin Runtime）
 plugins:
   slack:
-    name: my-slack-bot
-    token: ${SLACK_BOT_TOKEN}
-    appToken: ${SLACK_APP_TOKEN}
     socketMode: true          # 默认 true，可省略
+    endpoints:
+      - name: my-slack-bot
+        token: ${SLACK_BOT_TOKEN}
+        appToken: ${SLACK_APP_TOKEN}
+```
+
+多 workspace：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`name` 必填）：
+
+```yaml
+plugins:
+  slack:
+    endpoints:
+      - name: team-a
+        token: ${SLACK_BOT_TOKEN_A}
+        appToken: ${SLACK_APP_TOKEN_A}
+      - name: team-b
+        token: ${SLACK_BOT_TOKEN_B}
+        appToken: ${SLACK_APP_TOKEN_B}
 ```
 
 ## HTTP Events 配置
@@ -55,11 +70,12 @@ plugins:
 ```yaml
 plugins:
   slack:
-    name: my-slack-bot
-    token: ${SLACK_BOT_TOKEN}
-    signingSecret: ${SLACK_SIGNING_SECRET}
     socketMode: false
     webhookPath: /slack/events   # 可选，默认 /slack/events
+    endpoints:
+      - name: my-slack-bot
+        token: ${SLACK_BOT_TOKEN}
+        signingSecret: ${SLACK_SIGNING_SECRET}
 ```
 
 根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-slack`（`instanceKey: slack`）。  

package/lib/endpoint.d.ts

@@ -108,6 +108,8 @@ export interface SlackEndpointOptions {
 export declare class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     #private;
     constructor(options: SlackEndpointOptions);
+    /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
+    get name(): string;
     get client(): SlackWebClientLike | undefined;
     get platformUserId(): string | undefined;
     get config(): ResolvedSlackConfig;

package/lib/endpoint.js

@@ -27,6 +27,10 @@ export class SlackEndpoint {
     constructor(options) {
         this.#options = options;
     }
+    /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
+    get name() {
+        return this.#options.config.name;
+    }
     get client() {
         return this.#client;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-slack",
-  "version": "4.1.1",
+  "version": "5.0.0",
   "description": "Zhin.js Slack adapter for Plugin Runtime (Socket Mode / HTTP Events)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,20 +34,20 @@
   "dependencies": {
     "@slack/socket-mode": "^2.0.3",
     "@slack/web-api": "^7.17.0",
-    "@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,22 +3,6 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "name": {
-      "type": "string",
-      "default": "slack-bot"
-    },
-    "token": {
-      "type": "string",
-      "description": "Bot User OAuth Token (xoxb-...)"
-    },
-    "signingSecret": {
-      "type": "string",
-      "description": "Required for HTTP Events API (socketMode: false)"
-    },
-    "appToken": {
-      "type": "string",
-      "description": "App-Level Token (xapp-...) for Socket Mode"
-    },
     "socketMode": {
       "type": "boolean",
       "default": true,
@@ -32,7 +16,44 @@
       "type": "number",
       "default": 15000,
       "description": "Socket Mode client ping timeout (ms)"
+    },
+    "endpoints": {
+      "type": "array",
+      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（name 必填，其余覆盖顶层）",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Slack bot name"
+          },
+          "token": {
+            "type": "string",
+            "description": "Bot User OAuth Token (xoxb-...)"
+          },
+          "signingSecret": {
+            "type": "string",
+            "description": "Required for HTTP Events API (socketMode: false)"
+          },
+          "appToken": {
+            "type": "string",
+            "description": "App-Level Token (xapp-...) for Socket Mode"
+          }
+        },
+        "required": [
+          "name",
+          "token"
+        ]
+      }
+    },
+    "commandPrefix": {
+      "type": "string",
+      "default": "",
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
     }
   },
-  "required": ["token"]
+  "required": [
+    "endpoints"
+  ]
 }

package/src/endpoint.ts

@@ -102,6 +102,11 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     this.#options = options;
   }
 
+  /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
+  get name(): string {
+    return this.#options.config.name;
+  }
+
   get client(): SlackWebClientLike | undefined {
     return this.#client;
   }