用途：这是一份面向 Python 的 LangChain 1.0 / LangGraph 1.0 报错诊断参考，用于快速把终端中相同的十余种 traceback 匹配到具体原因和修复方式，减少排查时间。它属于诊断工具，不是预防工具，使用前提是已有报错或可复现的 bug。
主要能力：收录 14 条目录项（E01–E14），分三类。A 类导入与迁移错误（0.2/0.3 → 1.0，见 import-migration.md），如顶层 langchain.chat_models 重导出被移除导致 ImportError、LLMChain 等旧链类被 LCEL 取代、旧 memory 类被 LangGraph checkpointing 取代、initialize_agent 等旧 agent 工厂被 create_react_agent 取代、AgentAction 字段更名、langchain-anthropic 与 anthropic 版本不匹配。B 类内容形态与提示模板错误（见 content-shape.md），如 AIMessage.content 为 list 导致 'list' object has no attribute 'lower'、LCEL 各阶段字典结构不匹配的 KeyError、ChatPromptTemplate 默认 f-string 解析把用户输入的花括号当作模板变量。C 类 agent 与图执行陷阱（见 graph-traps.md），如 GraphRecursionError 默认 recursion_limit=25、handle_parsing_errors 吞掉工具异常、缺少 thread_id 导致多轮记忆丢失、状态含 datetime 等无法 JSON 序列化、router 返回不在 path_map 中导致图静默终止。
使用方式：先读 traceback 第一行，按异常类与报文子串在目录或分诊决策树中匹配（匹配报文而非调用位置），再套用一行修复或跳转参考文件查看前后代码与 codemod；每条目录项都给出可在 CI 中捕获该错误的测试思路。示例命令保持原样，例如 pip install "langchain-openai>=1.0,<2.0" "langchain-cli>=0.1" 与 python -m langchain_cli migrate src/。若无法匹配，查阅 triage-decision-tree.md 与 docs/pain-catalog.md。
限制：版本固定为 langchain-core 1.0.x、langchain 1.0.x、langgraph 1.0.x，验证日期 2026-04-21，需 Python 3.10+ 及 1.0.x 的 provider 集成包；不匹配的 traceback 不应在此添加猜测性修复。资料未提供收费、价格与平台信息。