iomgaa
f3e06eac89
Registration pages carry the chosen approach, why the split is by "which budget the time consumes", the five rejected alternatives with reasons, and the 3.6 correction found during independent verification.
36 lines
1.9 KiB
Markdown
36 lines
1.9 KiB
Markdown
---
|
|
type: plan
|
|
node_id: plan:issue8-stall-budget-plan
|
|
title: "issue #8 实施计划: stall 非生产性等待口径"
|
|
date: 2026-08-06
|
|
---
|
|
|
|
# issue #8 实施计划: stall 非生产性等待口径
|
|
|
|
**全文**: `plans/2026-08-06-issue8-stall-budget.md` |**实现**: [[design:issue8-stall-budget]] |**分支**: `feat/issue-8-stall-budget`
|
|
|
|
## 交付
|
|
|
|
| 任务 | 内容 | 提交 |
|
|
|---|---|---|
|
|
| T1 | `StallClock` 落地 + chat 路径改造 + 8 条测试 | `02c3d06` |
|
|
| T2 | embedding 路径复用 | `6d0f3c9` |
|
|
| T3 | ocr 路径复用 | `0477d95` |
|
|
| T4 | `config.py` docstring 与 `.env.example` 注释对齐(无逻辑变更) | `d05114e` |
|
|
| T5 | 全套件回归 + `ARCHITECTURE.md` §7.3 与 `CHANGELOG` 同步 | `3645e57` |
|
|
| T6 | 独立验证(全新上下文 verifier)+ 三个问题的修复 | `bc4683d`、`a0a5cf7` |
|
|
|
|
## 测试证据(先失败后通过)
|
|
|
|
三条路径的失效链条各有一条回归用例,改前均转红于 `reason="stalled"`:`retry.py:218`、`embedding.py:250`、`ocr.py:275`。issue 只记录了 chat 路径,embedding/ocr 两条为本次核出。
|
|
|
|
## 独立验证发现的三个问题(均已修)
|
|
|
|
1. **429 缝隙(中)**: 初稿使 429 尝试两个预算都不烧,慢 429 场景实测挂 25.2 小时——**修复引入的回归**。见设计 §3.6。
|
|
2. **测试假证据(中)**: 并发用例用了两个 `RetryMW` 实例,实例级共享被对象隔离掩盖,clock 提升为实例属性时 7 条用例全部逃逸。改为复用同一 `mw` 并补"两次调用间空转超窗"用例,变异测试确认可抓。
|
|
3. **文档遗漏(轻)**: 计划要求的 `test_backpressure.py` docstring 订正漏做。
|
|
|
|
## 保真校验
|
|
|
|
治理主循环为 CHS `governance.py:200-285` 移植物,但 `reference/` 不在工作区,故以设计 §4 行为审计表 9 条 + 代码内 CHS 行号注释为基准。核对结果:标"保留"的 8 条在 `git diff` 中零出现,唯一"替换"项为条件 A 度量口径。
|