Skip to content

KsADK 0.8.5

Choose a tag to compare

View all tags
@AgentArcLab AgentArcLab released this 19 Sep 23:52
v0.8.5
5128ff1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

KsADK 0.8.5

正式版本：v0.8.5

发布源：5128ff1e

亮点

  • Studio 内置消息渠道：官方 dsh-channels-client 随 KsADK 制品分发，Studio HTTP 服务先可用，再在后台装配默认 Channel 页面；首次打开不等待插件工具链或远端 Channel 服务。ksadk 不安装也不依赖 agentengine-channel Python 服务。
  • 本地 Agent 与云端 Channel 闭环：新增 Channel Connector Protocol v1（Agent Connector）。本地 ADK、LangGraph 等高代码 Agent 通过出站 WSS 接入云端 Channel，不需要开放本地端口；Studio 与独立高代码 Agent 使用同一套 Connector API。
  • 本地与云端 Agent 目标明确隔离：Channel 绑定显式使用 ConnectorWorkspaceId 和 Agent 身份，本地目标离线时不会静默回退到云端 Runtime，避免消息误投。
  • 运行时安全边界收紧：托管 checkpoint 缺少 prepare_state 时 fail-closed，hook 模式下 compaction 归属安全降级到 framework，避免恢复链路在不完整契约下继续执行。
  • LangGraph 审批恢复修复：checkpoint_ns 恢复为子图寻址语义，租户和 Agent 隔离改由稳定的 thread_id 承担；审批状态读取统一走异步入口，读取失败不再伪装成正常完成。
  • Studio 与运行时体验持续收敛：延续流式输出、MCP 鉴权与审批、会话互斥/恢复、运行时预热、默认模型和 Codex Runtime 升级，减少首次响应和会话切换等待。

新增与变更

  • Connector 支持 JWT 身份校验、register / invoke / cancel、deadline、idempotency key、心跳、指数退避重连、有限终态缓存和取消回收；连接断开且结果未知时不自动重放可能带副作用的 Agent 调用。
  • Channel API 支持多副本 owner/relay 路由和 workspace 隔离；跨副本 relay 使用 Redis Pub/Sub，不宣称 durable queue 或 exactly-once，业务重试由宿主按 idempotency_key 实现。
  • Channels 页面从 Studio 静态路由迁移为 DSH workspace 插件；公开协议参考为 docs/connector/channel-connector-protocol-v1.md。默认插件激活失败时只影响 Channel 页面，不阻塞 Studio 主服务。
  • 公开 pyproject.toml 移除未发布的 channel extra；wheel 构建不再解析 agentengine-channel。Web companion 固定使用 @kingsoftcloud/ksadk-web@0.3.11。
  • harness 流式输出透传到 reasoner 包装层，live-tail canonical 事件按 seq 去重；MCP envRefs 凭据回退、Codex bearer 合并、tool_search 目录隐藏和 mcp_tool_call 审批放行保持统一。
  • tool_approval_mode=full 时 composer 完全访问不再被 Harness 审批门重复拦截；新建会话互斥、切 Agent 回欢迎页、流式删除先取消、僵尸 RUNNING 回收和稳定排序继续生效。
  • 增加 prewarm 端点与跨轮激活复用；裁剪孤儿依赖和其他平台产物；默认模型为 deepseek-v4.1-flash，回退 glm-5.3-flash；Codex Runtime 升级至 openai-codex==0.154.0。
  • Studio 桌面打包补齐 Mach-O/Node 签名、DMG Applications 快捷方式和发布 workflow 的 Pillow、pnpm、secret 条件修复；这些是制品门禁改进，不改变 Python API。

