openbot
|
d0e187f74d
|
feat(flows): 助手出站媒体写入会话历史(issue #1 验收标准 8)
智能体发的附件此前只下发不落库:下一轮模型不知道上一轮发过什么,用户说
「再发大点」时没有可回指的对象。新增 describe_outbound() 把出站分片整理成
一行引用说明(类型/大小/MIME/时长/本地路径),与入站 prepare_inbound 的
summary 格式对齐,只存引用不存字节。
两条处理链都改走 _persist_reply():
- 同步链:原先只在 reply 非空时落库,纯媒体回复会让这一轮完全消失
- 流式链:原先同样只写正文
历史写入保持在发送之前——发送失败不该让下一轮失去上下文,因此不回滚,
且刻意不写「已发送」。
tests: test_builtin 3 条(附件入库、纯媒体入库、发送失败仍入库),
test_stream 补断流式分支的落库断言。变异验证:把两处调用点改回旧写法,
对应断言分别变红。
|
2026-11-10 14:09:29 +08:00 |
|
openbot
|
13b8d7a466
|
test(media): 补分块下载中断与 root 自动创建的实测
上一轮两条「未验证」的敞口,本次用可执行的测试消掉:
分块传输(Transfer-Encoding: chunked):
- download_limited 的 Content-Length 预检对分块响应无效,只剩按块累计
这一道闸。此前只有代码没有测试,无法证明超限时连接真的被中断。
- 新增 _ChunkedServer:起一个真 socket 的最小 HTTP/1.1 服务端,不下发
Content-Length、按 16 KiB 分块持续写 8 MiB。用真连接而不是桩,因为
要验证的正是「读到超限就断开」——桩测不出中断。
- 断言两条:抛 MediaRejected 且 detail 含「已中断」;服务端 sent < total
说明它没能把 8 MiB 写完,即连接在中途被断开,而不是读完再判。
- 变异验证:临时移除 media.py 里的累计判限后,该用例从通过变为
DID NOT RAISE,确认它测的确实是这段逻辑;随后已还原,media.py 与
HEAD 无差异(git diff 为空)。
root 不存在:
- store_media 用 mkdir(parents=True, exist_ok=True) 建目录,但此前没有
断言覆盖「首次运行时 home/data/inbound 还不存在」这条路径。
全量 295 passed,ruff 全绿,新增两条连续跑 3 次均稳定(涉及真 socket
与线程,排除偶发)。
|
2026-11-10 10:22:21 +08:00 |
|
openbot
|
5ca40c6b0e
|
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)未构造响应实测中断逻辑
|
2026-11-10 09:47:30 +08:00 |
|
openbot
|
2dde0d1160
|
feat(flows): 媒体入站进出站链路接线(issue #1 P0)
上一轮提交 9ce0ba0 把 media.py / outbox.py 的骨架铺好了,但没有任何调用方:
入站附件进不了上下文,出站 MediaOutbox 从不被创建,send_image / send_file
两个工具因此恒定返回「当前不在渠道会话中」。本次把链路接上。
入站:
- AgentReply 改用 prepare_inbound 整理分片:小图内联为 image_url 块,
大图与音视频退化为「路径 + 元信息」,文本类文件抽取正文进上下文
- 附件全部失败时回「附件未能接收:<原因>」,不再误报成「(无输出)」
- 正文用 prepared.summary(正文 + 附件清单),历史只存清单不存字节
- 只有正文发纯文本,带附件才发 content blocks(is_multimodal)
出站:
- 每轮创建一个 MediaOutbox 传给 run_task / stream_task,工具往里登记分片,
跑完 drain() 出来与正文合成一条 OutboundContent
- 只有媒体没有正文时不再补「(无输出)」;流式通道文本定稿后单独补发媒体
- ChannelServices.send_content 统一走「先文本、再逐个媒体」
解密钩子的抽象层:
- BaseChannel.media_transform(part, raw) 默认原样返回
- BaseChannel.make_media_transform(metadata) 按单条消息构造钩子。密钥随消息
而来,挂在渠道实例上会让并发处理的两条消息串用彼此的密钥
- ChannelServices.media_transform 从渠道取钩子,渠道未注册时返回 None
(不解密,但也不跳过后续的类型与大小校验)
- media.py 新增 MediaTransform 类型与 store_media(transform=)。钩子在类型嗅探
与大小判定之前执行——对密文嗅魔数只会得到 octet-stream——并在转换后对明文
再量一次上限,因为密文没超不等于明文没超
测试:test_builtin 增加 6 条媒体用例(文本+图、纯图、附件全失败、出站下发、
仅媒体不补空文案、流式补发),test_service / test_stream 的 fake_run_task 补
outbox 形参。全量 250 passed,ruff 全绿。
P0 边界说明:本提交只做接线与抽象,不含企业微信的具体解密实现、下载限长、
CLI 媒体命令与 docs 更新,这些在下一个提交(P1)。
|
2026-11-10 09:46:16 +08:00 |
|
openbot
|
9ce0ba0e13
|
feat(channels): 媒体入站链路接入,出站骨架就位(未接线)+ 空内容判定修复
媒体功能是上一轮智能体自改代码时留下的 WIP(那轮步数耗尽被中断)。
本次把手头完成度较高的部分整理到可提交状态,并修掉其中两处判定 bug。
入站(已可用):
- 新增 flows/media_input.py:附件先落盘再进上下文,小图内联为 base64,
大图与音视频退化为「路径 + 元信息」,附件级失败只降级为说明而不打断整轮
- processor 改用 prepare_inbound,文本 / 多模态输入据此决定发纯文本还是
content blocks
出站(骨架就位,尚未接线):
- 新增 agent/outbox.py、channels/media.py(大小与类型校验、限长下载 / 读取)
- 新增 send_image / send_file 工具、ChannelServices.send_content、
MessageEvent.content_event / media_event
- 目前还没有任何调用方创建 MediaOutbox,因此这两个工具一律返回
「当前不在渠道会话中」;渠道侧的 _send_media 由各平台子类实现
修复:
- prepare_inbound 不再塞「(无内容)」占位块:占位块会让 has_content 恒真,
空消息也能一路跑到 run_task,白烧一次模型调用
- 新增 PreparedInbound.is_multimodal 取代 len(blocks) > 1 的猜测:
「只有一张图、没有正文」时 blocks 只有 1 个,原逻辑会把附件丢掉
- 附件全部接收失败时回「附件未能接收:<原因>」,不再误报「空消息」
- 顺手清掉 ruff 告警(未用导入、__all__ 未排序、嵌套 if / with)
测试:test_processor 拆成三个用例(空消息 / 附件全失败 / 仅附件必须发
blocks,最后一条是防回潮的回归测试),全量 243 passed,ruff 全绿。
|
2026-11-09 21:33:50 +08:00 |
|
openbot
|
5da55f8d17
|
fix(flows): 步数预算与图硬上限分离,预算耗尽时优雅收尾
max_steps 以前同时充当软预算和 recursion_limit,于是预算耗尽的那一刻
必然触发 GraphRecursionError:模型连一句收尾都来不及说,用户只收到
「处理消息时出错,请稍后再试」,已产出的内容也不会落库。
- 新增 StepBudgetMiddleware:按模型调用轮数计账(agent_rounds =
max_steps // 2),剩余 <=4 轮时注入一次「立刻停止调用工具、给出结论」
的收尾提示,只提醒一次
- 新增 STEP_GRACE(20),recursion_limit = max_steps + STEP_GRACE,把余量
留给收尾动作
- GraphRecursionError 统一转成 StepBudgetExceeded,ainvoke 与流式两条
路径都覆盖
- AgentReply 把「步数用尽」渲染成可操作说明,接在已产出内容之后一并
下发并落库;用 _reported 标记让 on_error 不再补发通用错误文案,任务
状态仍如实记 failed
- 同步 README / docs/architecture.md / db/schema.py 中 max_steps 的语义
测试:新增 tests/test_budget.py(7 个用例),全量 241 passed。
|
2026-11-09 21:32:29 +08:00 |
|
openbot
|
fbb01c4c83
|
feat: 重构为 agent / channels / flows / db 分层架构
- agent: 新增 base.py 执行基类、execution.py 执行器、web.py 网络工具,
middlewares/steering.py 中间件;移除旧的 agent.py
- channels: 新增 ChannelManager、registry、models 与 IM 渠道(企业微信),
扩展 base.py
- flows: 新增 agent_task / bus / cron / scheduler / service / stream / rpc /
processor / tasks / model_settings / builtin;移除旧的 task.py
- db: 新增 sqlite schema 与 repo 层
- docs: 新增架构说明、Channel × EventBus 设计、任务编写教程
- 依赖新增 aiosqlite / httpx / langgraph / primp / pydantic / ripgrep /
wecom-aibot-sdk;新增 bot 命令入口
- 测试:232 passed
|
2026-11-09 20:32:25 +08:00 |
|
openbot
|
94421e5c2b
|
chore: 初始化 bot042 项目(uv + deepagents)
|
2026-11-05 14:49:27 +08:00 |
|