@zhin.js/adapter-slack 1.0.78 → 1.1.0

package/README.md

@@ -1,192 +1,146 @@
 # @zhin.js/adapter-slack
 
-Slack adapter for zhin.js framework.
+Zhin.js Slack 适配器（Plugin Runtime），优先 Socket Mode，也可经 Runtime Host HTTP Events API 收发消息。
 
-## Installation
+## 功能
+
+- **Socket Mode**（默认）：WebSocket 长连接，无需公网 URL
+- **HTTP Events API**：`httpHostToken` POST（签名验证），**非** legacy host-router/Koa
+- 入站经 `Endpoint.emit(...)`；出站 `send({ conversation, payload })` → `chat.postMessage` / Block Kit
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
+- Block Kit 按钮、斜杠命令、消息编辑、表情反应等（见 `agent/tools/`）
+
+## 安装
 
 ```bash
 pnpm add @zhin.js/adapter-slack
 ```
 
-## Configuration
+## Plugin Runtime
+
+- `@zhin.js/adapter` — 约定式 `adapters/slack.ts`（`defineAdapter`）
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
+- `@zhin.js/host-http` — 仅 HTTP 模式需要 `httpHostToken` 注册 Events 路由
+- `zhin.js` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-通过 **`socketMode`** 选择连接方式（默认 `true` 时为 Socket Mode）。
+入站：`gateway.receive({ conversation, message: { conversation, id }, content: text, sender, metadata })`（`conversation` 为 ConversationRef：`channel_type: im` → kind `private`，其余 → kind `group`；线程根 ts 进 `threadId`）  
+出站：`send({ conversation, payload })` → Web API（`conversation.id` 为 channel，`conversation.threadId` 为 thread_ts）
 
-### 模式对比
+### 平台权限（platform permit）
+
+- `plugin.ts` 已注册 checker，Runtime Tool 权限统一经 Core `canAccessTool()`；当前 Slack 入站没有可靠 sender role 时，受限工具按 fail-closed 拒绝，不会静默放行。
+
+## 模式对比
 
 | 模式 | `socketMode` | 适用场景 | 额外字段 |
 |------|--------------|----------|----------|
