- 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。
59 lines
2.1 KiB
Markdown
Executable File
59 lines
2.1 KiB
Markdown
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](agent-run-efi-resolve-bugs-2026-10.md) · [ext-agent.md](../design/ext-agent.md) |
|
||
|
||
---
|
||
|
||
## 0. 一句话
|
||
|
||
上游 LLM **连接拒绝 / 超时 / 非 200** 时,Runtime 曾以 **硬错误** 终止整个 `marqdo run`;产品(qdagent ASK/BUILD)无法落到结构化 `status=error`。
|
||
|
||
---
|
||
|
||
## 1. 复现
|
||
|
||
```bash
|
||
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 崩。
|