🛡️ ARK 诊断报告库

我们没有编造用例。以下每一份报告都针对 LangChain / LangGraph / CrewAI 里 真实存在的 issue, 按 4P 框架(Pinpoint → Probe → Prescribe → Publish)逐条剖析, 并附可离线运行的确定性复现脚本

23 份报告 10 个缺陷族 8 份实跑验证复现 1 例当日上游合并 3 次处方回流自身

📚 先从这里开始

🗓 诊断周报

📋 全部诊断报告(按时间倒序)

族标记对应缺陷模式索引中的 F1–F10

W32 · 2026-07-28 ~ 08-03

langchain-exa#39167 · `_get_metadata()` 的伪守护与真值删除

七行内两个反向缺陷:两参 getattr 零防御 + 真值当存在性静默删除 falsy

F10 首例

08-01

langchain-core#39163 · 任务取消把 run 永久留在 pending

CancelledError 属 BaseException,绕过全部终态回调 —— 失败伪装成「什么都没发生」

F3 第 5 例

07-31

langchain-core#39152 · dict prompt 的标量静默丢弃

F8 族新亚型「无声删除」· 6 臂对照离线复现

F8

07-31

langchain-openai#39113 · 合成 lc_ id 泄漏到 Responses API

与 #39100 构成跨 provider 精确镜像:各自「做对了三分之二」

F9

07-29

langchain#39106 · list_keys 越过边界

批次时间基准漂移导致的非确定性一致性缺陷

F7

07-28

langchain-anthropic#39100 · system block id 泄漏到 wire 协议

🏁 诊断当天即被 maintainer 合并修复(PR #39101),方案与 ARK 处方一致

✅ 上游已修

07-28

langchain-core#39099 · 前向引用未解析 → 工具静默变零参数

advertised ≠ enforced schema,12/13 工具空参数数月无人察觉

F3

07-28

langchain-core#39087 · 批次时间基准漂移

F7 族首例 · 非确定性一致性

F7

07-28

langchain-qdrant#39052 · MMR lambda_mult 语义反转

0.0 ↔ 1.0 行为互换 —— 永不抛异常、永远返回合法值、却与用户意图精确相反

F8

07-28

langchain-core#39047 · 官方推荐的 key encoder 100% 崩溃

sha256/sha512/blake2b 全部触发 "not a valid UUID" —— 库自身的弃用建议引向硬崩溃

F8

07-28

langchain#39039 · 流式静默丢弃 response.failed 事件

失败流与成功流无法区分

F3

07-24

W29 – W31

langchain#38989 · usage callback 异常退出后累加器泄漏

F2

07-24

langchain#38904 · 测试掩盖 / 断言失效

F4

07-26

langchain#38893 · 不可重试异常被吞成正常 AIMessage

F3

07-24

langchain#38892 · 合法空流误判失败,备胎静默替换

F3

07-24

langchain#38840 · Perplexity extra_body 参数永久沉淀

F2

07-26

langchain#38779 · Anthropic tool_choice 原地篡改实例状态

F2

07-25

langchain#38708 · 等价并行 tool_call 不去重 → N 倍成本

F1

07-21

langchain#38667 · KeyError DoS

F5

07-24

langchain#35475 · 测试即契约失效

F4

07-23

langchain#38843 · 畸形输入 / DoS

F5

07-15

langchain#34974 · 高并发下重复调用同一工具

F1

07-15

langgraph#6731 · 无限循环 / 递归耗尽

F6

07-15

🔬 离线确定性复现脚本

8 份复现脚本已全部实跑验证:隔离 venv 装齐依赖逐一跑通, 7 例复现诊断缺陷、1 例(#39100)印证上游修复已落地。无需 API key,无需网络。

→ 查看 scripts/repros/ 与验证记录 VERIFICATION.md

ARK — Agent Reliability Kit · github.com/wzg0911/ark

4P Framework: Pinpoint → Probe → Prescribe → Publish · 更新于 2026-08-01