-| **Socket Mode** | `true`（推荐本地/内网） | 无需公网 URL，WebSocket 长连接 | `appToken`（`xapp-...`） |
-| **HTTP Events** | `false` | 生产环境，有公网 HTTPS | `port`（Bolt 监听端口） |
-
-#### HTTP 模式前置条件
-
-- Slack App 中配置 **Event Subscriptions** 的 Request URL（须公网 HTTPS 可达）
-- 启用对应 Bot Events（`message.*`、`app_mention` 等）
-- 防火墙 / 反向代理放行 `port`
-- **不需要** `@zhin.js/host-router`（由 `@slack/bolt` 自行监听）
-
-### Socket Mode (Recommended for Development)
-
-```typescript
-import { defineConfig } from 'zhin.js'
-
-export default defineConfig({
-  bots: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      appToken: 'xapp-your-app-token',
-      socketMode: true
-    }
-  ]
-})
+| **Socket Mode**（默认） | `true` | 本地/内网，无需公网 URL | `appToken`（`xapp-...`） |
+| **HTTP Events** | `false` | 生产环境有公网 HTTPS | `signingSecret` + Runtime Host |
+
+## 前置条件
+
+1. 创建 Slack App，安装到 Workspace，并授予收发消息所需 OAuth scopes。
+2. Socket Mode 创建 `connections:write` App-Level Token；HTTP 模式配置 Signing Secret 与 Events URL。
+3. 订阅需要的 bot events，并把应用加入目标频道。
+
+## 最小配置（Socket Mode）
+
+```yaml
+# zhin.config.yml（Plugin Runtime）
+plugins:
+  slack:
+    socketMode: true          # 默认 true，可省略
+    endpoints:
+      - name: my-slack-bot
+        token: ${SLACK_BOT_TOKEN}
+        appToken: ${SLACK_APP_TOKEN}
 ```
 
-### HTTP Mode (For Production with Public URL)
-
-```typescript
-import { defineConfig } from 'zhin.js'
-
-export default defineConfig({
-  bots: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      socketMode: false,
-      port: 3000
-    }
-  ]
-})
+多 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}
 ```
 
-## Features
-
-- ✅ Send and receive text messages
-- ✅ Support for rich media (images, files)
-- ✅ Message formatting (Slack mrkdwn)
-- ✅ Reply to messages and threads
-- ✅ Mentions (@user, #channel)
-- ✅ Links and attachments
-- ✅ Socket Mode and HTTP mode
-- ✅ Private messages and channels
-
-## Setting Up Your Slack App
-
-1. Go to [Slack API](https://api.slack.com/apps)
-2. Create a new app
-3. Add Bot Token Scopes:
-   - `chat:write` - Send messages
-   - `chat:write.public` - Send messages to public channels
-   - `channels:read` - View basic channel info
-   - `channels:history` - View messages in channels
-   - `groups:read` - View basic private channel info
-   - `groups:history` - View messages in private channels
-   - `im:read` - View basic direct message info
-   - `im:history` - View messages in direct messages
-   - `mpim:read` - View basic group direct message info
-   - `mpim:history` - View messages in group direct messages
-   - `users:read` - View user info
-   - `files:read` - View files
-   - `files:write` - Upload files
-4. Enable Socket Mode (if using Socket Mode):
-   - Go to Socket Mode settings
-   - Enable Socket Mode
-   - Generate an app-level token with `connections:write` scope
-5. Subscribe to events:
-   - `message.channels` - Messages in public channels
-   - `message.groups` - Messages in private channels
-   - `message.im` - Direct messages
-   - `message.mpim` - Group direct messages
-   - `app_mention` - When the bot is mentioned
-6. Install the app to your workspace
-7. Copy the Bot User OAuth Token (`xoxb-...`)
-8. Copy the Signing Secret
-9. Copy the App-Level Token (`xapp-...`) if using Socket Mode
-
-## Usage Examples
-
-### Basic Message Handling
-
-```typescript
-import { usePlugin, MessageCommand } from 'zhin.js'
-
-const { addCommand } = usePlugin()
-
-addCommand(new MessageCommand('hello')
-  .action(async (message) => {
-    return 'Hello from Slack!'
-  })
-)
+## HTTP Events 配置
+
+```yaml
+plugins:
+  slack:
+    socketMode: false
+    webhookPath: /slack/events   # 可选，默认 /slack/events
+    endpoints:
+      - name: my-slack-bot
+        token: ${SLACK_BOT_TOKEN}
+        signingSecret: ${SLACK_SIGNING_SECRET}
 ```
 
-### Send Rich Messages
-
-```typescript
-addCommand(new MessageCommand('info')
-  .action(async (message) => {
-    return [
-      { type: 'text', data: { text: '*Bold* and _italic_ text\n' } },
-      { type: 'link', data: { url: 'https://slack.com', text: 'Visit Slack' } }
-    ]
-  })
-)
-```
+根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-slack`（`instanceKey: slack`）。  
+HTTP 模式下 Runtime Host（`http`）须已 listen；Slack App 的 Event Subscriptions / Interactivity / Slash Commands Request URL 指向 `https://your-domain/slack/events`。
 
-### Mention Users
-
-```typescript
-addCommand(new MessageCommand('mention <userId:text>')
-  .action(async (message, result) => {
-    return [
-      { type: 'at', data: { id: result.params.userId } },
-      { type: 'text', data: { text: ' Hello!' } }
-    ]
-  })
-)
-```
+## 环境变量
 
-### Reply in Thread
+| 变量 | 说明 |
+|------|------|
+| `SLACK_BOT_TOKEN` / `SLACK_TOKEN` | Bot User OAuth Token（`xoxb-...`） |
+| `SLACK_APP_TOKEN` | App-Level Token（Socket Mode，`xapp-...`） |
+| `SLACK_SIGNING_SECRET` | Signing Secret（HTTP 模式） |
+| `SLACK_BOT_NAME` | 可选 endpoint 名称 |
 
