7418andClaude Opus 4.6
b1a043a995
Bridge 新增"边生成边显示"能力，利用 Telegram Bot API 9.5 的 sendMessageDraft 在私聊中以草稿形式流式展示 Claude 生成进度。 架构上抽象为通道级可选能力，便于后续扩展到其他 IM。 types.ts - 新增 PreviewCapabilities、StreamingPreviewState 接口 channel-adapter.ts - BaseChannelAdapter 新增三个可选方法： getPreviewCapabilities / sendPreview / endPreview - sendPreview 返回 'sent'|'skip'|'degrade' 三态， 区分瞬时失败（跳过）和永久失败（降级） telegram-utils.ts - 新增 sendMessageDraft() API 封装（plain text，截断到 4096） telegram-adapter.ts - 实现 getPreviewCapabilities: 开关检查 + 私聊/群聊检测 + 降级状态 - 实现 sendPreview: 调 sendMessageDraft，400/404 永久降级，429 仅跳过 - 实现 endPreview: 空操作 - stop() 清空 previewDegraded Set conversation-engine.ts - 新增 OnPartialText 回调类型 - processMessage / consumeStream 透传 onPartialText 参数 - 使用独立 previewText 变量（只累积、不因 tool_use 清零）， 避免预览文本在工具调用后回退/抖动 bridge-manager.ts - 流式预览状态机：generateDraftId / getStreamConfig / flushPreview 节流闭包（间隔+最小增量+trailing-edge timer），finally 清理 - flushPreview 仅在 'degrade' 时降级，'skip'/网络错误不降级 - 新增 deliverResponse() 按 channelType 分发渲染： Telegram → markdownToTelegramChunks + deliverRendered 其他 IM → deliver() 纯文本（内部自动分块） 解除 handleMessage 对 Telegram 渲染的硬编码依赖 delivery-layer.ts - deliverRendered: chunk 失败后继续投递剩余 chunk（不中断）， 追发截断提示通知用户，返回 ok:false 标识不完整投递 - deliver: 保持原有 fail-fast 行为（短消息无需跳过） route.ts (bridge/settings) - BRIDGE_SETTING_KEYS 白名单追加 5 个流式配置项 docs/handover/bridge-system.md - 更新目录结构、数据流、设计决策（#12 流式预览）、设置项表 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Handover / 交接文档
系统架构、数据流、关键设计决策的持久化记录，供后续开发者（含 AI）快速上手。
AI 须知：修改或新增文件后更新下方索引；检索本目录前先读此文件。
索引
| 文件 | 主题 |
|---|---|
| agent-tooling-todo-bridge.md | SDK → SSE → DB 事件流、TodoWrite 字段映射、去重策略 |
| bridge-system.md | 多 IM 远程桥接系统架构（目录结构、数据流、设计决策） |