渠道层的内容模型与 WeCom 适配器的媒体收发已经实现,缺的是中间环节。现状盘点(均已核对代码):
data
local_path
url
channels/models.py:22-102
load_media_bytes
channels/base.py:613-639
channels/base.py:603-611
channels/im/wecom.py:188-247
channels/im/wecom.py:356-387
channels/base.py:478-486
但媒体目前走不通——下面是四处断点。
flows/processor.py:100-103 和 flows/builtin.py:270-274 都是先取纯文本,取不到就回一句固定文案:
flows/processor.py:100-103
flows/builtin.py:270-274
text = message.text.strip() if not text: yield MessageEvent.error_event("(空消息,已忽略)" if not message.has_media else "暂仅支持文本消息") return
后果:用户发一张图(或一个文件、一条语音、一段视频),智能体收不到,用户收到"暂仅支持文本消息"。文本+图片混合的消息则只有文本进入模型,图片被静默丢弃。
出站管线(base.py:478-486)已经能把 MessageEvent 里的媒体分片下发,但没有任何构造入口:
base.py:478-486
MessageEvent
MessageEvent.text()
error_event()
TextContent
models.py:216-249
MediaContent
models.py:102
src/
即:智能体没有"发图片/发文件"的工具,也没有能带媒体的事件构造器。
wecom.py:181-186 把每个媒体 URL 的 aeskey 记进 metadata["_media_aes_keys"](wecom.py:262),但没有任何地方用它解密:
wecom.py:181-186
aeskey
metadata["_media_aes_keys"]
wecom.py:262
fetch_remote_media
base.py:603
_strip_ephemeral_push_meta
wecom.py:425
_media_aes_keys
aes
tests/test_channels_wecom.py:104-111 只断言 key 被记录,不验证解密。
tests/test_channels_wecom.py:104-111
⚠️ 未核实:aeskey 的存在是否意味着该 URL 返回密文,我无法从代码确认(需要真实 WeCom 消息样本或官方文档)。若确为密文,当前入站媒体下载会得到无法使用的字节。
load_media_bytes 把整个文件/响应读进内存(path.read_bytes() / resp.content),顶部无大小上限。全仓 grep max_size / limit.*bytes 只命中 queue_maxsize(消息条数)。一个 2GB 视频会直接打爆内存。同时无 mime 白名单、无下载超时、落盘路径未做隔离校验。
path.read_bytes()
resp.content
max_size
limit.*bytes
queue_maxsize
P0|入站贯通
image_url
processor.py:100
builtin.py:273
P0|出站贯通 4. 新增智能体工具(如 send_file / send_image),产出带媒体分片的 MessageEvent,复用 base.py:478-486 现有下发路径。 5. 补充 MessageEvent 的媒体工厂方法。
send_file
send_image
P1|安全与正确性 6. 大小上限、mime 白名单、下载超时、落盘路径规范化(防 ../ 穿越),超限时降级为文本提示而不是抛异常。 7. WeCom aeskey 解密:先确认平台是否返回密文,再实现 AES-CBC 解密并接入 fetch_remote_media 覆写。
../
P2|其余 8. 历史持久化:当前 processor.py:116 把 content=text 存库,媒体不入历史。建议存引用(路径 + 类型 + 摘要),不存字节。 9. CLI 渠道 _send_media(cli.py:135-139)目前只打印占位行;补齐本地路径收发,便于无平台环境下调试。
processor.py:116
content=text
_send_media
cli.py:135-139
pytest
processor.py
builtin.py
tests/test_processor.py
tests/test_builtin.py
tests/test_stream.py
EMPTY_REPLY
No dependencies set.
The note is not visible to the blocked user.
背景
渠道层的内容模型与 WeCom 适配器的媒体收发已经实现,缺的是中间环节。现状盘点(均已核对代码):
data/local_path/url三级字节来源channels/models.py:22-102load_media_byteschannels/base.py:613-639channels/base.py:603-611channels/im/wecom.py:188-247channels/im/wecom.py:356-387channels/base.py:478-486但媒体目前走不通——下面是四处断点。
断点
1. 入站媒体到不了智能体(P0,阻断)
flows/processor.py:100-103和flows/builtin.py:270-274都是先取纯文本,取不到就回一句固定文案:后果:用户发一张图(或一个文件、一条语音、一段视频),智能体收不到,用户收到"暂仅支持文本消息"。文本+图片混合的消息则只有文本进入模型,图片被静默丢弃。
2. 智能体无法产出媒体(P0,阻断)
出站管线(
base.py:478-486)已经能把MessageEvent里的媒体分片下发,但没有任何构造入口:MessageEvent.text()/error_event()等工厂只构造TextContent(models.py:216-249)MediaContent类型别名在models.py:102定义后,src/内零处引用(全仓 grep 只命中定义行)即:智能体没有"发图片/发文件"的工具,也没有能带媒体的事件构造器。
3. WeCom 加密媒体拿不到明文(P1)
wecom.py:181-186把每个媒体 URL 的aeskey记进metadata["_media_aes_keys"](wecom.py:262),但没有任何地方用它解密:fetch_remote_media(base.py:603)是普通 GET,不解密_strip_ephemeral_push_meta(wecom.py:425)直接把_media_aes_keys丢掉aes无任何解密实现tests/test_channels_wecom.py:104-111只断言 key 被记录,不验证解密。4. 无资源护栏(P1)
load_media_bytes把整个文件/响应读进内存(path.read_bytes()/resp.content),顶部无大小上限。全仓 grepmax_size/limit.*bytes只命中queue_maxsize(消息条数)。一个 2GB 视频会直接打爆内存。同时无 mime 白名单、无下载超时、落盘路径未做隔离校验。方案建议
P0|入站贯通
image_url(base64 或 URL),文档按可抽取文本处理,音视频先只传元信息 + 落盘路径。processor.py:100/builtin.py:273的"仅文本"门禁:文本为空但有媒体时继续走智能体,提示语改为媒体摘要。P0|出站贯通
4. 新增智能体工具(如
send_file/send_image),产出带媒体分片的MessageEvent,复用base.py:478-486现有下发路径。5. 补充
MessageEvent的媒体工厂方法。P1|安全与正确性
6. 大小上限、mime 白名单、下载超时、落盘路径规范化(防
../穿越),超限时降级为文本提示而不是抛异常。7. WeCom
aeskey解密:先确认平台是否返回密文,再实现 AES-CBC 解密并接入fetch_remote_media覆写。P2|其余
8. 历史持久化:当前
processor.py:116把content=text存库,媒体不入历史。建议存引用(路径 + 类型 + 摘要),不存字节。9. CLI 渠道
_send_media(cli.py:135-139)目前只打印占位行;补齐本地路径收发,便于无平台环境下调试。验收标准
../)→ 落盘路径被限制在会话目录内pytest全绿非目标
风险
processor.py/builtin.py两条处理链,历史与流式逻辑耦合较紧,需回归tests/test_processor.py、tests/test_builtin.py、tests/test_stream.pyEMPTY_REPLY分支的既有测试断言需要同步调整