-```typescript
-addCommand(new MessageCommand('thread')
-  .action(async (message) => {
-    // Reply in a thread by passing the message timestamp
-    await message.$reply('This is a threaded reply!', true)
-  })
-)
-```
+## 消息格式
+
+### 出站（Markdown → mrkdwn）
 
-## Slack-Specific Features
+通用 Markdown（如 `**粗体**`）会转换为 Slack mrkdwn，并通过 Block Kit `section` 发送。
 
-### Slack Formatting
+### 入站（mrkdwn → Markdown）
 
-Slack uses mrkdwn format:
-- `*bold*` for **bold**
-- `_italic_` for *italic*
-- `~strike~` for ~~strikethrough~~
-- `` `code` `` for `code`
-- `> quote` for blockquotes
+| Slack mrkdwn | 通用 Markdown |
+|--------------|---------------|
+| `*bold*` | `**bold**` |
+| `_italic_` | `*italic*` |
+| `~strike~` | `~~strike~~` |
+| `<url\|text>` | `[text](url)` |
 
-### User and Channel Mentions
+## AI 工具
 
-The adapter automatically converts:
-- `<@U12345678>` to user mentions
-- `<#C12345678>` to channel mentions
+| 类别 | 路径 |
+|------|------|
+| Permit 词汇 | `agent/PERMITS.md` |
+| 平台工具 | `agent/tools/`（邀请、话题、反应、置顶、编辑等） |
+| 技能说明 | `agent/skills/slack.md` |
 
-### File Uploads
+## 限制
 
-Upload files using the `file` segment type with a local file path.
+- 入站 mrkdwn → Markdown 为启发式转换
+- Modals / Select menus — 暂不支持
+- OAuth 安装流程 — 暂不支持
+- 旧 `usePlugin` / `extends Adapter` / host-router 生产入口已删除
 
-## Limitations
+## 故障排查
 
-- Message recall requires channel information (not available from message ID alone)
-- Some Slack features like interactive components require additional setup
+| 现象 | 排查 |
+| --- | --- |
+| Socket Mode 无法连接 | 检查 `xapp-` Token、Socket Mode 与 `connections:write` scope |
+| HTTP Events 返回 401 | 检查 Signing Secret、原始请求体、服务器时钟与反向代理 |
+| 频道消息未触发 | 确认事件订阅、OAuth scopes，并邀请 App 进入频道 |
+| 线程回复跑到主频道 | 检查入站 `thread_ts` 是否保留为 Conversation `threadId` |
 
-## License
+## 许可证
 
 MIT
+
+## 发送失败与回执
+
+成功发送返回平台 `ts` 组成的消息引用，不以本地时间替代缺失回执。
+文件上传失败会让本次发送失败；分段消息中某段缺少有效回执时，停止后续分段。
+前面已成功的文件或分段不会自动回滚；发送失败可能表示部分已送达，请先核对目标会话再重试。

package/adapters/slack.js

