jelech/dsh-im-gateway

dsh-im-gateway

一个用于 DeepSeek Harness 的 IM 网关：将即时通讯工具桥接到 harness 智能体会话，并通过斜杠命令对其进行控制。

- 微信，通过腾讯官方 iLink Bot 传输通道（与 OpenClaw 的 @tencent-weixin/openclaw-weixin 使用的是同一个）——扫码登录、长轮询，无需公网端点/ngrok。
- 斜杠命令，仿照 Hermes Agent 的消息接口设计：/new、/sessions、/status、/model、……
- 每个对端一个智能体会话：每个 IM 联系人都拥有自己的 harness 智能体（相同的模型、工具、工作区），因此对话具有记忆且保持隔离。

架构

IM (微信 iLink)
│  扫码登录 + 长轮询（原生 fetch）
▼
dsh-im-gateway（宿主插件，每个进程一个）
├── 通道注册表        lib/channels/wechat-ilink.js   ← 传输适配器
├── 对端 → 会话映射      lib/gateway.js                 ← 智能体生命周期
├── 斜杠命令          lib/commands.js
└── HTTP 桥接             lib/http.js                    ← 浏览器面板
│
▼
harness agents 服务 → 智能体会话 → 模型/工具/工作区

按照 harness 惯例，分为两半：

- 宿主（index.js、lib/）：网关。每个进程只运行一次，因为通道令牌和对端→会话映射必须共享，而不是按会话独立。
- 客户端（client.js）：可选的浏览器“IM 网关”设置区域（扫码登录、状态、测试）。通过包的 dsh.client 声明自动发现。

命令

| 命令                  | 操作                                                        |
| ------------------------ | ------------------------------------------------------------- |
| /help                  | 列出命令                                                 |
| /new（或 /reset）     | 归档当前会话并启动一个新会话             |
| /sessions              | 列出该对端的当前会话 + 已归档会话                |
| /status                | 显示连接、模型和当前会话                   |
| /model [provider:model]| 显示当前模型，或切换（provider:model）到新会话 |

路线图：/retry、/undo、/compress、/usage、/personality、/stop（中断）以及技能调用。

安装

这是一个面向 harness 宿主平面的 Cordis 插件包。它声明了 dsh.bundle，因此官方 dsh plugin 命令会安装它并自动组合它——无需手动编辑组合配置。

从 GitHub 安装（在 npm 发布之前/不使用 npm 发布）

dsh plugin --profile web add github:jelech/dsh-im-gateway

dsh plugin 会转发给 pnpm add，而 github:user/repo 是 pnpm 的原生 spec。随后，该包的 dsh.bundle 声明会自动将其加入 profile 的 bundle 层（此包没有 prepare/构建脚本，因此不需要 allowBuilds 步骤）。

从 npm 注册表安装（发布之后）

markdown
dsh plugin --profile web add dsh-im-gateway

从本地检出安装
bash
dsh plugin --profile web add file:/absolute/path/to/dsh-im-gateway

安装后重启 harness（组合配置在启动时读取）。网关会注册一个 imGateway 服务，并且如果 profile 提供了 webServer，则会暴露 /im-gateway/ 以及设置部分。

如果不使用 dsh plugin 而是手动安装，等价操作是在 profile 目录下执行 pnpm add dsh-im-gateway，并在 cordis.patch.yml 中合并 insert 行（参见本仓库中的 cordis.patch.yml）。

登录

1. 打开 设置 → IM 网关 → 扫码登录微信（浏览器），或调用 gateway.login() 并扫描打印到宿主控制台的二维码。
2. 使用微信扫码并确认。令牌在进程生命周期内保存在内存中。
3. 给机器人发消息。文本消息由 harness agent 回复；以 / 开头的消息是命令。

注意事项与限制

- 目前仅支持文本。媒体（图片/语音/文件）需要 iLink CDN AES-128-ECB 路径；它被隔离在 channel 接口之后，可以在不触及网关核心的情况下添加。
- iOS 需要微信 ≈ 8.0.70；Android 可能会先提示更新微信（iLink 要求）。
- 浏览器面板在宿主本地渲染登录二维码（通过 qrcode npm 包，以 SVG 形式从 /im-gateway/qrcode 提供）——不使用第三方二维码服务，登录链接也没有外部网络往返。
- /im-gateway/ HTTP 桥接会在 harness web 服务器上注册原始路由；如果你的部署在路由层之上强制实施 HTTP 认证，请在 lib/http.js 中添加。

许可证

MIT