@zhin.js/adapter-slack 4.0.1 → 4.1.1

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+## 4.1.1
+
+### Patch Changes
+
+- cc5c94d: 约定式插件运行时迁移（breaking）：插件与适配器由 `usePlugin()` / `extends Adapter` 迁移为 `definePlugin` / `defineAdapter` + `plugin.ts` + 约定目录（`adapters/`、`commands/`、`components/`、`tools/` 等）。
+
+  - 新增约定式运行时包：`@zhin.js/plugin-runtime`、`@zhin.js/adapter`、`@zhin.js/runtime`、`@zhin.js/host-http`（首版 1.0.0 走 init-publish，不在本 changeset 内 bump）。
+  - 全部 20 个平台适配器改为约定式 `defineAdapter`，旧 `usePlugin` / `extends Adapter` / `segment-mapper` 生产入口已删除；onebot11 反向 WSS、onebot12 webhook/wss、milky sse/webhook/wss、satori webhook、kook webhook、qq webhook/middleware 等 slice 1 推迟的连接模式已补齐。
+  - 游戏 / 工具 / 服务插件同步迁移到约定目录结构。
+  - CLI 增加 plugin-runtime host installer（http/database/outbound/schedule/console 等）。
+
+  后续加固（同批）：
+
+  - CLI：`zhin runtime start --daemon`（pidfile/崩溃拉起/风暴保护），orphan watchdog 防僵尸进程；legacy `zhin dev` / `zhin start` 已移除（含 `zhin restart`），`zhin stop` 兼容新 daemon。
+  - 安全：builtin 工具统一走 `security/policy-facade.ts` 的 `runToolPolicies`（声明式策略表，deny 优先）；审计日志 close flush + 背压队列；`splitCompoundCommand` 引号感知、`extractCommandName` 去引号堵绕过。
+  - 日志：Logger 双堆栈修复、本地时区、`getLogger` 挂树（`setLevel` 递归生效）、第三方库（log4js/discord）桥接、启动人读总结。
+  - 结构：`plugins/games/shared` 迁为 `packages/game-kit`（`@zhin.js/game-kit`）；死目录 `plugins/adapters/common` 删除。
+  - 脚手架：`create-zhin-app` / `zhin new` / scaffold-wizard 生成物改为 Plugin Runtime 形态（minimal-bot 同构，新配置格式）。
+  - Console：endpoint.list 真实名称与 phase、schema:get-all 按 instanceKey 映射、db:\* 接 DatabaseHost。
+
+  注：按仓库发布惯例（见 1bb345dd2），本次 breaking 迁移统一使用 patch，避免 zhin.js 5.0 级联。
+
+- 447f3e2: 迁移缺口修复（legacy 功能对齐）：
+
+  - html 段出站规范化：经 `@zhin.js/html-renderer` 渲染为 image 段（sandbox 豁免、无渲染器时降级文本），修复真实平台 `[object Object]`。
+  - 群聊 @ 触发 AI：适配器入站标注 `metadata.mentioned`（icqq/qq/slack/onebot11/onebot12/napcat/milky/discord/telegram/kook/dingtalk/satori），`matchAiTrigger` 补齐 ignorePrefixes/respondToAt/respondToPrivate/keywords（默认值与 legacy 对齐）。
+  - im_transcripts 全量流水恢复写入（chat_history 工具可用）；群聊旁听上下文回迁。
+  - `ai.trigger.timeout/thinkingMessage/errorTemplate` 生效；masters/trusted 角色解析对齐 legacy。
+  - `Message.sender` 统一为用户 ID（onebot11/12、napcat、milky 原误传显示名）；quote_id 经 metadata 接入 AI 引用上下文。
+
+- Updated dependencies [16ec4e8]
+- Updated dependencies [cc5c94d]
+- Updated dependencies [447f3e2]
+  - @zhin.js/core@1.3.5
+  - @zhin.js/agent@1.0.4
+  - @zhin.js/host-http@1.0.1
+  - zhin.js@4.1.3
+  - @zhin.js/logger@1.0.75
+  - @zhin.js/plugin-runtime@1.0.1
+  - @zhin.js/adapter@1.0.1
+
+## 4.1.0
+
+### Minor Changes
+
+- 872c583: Slack 适配器 Phase 1/2：mrkdwn 出站、长消息切分、斜杠/按钮 ephemeral 反馈、入站 mrkdwn→Markdown、editMessage 对齐 core。
+
+  Logger 表格日志与 string-width 列宽；Agent AI Handler 框线表格与 introspection/MCP 导出；Core side-event 归一化；Schedule 时区规划；多适配器 side-event 与 API surface 更新。
+
+### Patch Changes
+
+- 872c583: fix: 代码格式优化
+- Updated dependencies [872c583]
+- Updated dependencies [872c583]
+  - @zhin.js/agent@1.0.3
+  - @zhin.js/host-router@2.0.3
+  - @zhin.js/logger@1.0.74
+  - zhin.js@4.1.2
+
 ## 4.0.1
 
 ### Patch Changes