@@ -0,0 +1,40 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * Convention entry: discover `adapters/slack.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { SlackEndpoint } from "../lib/endpoint.js";
+import { resolveSlackConfig, } from "../lib/protocol.js";
+import { slackRuntimeStateToken } from "../lib/slack-runtime-state.js";
+export { SlackEndpoint } from "../lib/endpoint.js";
+export default defineAdapter({
+    capabilities: ['inbound', 'outbound'],
+    operations: ['recall', 'edit', 'reaction'],
+    // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
+    // 其余拉取后上传）；kind=base64 解码后经 files.uploadV2 上传；kind=path 读盘上传；
+    // kind=file 无 Slack 对应物，丢弃留痕。Block Kit 原生按钮承载交互段。
+    segments: {
+        outboundMedia: ['url', 'upload', 'path'],
+        interactive: 'native',
+    },
+    create(context) {
+        const config = resolveSlackConfig(context.config);
+        // 注册到插件运行时状态（slack.endpoint list 的"运行中"数据源）
+        context.use(slackRuntimeStateToken).endpoints.set(config.id, {
+            id: config.id,
+            mode: config.mode,
+        });
+        if (config.mode === 'http') {
+            return new SlackEndpoint({
+                id: context.id,
+                http: context.use(httpHostToken),
+                config,
+            });
+        }
+        return new SlackEndpoint({
+            id: context.id,
+            config,
+        });
+    },
+});

package/adapters/slack.ts

@@ -0,0 +1,45 @@
+/**
+ * Convention entry: discover `adapters/slack.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { SlackEndpoint } from '../src/endpoint.js';
+import {
+  resolveSlackConfig,
+  type SlackAdapterConfig,
+} from '../src/protocol.js';
+import { slackRuntimeStateToken } from '../src/slack-runtime-state.js';
+
+export { SlackEndpoint } from '../src/endpoint.js';
+export type { SlackEndpointOptions, SlackSocketLike, SlackWebClientLike } from '../src/endpoint.js';
+
+export default defineAdapter<SlackAdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  operations: ['recall', 'edit', 'reaction'],
+  // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
+  // 其余拉取后上传）；kind=base64 解码后经 files.uploadV2 上传；kind=path 读盘上传；
+  // kind=file 无 Slack 对应物，丢弃留痕。Block Kit 原生按钮承载交互段。
+  segments: {
+    outboundMedia: ['url', 'upload', 'path'],
+    interactive: 'native',
+  },
+  create(context) {
+    const config = resolveSlackConfig(context.config);
+    // 注册到插件运行时状态（slack.endpoint list 的"运行中"数据源）
+    context.use(slackRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
+      mode: config.mode,
+    });
+    if (config.mode === 'http') {
+      return new SlackEndpoint({
+        id: context.id,
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    return new SlackEndpoint({
+      id: context.id,
+      config,
+    });
+  },
+});

package/agent/PERMITS.md

@@ -0,0 +1,24 @@
+# Slack Platform Permits
+
+## 入站字段
+
+频道消息异步 enrich（`users.info` + `conversations.info`，TTL 60s）：
+
+| 字段 | 来源 |
+|------|------|
+| `$sender.role` | `owner` · `admin` · `channel_admin` · `member` |
+| `$sender.permissions` | `workspace_owner` · `workspace_admin` · `channel_manager` |
+
+`channel_manager`：频道 `creator === user` 或 workspace 管理员。
+
+## Permit 词汇表
+
+| `platform(slack,…)` | 含义 |
+|---------------------|------|
+| `workspace_owner` | Workspace 主 |
+| `workspace_admin` | Workspace 管理员 |
+| `channel_manager` | 频道管理者 |
+
+## 工厂映射
+
+`scene_admin` → `channel_manager` · `scene_owner` → `workspace_owner`

package/{skills/slack/SKILL.md → agent/skills/slack.md}

@@ -34,6 +34,7 @@ tools:
   - slack_user_info
   - slack_set_purpose
   - slack_unarchive
+  - slack_edit_message
   - slack_kick_member
   - slack_set_group_name
   - slack_list_members
@@ -83,6 +84,7 @@ Slack 频道有两个元信息字段：
 | `slack_unpin_message` | 取消置顶 | — |
 | `slack_add_reaction` | 添加表情反应 | — |
 | `slack_remove_reaction` | 移除表情反应 | — |
+| `slack_edit_message` | 编辑消息 | 通过 chat.update 修改已发消息 |
 
 ## 易错点
 

package/agent/tools/add_reaction.ts

@@ -0,0 +1,29 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { normalizeSlackReactionName } from '../../src/slack-reaction.js';
+
+export default defineAgentTool<{
+  channel: string;
+  timestamp: string;
+  emoji: string;
+}>({
+  description: '给 Slack 消息添加表情反应',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+    emoji: z.string().describe('表情名称（不含冒号）'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  async execute({ channel, timestamp, emoji }, context) {
+    const client = context.$client;
+    const name = normalizeSlackReactionName(emoji);
+    try {
+      await client.reactions.add({ channel, timestamp, name });
+    } catch (error) {
+      if ((error as { data?: { error?: string } })?.data?.error !== 'already_reacted') throw error;
+    }
+    const success = true;
+    return { success, message: success ? `已添加反应 :${emoji}:` : '操作失败' };
+  },
+});

package/agent/tools/archive_channel.ts

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{
+  channel: string;
+}>({
+  description: '归档 Slack 频道',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermit('workspace_admin')],
+  async execute({ channel }, context) {
+    const client = context.$client;
+    await client.conversations.archive({ channel });
+    const success = true;
+    return { success, message: success ? '已归档频道' : '操作失败' };
+  },
+});

