6.0 KiB
停止后独立终态确认:有限调度修复
日期: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.phpSHA-256:e7a43edad2c4c64ba968d52b991b7f0b3dba12de0165a01062cf9be2bcd3ee7d。 - 本分工修改后 SHA-256:
d94a9aed3fb175f523b2cfa8bfb1d22bf6b82e1eab4618c8803af598591c6e5d。
该有限策略增加了第二次读前的等待,并将它的最大 I/O 余量缩小为约 500ms。它能覆盖原来约 300ms 后才持久化、且在最终查询时已经持久化的停止状态;持续 running、超过原 2 秒才持久化、或最终查询超过剩余 I/O 时限时仍会安全地保持 pending。离线测试不能证明实际 Dify 实例一定在此窗口内持久化,不能替代主代理的当前本机完整回答验收。