KsADK 0.7.0

[0.7.0] - 2026-07-15

亮点

• Google ADK 长任务支持 invocation 级断点恢复：KsADK 记录 ADK invocation 映射和最新工具/Agent 状态恢复点，通过共享 PostgreSQL session backend 支持 Pod 重建后继续同一个 run；控制台可按 runtime capability、checkpoint preview 和恢复风险决定是否展示恢复入口。
• 交互终端改为内容优先的 inline TUI：agentengine run / invoke 的聊天界面不再占用 alternate screen，保留终端原生 scrollback；流式文本、工具调用和工具结果按实际到达顺序展示，并支持 /tools 折叠或展开工具详情。
• PostgreSQL 会话故障不阻断 Agent：配置 PostgreSQL 时，驱动缺失、连接或写入异常会进入进程内存降级态并记录结构化告警；驱动补齐或后台探活恢复后，新会话和后续事件自动恢复写入 PostgreSQL。
• 会话事件更易排查：新增 ksadk_session_events_readable PostgreSQL 视图，将原始事件拍平为消息角色、文本、工具名称、生命周期状态和时间等字段。
• usage 与可观测数据更准确：LangGraph 流式 usage 会去重、聚合并优先作为当前轮权威值；Langfuse trace 保留 KsADK 已计算的 usage，避免 exporter 二次推断覆盖正确结果。

新增

• ADK Runner 接入 ResumabilityConfig、invocation_id 映射、递增 checkpoint、恢复审计和 runtime capability 描述；新增 KSADK_ADK_RESUMABLE 显式开关。
• TUI 新增 /tools 命令、模型选择、输入排队、处理中耗时状态、终端背景自适应和 /clear 原生 scrollback 清理。
• 新增 PostgreSQL 会话故障恢复 E2E 校验脚本，覆盖 LangGraph、LangChain、ADK、可读视图以及数据库中断后恢复写入。
• 公开 Fumadocs 文档站新增中英文云端部署指南，覆盖云账号配置、launch、build/deploy、Code/Container、KCE、VPC、持久化存储、运行时 env 和部署验证；GitHub Pages 子路径下的静态搜索索引改为显式寻址。

变更

• ADK checkpoint 只在共享 database session backend 下声明可跨 Pod 恢复；in-memory、local 和 SQLite backend 保留审计信息但不点亮恢复入口。Runtime bootstrap 的 Stop/Resume/checkpoint 字段改为跟随 runner 实际能力。
• 新建 Agent、Hermes、OpenClaw 和 MCP 部署时默认开启公网访问；更新已有资源时，未显式传入网络选项则不覆盖服务端现有配置，仍可通过 --disable-public-access 明确关闭。
• agentengine invoke --message 默认创建新 session，只有显式传入 session 时才复用，避免多次单次调用意外共享上下文。
• 模型上下文窗口区分 provider 返回的原始上限与扣除系统预留后的有效上限，避免 UI 展示值和运行时裁剪阈值混用。
• reasoning delta 仍实时流式返回，但每轮聚合为一条 reasoning 事件持久化，减少 PostgreSQL 写放大。
• 降级期间未写入 PostgreSQL 的旧事件不会自动补写；Pod 重启、迁移或请求切换到其他 Pod 时，历史上下文可能不完整，但当前 Agent 请求继续执行。
• PostgreSQL 连接池操作和关闭增加超时边界，避免数据库网络异常拖住请求或 Pod 退出。
• PostgreSQL session 创建改为数据库级幂等，多个 Pod 并发恢复或创建同一 session 时不会因唯一键竞争误触发降级。
• 公开发布流程统一为内部 master 经 clean export 生成公开候选，再通过 GitHub PR、Trusted Publishing 发布主包和兼容别名包；移除旧文档部署路径并补齐导出审计边界。

修复

• 修复 ADK 恢复能力关闭时被空消息静默转换为新任务、并发 invocation 映射串线、checkpoint ID 重启碰撞、零事件恢复异常和重复审计的问题。
• 改进 ADK Agent 名称不符合标识符规则时的启动诊断，直接提示非法值、入口位置和可用的修复名称，避免只输出 Pydantic 原始校验堆栈。
• 修复 ADK LiteLLM 非法工具参数补丁返回错误响应类型及重复包装，并补齐 MCP 结果补丁的幂等保护。
• 修复 inline TUI 中工具调用完成后被统一移动到回复末尾、历史重绘影响原生滚动、浅色终端输入区域不清晰等问题。
• 修复 Remote Runner 的 chat stream 将文本 delta 放在顶层时无法解析，导致远程回复内容缺失的问题。
• 修复 LangGraph 流式 usage chunk 重复、缺少 run id 或与最终事件并存时可能重复累计或丢失的问题。
• 修复 LangGraph checkpoint 恢复完成后仍读取源 checkpoint 快照，导致最终输出和后续 checkpoint 元数据停留在恢复前状态的问题。
• 修复 Langfuse exporter 覆盖 KsADK 权威 usage，导致 trace 中 token 数据与运行时不一致的问题。
• 修复 PostgreSQL 恢复后，降级期间创建的 session 无法继续写入 PG 的问题。
• 修复 ADK session 在健康 PostgreSQL 下不刷新其他副本新增事件的问题。
• 修复 DeepAgents 测试 fake model 对空内容 tool call 不产生 stream chunk 的兼容问题。
• 修复 langchain.agents.create_agent() 返回 message-state 时，LangChain Runner 丢弃流式文本、思考过程和工具调用/结果并回退为同步执行，以及将 Command(update=...) 内部控制对象误作最终正文的问题。
• 修复 Windows Python 3.13 安装 ADK extra 时可能从源码构建 LiteLLM 并因缺少 MSVC linker 失败的问题；显式使用 LiteLlm 的用户可先安装官方二进制 wheel。
• 修复 coding profile 未直接暴露 workspace 写文件工具，导致新建文件绕行 dispatcher；同时明确 read/edit 必须串行并让无效编辑参数优先返回准确诊断。
• 修复本地 agentengine web 缺少 ListSessionMessages action，导致刷新或切换 session 后历史消息无法回显的问题；历史投影保留正文、思考、工具、审批和附件信息。

发布记录

• GitHub main commit：2a6f94ae410d5cab54cd1f428c5048999f2fa509
• Tag：v0.7.0
• 内置 Web UI：@kingsoftcloud/ksadk-web@0.2.19
• make public-preflight：已通过