package/agent/tools/edit_message.ts

@@ -0,0 +1,25 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { editSlackContent } from '../../src/slack-outbound.js';
+
+export default defineAgentTool<{
+  channel: string;
+  message_ts: string;
+  text: string;
+}>({
+  description: '编辑 Slack 消息',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    message_ts: z.string().describe('消息时间戳'),
+    text: z.string().describe('新的消息文本'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  async execute({ channel, message_ts, text }, context) {
+    const client = context.$client;
+    await editSlackContent(client, channel, message_ts, [
+      { type: 'text', data: { text } },
+    ]);
+    return { success: true, message: '消息已编辑' };
+  },
+});

package/agent/tools/invite_to_channel.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{
+  channel: string;
+  users: string;
+}>({
+  description: '邀请用户加入 Slack 频道',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    users: z.string().describe('用户 ID 列表（逗号分隔）'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ channel, users }, context) {
+    const client = context.$client;
+    await client.conversations.invite({ channel, users });
+    const success = true;
+    return { success, message: success ? '已邀请用户加入频道' : '操作失败' };
+  },
+});

package/agent/tools/pin_message.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{
+  channel: string;
+  timestamp: string;
+}>({
+  description: '置顶 Slack 消息',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ channel, timestamp }, context) {
+    const client = context.$client;
+    await client.pins.add({ channel, timestamp });
+    const success = true;
+    return { success, message: success ? '已置顶消息' : '操作失败' };
+  },
+});

package/agent/tools/remove_reaction.ts

@@ -0,0 +1,32 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { normalizeSlackReactionName } from '../../src/slack-reaction.js';
+
+export default defineAgentTool<{
+  channel_id: string;
+  timestamp: string;
+  name: string;
+}>({
+  description: '移除 Slack 消息上的表情反应',
+  inputSchema: z.object({
+    channel_id: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+    name: z.string().describe('表情名称（如 thumbsup、heart）'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  async execute({ channel_id, timestamp, name }, context) {
+    const client = context.$client;
+    try {
+      await client.reactions.remove({
+        channel: channel_id,
+        timestamp,
+        name: normalizeSlackReactionName(name),
+      });
+    } catch (error) {
+      if ((error as { data?: { error?: string } })?.data?.error !== 'no_reaction') throw error;
+    }
+    const success = true;
+    return { success, message: success ? `已移除反应 :${name}:` : '操作失败' };
+  },
+});

package/agent/tools/set_purpose.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{
+  channel_id: string;
+  purpose: string;
+}>({
+  description: '设置 Slack 频道的用途/目的',
+  inputSchema: z.object({
+    channel_id: z.string().describe('频道 ID'),
+    purpose: z.string().describe('频道用途描述'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ channel_id, purpose }, context) {
+    const client = context.$client;
+    await client.conversations.setPurpose({ channel: channel_id, purpose });
+    const success = true;
+    return { success, message: success ? '频道用途已更新' : '操作失败' };
+  },
+});

package/agent/tools/set_topic.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{
+  channel: string;
+  topic: string;
+}>({
+  description: '设置 Slack 频道话题',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    topic: z.string().describe('新话题'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ channel, topic }, context) {
+    const client = context.$client;
+    await client.conversations.setTopic({ channel, topic });
+    const success = true;
+    return { success, message: success ? '已设置频道话题' : '操作失败' };
+  },
+});

package/agent/tools/unarchive.ts

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+
+export default defineAgentTool<{
+  channel_id: string;
+}>({
+  description: '恢复已归档的 Slack 频道',
+  inputSchema: z.object({
+    channel_id: z.string().describe('频道 ID'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermit('workspace_admin')],
+  async execute({ channel_id }, context) {
+    const client = context.$client;
+    await client.conversations.unarchive({ channel: channel_id });
+    const success = true;
+    return { success, message: success ? '频道已恢复' : '操作失败' };
+  },
+});