mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-27 15:13:37 +08:00
c032e38081
Major upstream changes integrated: - providers list drag-and-drop reordering (#753) - streaming stability fixes for slow providers (#766) - active-turn prompt queue with edit/dedupe (#755) - H5 access tokens / ports / background sessions (#767, #764) - OpenAI prompt cache semantics (#789) - exit plan approvals preview (#793) - Windows settings panel stability (#788, #791) - file path expansion when revealing generated files (#776) - in-app browser preview menus (#761) - auto-dream background memory consolidation - compactCount tracking on sessions - streamingResponseChars metric - v0.4.2 release notes Conflict resolution highlights: - providerService: kept HEAD's markThinkingIncompatible + upstream's reorderProviders side-by-side - types/provider: kept FetchModelsSchema + ReorderProvidersSchema both - Settings.tsx: migrated HEAD's compat/thinking badges into upstream's SortableProviderCard slots - chatStore: kept both message-queue implementations (messageQueue + queuedUserMessages) - compact_boundary: merged HEAD's registerCompactionAndShouldSuggest with upstream's compactCount field - exposed __resetCompactionThrashForTesting to fix cross-test state pollution exposed by upstream's new compactCount=2 test Verification: - desktop tsc --noEmit: clean - desktop test suite: 1789/1792 pass (3 pre-existing electron/terminal Windows-only failures, not regressions) - server providers test: 95/95 pass - desktop chatStore tests: 131/131 pass - desktop settingsStore + WorkspacePanel tests: 65/65 pass
Claude Code IM Adapters
当前目录只放 IM Adapter 运行时代码。
用户文档已经迁移到 docs/，并且以 Desktop Webapp 配置流程为准：
docs/im/index.mddocs/im/wechat.mddocs/im/dingtalk.mddocs/im/whatsapp.mddocs/im/telegram.mddocs/im/feishu.md
当前方案摘要
当前真实链路是：
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
快速启动
cd adapters
bun install
bun run telegram
# 或
bun run feishu
# 或
bun run wechat
# 或
bun run dingtalk
# 或
bun run whatsapp
开发
运行测试
cd adapters
bun test
bun test common/
bun test telegram/
bun test feishu/
bun test wechat/
bun test dingtalk/
bun test whatsapp/
目录结构
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。