package/README.md

@@ -1,192 +1,109 @@
 # @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
+- 入站经 `messageGatewayToken`；出站 `send({ target, 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` — `messageGatewayToken` 入站/出站
+- `@zhin.js/host-http` — 仅 HTTP 模式需要 `httpHostToken` 注册 Events 路由
+- `@zhin.js/plugin-runtime` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
+
+入站：`gateway.receive({ adapter, target: channelId, content: text, sender, metadata })`  
+出站：`send({ target, payload })` → Web API（`target` 可为 `channel` 或 `channel:thread_ts`）
+
+### 平台权限（platform permit）
 
-通过 **`socketMode`** 选择连接方式（默认 `true` 时为 Socket Mode）。
+- `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 可达）
-- 启用对应 Endpoint 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({
-  endpoints: [
-    {
-      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 |
+
+## 最小配置（Socket Mode）
+
+```yaml
+# zhin.config.yml（Plugin Runtime）
+plugins:
+  slack:
+    name: my-slack-bot
+    token: ${SLACK_BOT_TOKEN}
+    appToken: ${SLACK_APP_TOKEN}
+    socketMode: true          # 默认 true，可省略
 ```
 
-### HTTP Mode (For Production with Public URL)
-
-```typescript
-import { defineConfig } from 'zhin.js'
-
-export default defineConfig({
-  endpoints: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      socketMode: false,
-      port: 3000
-    }
-  ]
-})
-```
+## HTTP Events 配置
 
-## 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 Endpoint 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 Endpoint 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!'
-  })
-)
+```yaml
+plugins:
+  slack:
+    name: my-slack-bot
+    token: ${SLACK_BOT_TOKEN}
+    signingSecret: ${SLACK_SIGNING_SECRET}
+    socketMode: false
+    webhookPath: /slack/events   # 可选，默认 /slack/events
 ```
 
-### 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
-
-```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)
-  })
-)
-```
+| 变量 | 说明 |
+|------|------|
+| `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 名称 |
 
-## Slack-Specific Features
+## 消息格式
 
-### Slack Formatting
+### 出站（Markdown → mrkdwn）
 
-Slack uses mrkdwn format:
-- `*bold*` for **bold**
-- `_italic_` for *italic*
-- `~strike~` for ~~strikethrough~~
-- `` `code` `` for `code`
-- `> quote` for blockquotes
+通用 Markdown（如 `**粗体**`）会转换为 Slack mrkdwn，并通过 Block Kit `section` 发送。
 
-### User and Channel Mentions
+### 入站（mrkdwn → Markdown）
 
-The adapter automatically converts:
-- `<@U12345678>` to user mentions
-- `<#C12345678>` to channel mentions
+| Slack mrkdwn | 通用 Markdown |
+|--------------|---------------|
+| `*bold*` | `**bold**` |
+| `_italic_` | `*italic*` |
+| `~strike~` | `~~strike~~` |
+| `<url\|text>` | `[text](url)` |
 
-### File Uploads
+## AI 工具
 
-Upload files using the `file` segment type with a local file path.
+| 类别 | 路径 |
+|------|------|
+| Permit 词汇 | `agent/PERMITS.md` |
+| 平台工具 | `agent/tools/`（邀请、话题、反应、置顶、编辑等） |
+| 技能说明 | `agent/skills/slack.md` |
 
-## Limitations
+## 限制
 
-- Message recall requires channel information (not available from message ID alone)
-- Some Slack features like interactive components require additional setup
+- 入站 mrkdwn → Markdown 为启发式转换
+- Modals / Select menus — 暂不支持
+- OAuth 安装流程 — 暂不支持
+- 旧 `usePlugin` / `extends Adapter` / host-router 生产入口已删除
 
-## License
+## 许可证
 
 MIT

package/adapters/slack.ts

