mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-16 13:03:31 +08:00
ddcfa5faae
Add a WhatsApp adapter backed by Baileys linked-device auth, plus desktop QR binding UI, server config endpoints, sidecar startup wiring, tests, and documentation. Constraint: Uses WhatsApp Web linked-device auth, not Meta WhatsApp Business Cloud API. Tested: - cd adapters && bun run check:adapters - bun test src/server/__tests__/adapters.test.ts - cd desktop && bun run check:desktop - bun run check:native - bun run check:persistence-upgrade - bun run check:docs Not-tested: - Live WhatsApp QR pairing, because no WhatsApp account/device was exercised here. - bun run check:server, because the existing src/server/__tests__/conversations.test.ts timeout still fails independently. Confidence: medium Scope-risk: moderate
112 lines
3.3 KiB
Markdown
112 lines
3.3 KiB
Markdown
# Claude Code IM Adapters
|
|
|
|
当前目录只放 IM Adapter 运行时代码。
|
|
|
|
用户文档已经迁移到 `docs/`，并且以 Desktop Webapp 配置流程为准：
|
|
|
|
- `docs/im/index.md`
|
|
- `docs/im/wechat.md`
|
|
- `docs/im/dingtalk.md`
|
|
- `docs/im/whatsapp.md`
|
|
- `docs/im/telegram.md`
|
|
- `docs/im/feishu.md`
|
|
|
|
## 当前方案摘要
|
|
|
|
当前真实链路是：
|
|
|
|
```text
|
|
Desktop Webapp Settings
|
|
-> /api/adapters
|
|
-> ~/.claude/adapters.json
|
|
-> adapters/<platform>/index.ts
|
|
-> /api/sessions + /ws/:sessionId
|
|
-> Claude Code session
|
|
```
|
|
|
|
注意两点：
|
|
|
|
- IM 配置和配对都在 Desktop Webapp 的 `Settings -> IM 接入`
|
|
- Webapp 不会自动启动 Adapter 进程，仍需手动运行 `bun run wechat`、`bun run dingtalk`、`bun run telegram` 或 `bun run feishu`
|
|
|
|
## 快速启动
|
|
|
|
```bash
|
|
cd adapters
|
|
bun install
|
|
bun run telegram
|
|
# 或
|
|
bun run feishu
|
|
# 或
|
|
bun run wechat
|
|
# 或
|
|
bun run dingtalk
|
|
# 或
|
|
bun run whatsapp
|
|
```
|
|
|
|
## 开发
|
|
|
|
### 运行测试
|
|
|
|
```bash
|
|
cd adapters
|
|
bun test
|
|
bun test common/
|
|
bun test telegram/
|
|
bun test feishu/
|
|
bun test wechat/
|
|
bun test dingtalk/
|
|
bun test whatsapp/
|
|
```
|
|
|
|
### 目录结构
|
|
|
|
```text
|
|
adapters/
|
|
├── common/
|
|
│ └── attachment/ # 跨平台附件工具(types / limits / store / image-watcher)
|
|
├── telegram/
|
|
│ └── media.ts # TelegramMediaService(grammy Bot API 封装)
|
|
├── feishu/
|
|
│ ├── media.ts # FeishuMediaService(@larksuiteoapi/node-sdk 封装)
|
|
│ └── extract-payload.ts # 入站 im.message.receive_v1 事件解析
|
|
├── wechat/
|
|
│ ├── protocol.ts # 微信 iLink QR 登录 / getupdates / sendmessage 协议封装
|
|
│ └── index.ts # 微信文本聊天 Adapter
|
|
├── dingtalk/
|
|
│ ├── helpers.ts # 钉钉 Stream 消息解析与会话键
|
|
│ └── index.ts # 钉钉扫码绑定 / Stream 文本聊天 Adapter
|
|
├── whatsapp/
|
|
│ ├── session.ts # Baileys socket / auth state 封装
|
|
│ ├── protocol.ts # WhatsApp QR 登录 / 解绑协议封装
|
|
│ └── index.ts # WhatsApp Web 私聊 Adapter
|
|
├── package.json
|
|
├── tsconfig.json
|
|
└── README.md
|
|
```
|
|
|
|
## 附件收发
|
|
|
|
两个 Adapter 都支持双向图片/文件,和 Desktop 端走同一套 `AttachmentRef` 协议透传给主进程。
|
|
|
|
**入站(用户 → Claude):**
|
|
|
|
- 飞书: 图片(jpg/png/gif/webp/heic)、文档(doc/xls/ppt/pdf 等)、post 富文本里的 img/file 元素
|
|
- Telegram: photo、document、video、audio、voice
|
|
- WhatsApp: image、document、video、audio、sticker
|
|
|
|
下载落地到 `~/.claude/im-downloads/{platform}/{sessionId}/`,24 小时后自动 GC(`.part` 孤文件 10 分钟超时)。大小限制:单张图 ≤10 MB、单个文件 ≤30 MB,超限直接拒收并在 IM 里提示。
|
|
|
|
**出站(Claude → 用户):**
|
|
|
|
Agent 流式文本里的 markdown 图片引用 `` 会被 `ImageBlockWatcher` 识别、上传到 IM 平台,作为独立图片消息发出:
|
|
|
|
- 飞书: `im.message.create(msg_type='image')` 单发(card 内嵌是后续优化)
|
|
- Telegram: `bot.api.sendPhoto(InputFile)` 单发
|
|
- WhatsApp: Baileys `sendMessage({ image })` 单发
|
|
|
|
非图片类出站(Agent 产的 pdf/zip 等)暂不支持。
|
|
|
|
设计细节: `docs/superpowers/specs/2026-04-11-im-attachment-support-design.md`。
|