修复

  • 修复内置工具 digest 漂移自愈、Harness 文件工具写入用户工作区，以及 event store stat 缓存导致 SSE 投影循环全量重读的问题。
  • 修复 Connector 首次 heartbeat 窗口、重复投递终态回放、跨副本 owner fencing 和错误响应泄露；断线未知结果仍保持显式不确定，不伪造成功或自动重试。
  • 修复 Studio Channel 页面双路由和静态导航并存、插件发现 fan-out 阻塞首屏，以及 Vite/Teams 样式/xterm 构建测试不稳定的问题。
  • 修复托管 checkpoint hook 缺失时继续执行的风险；缺少 prepare_state 现在返回明确的 fail-closed 错误，已有 durable checkpointer 不再错误接管 compaction。
  • 修复 LangGraph/LangChain 使用托管 PostgreSQL checkpoint 时审批卡不弹的问题：移除租户 namespace 注入，保留合法子图的完整 namespace，支持嵌套子图 interrupt，并让状态读取错误显性失败。
  • 修复共享 checkpoint 库中同一租户不同 Agent 复用 session ID 造成 thread 冲突的问题；thread identity 现在包含 Agent 维度。

验证与发布记录

  • KsADK 重点 Python、Studio connector、插件生命周期、前端 Vitest 与生产 Vite 构建已通过；公开制品已完成 wheel/sdist 内容和校验和核对。
  • Channel Connector gateway、JWT、Redis 双副本、heartbeat、Studio inbound pipeline、真实 Harness 执行和浏览器 Channel workspace E2E 已在隔离临时环境通过；IM 投递和模型响应使用确定性替身，未宣称真实账号验收。
  • 正式版本：v0.8.5，GitHub Release 已发布，PyPI 已发布 ksadk==0.8.5；@kingsoftcloud/ksadk-web@0.3.11 与本版本配套。
  • 发布源：GitHub commit 5128ff1e，对应 tag v0.8.5。wheel/sdist 均包含生成后的 Studio/Web 静态资源；Release 附件已与 PyPI 文件对齐，均包含生成后的 Studio/Web 静态资源。

制品校验和

  • ksadk-0.8.5-py3-none-any.whl：e7f94fe28efcf854554a7b8aa281fe63201956cff801bda288fcc80ce419ef1a
  • ksadk-0.8.5.tar.gz：1d4e6361b3bfa8849133ace33158789f47277eadc62792913660520140c42730
  • wheel：8,815,925 bytes；包含 265 个 server 静态文件、193 个 studio 静态文件
  • sdist：8,250,557 bytes

用户可见影响与运行时契约

  • 使用 LangGraph/LangChain 人机审批的 Agent，在托管 PostgreSQL checkpoint 下现在会正确显示审批卡，并可在新的 Pod 中继续恢复。
  • configurable.checkpoint_ns 只用于 LangGraph 真实子图寻址；租户、workspace 和 Agent 身份不再写入该字段。业务 Agent 不应自行把租户标签放入 checkpoint_ns。
  • 租户和 Agent 隔离由稳定的 framework thread_id 承担；同一身份、同一 Agent 和同一外部 session 会得到稳定 thread，不同 Agent 不共享 checkpoint。
  • 审批状态读取、checkpoint 元数据和 usage 读取共用异步状态读取入口。配置了 checkpointer 的图如果状态不可读，会返回显式失败，而不会被标记为 completed。
  • 托管 PostgreSQL graph factory 仍需同时提供 ksadk_prepare_state，避免 checkpoint 恢复 messages 后再次注入历史造成重复上下文。

验证矩阵

  • LangGraph/LangChain HITL：interrupt、approval projection、approve/reject/edit resume。
  • Nested subgraph：子图 interrupt 可见，真实带 task ID 的 namespace 保持完整并可用于恢复。
  • Checkpoint：thread identity 隔离、跨 Agent 隔离、跨 Pod durable backend 能力探测和不可读状态 fail-closed。
  • Studio/Channel：Connector JWT、heartbeat、幂等、跨副本 owner fencing、Channel workspace 和浏览器场景。
  • 制品：PyPI wheel/sdist、GitHub Release 附件、Studio/Web 静态资源和 build provenance 均已核对。

安装

pip install --upgrade ksadk==0.8.5

Hosted UI 配套使用 @kingsoftcloud/ksadk-web@0.3.11。桌面用户使用本 Release 附件中的 macOS DMG/ZIP 或 Windows ZIP。

Assets 10
Loading