Files
marqdo/doc/research/agent-llm-transport-soft-2026-10.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- 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。
2026-11-18 10:29:26 +08:00

2.1 KiB
Executable File
Raw Permalink Blame History

缺陷记录: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 崩。