dsh-messaging-gateway：接入 Slack 与飞书的消息网关

DeepSeek Harness (DSH) 的插件化架构允许开发者根据需求扩展功能。对于需要通过协作平台进行交互的场景，dsh-messaging-gateway 提供了一个直接的接入方案。

核心定位¶

这是一个消息 Gateway 插件。它遵循“一台 DSH Host，一个 Gateway”的原则。开发者需要自己创建并配置 Slack 和飞书应用。插件负责处理消息路由、会话管理和本地状态存储。所有 Token 仅存储在本地，不会上传到第三方服务器。

安装¶

安装前请确保 DeepSeek Harness 版本 >= 0.2.0-rc.1（推荐 0.2.0-rc.2），且环境满足 Node.js ^22.19.0 || >=24.0.0。

官方桌面 App¶

1. 打开 设置。
2. 进入 插件。
3. 点击 添加插件。
4. 在“包名或地址”中输入：

dsh-messaging-gateway@0.2.3

5. 安装完成后重启 Host。

Web CLI¶

使用官方 CLI 命令安装，该命令仅写入 web profile：

dsh plugin --profile web add dsh-messaging-gateway@0.2.3

若 dsh 不在 PATH 中，请使用：

npx @deepseek-ai/dsh plugin --profile web add dsh-messaging-gateway@0.2.3

配置与连接¶

安装并重启 Host 后，进入 设置 → 消息。

Slack 集成¶

1. 在消息页点击 复制 Manifest，前往 Slack API 创建并安装应用。
2. 填入配置：
   - Bot Token：以 xoxb- 开头。
   - App-level Token：带 connections:write 权限，以 xapp- 开头。
   - Member ID：你自己的用户 ID。
3. 保存配置，给 Bot 发送一条私信。在频道中 @Bot 才会响应。
4. 注意：Slack 的斜杠面板（Slash Menu）通常需要约 5 分钟才能出现。

飞书 集成¶

1. 在飞书开放平台创建企业自建应用，启用机器人功能。
2. 权限：发布新版本以生效，包括 application:app_slash_command:write、application:app_slash_command:read、im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:message:send_as_bot。
3. 事件订阅：选择长连接，订阅接收消息 v2.0。
4. 填入配置：
   - App ID：以 cli_ 开头。
   - App Secret。
   - Member ID：你自己的 ou_...。
5. 保存配置，给机器人发一条私信。

使用与命令¶

会话管理¶

在聊天中，你可以使用以下命令：

• /new：开启新会话。
• /reset：重置当前会话。
• /compact：压缩上下文。
• /help：查看帮助文档。
• /model：切换模型。

目录与状态¶

默认工作目录位于：
- $DSH_HOME/messaging-gateway/workspaces/slack
- $DSH_HOME/messaging-gateway/workspaces/feishu

状态文件保存在 $DSH_HOME/messaging-gateway/state.json。

配置模型¶

在 设置 → 消息 → Slack / 飞书 中，可以配置每个平台的模型和推理强度。这些设置将用于首次私信以及 /new、/reset 命令。

技术细节¶

防重复机制¶

Gateway 在启动时会原子租用 $DSH_HOME/messaging-gateway/instance.lock。如果同一 Home 目录下已有其他 Host 进程占用了锁，当前 Gateway 将保持不活动状态。修复重复 Host 后，只有留存的进程会继续工作。

本地化安全¶

插件依赖 @slack/bolt 和 @larksuiteoapi/node-sdk。所有认证信息仅在本地内存中处理，不经过官方共享 bot。

许可¶

MIT 许可证。

参考资料¶

• GitHub 仓库
• DSH 社区目录