QQDeepSeekBot 系列 03：媒体解析越多，失败边界越要清楚#

媒体能力的价值#

文本对话只能处理用户直接输入的内容。加入媒体解析后，机器人可以理解图片内容、总结链接、读取文件摘要，甚至把多种输入合并成一次回答。

这些能力能扩展使用场景，但也会带来依赖问题。解析服务可能超时，链接可能打不开，文件可能过大，图片可能格式异常。每种失败都需要单独处理。

失败不能刷屏#

群聊失败提示必须克制。解析失败时，系统可以简短说明失败原因，也可以只记录日志并静默处理。是否提示用户，应该由群配置决定。

如果每次失败都发送长提示，群聊体验会很差。尤其是链接解析、图片下载和模型超时这类问题，短时间内可能重复出现，必须配合频率限制。

链路隔离#

媒体解析失败不能拖垮文本回复。图片解析不可用时，文本问答仍应继续；链接总结失败时，普通对话仍应可用。不同能力之间要隔离，不能让一个模块异常影响全部功能。

这种隔离需要在后端调度层处理。每个媒体任务都有超时、错误捕获和状态记录，主消息流程只接收可用结果。

日志和排查#

失败状态需要进入日志。日志至少记录群号、用户触发、媒体类型、失败阶段、错误摘要和处理结果。这样维护时可以判断问题是配置、网络、文件格式还是外部服务。

日志不应该直接刷到群里。群里只需要必要提示，完整排查信息留给 Studio 或后台查看。

阶段结论#

QQDeepSeekBot 的媒体能力要和失败边界一起设计。能解析更多内容是能力提升，但能在失败时保持安静、可恢复、可排查，才是群聊机器人长期可用的关键。