feat(channels): 平台解密、下载限长与 CLI 媒体命令(issue #1 P1)
P0 接好了链路与钩子抽象,但几个实际会让功能不可用的点没处理:企业微信的 aeskey 记录下来后被直接丢弃、远端下载把整份响应读进内存、没有真实平台时 无法造出媒体消息来调试。本次补齐这三块。 企业微信解密: - WeComChannel.make_media_transform 按本条消息的 <media>.aeskey 构造闭包, 用 SDK 的 decrypt_file 解密(IV 取密钥前 16 字节、PKCS#7 去填充)。 不在本仓库重写密码学——那只会多出第二份可能与平台不一致的实现 - 没有对应 url 的密钥时原样返回字节,不猜、不抛:由 MIME 嗅探去判定 - SDK 缺失时抛 MediaRejected(含安装提示),不让 ImportError 冒泡打断整轮 下载限长: - BaseChannel.fetch_remote_media 从 resp.content 整份读改成 client.stream 按块累计,Content-Length 先预检、流式累计超限即中断 - 上限取各类型限制的最大值:此方法拿不到分片类型,宁可放到最宽的一档, 精确的按类型判定仍由 store_media 负责 CLI 媒体入口: - /image <路径>、/file <路径> 解析成本地附件分片,走与其他渠道同一套 media.py 策略(存在性、大小上限、MIME 嗅探、文件名净化),不因为 「本地」就跳过 - 拒绝时降级为一条说明文本而非抛异常:CLI 里抛异常会直接终止输入泵 - _send_media 从打印占位行改为回执真实字节的大小与 sha256 前缀。 CLI 里不存在「发送」这回事,所以不打印「已发送」 顺带修的健壮性问题: - store_media 的临时文件名加 uuid 后缀。原先固定 .part,同一会话并发落盘 同名文件时会互相截断,且 try/finally 保证失败不留半份字节 - read_file_limited 的超限文案原先把同一个数写了两遍(「大于 8 MiB (上限 8 MiB)」),改为「文件大于 8 MiB(上限 8 MiB)」,并注明只多读了 1 字节所以只能说「大于」 - cli.py 的 except Exception 收窄为 (OSError, ValueError, TypeError): CancelledError 必须能穿过这一层 测试:新增 tests/test_media_pipeline.py 43 条,按 issue 的六条验收标准逐条 对应(路径穿越与净化、读取与下载限长、MIME 魔数优先、outbox 上限与上下文 隔离、prepare_inbound 多模态与降级、CLI 收发)。文档 architecture.md 补 安全护栏、平台解密、CLI 入口三段。 未验证(见 PR 描述): - 没有一条真实的企业微信加密媒体消息跑过解密路径,单测里这一环是桩 - 分块传输(Transfer-Encoding: chunked)未构造响应实测中断逻辑
This commit is contained in:
1 parent
2dde0d1160
commit
5ca40c6b0e
6 files changed
+738
-18
No files matched your search
+30
-4
@@ -317,16 +317,42 @@ ChannelManager(
|
||||
`supports_steer = True`。处理链路:
|
||||
|
||||
```
|
||||
ChannelMessage → 校验文本(空文本/纯媒体给固定提示)
|
||||
ChannelMessage → prepare_inbound(附件落盘;小图内联成 image_url 块)
|
||||
→ 无可用内容?→ 回「附件未能接收:<原因>」/「(无输出)」并结束
|
||||
→ ensure_db → ensure_session → list_messages → build_history
|
||||
→ add_message(user)
|
||||
→ add_message(user, 正文 + 附件清单)
|
||||
→ 建 MediaOutbox(本轮出站信箱)
|
||||
→ open_stream() ┬ 支持流式:update(ACK) → stream_task 边生成边覆盖 → finish
|
||||
└ 不支持:run_task → send_text 一次性发送
|
||||
│ → 媒体在文本定稿后单独补一条
|
||||
└ 不支持:run_task → 有媒体走 send_content,否则 send_text
|
||||
→ 补记插话(_persist_steered)→ add_message(assistant)
|
||||
```
|
||||
|
||||
媒体链路(issue #1 的 P0 部分):
|
||||
|
||||
- **入站**:`flows/media_input.prepare_inbound()` 把分片整理成多模态块——小图 base64
|
||||
内联、大图与音视频退化为「路径 + 元信息」、文本类文件抽取正文;单个附件超限/类型
|
||||
拒绝/下载失败只写进 `notes`,不打断整轮。字节落盘在 `home/data/inbound/<session>/`,
|
||||
历史只存正文 + 附件清单,不存字节。
|
||||
- **出站**:`agent/outbox.MediaOutbox` 是本轮的信箱,`send_image` / `send_file` 工具
|
||||
往里登记分片;`run()` 结束后 `drain()` 出来,与正文合成**一条** `OutboundContent`,
|
||||
由出站管线「先文本、再逐个媒体」下发,避免平台上出现两条消息。只有媒体没有正文时
|
||||
不再补「(无输出)」;流式通道只送文本,媒体等文本定稿后单独补一条。
|
||||
- **安全护栏**:所有字节来源(`data` / `local_path` / `url`)都经过
|
||||
`channels/media.py` 的同一套策略——按类型的大小上限、魔数优先的 MIME 判定、
|
||||
可执行扩展名拉黑、文件名净化与根目录约束;远端下载改为流式按块读取,
|
||||
`Content-Length` 先预检、超限即中断,整份读进内存的路径已移除。
|
||||
- **平台解密**:`BaseChannel.make_media_transform()` 按单条消息的 metadata 构造
|
||||
解密钩子(密钥随消息而来,挂在渠道实例上会串台),企业微信用
|
||||
`<media>.aeskey` 走 SDK 的 `decrypt_file`。解密在类型嗅探**之前**执行,并对
|
||||
明文再量一次大小——密文没超不等于明文没超。
|
||||
- **CLI 调试入口**:`/image <路径>`、`/file <路径>` 可以直接在无平台环境造出
|
||||
媒体入站消息;出站 `_send_media` 不再打印占位行,改为回执真实字节的
|
||||
大小与 sha256 前缀(CLI 里没有「已发送」这回事)。
|
||||
|
||||
`ChannelServices` 是它的运行期依赖(`channels` / `settings` / `db` / `hub` / `cache` /
|
||||
历史条数与字符预算 / 发送超时),由 `TaskRunner(deps=...)` 注入。
|
||||
历史条数与字符预算 / 发送超时),由 `TaskRunner(deps=...)` 注入;`media_policy()` 从
|
||||
渠道取媒体大小上限与下载请求头,未知渠道退回默认值(不因为查不到渠道就跳过校验)。
|
||||
`on_error` 钩子会尽量回一句 `ERROR_REPLY`,发送失败只记日志(避免错误处理再次抛错)。
|
||||
|
||||
两个细节:
|
||||
|
||||
Reference in new issue
Block a user