我仔细设计了文档的类目结构，一步一步分解了软件的部署和使用过程，特别是对于安装部署的过程，我写完之后，就自己严格跟着文档在纯净的系统上跟着做，发现有疏漏的地方就立即补充修改。
不要同时启用 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 干一个活，不是发一次请求，是连着发十几到几十次工具调用。这一长串请求里，只要有一次卡了十秒，你整个任务的体感就崩了。平均值把这种“偶尔的暴雷”给抹平了，而你实际感受到的，恰恰是那些暴雷的瞬间。