Minke是一个基于 DeepSeek Harness 的本地优先（local-first）桌面 Agent 工作区，支持微信、Telegram、Discord 三大 IM 通道接入：在微信里发一条消息，电脑上的 Minke Agent 就开始执行任务，完成后把结果发回聊天窗口。本文是一份面向新手的实操指南，带你 10 分钟打通 IM 通道，实现"用微信发起 AI 任务"。

一、为什么把 AI Agent 接到 IM 上？

想象一下这些场景 📱：

• 出门在外，用微信说一句"帮我整理今天的新闻并生成摘要"，回家结果已经躺在对话里；
• 手机上临时收到文件，直接转发给 Minke 的 Bot 让它处理；
• 在 Discord 服务器里@Minke触发任务，团队围观 Agent 工作过程。

Minke 的Connections（连接）面板统一管理三类通道，左侧列表实时显示每个通道的在线状态 🟢：

📌 通道设置入口：打开 Minke 主界面 → 打开Connections（远端连接）面板。相关 UI 源码见 packages/harness-overlay/src/client/remote-hub/view.tsx。

三大通道特性一览：

二、准备工作：安装 Minke 并授权凭据存储

1. 在电脑（macOS / Windows / Linux）上安装 Minke 桌面应用，版本与安装方式详见 README.md；
2. 首次进入 Connections 面板时，点击Authorize credential access（授权凭据访问）：
   • macOS 会弹出系统钥匙串（Keychain）请求，输入 Mac 登录密码并选择"始终允许"；
   • 这一步用于加密保存各通道的连接凭据（Token、会话凭据），不授权则消息通道保持关闭；
3. 面板底部显示System ready即表示运行依赖就绪，可以开始接通道。

🔐 凭据采用本机加密存储：微信凭据使用版本化 AES-256-GCM 信封加密绑定行用途，Bot Token 同样只保存在本机、不会在界面显示。实现细节可参考 packages/remote-access 与 packages/harness-overlay/src/remote-hub-contract.ts。

三、微信接入教程：扫码一步连上

微信是最"零门槛"的通道，全程只需扫一次码 ✅：

1. 在 Connections 面板的Messaging（消息）区域选择WeChat（微信），点击连接微信；
2. 界面生成二维码，用你的微信扫码，并在手机上确认（注意：只有扫码这个账号的一对一私聊消息才会进入 Minke Agent，群聊不会触发）；
3. 若微信要求额外验证，在界面输入手机端显示的数字验证码并提交；
4. 状态变为已连接（Connected），并显示连接时间、在线时长、收发统计。

微信通道的可靠性设计（会话失效自动提示重新扫码、投递失败保留待发送消息等）实现在 packages/im-weixin/，其 README 详细说明了登录、长轮询与加密媒体传输协议。

⚠️ 常见提示：

• 会话已失效→ 重新扫码即可；
• 凭据保护不可用→ 回到第二步完成系统钥匙串/密钥环授权。

四、Telegram 接入教程：BotFather 三步搞定

Telegram 通道通过官方 Bot API 连接，需要先在 Telegram 里拿到一个 Bot Token：

1. 在 Telegram 中找到@BotFather，按提示创建 Bot，复制它给你的 Token（形如123456:ABC-...）；
2. 回到 Minke 的 Connections 面板，选择Telegram，把 Token 粘贴到Bot Token输入框，点击连接；
3. Token 验证通过后状态变为已连接，随后直接在 Telegram 里给你的 Bot 发消息即可。

几个实用细节 💡：

• 网络问题：Minke 支持在通道设置里填写可选的 HTTP CONNECT 代理（格式http://主机:端口），留空则走系统网络，Minke 不会自动探测本机代理；
• 独占接收：Minke 接管 long polling 后会保留待处理更新，请勿让另一个实例同时用同一个 Token 接收，否则会收到"另一个实例正在使用此 Token"的冲突提示；
• Token 已加密保存在本机且界面不再显示，重新连接自动复用；需要更换时用更新 Token，彻底清除用清除 Token。

Telegram 传输层实现在 packages/im-telegram/，支持文本、图片、文档、语音等消息类型的收发与长消息自动分片。

