Files
zyt/artifacts/ai_stop_confirmation_fix_20261027.md
T
2026-10-27 14:03:35 +08:00

54 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 停止后独立终态确认:有限调度修复
日期:2026-10-27。范围仅为 `AssistantRequestControl.php` 的确认查询调度、新增 `AssistantDelayedTerminalConfirmationTest.php` 和本报告。保留工作区已有修改,没有修改旧测试、Dify 远端状态、控制器、模型配置或凭据。本分工没有网络、真实模型、数据库或真实请求控制文件访问;完整本机浏览器链路验收由主代理执行。
## 修复
10:17 审查已证明,原逻辑在约 308ms 内用掉两次查询;停止 ACK 和流中的 stopped 已到达,独立持久状态仍为 running,因而正确阻止了校正生成,但尚有大部分 2 秒预算没有用于观察最终一致性。
仍保留每代最多 **2 次 GET、原始 2 秒总预算、单次最多 1 秒 I/O、至少 250ms 间隔**。首次 GET 立即进行;首次已得到合法独立终态时立即完成,无额外等待。需要第二次查询时,将其安排在该代有效截止时间前 500ms:普通新预算下约第 1500ms 开始,并只传入剩余时间(最多约 500ms)。若最终恢复调用有更早的共享截止时间,该截止时间只缩小窗口。若现有 250ms 最小间隔已覆盖剩余预算,则不再查询。
`verification_started_at` 和已消费次数从原控制文件读取;等待发生在文件锁和 GC 锁之外。等待后重新原子检查身份、原截止时间、次数和租约,再执行 I/O。后续 close/reconcile/final recovery 无法重置该代预算或增加查询次数。原 task/run/profile/user/generation、submission owner 和 claim token 检查均保留。超出单次 I/O 时限或原截止时间的 terminal 仅能作为带 `within_budget=false` 的观察,不可确认或释放身份。
只有严格 `ok=true`、与原绑定一致的独立持久 stopped/succeeded/failed 仍可放行。ACK、producer stopped、running、过期预算都不能放行;已有取消和超时意图即使清理确认成功仍禁止下一次提交。没有改写 Dify 运行状态。
## 验证结果
通过:
| 命令/测试 | 结果 |
| --- | --- |
| `php -l server/app/adminapi/service/AssistantRequestControl.php` | 无语法错误 |
| `php -l server/tests/AssistantDelayedTerminalConfirmationTest.php` | 无语法错误 |
| `php server/tests/AssistantDelayedTerminalConfirmationTest.php` | **68 条断言通过** |
| `php server/tests/AssistantFinalLifecycleR26Test.php` | 90 条断言通过 |
| `php server/tests/AssistantGenerationWiringR26Test.php` | 34 条断言通过 |
| `php server/tests/AssistantSubmissionOwnershipR26bTest.php` | 31 条断言通过 |
| `php server/tests/AssistantSubmissionRejectionR26bTest.php` | 161 条断言通过 |
| `git diff --check -- server/app/adminapi/service/AssistantRequestControl.php` | 通过 |
新测试使用独立临时目录和可控单调时钟,覆盖早期 running → 1250ms 后 stopped(0ms/1500ms 两次读)、立即持久终态、持续 running、原代预算复用、时钟回退、单次 I/O 超时、最终回调过期、等待和 I/O 时无锁、跨 worker claim、最终查询 token/代次/run/submission 替换、重复调用、取消/超时硬门和更早的整请求截止时间。校验成功后实际申请了一次新的校正 submission,并检查原终态证据保留。
以下旧测试未修改,不能报告为全部通过:
| 测试 | 结果与归属 |
| --- | --- |
| `AssistantPerGenerationLifecycleR26Test.php` | 原先 117 条断言通过;本次在“全局恢复”旧期望处失败。该 fixture 固定假设前两次 GET 各有 1000ms 且还能第三次 GET;新策略将最终一次移到窗口后半段,I/O 余量变小。此为调度改变直接影响的旧时间/次数假设,原安全门断言此前均通过。 |
| `AssistantLifecycleRegressionR26bTest.php` / `AssistantLifecycleRegressionR26cTest.php` | 各 322 条检查;除源码 SHA pin 和同一旧全局调度断言外无行为失败。 |
| `AssistantSubmissionBoundaryIndependentR26cTest.php` | 322 条检查;仅源码 SHA pin 失败,其余行为检查通过。 |
| `AssistantSubmissionWiringR26bTest.php` | 61 条检查;仅已有 controller SHA pin 失败,其余行为检查通过。 |
| `AssistantClosedTransportRecoveryTest.php` | 在缺少严格 `ok=true` 的旧 lookup fixture 处失败;用修改前完全相同的 control 源码重新运行仍同样失败。 |
| `AssistantRequestTerminalReconciliationTest.php` | 在仅 producer 终态清除 handoff 的旧假设处失败;修改前源码同样失败。 |
| `DiagnosisAiAssistantStopCoordinationTest.php` | 在仅 producer 终态放行下一代的旧假设处失败;修改前源码同样失败。 |
| `DifyWorkflowControlIdentityIntegrationTest.php` | `normal_exact_pair_terminal=false`;旧测试仅消费流终态,没有独立持久查询;修改前源码结果完全相同。 |
| `DifyWorkflowRunStatusTest.php` | 在第 238 行以测试自身路径充当 CA 的 fixture 失败(期待 success);本次未改 adapter,测试不加载 control,属本次调度改动之外的既有测试/环境问题,未扩大修复。 |
上述“修改前同样失败”通过临时副本加载修改前 control 复核,没有将工作区源码回滚,也没有修改测试文件。复原副本的 SHA-256 严格等于开始工作时读取值,验证后已清理临时文件。原有测试的 SHA pin 也没有为消除失败而改写。
## 源码指纹与限制
- 本分工修改前 `AssistantRequestControl.php` SHA-256:`e7a43edad2c4c64ba968d52b991b7f0b3dba12de0165a01062cf9be2bcd3ee7d`。
- 本分工修改后 SHA-256:`d94a9aed3fb175f523b2cfa8bfb1d22bf6b82e1eab4618c8803af598591c6e5d`。
该有限策略增加了第二次读前的等待,并将它的最大 I/O 余量缩小为约 500ms。它能覆盖原来约 300ms 后才持久化、且在最终查询时已经持久化的停止状态;持续 running、超过原 2 秒才持久化、或最终查询超过剩余 I/O 时限时仍会安全地保持 pending。离线测试不能证明实际 Dify 实例一定在此窗口内持久化,不能替代主代理的当前本机完整回答验收。