KsADK 0.8.6

KsADK 0.8.6 汇总 0.8.5 以来的 Native Harness、Studio、A2A、持久化恢复及运行时修复，配套 @kingsoftcloud/ksadk-web 0.3.13。

PyPI 主包 · 兼容发行包 · 配套 npm

本页 Assets 提供与 PyPI 正式制品哈希一致的 SDK wheel/sdist，校验值见 SHA256SUMS-sdk-0.8.6.txt。

请使用 Python 3.12 或更高版本，在新虚拟环境升级：

python -m pip install -U ksadk==0.8.6

兼容发行名 agentengine-sdk-python==0.8.6 提供相同 ksadk 导入，两个发行名请二选一安装。wheel/sdist 内嵌 Web 静态资源，测试目录不随制品分发。既有云端 Agent 不会随本地升级自动重建或部署。

发布来源

• 公开提交：867f7db3，对应 annotated tag v0.8.6；与通过 review/CI 的最终候选 9946f865 代码树一致。
• 可信发布 workflow 已完成两个 PyPI 包的 Trusted Publishing 和公开文档部署。
• 发布后从正式 PyPI 下载并核验四个制品的 SHA256；两个发行包分别在全新 uv 环境完成依赖检查、流式/持久会话与实际 SDK 工具 worker 验证。
• 主 wheel 为 10,186,176 bytes（约 9.71 MiB），测试文件为 0。

验证与范围

• 最终公开候选通过完整 make public-preflight、全部 CI、制品检查、安全扫描与 CodeQL。
• 两个 ADK 兼容锚点各 2447 项测试通过；Studio 518 项 UI、77 项 Node 测试、类型检查、生产构建和响应式浏览器门禁通过。
• 实际构建 UI 的真实模型验收连续 3 次通过，覆盖首次发送、刷新、SQLite 冷恢复及同会话追问；验收期间源码与静态资源摘要保持不变，wheel 内的 Studio 资源与验收包一致。
• 两个 Python 发行包完成构建、内容审计、依赖检查与安装后流式/持久运行验证；wheel 和源码包完成独立干净安装，测试目录不随制品分发。
• 云端部署、Native 多副本恢复和目标服务鉴权仍需各自环境单独验收。

发布后检查

• 发布后的原主线 CI 的导航浏览器场景在四种尺寸下均通过功能断言，但服务线程 5 秒退出检查连续失败两次，未计为通过。根因为插件信息投影在 HTTP 事件循环同步探测工具链；源码修复 PR #114 已通过完整本地公开预检和全部 16 项 PR 检查，并合并到 main（82ff427c）。合并后主线 CI 全部通过，原始浏览器导航及服务退出门禁通过，无需重跑。该修复未包含在本页已发布的 0.8.6 制品中；不新增版本、不移动 tag、不替换 PyPI/npm 制品。发布前最终候选的完整 CI 和发布 workflow 门禁均已通过。
• 独立桌面构建 的 macOS 任务通过；Windows 任务因构建脚本解析绝对 tarball 路径失败，未生成 Windows 桌面包。Python/npm 制品与文档发布已成功；桌面包不属于上述 SDK 安装验证结论。

[0.8.6] - 2026-10-15

升级须知

• 最低 Python 版本提高到 3.12。请在新虚拟环境安装并验证依赖；已有 Agent 可保留原 SDK 与镜像，不会随本地升级自动重建或重新部署。
• 本版本配套 @kingsoftcloud/ksadk-web@0.3.13。wheel/sdist 内嵌已构建的 Web 与 Studio 静态资源，安装后无需现场构建前端；Python 依赖和 Node/Codex/DSH 工具链仍需分别安装或预缓存。
• 普通本地 Studio 默认选择 Native Harness 与 SQLite 持久化执行账本；显式 Agent 选择、自定义执行宿主和兼容模式继续按配置生效。可用 KSADK_STUDIO_NATIVE_DEFAULT=0 选择 Managed 兼容路径；这不改变云端既有 Agent 的执行内核。
• agentengine-sdk-python 兼容发行包与 ksadk 同步为 0.8.6，独立提供相同的 ksadk 导入与实现。两种发行名二选一安装，避免在同一环境覆盖共享文件。
• 修复兼容发行包的 all extra 回指主包的问题，改为展开自身发行名的 extras，避免额外安装另一份共享同一导入目录的 SDK。

Native Harness 与 Studio

• 新增 Native 执行内核、事件账本、工具策略、工作区边界、上下文规划、compaction、任务验证与子 Agent 生命周期；Studio 接入 Native 模型、工具、插件能力及执行控制，保留框架原生 Provider 的独立执行语义。
• Native 工具调用按授权、审批与审计边界执行；hard deny 不因完全访问模式放行。上下文、Hook、Skill、Browser、Memory 和子 Agent 恢复需要宿主显式装配及匹配的策略，不因接口存在就自动获得生产权限。
• 增加持久化运行恢复、暂停/继续、子任务状态和验证结果投影，收紧崩溃恢复、未知副作用、模型切换和结果发布边界。Native 云端启用、多副本恢复与所有外部服务兼容性仍需目标环境单独验收。

A2A、Kernel 与恢复

• 完善 A2A 1.0 的工具、专家调用、流式文本制品和结构化输入；按子 scope 隔离取消与失败，避免子任务终态停止根任务。
• Codex 专家等待和原生 checkpoint 支持带 fence 的持久化恢复；恢复前核对 Agent、scope 和执行归属，已提交结果可回放，结果不确定的启动不自动重发。
• checkpoint 保留类型化 envelope、时间戳、carrier 完整性与规范恢复审计；内存、SQLite、PostgreSQL 与 resilient 服务对工具执行回执进行身份、参数、输出和冲突校验。
• 通过 durable claim 防止同一工具回执键被并发重复执行；外部副作用已发生但尚未确认提交的情况仍可为 unknown，必须显式对账，不宣称 exactly-once，也不自动重试。

历史读取与数据库预算

• 历史分页优先读取有界投影，保留 session sequence、来源、epoch 和 snapshot 边界；按能力声明支持新 Runtime 协议，旧 Runtime 沿用既有游标语义。
• 新增连接、读写、锁、完整 replay 和清理预算，以及历史读取并发/初始窗口配置。普通历史请求的预算与 Agent 执行时长分离；超时或读取失败明确返回状态，不伪造空历史或已完成结果。
• PostgreSQL 连接取消、事务回滚和 pool reset 共用清理预算；reset 失败或超时会丢弃连接，不覆盖已确认的读取/提交结果或原始数据库错误。
• 持久写入结果未知时隔离不安全的本地镜像与降级缓存；确认提交结果并恢复完整快照后才允许继续使用，避免重复事件序号和错误回放。

CLI、运行时与 Web

• Studio 增加跨工作区操作聚合、原生目录选择、可选工作区启动与无重启切换，支持会话内搜索、草稿冲突处理、快捷创建 Agent、快捷键和未决提交重试提示；链接目录通过显式授权策略控制。
• Studio 新增云端 Teams 的契约、客户端、协作界面与持久执行集成；资源绑定、permit、签名和云服务可用性仍由对应控制面及宿主负责。
• 模型配置支持完整设置页、最小配置流程，以及 Anthropic Messages、Chat Completions、Responses 的探测与执行；新增 SDK 版本和 PyPI 更新检查，完善原生 Responses 代理及有限重试预算/限流诊断。
• 本地进程资源限制成为共享 runtime 能力；运行时镜像区分经过构建验证的镜像标识与原生版本。Studio 首屏避免等待逐 Agent 发现，工作区切换、云控制面读取和静态资源缓存减少重复请求。
• LangGraph 显式图配置的 recursion_limit 优先于 KSADK_LANGGRAPH_RECURSION_LIMIT，未配置时使用默认 50；异常及断开的 SSE 进入失败终态，公开错误脱敏并保留调用身份。
• 修复托管 Agent 的 admitted session actions 调用、完整事件翻页、已接受调用的中断读取重连，以及 Agent Update 的同步响应/持久操作等待和 busy 冲突提示。
• CLI 翻页保留历史来源 epoch；来源改变时明确停止观察，避免沿用失效游标，也不会重发已受理的运行请求。
• 修复 Code 包的 framework manifest、LangGraph SQLite saver、基础运行时 rich 依赖、Unicode 附件与归档文件名，以及 Codex 原生线程指令和根运行身份。
• 云资源请求统一透传 X-Traffic-Source，通过 KSADK_TRAFFIC_SOURCE 配置，默认 agentkit；该字段用于来源标识，不替代鉴权。
• 配套 Web 修复历史分页与实时消息合并、草稿/Agent 切换隔离、原始提问顺序、原生工具日志、LangGraph 审批历史、输入法确认键误发送和永久订阅错误重试；工具审批统一呈现在输入框上方，保留拒绝、取消、未知及投递失败状态。
• Studio 桌面签名、更新 feed 和发布工作流补齐来源固定、完整性与安装后验证；Python/npm 发布不等于新桌面安装包或云端镜像已部署。
• Python 源码包显式排除测试目录，wheel/sdist 审计新增测试目录阻断规则；CI 补齐真实 PostgreSQL 历史/恢复测试环境与并行测试依赖，防止内部测试误入发布包或新门禁无法运行。 ADK 多版本矩阵在工具链和构建完成后固定目标版本，并在实际测试前断言版本，避免环境同步把旧版测试恢复为 lockfile 版本。
• 按既有模块体积门禁拆分历史查询、流式投影、云端路由及运行时辅助代码，保留原入口和契约；Teams 集成测试按数据库时钟签发测试 permit，覆盖宿主时钟领先的情况。

修复

• 修复 Studio 聊天首次加载时，迟到的会话列表或工作区身份切换清空新草稿的问题；工作区身份确定后再挂载聊天，初始对话明确登记为本地草稿，发送前保持输入与会话归属一致。
• 本地会话选择同步到地址，刷新时按原 Agent 与会话恢复；切换 Agent 时清除旧会话请求，工作区刷新失败时保留已确认的草稿归属。
• 历史正文块与当前消息的最终正文不一致时使用兼容投影，避免同轮独立消息重复显示整轮内容，或流式草稿覆盖最终修正文。
• 恢复审计统一识别 run_resume、runtime_resume 与 continuation.resumed，同一恢复尝试的新旧载荷只计一次；没有尝试 ID 的历史记录保持独立计数。
• 审批已拒绝、取消或不存在时，迟到批准不能新建工具执行占位；规范与历史事件按审批 ID 匹配，多条审批并存时不会错移终态；崩溃重试仅回放匹配的既有 claim 或合法回执。
• SQLite 与 PostgreSQL 的会话删除和执行占位插入使用数据库级互斥，避免删除在途 claim；SQLite 并发插入输家统一校验工具与参数摘要。
• Studio、Hosted UI、构建门禁和环境变量文档统一固定 Web 依赖版本，修复旧依赖缺少云团队导出导致的公开预检构建失败。
• Linux 关闭插件进程组时区分已退出的僵尸成员与活进程，避免无效等待完整关闭预算；活进程、隐藏或身份不明的进程组继续按原预算清理，并保留强制终止收尾。
• 托管 DSH 工具链统一固定官方 0.1.7-rc.1 与完整 Core/HMR 依赖图，修复旧版本的实时 profile 启动错误；保留上游插件的依赖与兼容性保护。
• 公开预检与 Studio 浏览器 CI 在隔离目录初始化官方 Provider 工具链，测试 Agent 显式声明宿主进程权限；响应式和前端子检查失败会阻断验证。
• Studio 导航回归覆盖先建本地草稿、首次发送再创建服务端会话，防止迟到列表恢复旧会话；更新当前导航尺寸与固定运行时的浏览器断言。
• 恢复桌面展开导航时的收起按钮，浏览器回归验证收起、展开和刷新后的选择保留。
• 发布候选的 Web 身份校验、桌面打包子脚本和 manifest 统一使用固定 Web 版本；默认 Make 版本会传给子进程，旧版本即使所有证据一致也会被拒绝。
• 实时审批确认使用与持久化恢复一致的公开 interaction_id，修复内部审批 ID 导致合法批准/拒绝无法恢复的问题。
• LangGraph 恢复后的历史工具结果按 run、scope 与调用身份去重，避免从历史快照重放原生工具事件时重新生成旧审批。
• Native 的 ArtifactRead 容量报价支持默认并行只读批次，使用真实 reducer 估算封存后的上下文预算；报价不执行工具、不写入执行事实。
• Chat 流中工具身份完整而参数未填充时，保留不完整响应分类并受既有重试预算约束，不补成可执行的空参数；身份冲突、参数改写和其他协议错误继续拒绝。
• 恢复显式启用的空流补偿：仅在没有文本、没有工具调用且因输出上限结束时允许一次兼容请求；固定输出预算不扩张，策略拒绝、用户取消和 Native 禁止隐式重试的行为保持原约束。
• Native 清理内部唤醒任务时继续传播外层取消，确保在该窗口取消的模型及子 Agent 真正停止，避免父任务恢复后一直等待子任务清理。
• 历史正文块累计增量文本后再处理终态快照，避免长会话刷新或分页回退时重复追加整段回复。

文档

• 补齐工具执行占位查询、显式对账的请求、响应、鉴权和失败语义；unknown 不会自动重执行，对账后同键回放失败结果。

完整变更见 CHANGELOG，使用与升级说明见 公开文档。