五、Discord 接入教程：配对后 @Bot 发起任务

Discord 通道在 Bot Token 之外多一步私聊配对，用于防止陌生人滥用你的 Agent：

1. 在 Discord Developer Portal 创建 Bot 并复制 Token；
2. 在 Portal 中启用Message Content Intent（必需，否则 Minke 会报"Discord 拒绝了 Message Content Intent"）；若要在服务器内使用，还需给 Bot 授予View Channels / Send Messages / Read Message History权限；
3. 把 Token 粘贴进 Minke 的 Discord 通道设置，点击连接；
4. 在 Discord 中给该 Bot发一条私聊消息，Minke 界面会弹出配对请求（含配对码与过期时间），核对后点击批准配对；
5. 配对完成后，你在私聊中发任务，或在服务器里@Bot、直接回复 Bot 的消息，都能触发 Minke。

Discord 通道的 Gateway v10 接入、心跳重连与消息归一化逻辑见 packages/im-discord/。

🌐 如果自动连接失败，Discord 通道也提供手动备用代理输入框（格式同样是http://主机:端口），留空可恢复自动选择。

六、连接后怎么用：发条消息就能派活

三大通道接通后，使用方式完全一致——把消息当命令：

1. 在微信 / Telegram / Discord 里对 Minke 说："搜索今天的 AI 行业新闻并总结成 5 条要点"；
2. Minke 内部的消息通道（IM Gateway）收到消息后，将其路由给 Minke Agent 执行；
3. Agent 完成后，回复内容会发回同一个 IM 对话，长回复自动按平台限制分片发送。

值得留意的可靠性机制（由共享 IM Gateway 提供，源码在 packages/im-gateway/）：

• 消息不丢：每条消息写入本机持久化收件箱，Agent 暂时不可用时会后台重试；
• 投递可恢复：Agent 生成回复但发送失败时，待发送消息会保留在发件箱，恢复后继续投递；
• 默认拒绝：在 Agent 授权与路由未接通期间，外部消息会被默认拒绝且不会写入本机。

七、安全与隐私要点 🔒

• 凭据本地加密：微信凭据与 Bot Token 均保存在本机受保护存储中，Token 不显示、不上传；
• 最小入口：微信通道只接受扫码账号的私聊消息；Telegram/Discord 依赖配对与 Bot 白名单机制，他人无法直接驱动你的 Agent；
• 可彻底解绑：断开连接、清除 Token、重置本地数据等操作都会同步清理本机凭据；若某通道凭据损坏，可用重建 IM Gateway重置共享收件箱（注意：会删除所有通道的本机凭据与投递记录，操作不可撤销）。

各通道安全契约的详细说明见 packages/im-weixin/THIRD_PARTY_NOTICES.md 与 packages/im-gateway/README.md。

八、常见问题（FAQ）

Q1：微信扫码后一直卡在"已扫码"？A：请在手机端确认登录；若要求验证码，在 Minke 界面输入手机显示的数字码。仍不行则取消后重新连接（微信会话有效期有限）。

Q2：提示"配对待确认"（Telegram/Discord）？A：这是防滥用设计——先在 IM 里给 Bot 发一条私聊消息，Minke 界面出现配对请求后核对配对码并批准。

Q3：Telegram 提示"另一个实例正在使用此 Token"？A：同一 Token 只能有一个长轮询接收方。停掉另一个使用同一 Token 的程序，再在 Minke 中重新连接。

Q4：通道显示"需要处理"状态？A：查看面板给出的具体原因（网络不可达、凭据失效、Agent 暂时不可用等），按其提示重试或重新扫码/重新连接即可，消息在本地已被安全保留。

写在最后

至此，你已经完成 Minke 与微信、Telegram、Discord 三大 IM 通道的全部接入：扫码、贴 Token、批准配对，10 分钟内即可实现"手机一句话，电脑 Agent 开始干活"。Minke 还会持续演进（如远程 Web 访问、PWA 安装等），更多功能可关注 docs/ 目录下的项目文档与 packages/README.md 了解各模块划分。

祝你使用愉快 🚀