dsh-messaging

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# DSH Messaging（hermes-agent 消息平台移植）

将 [hermes-agent](https://github.com/NousResearch/hermes-agent) 的消息平台体系移植为 DSH 插件，**整合为单一插件 `messaging-core`**：27 个消息渠道的适配器全部内聚在插件内部，一个插件完成注册、会话映射、出站路由、授权、命令与配置界面。

## 功能特性

- **27 个消息平台**：Telegram、Discord、Slack、IRC、ntfy、Email、Matrix、Home Assistant、Signal、WhatsApp、飞书/Lark、Mattermost、QQ、LINE、SMS、WhatsApp Cloud、企业微信、Teams、钉钉、Google Chat、通用 Webhook、A2A、微信个人号（iLink）、BlueBubbles iMessage、OpenAI 兼容 API Server、腾讯元宝、SimpleX
- **统一会话体系**：每个聊天映射到独立的 DSH 会话（`msg-<平台>-[-vN]`），支持 `/new`、`/resume`（按标题切换历史会话）、`/title`、`/status`、`/stop`、`/compress`
- **每平台独立工作区**：`$DSH_HOME/messaging/workspace/<平台>/`，注册进 host 工作区注册表，侧栏按平台分组
- **出站流式路由**：订阅 `session/event`，按平台能力渲染（HTML/纯文本/原生 Markdown），支持流式编辑与 typing 指示
- **授权白名单**：每平台 `allowedUsers` / `allowAll`
- **配置界面**：侧栏「消息平台」入口（与「新建会话」同款按钮），hermes 式两栏弹窗（左侧平台列表，右侧配置表单），配置走 `/messaging/config` 端点持久化
- **共享 Webhook 监听器**：webhook 型平台共用 HTTP listener（默认 `127.0.0.1:8765`）

## 截图

| | | |
| :---: | :---: | :---: |
| [图片: 侧栏消息平台入口]
侧栏消息平台入口 | [图片: 消息平台配置弹窗]
消息平台配置弹窗 | |

## 安装（web profile）

在 profile 的 `package.json` 中添加依赖，并将 `messaging-core` 加入 `dsh.profile.bundles`：

```json
{
  "dependencies": {
    "messaging-core": "file:<本仓库路径>/packages/messaging-core"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "...",
        "messaging-core"
      ]
    }
  }
}
```

然后 `pnpm install` 并重启 dsh web。源码更新后运行 `deploy.ps1` 同步到 profile 的 `node_modules`（file: 依赖是拷贝安装，不是软链），再手动重启 dsh web 生效。

## 使用

- 侧栏「消息平台」按钮 → 弹窗中选择平台 → 填写配置保存
- 平台连接后，向机器人发消息即可对话；`/status` 查看会话与模型状态，`/title 标题` 设置会话标题，`/resume` 列出/切换历史会话，`/compress` 手动压缩上下文

## 结构

```
packages/messaging-core/
  lib/
    index.js          # 插件入口：messaging 服务 + 27 个平台注册 + 命令系统
    config.js         # 平台目录（弹窗/端点/向导共用的单一事实源）
    agents.js         # agent 生命周期（创建/恢复/单飞/工作区挂载）
    session-map.js    # 聊天↔会话映射（JSONL 持久化 + 历史记录）
    outbound.js       # session/event → 平台适配器 路由
    markdown.js       # 按平台能力渲染（html/plain）
    workspaces.js     # 每平台独立工作区
    tools.js          # send_message / messaging_status 工具
    http.js           # 共享 webhook listener
    client.js         # 侧栏入口 + 配置弹窗（web 客户端 bundle）
    platforms/        # 27 个平台适配器模块（telegram.js、qq.js、discord.js …）
```

## 配置

配置存储在 `$DSH_HOME/settings.yaml`，命名空间 `messaging-<平台>`（如 `messaging-qq`、`messaging-telegram`），与弹窗、CLI 向导（`messaging-setup.mjs`）、`/messaging/config` 端点共用同一 schema 目录（`config.js`）。

## 平台适配器说明

| 平台 | 接入方式 |
| --- | --- |
| Telegram | grammY 长轮询，流式编辑/typing/媒体 |
| Discord | Gateway intents，流式编辑/typing |
| QQ | 官方 Bot API v2 WS 网关（C2C + 群 @），REST 发送，原生 Markdown（需开通原生 MD 权限，失败自动回退纯文本） |
| 微信个人号 | iLink Bot API 长轮询，QR 配对向导 `weixin-pair.mjs` |
| WhatsApp | Baileys 多设备协议，QR 配对 |
| 飞书/Lark | 官方 SDK + WS 长连接事件订阅 |
| Slack | Socket Mode + chat.update 流式编辑 |
| Matrix | sync 循环 + m.replace 流式编辑 |
| 钉钉 | Stream 模式官方 SDK |
| Teams | Bot Framework webhook + continueConversation |
| 其余 | 见各模块文件头注释 |

## 开发与验证

- `node messaging-setup.mjs`：CLI 配置向导（list / 交互式 / 旧参数兼容）
- `node verify-live.mjs`：检查运行中的 dsh web 是否为最新构建（/messaging/status、/messaging/config、客户端 bundle）
- `deploy.ps1`：将 `packages/messaging-core` 同步到 `%USERPROFILE%\.dsh\profiles\web\node_modules\messaging-core`

## 鸣谢

协议与交互语义参考 [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)（MIT License, Copyright (c) 2025 Nous Research），衍生部分的归属声明见 [NOTICE](NOTICE)。