Skip to content
morphz-aiPublic

About

MorphLink: Multi-channel bridge from messaging apps to Morphz

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

Repository files navigation

MorphLink

MorphLink 是一个用于连接主流即时通讯(IM)平台与 Morphz 认知机器人的多通道消息桥接网关与 SDK。

通过 MorphLink,你可以将个人微信、企业微信智能机器人、Telegram、Discord、飞书、钉钉等 IM 渠道无缝接入 Morphz,实现消息双向路由、会话流转、流式进度与状态回传、富媒体附件收发以及跨渠道身份对齐。


✨ 核心特性

  • 多通道原生适配:
    • 微信 (WeChat):基于终端二维码快速扫码登录,支持个人/群聊对话、Typing 正在输入态保持与清理、图片/文档附件收发。
    • 企业微信 (WeCom):基于企业微信智能机器人 WebSocket 长连接通道,原生支持流式回复(reply_stream)、Markdown/图文与卡片消息。
    • Telegram:基于 Telegram Bot API 长轮询机制(getUpdates),轻量稳定,开箱即用。
    • Discord:基于 Discord Gateway / Bot API,支持频道消息收发与实时交互。
    • 飞书 (Feishu):支持飞书开放平台应用凭据与长连接事件分发,支持富文本与卡片进度。
    • 钉钉 (DingTalk):支持钉钉 AI 助理 / 机器人消息通道。
  • 解耦的桥接核心:
    • 核心桥接层(MorphzBridge)与具体通道协议完全解耦,通道仅负责协议适配与上/下行序列化。
    • 幂等消息提交与 Session 游标推进机制,具备异常自愈与重新绑定能力。
  • 统一的凭证与多账号管理:
    • 统一存储各通道凭证(~/.morphlink/),支持单渠道多账号并发运行与动态热加载。
    • 简洁直观的 CLI:扫码登录、列出账号、注销清理一键完成。
  • SDK 与独立可执行程序分层:
    • morphlink::sdk 提供纯 Rust 异步库能力,方便嵌入其他宿主。
    • 独立 CLI 工具开箱即用。

🚀 快速开始

1. 编译构建

要求 Rust 1.75+ 与 Cargo:

git clone https://github.com/morphz-ai/morphlink.git
cd morphlink
cargo build --release

编译产物位于 target/release/morphlink。

2. 账号登录

通过 CLI 交互式登录对应渠道:

# 微信扫码登录
./target/release/morphlink login --channel wechat

# 微信企业号 / 企业微信智能机器人
./target/release/morphlink login --channel wecom

# Telegram Bot
./target/release/morphlink login --channel telegram

# 飞书 / 钉钉 / Discord
./target/release/morphlink login --channel feishu
./target/release/morphlink login --channel dingtalk
./target/release/morphlink login --channel discord

查看已配置的账号状态:

./target/release/morphlink accounts

3. 启动网关服务

默认连接本地 Morphz 服务(http://127.0.0.1:8808):

# 启动所有已配置的渠道
./target/release/morphlink start --url http://127.0.0.1:8808 --token <YOUR_TOKEN>

# 或者仅启动指定渠道(如 wechat)
./target/release/morphlink start --channel wechat

📁 目录结构

morphlink/
├── src/
│   ├── channels/          # 各 IM 渠道适配器 (WeChat, WeCom, Telegram, Discord, Feishu, DingTalk)
│   ├── acp_bridge.rs      # ACP 协议支持与权限流转
│   ├── backend.rs         # 后端选择与抽象
│   ├── hotload.rs         # 账号凭据热重载
│   ├── morphz_bridge.rs   # Morphz 核心桥接逻辑与游标管理
│   ├── paths.rs           # 凭据与配置文件路径约定
│   ├── sdk.rs             # 通道 SDK 接口定义
│   ├── lib.rs             # 库入口
│   └── main.rs            # CLI 命令入口
├── docs/                  # 架构设计与跨渠道身份映射文档
├── vendor/                # 企业微信 Rust SDK 等内嵌模块
├── Cargo.toml
└── LICENSE                # Apache 2.0 许可证

📄 开源许可证

本项目采用 Apache-2.0 License 开源。

About

MorphLink: Multi-channel bridge from messaging apps to Morphz

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages