我仔细设计了文档的类目结构，一步一步分解了软件的部署和使用过程，特别是对于安装部署的过程，我写完之后，就自己严格跟着文档在纯净的系统上跟着做，发现有疏漏的地方就立即补充修改。
不要同时启用 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 个文件，而且很快就会出现行为漂移。
国家防总今天下午4时将针对广东的防汛防台风应急响应提升至三级，并同步针对江西、湖南启动防汛四级应急响应。