@@ -0,0 +1,34 @@
+/**
+ * Convention entry: discover `adapters/slack.ts` → defineAdapter.
+ */
+import { defineAdapter } from '@zhin.js/adapter';
+import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { httpHostToken } from '@zhin.js/host-http';
+import { SlackEndpoint } from '../src/endpoint.js';
+import {
+  resolveSlackConfig,
+  type SlackAdapterConfig,
+} from '../src/protocol.js';
+
+export { SlackEndpoint } from '../src/endpoint.js';
+export type { SlackEndpointOptions, SlackSocketLike, SlackWebClientLike } from '../src/endpoint.js';
+
+export default defineAdapter<SlackAdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  create(context) {
+    const config = resolveSlackConfig(context.config);
+    if (config.mode === 'http') {
+      return new SlackEndpoint({
+        id: context.id,
+        gateway: context.use(messageGatewayToken),
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    return new SlackEndpoint({
+      id: context.id,
+      gateway: context.use(messageGatewayToken),
+      config,
+    });
+  },
+});

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,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel: string;
+  timestamp: string;
+  emoji: string;
+}>({
+  description: '给 Slack 消息添加表情反应',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+    emoji: z.string().describe('表情名称（不含冒号）'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  async execute({ endpoint_id, channel, timestamp, emoji }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.addReaction(channel, timestamp, emoji);
+    return { success, message: success ? `已添加反应 :${emoji}:` : '操作失败' };
+  },
+});

package/agent/tools/archive_channel.ts

@@ -0,0 +1,24 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel: string;
+}>({
+  description: '归档 Slack 频道',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel: z.string().describe('频道 ID'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('workspace_admin')],
+  async execute({ endpoint_id, channel }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.archiveChannel(channel);
+    return { success, message: success ? '已归档频道' : '操作失败' };
+  },
+});

package/agent/tools/edit_message.ts

@@ -0,0 +1,28 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel: string;
+  message_ts: string;
+  text: string;
+}>({
+  description: '编辑 Slack 消息',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel: z.string().describe('频道 ID'),
+    message_ts: z.string().describe('消息时间戳'),
+    text: z.string().describe('新的消息文本'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  async execute({ endpoint_id, channel, message_ts, text }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    await endpoint.editMessage(channel, message_ts, [
+      { type: 'text', data: { text } },
+    ]);
+    return { success: true, message: '消息已编辑' };
+  },
+});

package/agent/tools/invite_to_channel.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel: string;
+  users: string;
+}>({
+  description: '邀请用户加入 Slack 频道',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel: z.string().describe('频道 ID'),
+    users: z.string().describe('用户 ID 列表（逗号分隔）'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ endpoint_id, channel, users }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.inviteToChannel(channel, users.split(','));
+    return { success, message: success ? '已邀请用户加入频道' : '操作失败' };
+  },
+});

package/agent/tools/pin_message.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel: string;
+  timestamp: string;
+}>({
+  description: '置顶 Slack 消息',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ endpoint_id, channel, timestamp }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.pinMessage(channel, timestamp);
+    return { success, message: success ? '已置顶消息' : '操作失败' };
+  },
+});

package/agent/tools/remove_reaction.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel_id: string;
+  timestamp: string;
+  name: string;
+}>({
+  description: '移除 Slack 消息上的表情反应',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel_id: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+    name: z.string().describe('表情名称（如 thumbsup、heart）'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  async execute({ endpoint_id, channel_id, timestamp, name }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.removeReaction(channel_id, timestamp, name);
+    return { success, message: success ? `已移除反应 :${name}:` : '操作失败' };
+  },
+});

package/agent/tools/set_purpose.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel_id: string;
+  purpose: string;
+}>({
+  description: '设置 Slack 频道的用途/目的',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel_id: z.string().describe('频道 ID'),
+    purpose: z.string().describe('频道用途描述'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ endpoint_id, channel_id, purpose }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.setChannelPurpose(channel_id, purpose);
+    return { success, message: success ? '频道用途已更新' : '操作失败' };
+  },
+});

package/agent/tools/set_topic.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel: string;
+  topic: string;
+}>({
+  description: '设置 Slack 频道话题',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel: z.string().describe('频道 ID'),
+    topic: z.string().describe('新话题'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ endpoint_id, channel, topic }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.setChannelTopic(channel, topic);
+    return { success, message: success ? '已设置频道话题' : '操作失败' };
+  },
+});

package/agent/tools/unarchive.ts

@@ -0,0 +1,24 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel_id: string;
+}>({
+  description: '恢复已归档的 Slack 频道',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel_id: z.string().describe('频道 ID'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('workspace_admin')],
+  async execute({ endpoint_id, channel_id }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.unarchiveChannel(channel_id);
+    return { success, message: success ? '频道已恢复' : '操作失败' };
+  },
+});

package/agent/tools/unpin_message.ts

@@ -0,0 +1,26 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { platformPermit } from '../../src/platform-permit.js';
+import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
+
+export default defineAgentTool<{
+  endpoint_id: string;
+  channel_id: string;
+  timestamp: string;
+}>({
+  description: '取消 Slack 频道中消息的置顶',
+  inputSchema: z.object({
+    endpoint_id: z.string().describe('Endpoint 名称'),
+    channel_id: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+  }),
+  platforms: ['slack'],
+  tags: ['slack'],
+  permissions: [platformPermit('channel_manager')],
+  async execute({ endpoint_id, channel_id, timestamp }) {
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    const success = await endpoint.unpinMessage(channel_id, timestamp);
+    return { success, message: success ? '已取消置顶' : '操作失败' };
+  },
+});