make ai follow-up suggestions optional (#3591)

CHANGELOG.md

@@ -1,326 +0,0 @@
-# Changelog
-
-All notable changes to DeerFlow are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [2.0.0] — 2026-06-15
-
-DeerFlow 2.0 is a ground-up rewrite around a "super agent" harness with
-sub-agents, persistent memory, sandbox execution, and an extensible
-skills/tools system. It shares no code with the 1.x line, which now lives on
-the [`main-1.x` branch](https://github.com/bytedance/deer-flow/tree/main-1.x).
-
-This release closes [milestone 2.0.0](https://github.com/bytedance/deer-flow/milestone/1)
-with **102 merged pull requests** since the first 2.0 milestone tag.
-
-### ⚠ Breaking changes
-
-- **harness:** Hydrate runs from `RunStore` and persist interrupted status. Run
-  cancellation/multitask semantics now require a working RunStore on the
-  worker that owns the run; cross-worker cancels return 409 instead of
-  silently appearing successful. ([#2932])
-
-### Added
-
-#### Agents & runtime
-- **agent:** Custom-agent self-updates with user isolation — agents can persist
-  edits to their own `SOUL.md` / `config.yaml` from inside a normal chat.
-  ([#2713])
-- **loop-detection:** Make loop detection configurable with per-tool frequency
-  overrides; keep configurable on/off switch. ([#2586], [#2711])
-- **loop-detection:** Defer warning injection so detector pairs cleanly with
-  tool-call lifecycle. ([#2752])
-- **run:** Propagate `model_name` from the gateway request through the runtime
-  and persistence stack into the SQLite-backed store. ([#2775])
-- **subagents:** Stream subagent token usage to the header via terminal task
-  events. ([#2882])
-
-#### Models & integrations
-- **models:** Add StepFun reasoning model adapter. ([#3461])
-- **community:** Add Brave Search web search tool. ([#3528])
-- **channels:** Enhance Discord with mention-only mode, thread routing, and
-  typing indicators. ([#2842])
-- **im:** Add user-owned IM channel connections — users can bind their own
-  Slack/Telegram/Discord/Feishu/DingTalk/WeChat/WeCom accounts on top of the
-  operator-configured bots. ([#3487])
-
-#### Observability
-- **trace:** Set the LangGraph trace name to `lead_agent` (or the custom
-  agent's `agent_name`) for cleaner Langfuse/LangSmith traces. ([#3101])
-- **frontend:** Refine token usage display modes. ([#2329])
-- **defaults:** Enable token usage tracking by default. ([#2841])
-- **defaults:** Raise default summarization trigger threshold. ([#3174])
-
-### Performance
-
-- **harness:** Push thread metadata filters into SQL instead of post-filtering
-  in Python. ([#2865])
-- **runtime:** Index runs by `thread_id` to avoid O(n) scans in `RunManager`.
-  ([#3499])
-- **runtime:** Index messages in `MemoryRunEventStore` to avoid O(n) scans.
-  ([#3531])
-
-### Security
-
-- **upload:** Reject symlinked upload destinations. ([#2623])
-- **uploads:** Add Windows support for safe symlink-protected uploads.
-  ([#2794])
-- **mcp:** Mask sensitive values in MCP config API responses. ([#2667])
-- **mcp:** Harden the MCP config endpoint against malformed input. ([#3425])
-- **auth:** Reject cross-site auth POSTs. ([#2740])
-- **gateway:** Cap skill artifact preview decompression to prevent
-  zip-bomb-style abuse. ([#2963])
-
-### Fixed
-
-#### Runtime, gateway & persistence
-- **runtime:** Rollback restore checkpoint now supersedes newer checkpoints.
-  ([#2582])
-- **runtime:** Persist run message summaries. ([#2850])
-- **runtime:** Bound `write_file` execution-failure observations to keep
-  failure traces from blowing out the context. ([#3133])
-- **runtime:** Protect the sync singleton's init and reset paths. ([#3413])
-- **runtime:** Avoid PostgreSQL aggregate `FOR UPDATE` on run events.
-  ([#2962])
-- **runs:** Restore historical runs from persistent store after a gateway
-  restart. ([#2989])
-- **gateway:** Return ISO 8601 timestamps from threads endpoints. ([#2599])
-- **gateway:** Make cancel idempotent for already-interrupted runs. ([#3058])
-- **gateway:** Split `stream_existing_run` into per-method routes for unique
-  OpenAPI `operationId`s. ([#3228])
-- **events:** Serialize structured DB event content. ([#2762])
-- **persistence:** Emit timezone-aware timestamps from SQLite-backed stores.
-  ([#3130])
-- **persistence:** Reuse token usage model grouping expression. ([#2910])
-- **runs:** Ignore stale run reconnect conflicts. ([#3284])
-- **nginx:** Defer CORS to the gateway allowlist instead of double-applying it.
-  ([#2861])
-
-#### Agents, subagents & middleware
-- **subagents:** Make subagent timeout terminal state atomic. ([#2583])
-- **subagents:** Use model override for tools and middleware. ([#2641])
-- **subagents:** Consolidate `system_prompt` and skills into a single
-  `SystemMessage`. ([#2701])
-- **subagent:** Isolate subagents from the parent run's checkpointer.
-  ([#3559])
-- **agents:** Make `update_agent` honor `runtime.context` `user_id` like
-  `setup_agent` does. ([#2867])
-- **agents:** Resolve duplicate `todos` channel type conflict in
-  `TodoMiddleware`. ([#3200])
-- **agents:** Offload blocking filesystem IO in the custom-agent router off
-  the event loop. ([#3457])
-- **agents:** Keep new agent bootstrap in user scope. ([#2784])
-- **loop-detection:** Keep tool-call pairing on warn injection. ([#2725])
-- **middleware:** Sync raw tool-call metadata. ([#2757])
-- **middleware:** Handle invalid tool calls in dangling pairing middleware.
-  ([#2891])
-- **middleware:** Prevent todo completion reminder IM-message leak. ([#2907])
-- **middleware:** Normalize tool result adjacency before model calls.
-  ([#2939])
-
-#### Memory & tracing
-- **memory:** Replace short-lived `asyncio.run()` with a persistent event
-  loop. ([#2627])
-- **memory:** Isolate queued memory updates by agent. ([#2941])
-- **memory:** Parse wrapped memory-update JSON responses. ([#3252])
-- **tracing:** Propagate `session_id` and `user_id` into Langfuse traces.
-  ([#2944])
-- **trace:** Decode unicode escape sequences in non-ASCII memory trace info.
-  ([#3104])
-
-#### Tools, sandbox & MCP
-- **mcp:** Fix env resolution in MCP config lists. ([#2556])
-- **models:** Record Codex token usage in `usage_metadata`. ([#2585])
-- **sandbox:** Supplement `list_running` in `RemoteSandboxBackend`. ([#2716])
-- **sandbox:** Disable MSYS path conversion for Git Bash on Windows.
-  ([#2766])
-- **sandbox:** Avoid blocking sandbox readiness polling. ([#2822])
-- **sandbox:** Uphold the `/mnt/user-data` contract at the `Sandbox` API
-  boundary. ([#2881])
-- **sandbox:** Scope provisioner PVC data by user. ([#2973])
-- **sandbox:** Merge idempotent sandbox state updates. ([#3518])
-- **tools:** Introduce `Runtime` type alias to eliminate Pydantic serialization
-  warnings. ([#2774])
-- **tools:** Preserve `tool_search` promotions across re-entrant
-  `get_available_tools`. ([#2885])
-- **harness:** Wrap async-only config tools for sync client execution.
-  ([#2878])
-- **harness:** Wrap all async-only tools for sync clients. ([#2935])
-
-#### Skills & channels
-- **skills:** Enforce `allowed-tools` metadata. ([#2626])
-- **skills:** Harden slash skill activation across chat channels. ([#3466])
-- **skills:** Fix custom skill install permissions. ([#3241])
-- **channels:** Authenticate gateway command requests. ([#2742])
-
-#### Auth
-- **auth:** Replace setup-status 429 rate limit with a cached response.
-  ([#2915])
-- **auth:** Persist auto-generated JWT secret so it survives restarts.
-  ([#2933])
-
-#### Frontend
-- **frontend:** Restore `localhost` fallback for `getGatewayConfig` in prod
-  mode. ([#2718])
-- **chat:** Prevent the first user message from being swallowed in new
-  conversations. ([#2731])
-- **frontend:** Use backend thread token usage for the header total. ([#2800])
-- **frontend:** Wait for async chat submit before clearing the input.
-  ([#2940])
-- **frontend:** Resolve login page flickering and the resize-observer loop.
-  ([#2954])
-- **frontend:** Deduplicate restored thread messages. ([#2958])
-- **frontend:** Avoid duplicate optimistic user message. ([#3002])
-- **frontend:** Hide the copy button for streaming assistant messages.
-  ([#3176])
-- **frontend:** Show a new thread in the sidebar immediately on creation.
-  ([#3283])
-- **frontend:** Isolate new chat thread messages. ([#3508])
-- **frontend:** Cap deeply nested list indentation to prevent render crashes.
-  ([#3393], [#3570])
-- **token-usage:** Dedupe token usage aggregation by message id. ([#2770])
-
-#### Build, deploy, scripts & config
-- **packaging:** Add `postgres` extra for store/checkpointer support; clarify
-  install guidance. ([#2584])
-- **harness:** Resolve runtime paths from the project root. ([#2642])
-- **docker:** Force nginx to resolve upstream names at request time.
-  ([#2717])
-- **docker:** Default Gateway to a single worker to prevent multi-worker
-  breakage. ([#3475])
-- **scripts:** Preserve `uv` extras across `make dev` restarts. ([#2767],
-  [#2754])
-- **scripts:** Clean up local nginx on stop. ([#3005])
-- **deploy:** Fall back to `python` / `openssl` when `python3` is absent for
-  secret generation. ([#3074])
-- **config:** Make the reload boundary discoverable from code. ([#3144],
-  [#3153])
-- **replay-e2e:** Key replay fixtures by caller and conversation. ([#3453])
-
-### Changed
-
-- **provider (refactor):** Share assistant payload replay matching across
-  providers. ([#3307])
-
-### Documentation
-
-- Document blocking-IO detection usage and maintenance. ([#3233])
-- Clean standalone LangGraph server remnants from docs. ([#3301])
-
-### Internal
-
-- **dev:** Add async/thread boundary detector. ([#2936])
-- **runtime:** Add lifecycle end-to-end coverage. ([#2946])
-- **windows:** Add `PYTHONIOENCODING` and `PYTHONUTF8` to backend Makefile
-  targets. ([#3069])
-- **blocking-io:** Fail-loud repo-root resolution and shared detector CLI
-  shim. ([#3512])
-
-[2.0.0]: https://github.com/bytedance/deer-flow/releases/tag/v2.0.0
-[#2329]: https://github.com/bytedance/deer-flow/pull/2329
-[#2556]: https://github.com/bytedance/deer-flow/pull/2556
-[#2582]: https://github.com/bytedance/deer-flow/pull/2582
-[#2583]: https://github.com/bytedance/deer-flow/pull/2583
-[#2584]: https://github.com/bytedance/deer-flow/pull/2584
-[#2585]: https://github.com/bytedance/deer-flow/pull/2585
-[#2586]: https://github.com/bytedance/deer-flow/pull/2586
-[#2599]: https://github.com/bytedance/deer-flow/pull/2599
-[#2623]: https://github.com/bytedance/deer-flow/pull/2623
-[#2626]: https://github.com/bytedance/deer-flow/pull/2626
-[#2627]: https://github.com/bytedance/deer-flow/pull/2627
-[#2641]: https://github.com/bytedance/deer-flow/pull/2641
-[#2642]: https://github.com/bytedance/deer-flow/pull/2642
-[#2667]: https://github.com/bytedance/deer-flow/pull/2667
-[#2701]: https://github.com/bytedance/deer-flow/pull/2701
-[#2711]: https://github.com/bytedance/deer-flow/pull/2711
-[#2713]: https://github.com/bytedance/deer-flow/pull/2713
-[#2716]: https://github.com/bytedance/deer-flow/pull/2716
-[#2717]: https://github.com/bytedance/deer-flow/pull/2717
-[#2718]: https://github.com/bytedance/deer-flow/pull/2718
-[#2725]: https://github.com/bytedance/deer-flow/pull/2725
-[#2731]: https://github.com/bytedance/deer-flow/pull/2731
-[#2740]: https://github.com/bytedance/deer-flow/pull/2740
-[#2742]: https://github.com/bytedance/deer-flow/pull/2742
-[#2752]: https://github.com/bytedance/deer-flow/pull/2752
-[#2754]: https://github.com/bytedance/deer-flow/pull/2754
-[#2757]: https://github.com/bytedance/deer-flow/pull/2757
-[#2762]: https://github.com/bytedance/deer-flow/pull/2762
-[#2766]: https://github.com/bytedance/deer-flow/pull/2766
-[#2767]: https://github.com/bytedance/deer-flow/pull/2767
-[#2770]: https://github.com/bytedance/deer-flow/pull/2770
-[#2774]: https://github.com/bytedance/deer-flow/pull/2774
-[#2775]: https://github.com/bytedance/deer-flow/pull/2775
-[#2784]: https://github.com/bytedance/deer-flow/pull/2784
-[#2794]: https://github.com/bytedance/deer-flow/pull/2794
-[#2800]: https://github.com/bytedance/deer-flow/pull/2800
-[#2822]: https://github.com/bytedance/deer-flow/pull/2822
-[#2841]: https://github.com/bytedance/deer-flow/pull/2841
-[#2842]: https://github.com/bytedance/deer-flow/pull/2842
-[#2850]: https://github.com/bytedance/deer-flow/pull/2850
-[#2861]: https://github.com/bytedance/deer-flow/pull/2861
-[#2865]: https://github.com/bytedance/deer-flow/pull/2865
-[#2867]: https://github.com/bytedance/deer-flow/pull/2867
-[#2878]: https://github.com/bytedance/deer-flow/pull/2878
-[#2881]: https://github.com/bytedance/deer-flow/pull/2881
-[#2882]: https://github.com/bytedance/deer-flow/pull/2882
-[#2885]: https://github.com/bytedance/deer-flow/pull/2885
-[#2891]: https://github.com/bytedance/deer-flow/pull/2891
-[#2907]: https://github.com/bytedance/deer-flow/pull/2907
-[#2910]: https://github.com/bytedance/deer-flow/pull/2910
-[#2915]: https://github.com/bytedance/deer-flow/pull/2915
-[#2932]: https://github.com/bytedance/deer-flow/pull/2932
-[#2933]: https://github.com/bytedance/deer-flow/pull/2933
-[#2935]: https://github.com/bytedance/deer-flow/pull/2935
-[#2936]: https://github.com/bytedance/deer-flow/pull/2936
-[#2939]: https://github.com/bytedance/deer-flow/pull/2939
-[#2940]: https://github.com/bytedance/deer-flow/pull/2940
-[#2941]: https://github.com/bytedance/deer-flow/pull/2941
-[#2944]: https://github.com/bytedance/deer-flow/pull/2944
-[#2946]: https://github.com/bytedance/deer-flow/pull/2946
-[#2954]: https://github.com/bytedance/deer-flow/pull/2954
-[#2958]: https://github.com/bytedance/deer-flow/pull/2958
-[#2962]: https://github.com/bytedance/deer-flow/pull/2962
-[#2963]: https://github.com/bytedance/deer-flow/pull/2963
-[#2973]: https://github.com/bytedance/deer-flow/pull/2973
-[#2989]: https://github.com/bytedance/deer-flow/pull/2989
-[#3002]: https://github.com/bytedance/deer-flow/pull/3002
-[#3005]: https://github.com/bytedance/deer-flow/pull/3005
-[#3058]: https://github.com/bytedance/deer-flow/pull/3058
-[#3069]: https://github.com/bytedance/deer-flow/pull/3069
-[#3074]: https://github.com/bytedance/deer-flow/pull/3074
-[#3101]: https://github.com/bytedance/deer-flow/pull/3101
-[#3104]: https://github.com/bytedance/deer-flow/pull/3104
-[#3130]: https://github.com/bytedance/deer-flow/pull/3130
-[#3133]: https://github.com/bytedance/deer-flow/pull/3133
-[#3144]: https://github.com/bytedance/deer-flow/pull/3144
-[#3153]: https://github.com/bytedance/deer-flow/pull/3153
-[#3174]: https://github.com/bytedance/deer-flow/pull/3174
-[#3176]: https://github.com/bytedance/deer-flow/pull/3176
-[#3200]: https://github.com/bytedance/deer-flow/pull/3200
-[#3228]: https://github.com/bytedance/deer-flow/pull/3228
-[#3233]: https://github.com/bytedance/deer-flow/pull/3233
-[#3241]: https://github.com/bytedance/deer-flow/pull/3241
-[#3252]: https://github.com/bytedance/deer-flow/pull/3252
-[#3283]: https://github.com/bytedance/deer-flow/pull/3283
-[#3284]: https://github.com/bytedance/deer-flow/pull/3284
-[#3301]: https://github.com/bytedance/deer-flow/pull/3301
-[#3307]: https://github.com/bytedance/deer-flow/pull/3307
-[#3393]: https://github.com/bytedance/deer-flow/pull/3393
-[#3413]: https://github.com/bytedance/deer-flow/pull/3413
-[#3425]: https://github.com/bytedance/deer-flow/pull/3425
-[#3453]: https://github.com/bytedance/deer-flow/pull/3453
-[#3457]: https://github.com/bytedance/deer-flow/pull/3457
-[#3461]: https://github.com/bytedance/deer-flow/pull/3461
-[#3466]: https://github.com/bytedance/deer-flow/pull/3466
-[#3475]: https://github.com/bytedance/deer-flow/pull/3475
-[#3487]: https://github.com/bytedance/deer-flow/pull/3487
-[#3499]: https://github.com/bytedance/deer-flow/pull/3499
-[#3508]: https://github.com/bytedance/deer-flow/pull/3508
-[#3512]: https://github.com/bytedance/deer-flow/pull/3512
-[#3518]: https://github.com/bytedance/deer-flow/pull/3518
-[#3528]: https://github.com/bytedance/deer-flow/pull/3528
-[#3531]: https://github.com/bytedance/deer-flow/pull/3531
-[#3559]: https://github.com/bytedance/deer-flow/pull/3559
-[#3570]: https://github.com/bytedance/deer-flow/pull/3570

CHANGELOG_zh.md

@@ -1,301 +0,0 @@
-# 更新日志
-
-本文件记录 DeerFlow 的所有重要变更。
-
-格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
-版本号遵循 [语义化版本规范](https://semver.org/lang/zh-CN/)。
-
-[English](./CHANGELOG.md) | 中文
-
-## [2.0.0] — 2026-06-15
-
-DeerFlow 2.0 是围绕"超级智能体"框架的彻底重写，核心包含子智能体、持久化记忆、
-沙箱执行以及可扩展的技能（Skill）/工具系统。本版本与 1.x 系列**没有共享代码**，
-原有的 Deep Research 框架仍在
-[`main-1.x` 分支](https://github.com/bytedance/deer-flow/tree/main-1.x)上维护。
-
-本次发布关闭了
-[2.0.0 里程碑](https://github.com/bytedance/deer-flow/milestone/1)，
-自首个 2.0 里程碑标签以来累计合并 **102 个 Pull Request**。
-
-### ⚠ 不兼容变更（Breaking Changes）
-
-- **harness：** 从 `RunStore` 重新加载历史 run，并持久化"已中断（interrupted）"
-  状态。run 的取消 / 多任务调度语义现在要求拥有该 run 的 worker 上具备可用的
-  RunStore；跨 worker 的取消请求将返回 `409`，不再静默"伪成功"。([#2932])
-
-### 新增
-
-#### 智能体与运行时
-- **智能体：** 自定义智能体支持自我更新，并按用户隔离 —— 智能体可在普通对话中
-  持久化对自身 `SOUL.md` / `config.yaml` 的修改。([#2713])
-- **循环检测：** 支持配置开关，并可按工具维度覆盖触发频率。([#2586]、[#2711])
-- **循环检测：** 警告注入延后执行，避免与工具调用生命周期错位。([#2752])
-- **运行：** 将 `model_name` 从 gateway 请求一直透传到运行时与持久化层（SQLite
-  存储）。([#2775])
-- **子智能体：** 通过终态任务事件，把子智能体的 token 用量流式上报到 header。
-  ([#2882])
-
-#### 模型与集成
-- **模型：** 新增 StepFun 推理模型适配器。([#3461])
-- **社区工具：** 新增 Brave Search 网络检索工具。([#3528])
-- **渠道：** Discord 增加"仅响应 mention"模式、话题路由（thread routing）以及
-  正在输入指示。([#2842])
-- **IM：** 新增"用户自有 IM 渠道连接"——用户可以在运营方配置的 bot 之上，绑定
-  自己的 Slack / Telegram / Discord / 飞书 / 钉钉 / 微信 / 企业微信 账号。
-  ([#3487])
-
-#### 可观测性
-- **追踪：** LangGraph 追踪名设置为 `lead_agent`（自定义智能体则使用其
-  `agent_name`），让 Langfuse / LangSmith 中的 trace 更清晰。([#3101])
-- **前端：** 优化 token 用量的展示模式。([#2329])
-- **默认值：** 默认开启 token 用量统计。([#2841])
-- **默认值：** 提高默认的上下文摘要触发阈值。([#3174])
-
-### 性能优化
-
-- **harness：** 把 thread 元数据过滤下推到 SQL，不再在 Python 侧后过滤。
-  ([#2865])
-- **运行时：** 为 run 增加 `thread_id` 索引，避免 `RunManager` 中的 O(n) 扫描。
-  ([#3499])
-- **运行时：** 为 `MemoryRunEventStore` 中的消息建立索引，避免 O(n) 扫描。
-  ([#3531])
-
-### 安全
-
-- **上传：** 拒绝指向符号链接的上传目标。([#2623])
-- **上传：** 在 Windows 上支持基于符号链接保护的安全上传。([#2794])
-- **MCP：** 在 MCP 配置接口的响应中对敏感字段进行脱敏。([#2667])
-- **MCP：** 加固 MCP 配置接口对异常输入的处理。([#3425])
-- **认证：** 拒绝跨站点（cross-site）的认证 POST 请求。([#2740])
-- **网关：** 限制 skill artifact 预览的解压上限，避免被 zip-bomb 类构造滥用。
-  ([#2963])
-
-### 修复
-
-#### 运行时、网关与持久化
-- **运行时：** rollback 恢复的 checkpoint 现在能够覆盖更新的 checkpoint。
-  ([#2582])
-- **运行时：** 持久化 run 的消息摘要。([#2850])
-- **运行时：** 限制 `write_file` 执行失败时上报的观测信息长度，避免失败 trace
-  撑爆上下文。([#3133])
-- **运行时：** 加锁保护同步单例的初始化与 reset 路径。([#3413])
-- **运行时：** 为 run events 移除 PostgreSQL 上不必要的聚合
-  `FOR UPDATE`。([#2962])
-- **运行：** gateway 重启后从持久化存储中恢复历史 run。([#2989])
-- **网关：** threads 接口返回 ISO 8601 格式的时间戳。([#2599])
-- **网关：** 对已经处于 interrupted 状态的 run，cancel 接口幂等返回。
-  ([#3058])
-- **网关：** 将 `stream_existing_run` 拆分为按 HTTP 方法区分的多个路由，确保
-  OpenAPI `operationId` 唯一。([#3228])
-- **事件：** 序列化结构化的 DB event 内容。([#2762])
-- **持久化：** SQLite 后端的存储统一返回带时区的时间戳。([#3130])
-- **持久化：** 复用 token 用量按模型分组的 SQL 表达式。([#2910])
-- **运行：** 忽略已过期的 run reconnect 冲突。([#3284])
-- **nginx：** 把 CORS 策略下放到 gateway 的 allowlist，避免双重应用。
-  ([#2861])
-
-#### 智能体、子智能体与中间件
-- **子智能体：** 让"子智能体超时"成为原子化的终态。([#2583])
-- **子智能体：** 工具与中间件按 model 覆盖（model override）来构造。([#2641])
-- **子智能体：** 把 `system_prompt` 与 skills 合并到单条 `SystemMessage`。
-  ([#2701])
-- **子智能体：** 子智能体与父 run 的 checkpointer 隔离。([#3559])
-- **智能体：** `update_agent` 与 `setup_agent` 一致，遵循 `runtime.context` 的
-  `user_id`。([#2867])
-- **智能体：** 解决 `TodoMiddleware` 中 `todos` 通道的类型冲突。([#3200])
-- **智能体：** 把自定义智能体路由中的阻塞文件 IO 移出事件循环。([#3457])
-- **智能体：** 新智能体的 bootstrap 流程保持在用户作用域内。([#2784])
-- **循环检测：** 注入 warn 时仍保持 tool-call 配对。([#2725])
-- **中间件：** 同步原始 tool-call 元数据。([#2757])
-- **中间件：** dangling 配对中间件正确处理非法 tool call。([#2891])
-- **中间件：** 防止 todo 完成提醒消息泄漏到 IM 渠道。([#2907])
-- **中间件：** 调用模型前先把 tool result 的相邻关系规范化。([#2939])
-
-#### 记忆与追踪
-- **记忆：** 用常驻事件循环替换短生命周期的 `asyncio.run()`。([#2627])
-- **记忆：** 队列化的 memory 更新按智能体维度隔离。([#2941])
-- **记忆：** 解析被外层包裹的 memory 更新 JSON 响应。([#3252])
-- **追踪：** 把 `session_id` 与 `user_id` 透传到 Langfuse trace。([#2944])
-- **追踪：** 修复中文 memory trace 信息显示为 unicode 转义序列的问题。
-  ([#3104])
-
-#### 工具、沙箱与 MCP
-- **MCP：** 修复 MCP 配置中列表型变量的环境变量解析。([#2556])
-- **模型：** Codex 的 token 用量记录到 `usage_metadata`。([#2585])
-- **沙箱：** 在 `RemoteSandboxBackend` 中补上 `list_running`。([#2716])
-- **沙箱：** Windows / Git Bash 下关闭 MSYS 路径转换。([#2766])
-- **沙箱：** 沙箱就绪轮询不再阻塞事件循环。([#2822])
-- **沙箱：** `Sandbox` API 边界统一遵守 `/mnt/user-data` 契约。([#2881])
-- **沙箱：** Provisioner 的 PVC 数据按用户隔离。([#2973])
-- **沙箱：** 合并幂等的沙箱状态更新。([#3518])
-- **工具：** 引入 `Runtime` 类型别名，消除 Pydantic 序列化告警。([#2774])
-- **工具：** 在重入式 `get_available_tools` 调用之间保留 `tool_search` 的提升
-  状态。([#2885])
-- **harness：** 为同步客户端封装仅异步可用的 config 工具。([#2878])
-- **harness：** 同步客户端可用所有原本仅异步的工具（统一封装）。([#2935])
-
-#### 技能与渠道
-- **技能：** 强制校验 `allowed-tools` 元数据。([#2626])
-- **技能：** 在各聊天渠道下加固 `/skill` 斜杠激活。([#3466])
-- **技能：** 修复自定义 skill 安装时的权限问题。([#3241])
-- **渠道：** Gateway 的命令请求需要鉴权。([#2742])
-
-#### 认证
-- **认证：** 用缓存响应替换 setup-status 接口的 429 限流。([#2915])
-- **认证：** 自动生成的 JWT secret 持久化保存，重启后仍可用。([#2933])
-
-#### 前端
-- **前端：** 在 prod 模式下恢复 `getGatewayConfig` 的 `localhost` 兜底。
-  ([#2718])
-- **聊天：** 修复新会话第一条用户消息被吞掉的问题。([#2731])
-- **前端：** header 总计 token 数采用后端线程级 token 用量。([#2800])
-- **前端：** 异步 chat submit 完成后再清空输入框。([#2940])
-- **前端：** 修复登录页闪烁与 ResizeObserver 死循环。([#2954])
-- **前端：** 对恢复出的会话消息去重。([#2958])
-- **前端：** 避免乐观渲染产生重复的用户消息。([#3002])
-- **前端：** 流式中的 assistant 消息不再展示复制按钮。([#3176])
-- **前端：** 新建 thread 后立即在侧边栏显示。([#3283])
-- **前端：** 新建会话的 thread 消息相互隔离。([#3508])
-- **前端：** 限制深层嵌套列表的缩进，避免渲染崩溃。([#3393]、[#3570])
-- **token 用量：** token 用量按 message id 去重聚合。([#2770])
-
-#### 构建、部署、脚本与配置
-- **打包：** 新增 `postgres` extra 以支持 store / checkpointer，并完善安装
-  说明。([#2584])
-- **harness：** 运行时路径以项目根目录为基准解析。([#2642])
-- **Docker：** 让 nginx 在每次请求时再解析 upstream 名称。([#2717])
-- **Docker：** 把 Gateway 默认改为单 worker，避免多 worker 模式下出现异常。
-  ([#3475])
-- **脚本：** `make dev` 重启时保留 `uv` extras。([#2767]、[#2754])
-- **脚本：** 停止时清理本地 nginx。([#3005])
-- **部署：** 没有 `python3` 时，secret 生成回退到 `python` / `openssl`。
-  ([#3074])
-- **配置：** 让 reload boundary 在代码层面可发现。([#3144]、[#3153])
-- **replay-e2e：** 重放 fixture 按调用方与会话作为 key。([#3453])
-
-### 变更
-
-- **provider（重构）：** 各 provider 间共享 assistant payload 的回放匹配逻辑。
-  ([#3307])
-
-### 文档
-
-- 补充 blocking-IO 检测的使用与维护说明。([#3233])
-- 清理文档中残留的"独立 LangGraph 服务器"相关内容。([#3301])
-
-### 内部改进
-
-- **开发：** 新增 async / thread 边界检测器。([#2936])
-- **运行时：** 增加 lifecycle 端到端测试覆盖。([#2946])
-- **Windows：** 后端 Makefile 各 target 加入 `PYTHONIOENCODING` 与
-  `PYTHONUTF8`。([#3069])
-- **blocking-io：** 检测器以"显式失败（fail-loud）"方式解析仓库根目录，并提供
-  共享 CLI 入口。([#3512])
-
-[2.0.0]: https://github.com/bytedance/deer-flow/releases/tag/v2.0.0
-[#2329]: https://github.com/bytedance/deer-flow/pull/2329
-[#2556]: https://github.com/bytedance/deer-flow/pull/2556
-[#2582]: https://github.com/bytedance/deer-flow/pull/2582
-[#2583]: https://github.com/bytedance/deer-flow/pull/2583
-[#2584]: https://github.com/bytedance/deer-flow/pull/2584
-[#2585]: https://github.com/bytedance/deer-flow/pull/2585
-[#2586]: https://github.com/bytedance/deer-flow/pull/2586
-[#2599]: https://github.com/bytedance/deer-flow/pull/2599
-[#2623]: https://github.com/bytedance/deer-flow/pull/2623
-[#2626]: https://github.com/bytedance/deer-flow/pull/2626
-[#2627]: https://github.com/bytedance/deer-flow/pull/2627
-[#2641]: https://github.com/bytedance/deer-flow/pull/2641
-[#2642]: https://github.com/bytedance/deer-flow/pull/2642
-[#2667]: https://github.com/bytedance/deer-flow/pull/2667
-[#2701]: https://github.com/bytedance/deer-flow/pull/2701
-[#2711]: https://github.com/bytedance/deer-flow/pull/2711
-[#2713]: https://github.com/bytedance/deer-flow/pull/2713
-[#2716]: https://github.com/bytedance/deer-flow/pull/2716
-[#2717]: https://github.com/bytedance/deer-flow/pull/2717
-[#2718]: https://github.com/bytedance/deer-flow/pull/2718
-[#2725]: https://github.com/bytedance/deer-flow/pull/2725
-[#2731]: https://github.com/bytedance/deer-flow/pull/2731
-[#2740]: https://github.com/bytedance/deer-flow/pull/2740
-[#2742]: https://github.com/bytedance/deer-flow/pull/2742
-[#2752]: https://github.com/bytedance/deer-flow/pull/2752
-[#2754]: https://github.com/bytedance/deer-flow/pull/2754
-[#2757]: https://github.com/bytedance/deer-flow/pull/2757
-[#2762]: https://github.com/bytedance/deer-flow/pull/2762
-[#2766]: https://github.com/bytedance/deer-flow/pull/2766
-[#2767]: https://github.com/bytedance/deer-flow/pull/2767
-[#2770]: https://github.com/bytedance/deer-flow/pull/2770
-[#2774]: https://github.com/bytedance/deer-flow/pull/2774
-[#2775]: https://github.com/bytedance/deer-flow/pull/2775
-[#2784]: https://github.com/bytedance/deer-flow/pull/2784
-[#2794]: https://github.com/bytedance/deer-flow/pull/2794
-[#2800]: https://github.com/bytedance/deer-flow/pull/2800
-[#2822]: https://github.com/bytedance/deer-flow/pull/2822
-[#2841]: https://github.com/bytedance/deer-flow/pull/2841
-[#2842]: https://github.com/bytedance/deer-flow/pull/2842
-[#2850]: https://github.com/bytedance/deer-flow/pull/2850
-[#2861]: https://github.com/bytedance/deer-flow/pull/2861
-[#2865]: https://github.com/bytedance/deer-flow/pull/2865
-[#2867]: https://github.com/bytedance/deer-flow/pull/2867
-[#2878]: https://github.com/bytedance/deer-flow/pull/2878
-[#2881]: https://github.com/bytedance/deer-flow/pull/2881
-[#2882]: https://github.com/bytedance/deer-flow/pull/2882
-[#2885]: https://github.com/bytedance/deer-flow/pull/2885
-[#2891]: https://github.com/bytedance/deer-flow/pull/2891
-[#2907]: https://github.com/bytedance/deer-flow/pull/2907
-[#2910]: https://github.com/bytedance/deer-flow/pull/2910
-[#2915]: https://github.com/bytedance/deer-flow/pull/2915
-[#2932]: https://github.com/bytedance/deer-flow/pull/2932
-[#2933]: https://github.com/bytedance/deer-flow/pull/2933
-[#2935]: https://github.com/bytedance/deer-flow/pull/2935
-[#2936]: https://github.com/bytedance/deer-flow/pull/2936
-[#2939]: https://github.com/bytedance/deer-flow/pull/2939
-[#2940]: https://github.com/bytedance/deer-flow/pull/2940
-[#2941]: https://github.com/bytedance/deer-flow/pull/2941
-[#2944]: https://github.com/bytedance/deer-flow/pull/2944
-[#2946]: https://github.com/bytedance/deer-flow/pull/2946
-[#2954]: https://github.com/bytedance/deer-flow/pull/2954
-[#2958]: https://github.com/bytedance/deer-flow/pull/2958
-[#2962]: https://github.com/bytedance/deer-flow/pull/2962
-[#2963]: https://github.com/bytedance/deer-flow/pull/2963
-[#2973]: https://github.com/bytedance/deer-flow/pull/2973
-[#2989]: https://github.com/bytedance/deer-flow/pull/2989
-[#3002]: https://github.com/bytedance/deer-flow/pull/3002
-[#3005]: https://github.com/bytedance/deer-flow/pull/3005
-[#3058]: https://github.com/bytedance/deer-flow/pull/3058
-[#3069]: https://github.com/bytedance/deer-flow/pull/3069
-[#3074]: https://github.com/bytedance/deer-flow/pull/3074
-[#3101]: https://github.com/bytedance/deer-flow/pull/3101
-[#3104]: https://github.com/bytedance/deer-flow/pull/3104
-[#3130]: https://github.com/bytedance/deer-flow/pull/3130
-[#3133]: https://github.com/bytedance/deer-flow/pull/3133
-[#3144]: https://github.com/bytedance/deer-flow/pull/3144
-[#3153]: https://github.com/bytedance/deer-flow/pull/3153
-[#3174]: https://github.com/bytedance/deer-flow/pull/3174
-[#3176]: https://github.com/bytedance/deer-flow/pull/3176
-[#3200]: https://github.com/bytedance/deer-flow/pull/3200
-[#3228]: https://github.com/bytedance/deer-flow/pull/3228
-[#3233]: https://github.com/bytedance/deer-flow/pull/3233
-[#3241]: https://github.com/bytedance/deer-flow/pull/3241
-[#3252]: https://github.com/bytedance/deer-flow/pull/3252
-[#3283]: https://github.com/bytedance/deer-flow/pull/3283
-[#3284]: https://github.com/bytedance/deer-flow/pull/3284
-[#3301]: https://github.com/bytedance/deer-flow/pull/3301
-[#3307]: https://github.com/bytedance/deer-flow/pull/3307
-[#3393]: https://github.com/bytedance/deer-flow/pull/3393
-[#3413]: https://github.com/bytedance/deer-flow/pull/3413
-[#3425]: https://github.com/bytedance/deer-flow/pull/3425
-[#3453]: https://github.com/bytedance/deer-flow/pull/3453
-[#3457]: https://github.com/bytedance/deer-flow/pull/3457
-[#3461]: https://github.com/bytedance/deer-flow/pull/3461
-[#3466]: https://github.com/bytedance/deer-flow/pull/3466
-[#3475]: https://github.com/bytedance/deer-flow/pull/3475
-[#3487]: https://github.com/bytedance/deer-flow/pull/3487
-[#3499]: https://github.com/bytedance/deer-flow/pull/3499
-[#3508]: https://github.com/bytedance/deer-flow/pull/3508
-[#3512]: https://github.com/bytedance/deer-flow/pull/3512
-[#3518]: https://github.com/bytedance/deer-flow/pull/3518
-[#3528]: https://github.com/bytedance/deer-flow/pull/3528
-[#3531]: https://github.com/bytedance/deer-flow/pull/3531
-[#3559]: https://github.com/bytedance/deer-flow/pull/3559
-[#3570]: https://github.com/bytedance/deer-flow/pull/3570

backend/app/gateway/routers/suggestions.py

@@ -135,6 +135,8 @@ async def generate_suggestions(
     request: Request,
     config: AppConfig = Depends(get_config),
 ) -> SuggestionsResponse:
+    if not config.suggestions.enabled:
+        return SuggestionsResponse(suggestions=[])
     if not body.messages:
         return SuggestionsResponse(suggestions=[])
 

backend/packages/harness/deerflow/config/app_config.py

@@ -28,6 +28,7 @@ from deerflow.config.skill_evolution_config import SkillEvolutionConfig
 from deerflow.config.skills_config import SkillsConfig
 from deerflow.config.stream_bridge_config import StreamBridgeConfig, load_stream_bridge_config_from_dict
 from deerflow.config.subagents_config import SubagentsAppConfig, load_subagents_config_from_dict
+from deerflow.config.suggestions_config import SuggestionsConfig
 from deerflow.config.summarization_config import SummarizationConfig, load_summarization_config_from_dict
 from deerflow.config.title_config import TitleConfig, load_title_config_from_dict
 from deerflow.config.token_usage_config import TokenUsageConfig
@@ -116,6 +117,7 @@ class AppConfig(BaseModel):
     acp_agents: dict[str, ACPAgentConfig] = Field(default_factory=dict, description="ACP-compatible agent configuration")
     subagents: SubagentsAppConfig = Field(default_factory=SubagentsAppConfig, description="Subagent runtime configuration")
     guardrails: GuardrailsConfig = Field(default_factory=GuardrailsConfig, description="Guardrail middleware configuration")
+    suggestions: SuggestionsConfig = Field(default_factory=SuggestionsConfig, description="Follow-up suggestions configuration.")
     circuit_breaker: CircuitBreakerConfig = Field(default_factory=CircuitBreakerConfig, description="LLM circuit breaker configuration")
     channel_connections: ChannelConnectionsConfig = Field(
         default_factory=ChannelConnectionsConfig,

backend/packages/harness/deerflow/config/suggestions_config.py

@@ -0,0 +1,7 @@
+from pydantic import BaseModel, Field
+
+
+class SuggestionsConfig(BaseModel):
+    """Configuration for automatic follow-up suggestions."""
+
+    enabled: bool = Field(default=True, description="Whether to enable follow-up question suggestions at the end of an AI response")

backend/packages/harness/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deerflow-harness"
-version = "2.0.0"
+version = "0.1.0"
 description = "DeerFlow agent harness framework"
 requires-python = ">=3.12"
 dependencies = [

backend/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deer-flow"
-version = "2.0.0"
+version = "0.1.0"
 description = "LangGraph-based AI agent system with sandbox execution capabilities"
 readme = "README.md"
 requires-python = ">=3.12"

backend/tests/test_suggestions_router.py

@@ -74,7 +74,7 @@ def test_generate_suggestions_strips_inline_think_block(monkeypatch):
     fake_model.ainvoke = AsyncMock(return_value=MagicMock(content=content))
     monkeypatch.setattr(suggestions, "create_chat_model", lambda **kwargs: fake_model)
 
-    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace()))
+    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace(suggestions=SimpleNamespace(enabled=True))))
 
     assert result.suggestions == ["深度学习和机器学习的区别？", "常用框架有哪些？", "需要什么数学基础？"]
 
@@ -103,7 +103,7 @@ def test_generate_suggestions_parses_and_limits(monkeypatch):
 
     # Bypass the require_permission decorator (which needs request +
     # thread_store) — these tests cover the parsing logic.
-    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace()))
+    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace(suggestions=SimpleNamespace(enabled=True))))
 
     assert result.suggestions == ["Q1", "Q2", "Q3"]
     fake_model.ainvoke.assert_awaited_once()
@@ -125,7 +125,7 @@ def test_generate_suggestions_parses_list_block_content(monkeypatch):
 
     # Bypass the require_permission decorator (which needs request +
     # thread_store) — these tests cover the parsing logic.
-    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace()))
+    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace(suggestions=SimpleNamespace(enabled=True))))
 
     assert result.suggestions == ["Q1", "Q2"]
     fake_model.ainvoke.assert_awaited_once()
@@ -147,7 +147,7 @@ def test_generate_suggestions_parses_output_text_block_content(monkeypatch):
 
     # Bypass the require_permission decorator (which needs request +
     # thread_store) — these tests cover the parsing logic.
-    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace()))
+    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace(suggestions=SimpleNamespace(enabled=True))))
 
     assert result.suggestions == ["Q1", "Q2"]
     fake_model.ainvoke.assert_awaited_once()
@@ -166,6 +166,29 @@ def test_generate_suggestions_returns_empty_on_model_error(monkeypatch):
 
     # Bypass the require_permission decorator (which needs request +
     # thread_store) — these tests cover the parsing logic.
-    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace()))
+    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=SimpleNamespace(suggestions=SimpleNamespace(enabled=True))))
 
     assert result.suggestions == []
+
+
+def test_generate_suggestions_returns_empty_when_disabled(monkeypatch):
+    """Ensure suggestions are bypassed and returned an empty list when disabled in config."""
+    req = suggestions.SuggestionsRequest(
+        messages=[
+            suggestions.SuggestionMessage(role="user", content="Hi"),
+            suggestions.SuggestionMessage(role="assistant", content="Hello"),
+        ],
+        n=3,
+        model_name=None,
+    )
+
+    mock_config = SimpleNamespace(suggestions=SimpleNamespace(enabled=False))
+
+    fake_model = MagicMock()
+    fake_model.ainvoke = AsyncMock(side_effect=RuntimeError("Model should not be called."))
+    monkeypatch.setattr(suggestions, "create_chat_model", lambda **kwargs: fake_model)
+
+    result = asyncio.run(suggestions.generate_suggestions.__wrapped__("t1", req, request=None, config=mock_config))
+
+    assert result.suggestions == []
+    fake_model.ainvoke.assert_not_called()

backend/uv.lock

@@ -756,7 +756,7 @@ wheels = [
 
 [[package]]
 name = "deer-flow"
-version = "2.0.0"
+version = "0.1.0"
 source = { virtual = "." }
 dependencies = [
     { name = "bcrypt" },
@@ -828,7 +828,7 @@ dev = [
 
 [[package]]
 name = "deerflow-harness"
-version = "2.0.0"
+version = "0.1.0"
 source = { editable = "packages/harness" }
 dependencies = [
     { name = "agent-client-protocol" },

config.example.yaml

@@ -15,7 +15,7 @@
 # ============================================================================
 # Bump this number when the config schema changes.
 # Run `make config-upgrade` to merge new fields into your local config.yaml.
-config_version: 12
+config_version: 13
 
 # ============================================================================
 # Logging
@@ -711,6 +711,16 @@ tool_output:
   #   web_search: 8000
   #   bash: 20000
 
+# ============================================================================
+# Suggestions Configuration
+# ============================================================================
+# Configure whether the agent automatically generates follow-up question
+# suggestions at the end of each response.
+
+suggestions:
+  enabled: true
+
+
 # ============================================================================
 # Loop Detection Configuration
 # ============================================================================

frontend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deer-flow-frontend",
-  "version": "2.0.0",
+  "version": "0.1.0",
   "private": true,
   "type": "module",
   "scripts": {