不要同时启用 sundablog.pf4j.legacy-bootstrap-enabled=true，否则旧启动器与 starter 可能重复加载或启动插件。
join(results) 坑 6：流式输出的解析 LangGraph 支持多种 stream mode：updates、values、messages、custom、checkpoints 等。
path.exists(HISTORY_FILE): return [] try: with open(HISTORY_FILE, 'r', encoding='utf-8') as f: return json.
道理很简单：Agent 干一个活，不是发一次请求，是连着发十几到几十次工具调用。这一长串请求里，只要有一次卡了十秒，你整个任务的体感就崩了。平均值把这种“偶尔的暴雷”给抹平了，而你实际感受到的，恰恰是那些暴雷的瞬间。
这就是"单一真相来源"（Single Source of Truth）的威力。如果追问逻辑要在每个 Skill 里重复写一遍，改一次要改 5 个文件，而且很快就会出现行为漂移。