飞书流式卡片更新失败：Agent 回复包含外部图片 URL 时报 invalid image keys

[tianxia3111]

问题描述

当 MoviePilot Agent 在飞书对话回复中使用 Markdown 图片语法（如 ![海报](https://image.tmdb.org/t/p/original/xxx.jpg)）时，飞书流式卡片更新会失败，报错：

飞书流式卡片内容更新失败：card_id=xxx, element_id=mp_stream_body, sequence=7, code=200570, msg=ErrMsg: card contains invalid image keys; ErrorValue: image key https://image.tmdb.org/t/p/original/xxx.jpg

复现步骤

1. 配置飞书通知渠道，启用 Agent 对话功能
2. 向 Agent 发送搜索请求（如搜索电影）
3. Agent 回复中包含 TMDB 海报图片的 Markdown 语法
4. 飞书流式卡片更新失败

问题原因

飞书卡片 API 不支持直接使用外部 URL 作为图片 key。Agent 回复中的 Markdown 图片语法 ![...](url) 被飞书解析为图片 key，但外部 URL 不是有效的飞书 image key。

临时解决方案

在 app/modules/feishu/feishu.py 的 _escape_card_text 方法中，添加正则表达式移除 Markdown 图片语法：

@staticmethod
def _escape_card_text(text: Optional[str]) -> str:
    """转义飞书卡片 markdown 中易误触的字符，同时移除外部图片语法。"""
    if not text:
        return ""
    escaped = str(text)
    import re as _re
    escaped = _re.sub(r"!\[[^\]]*\]\([^)]*\)", "", escaped)
    for source, target in {
        "\\": "\",
        "<": "&#60;",
        ">": "&#62;",
    }.items():
        escaped = escaped.replace(source, target)
    return escaped

建议修复

1. 在 _escape_card_text 方法中自动过滤外部图片语法
2. 或者在 Agent 回复逻辑中，避免直接使用 Markdown 图片语法，改用飞书的图片上传接口

环境信息

• MoviePilot 版本：v2 (latest)
• 部署方式：Docker
• 飞书模块：app/modules/feishu/feishu.py

[jxxghp]

已修复并推送到 v2 分支：052e1ca8

处理内容：

• 飞书 Agent 流式回复中，普通 Markdown 链接会保留。
• Markdown 图片语法会从流式卡片文本中剥离，避免 CardKit 把外链当 image_key 导致 invalid image keys。
• 图片会单独上传并作为图片卡片发送；流式累计过程中未闭合的图片语法会先隐藏，等闭合后再识别发送。
• 上传前会校验远程响应是否确实为图片，普通网页链接不会被当图片上传。

验证：

• ./.venv/bin/python -m pytest -p no:cacheprovider tests/test_feishu.py
• ./.venv/bin/python -m pylint --errors-only app/modules/feishu/feishu.py app/modules/feishu/init.py
• git diff --check