- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2.1 KiB
Executable File
2.1 KiB
Executable File
缺陷记录:LLM 传输失败硬中断 Agent Runtime
| 状态 | Fixed(2026-10-16) — 见 §3;金样 tests/ext/agent-llm-transport-soft.mq.md |
| 日期 | 2026-10-16 |
| 发现方 | qdagent(接通 agent.run live 路径时) |
| 影响面 | host/net · plugins/llm · ext/ai/llm · ext/ai/llm/openai · ext/ai/agent |
| 相关 | agent-run-efi-resolve-bugs-2026-10.md · ext-agent.md |
0. 一句话
上游 LLM 连接拒绝 / 超时 / 非 200 时,Runtime 曾以 硬错误 终止整个 marqdo run;产品(qdagent ASK/BUILD)无法落到结构化 status=error。
1. 复现
OPENAI_API_KEY=offline OPENAI_BASE_URL=http://127.0.0.1:9 \
marqdo run tests/ext/agent-llm-transport-soft.mq.md
# 修复前:exit≠0,error: http POST …
# 修复后:exit 0,ask/step/run 均带 finish|status=error + error 文本
2. 根因
| 层 | 行为 |
|---|---|
host_http_post / SSE |
传输失败 Err(...) → VM abort |
plugins/llm llm_chat_completions |
同上 Err |
ext/ai/llm/openai |
HTTP≠200 → sys.exit 1 |
agent.model_turn / step / plan |
无软失败臂 |
3. 修复清单
| # | 改动 | 文件 |
|---|---|---|
| 1 | 传输失败 → {status:0, body} / SSE error event |
src/host/net.rs |
| 2 | 插件返回 {finish:error, error, …} 而非 Err |
plugins/llm/src/lib.rs |
| 3 | openai 非 200 → 结构化 pack,禁止 sys.exit |
ext/ai/llm/openai.mq.md |
| 4 | llm.ask 透传 error / finish |
ext/ai/llm.mq.md |
| 5 | model_turn / step / plan 收成 status=error |
ext/ai/agent.mq.md |
| 6 | 金样 | tests/ext/agent-llm-transport-soft.mq.md |
契约:Agent Runtime 对 LLM 传输失败必须可捕获;status=error + error 字符串;进程退出码 0(程序正常返回错误图)。
4. 对 qdagent
ensure_llm 有 key 但上游不可达时,ask/build 可走既有 mode=error 臂写 workbook,不再整 CLI 崩。