ksadk 0.8.3

KsADK 0.8.3

插件化基础与本地自动化：在 0.8.2 的运行时与端云协同地基之上，新增插件体系、本地调度与会话表面统一。本版本只增加本地能力，不要求已发布 Agent、历史 Bundle 或无 PostgreSQL 的单机模式升级。

插件化基础

• 新增统一的 agentengine plugin 产品入口，但不定义第三种 KsADK 私有插件格式。DSH Bundle/Profile 是唯一默认生态；受管理的固定版本 DSH/pnpm 工具链覆盖 create、validate、test、pack，开发者无需检出或编译 DeepSeek Harness 源码。
• 新增事务化 PluginHost、能力注册与组合合同。SQLite Store 与 Renderer 保持 host-owned，MCP、Skill 和 Context 只投影经过边界校验的安全数据；数据库路径和已解析 Secret 不越界。
• 新增 Codex App Server 插件桥接：Codex 插件的发现、详情、安装和卸载均交给 Codex 宿主，KsADK 不复制插件实现，也不接管其认证或宿主权限。
• 新增 DeepSeek Harness Profile 管理桥接：DSH Bundle 的发现、安装、启停、升级、卸载和配置预检均委托给受管理的原生 dsh plugin，KsADK 只保存无 Secret 的 inventory、来源摘要与配置摘要。

Studio 自动化与会话表面

• 新增本地 Scheduler Lite：支持 once、interval、cron、IANA 时区、启停、编辑、删除、立即运行、misfire 策略、并发保护和 occurrence 历史。Studio 提供全局自动化页和 Agent 详情页自动化 Tab。
• 冻结 ConversationSurface、ConversationInput 和 ConversationItem 合同，统一文本、reasoning、工具、审批、A2UI 与未知 item 的 identity-aware 归并和回放边界。
• Hosted UI 与 Studio 固定到 @kingsoftcloud/ksadk-web@0.3.4。该版本在 0.3.3 基础上修复 item 完成被误判为整轮完成的问题，等待显式 run terminal 才解锁下一轮；"正在思考"改为持续可见的文字流光，并提供可独立运行的 GitHub Pages 演示。
• 修复 Studio 切换会话后 composer 卡 disabled、后续提交触发 runtime handle is already attached 的问题：切换会话时重置 stream 与草稿。

兼容与发布

• 本版本只增加本地能力，不要求历史 Agent 升级。历史 Harness 只有命中显式登记的精确来源摘要才进入 legacy adapter；未知来源 fail closed。
• ksadk-web@0.3.4 已通过 npm Trusted Publishing 发布，registry integrity 为 sha512-IudZCNnWAWYJOb/s/lbr02qg17KWQ0s/419StDVZxcEcbJOVVKE4GkbGtGs/5X+WkzbXE9eOUvIEydN5QEV4LQ==。
• Claude Code、游戏插件和任意第三方插件格式尚未作为已支持生态发布。后续可以通过 Provider 或 ecosystem bridge 接入，但必须先通过权限、生命周期、ConversationSurface 和兼容性 conformance。

完整发布说明见 CHANGELOG.md。

KsADK 0.8.2

KsADK 0.8.2

运行时地基与端云协同：冻结 Agent Runtime 协议地基，Studio 打通本地创作到云端生命周期，前后端会话统一到真实事件流。已发布 Agent 无需改动即可继续运行。

亮点

• 运行时协议地基冻结：冻结 AgentControlChannel/v1、SessionEventEnvelope/v1、ActivationLease/v1、RuntimeCapabilityMatrix/v1 与 Interaction/v1，通过 schema digest 和 additive-only gate 防止后续随意改协议。
• 可靠执行不再强制 PostgreSQL：AgentKernelStore 支持 InMemory、SQLite 与 PostgreSQL。普通单副本 Agent 可不配置 PG；需要跨 Pod 恢复、接管和高可用时再启用 PostgreSQL，并使用 lease、fencing 与事务 CAS 保证唯一 owner。
• Studio 打通本地创作到云端生命周期：沿用平台既有 CreateAgent / UpdateAgent 等接口，支持构建、部署、状态、详情、会话、删除、版本选择与二次确认回滚；账号中由 CLI 部署的高代码 Agent 也可直接选择和管理。
• 前后端会话统一到真实事件流：本地 Web UI 与 Hosted UI 固定使用 @kingsoftcloud/ksadk-web@0.3.2，Studio 对齐同一 Interaction / RuntimeEvent 合同，支持签名 SSE、流式正文、思考、工具、审批、附件、模型、三档审批以及 Goal / Plan 控制；普通前台聊天不依赖 Background 长任务模式。

安全与可靠性

• Gateway 的 Agent Runtime 路由统一经过 Server admission；Runtime 缺少 Server 签发 permit 时 fail closed。permit 绑定 Agent、session、action、TTL 与 durable nonce，避免伪造引用、会话放大和重放。
• worker 消费真实 RuntimeEvent 流，统一 run identity、handle digest、lease fencing、冷恢复和 resume；事件日志成为 session 状态的单一事实来源。
• 加固 Studio 模型 URL 占位符识别和工作区路径边界，阻断相似域名误判、父目录/同名前缀目录和符号链接逃逸。

社区贡献

• 合入 PR #53（@pengliang100，commit author pengliang3）：过滤 LangGraph tool message 中的纯文本工具标记，保留原提交作者信息。

验证与发布记录

• 当前候选已在真实隔离云环境完成同一 Agent 原地更新，以及系统提示词、MCP 调用、前台 SSE、最终消息去重、刷新后思考/工具回放验证。
• Web UI：@kingsoftcloud/ksadk-web@0.3.2，npm integrity sha512-Ytjd3pIgy6LfHCmguXUDQr/wy9ClqKjbv+J+NAzH/+UIJjhVl3y1SA2eR7WwsWSn42zxBFme/xniUZMNBV53Aw==。
• Python：ksadk==0.8.2 与兼容别名 agentengine-sdk-python==0.8.2。

完整发布说明见 CHANGELOG。

KsADK 0.8.1

公开发布时间：2026-08-13
变更记录冻结：2026-08-10

[0.8.1] 变更记录

亮点

• 首次交付 AgentKit Studio：0.8.0 尚未包含 Studio；0.8.1 新增 agentengine studio 本地 Agent 构建与运行控制台。首版直接采用单一 React shell，统一承载 Agent、会话、构建、部署、工程资源、可观测性、运行资源和任务编排页面；React 是首次交付时的前端选型，不是从既有 vanilla Studio 迁移而来。
• Agent 全生命周期在一个本地工作区闭环：支持快速创建、对话构建、YAML/Agent ZIP 导入、ADK/LangGraph 项目识别，以及 Agent 配置、能力绑定、校验、构建、运行、评估、部署、回滚和操作进度查询。根路径直接进入 Agent 工作区，不引入需要单独维护的 /chat 前端入口。
• 对话运行升级为可暂停、可继续的人机交互状态机：在 0.8.0 RuntimeEvent v1、AG-UI/A2UI 和 RuntimeAdapter 基础上，打通 Responses/SSE 增量输出、持久化事件回放、切换会话与刷新恢复、暂停/继续/取消、审批提交和结构化用户输入。ADK、LangGraph 与 Codex 共用运行状态和交互投影，不要求 Studio 为每个框架维护一套私有渲染协议。
• 本地可观测性成为 Studio 的一等能力：新增运行概览、趋势卡片、可分页筛选的 Trace 列表、Span 瀑布时间线、详情面板、Attributes/Events/Resource 浏览，以及格式化并高亮的 Raw OTLP 预览；会话运行详情可直接关联完整 Trace。
• 标准 OTLP 成为唯一远端 trace 通路：每个 Python Agent 进程使用一个 TracerProvider，由两个 OTLP/HTTP BatchSpanProcessor 将同一批 spans 写入 Langfuse 主路（标准 OTEL_EXPORTER_OTLP_*）和 CloudMonitor 次路（平台 CLOUD_MONITOR_OTLP_*），两端保持相同的 trace_id / span_id。不再部署 CallbackHandler、Langfuse SDK exporter、Collector、sidecar、额外容器或额外 Pod。
• 托管可观测性默认开启：agentengine deploy、agentengine launch 和 agentengine hermes deploy 默认请求平台可观测性；CLI 与控制台共用控制面开关，由平台注入主路和次路配置。只有显式选择 --no-observability 或在控制台关闭时才禁用。

新增

• 新增 Studio 本地控制面与版本化 API，覆盖 workspace、Agent、模板、资源目录、模型配置、凭证引用、构建、运行、会话、Trace、评估、部署和长操作；本地写请求使用随机 session token 与 CSRF 校验，凭证可从当前进程、全局配置或项目配置解析。
• 新增模型、Python Tool、MCP 与 Skill 资源管理。Python Tool 支持源码上传、只读检查、可复制示例和 schema 校验；Skill 支持候选扫描、逐项复核导入、冲突确认、文件树浏览以及 Markdown/代码高亮预览。
• 新增 Agent 外观配置和图标资源上传；Agent 本地标识默认使用带随机后缀的稳定 ID，表单统一标明必填、选填和自动生成字段，并提供文件拖放、多选、选择器、数据表、对话框与代码预览等共享 React 组件。
• 新增 Studio 会话工作区：单行紧凑会话列表、流式正文与思考/工具 activity、上下文窗口用量、附件入口、三档审批策略、/goal / /plan 命令和运行模式条。审批等级从下一轮实时生效，生成期间发送按钮切换为暂停/停止控制。
• 新增 A2UI surface 增量归并、持久化回放和交互回传，支持确认、单选、多选与自定义输入；无 A2UI surface 时，工具、审批和 RuntimeEvent 仍以克制的通用 activity 卡片展示。
• 新增运行资源与任务编排页面，将 Runtime、模型、Tool/MCP/Skill 绑定、路由约束和最近调度投影为可检查的 DAG；节点根据画布宽度自适应布局。
• 新增 AgentKit manifest、Codex Agent 构建与运行服务、资源/能力目录、操作事件流、Agent 头像资产以及本地 OTLP Trace 存储与查询能力。
• agentengine hermes deploy 新增可重复的 --env KEY=VALUE 与 --env-file（dotenv 或 JSON 对象），并可自动发现当前目录 .env；优先级为 --env > --env-file > 当前进程环境 > 自动 .env。显式环境参数会进入新建或更新 payload，未显式指定时更新已有 Hermes 不覆盖服务端环境配置。OpenClaw deploy 同步复用该解析规则并新增 --env-file 与自动 .env 加载。
• 新增 React Studio 专项 CI 门禁，覆盖协议归并、组件行为、TypeScript、生产构建、样式契约、桌面浏览器烟测和常见分辨率响应式烟测，并校验随 Python 包分发的静态产物与 React 源码一致。

变更

• Runtime 启动路径收敛到显式的 factory、adapter 和 conversation execution 边界；CLI、Web、A2A、AG-UI 与 Studio 共用同一运行时装配逻辑，减少模块级全局 runner 和重复 SSE 实现。
• Codex 从旧 runner 路径收敛到 CodexRuntimeAdapter 与官方 app-server transport，补齐模型代理、HOME 隔离、审批/沙箱策略、全局凭证继承、结构化交互事件和中断后的流式 transport 回收。
• Responses 输入、会话历史、运行事件、tool/approval/A2UI activity 和 usage 在服务端统一投影；/v1/responses 保持主要会话接口，/v1/chat/completions 继续作为 OpenAI-compatible 协议入口，而不是 Studio 页面路由。
• Studio 前端源码位于 ksadk/studio/react-ui，Python 包中的 ksadk/studio/static 只保存其生产构建产物；首次交付不引入另一套 vanilla Studio 前端。
• Studio 桌面布局统一适配 MacBook 14 英寸及常见 2K/4K 视口；导航、DAG 画布、会话列表、Composer、深浅色主题和 Trace 详情共享设计令牌与响应式规则。手机竖屏不属于 0.8.1 支持范围。
• 删除 langfuse_exporter.py、runners/utils/langfuse.py、LANGFUSE_USE_CALLBACK 和 Langfuse SDK callback 路径；tracing extra 不再安装 langfuse，仅保留 OpenInference 自动插桩。
• 调整 Python 包依赖边界：langchain-openai 仅随 langchain、langgraph 和 deepagents framework extras 安装，不再由基础 ksadk wheel 强制安装。这样 Hermes 等不使用 LangChain OpenAI adapter 的运行时可保留其已验证的 OpenAI SDK 版本；选择这些框架的生成项目仍会声明并安装同一受支持版本范围。
• all extra 纳入 Codex 支持；Studio 运行与测试依赖补齐 MCP、Pillow 和 Playwright，wheel/sdist 继续只打包 React 生产静态资源而不包含 Node.js 源码依赖。
• agentengine hermes exec 增加显式 --agent 目标并改为 argv 原样透传，由远端 Pod 执行最终命令策略；普通 argv 不再被猜测为 Agent 名称，--session 业务会话 ID 会写入 terminal start frame。
• 用户显式调用 save_memory 时向 SDK 记忆后端发送 flush=True，保证本次数据完成抽取后再返回；自动轮次保存继续使用后端默认批处理语义。
• agentengine studio 默认继续仅监听 loopback，但端口调整为 8080；可用 --port 覆盖。Studio 前端源码开发代理也使用同一默认端口。

修复与性能

• 修复 LangGraph 回调将 ToolGateway 结果序列化为 JSON 文本时，工具审批未被识别为可恢复交互的问题；Responses 客户端现在会收到标准审批项，批准后可继续原工具调用并执行真实副作用。
• 修复 LangGraph 中 ToolGateway 审批完成后向已结束图发送原生 resume、导致副作用虽已执行却没有后续回复的问题；现在会基于已持久化的真实工具结果继续生成最终回答，同时保留原生 interrupt() 的 resume 语义。
• 修复 Studio 快速创建向导与模板编排 API 的请求契约，并将 ADK/LangGraph 的源码路径和入口变量完全交由服务端生成；“创建后立即构建并打开会话”现在会实际提交 Build、等待成功后再进入会话。Codex、ADK、LangGraph 三种 Runtime 均按同一流程创建和构建。
• 修复 Codex RuntimeAdapter 事件信封丢失调用方 agent_id / user_id / invocation_id 的问题，避免通过 /v1/responses 运行时因作用域校验不一致返回 500。
• 修复通用 Agent 创建与更新部署 payload 未标记敏感环境变量的问题；模型 API Key、Token、Secret 等现在按统一规则写入 IsSensitive，避免控制面将其按普通变量处理。
• 修复 Codex ManagedRuntime 的本地声明构建与请求组装：部署/--dry-run 会加载项目 YAML、计算 manifest SHA-256 并传给控制面，而不把部署参数误当作 Agent manifest。
• 修复 Codex 中断后 SDK transport 残留后台等待任务，避免事件循环退出阶段挂起。
• CloudMonitor traces 专用 endpoint、protocol 和 headers 分别优先于通用配置；CLOUD_MONITOR_OTLP_TRACES_HEADERS 与 CLOUD_MONITOR_OTLP_HEADERS 都支持 RFC 3986 percent-encoded values。
• CLOUD_MONITOR_APP_KEY 降级为一个版本的过渡 fallback：仅当 traces 和通用 headers 环境变量都整体缺失时才翻译为 Ksc-Appkey。任一 headers 变量已提供但无有效 Ksc-Appkey 时 fail closed，不混入旧 AppKey。
• AgentEngine 托管 runtime 在模块级 ksadk.server.app:app 与 BaseRunner.run_server() 两个真实入口都按 KSADK_A2A_RUNTIME_ID 挂载 discovery-only /.well-known/agent-card.json；卡片明确声明 streaming=false，不开放 JSON-RPC、REST Task 或其他 A2A 数据面路由。
• A2ASpaceClient.from_env() 优先读取 KSADK_A2A_SPACE_ID，并保留对单元素 KSADK_A2A_SPACE_IDS JSON 数组的兼容读取。
• A2A 核心依赖改为 a2a-sdk[fastapi]；PostgreSQL TaskStore 支持移到可选 ksadk[a2a-postgres]，discovery-only runtime 不再因 A2A 被强制安装 PostgreSQL adapter。会话系统既有 asyncpg 依赖保持不变。

兼容性、迁移与评审边界

• 0.8.1 是 AgentKit Studio 的首次交付，不存在从 0.8.0 Studio 或 vanilla Studio 迁移的问题。Studio 只有一个 React 前端入口；自研 UI 仍可直接消费 Responses/SSE、RuntimeEvent、AG-UI/A2UI 和运行控制 API，不要求使用 React。
• RuntimeEvent schema 继续保持 v1 additive 兼容；新增交互和运行控制通过追加事件类型与控制 API 表达，不修改既有事件字段语义。
• 旧 LANGFUSE_* 凭证不再创建 SDK callback/exporter。迁移时把 Langfuse OTLP endpoint 与 Authorization header 配置到标准 OTEL_EXPORTER_OTLP_*。
• 新部署使用 CLOUD_MONITOR_OTLP_TRACES_HEADERS 或 CLOUD_MONITOR_OTLP_HEADERS 提供 Ksc-Appkey；CLOUD_MONITOR_APP_KEY 仅用于旧控制面的短期兼容。
• A2A 环境变量明确区分部署期 KSADK_A2A_RUNTIME_ID 与注册后 KSADK_A2A_AGENT_ID；v1 discovery card 只依赖前者。
• Codex ksadk init 的本地 web/Responses 运行与 ManagedRuntime 请求组装已验证；真实云端部署仍依赖服务端发布 Runtime catalog、对应 Linux runtime image 和内联 manifest 的公开控制面契约。该服务端能力未在本次 SDK 发布中宣称可用，SDK 不会把 Codex 静默降级为 Code 部署。

文档

• 同步中英文 README、Studio CLI、可观测性、环境变量、知识库与记忆库指南；新增可从左侧导航进入的 AgentKit Local Studio 指南，补充首次 Studio 交付、React 源码/构建产物边界、运行控制与交互协议、默认 OTLP 双写、显式关闭、header 优先级、旧 AppKey 边界以及 Hermes session 语义。

发布记录

• Python：ksadk==0.8.1
• 内置 Web UI：@kingsoftcloud/ksadk-web@0.3.1（source b4e9f938828ef669347dadb7f0eb3f0a01747a6a）
• AgentKit Studio：首次交付，React 单一前端随 Python wheel 分发生产构建产物
• 当前状态：公开发布；相对 0.8.0 的 Studio、Runtime、Codex、可观测性、CLI、依赖与文档变更均记录于本节
• 本地发版验证：Studio 快速创建、构建和会话入口已覆盖 Codex、ADK、LangGraph；ksadk init -f <codex|adk|langgraph> 生成的三套模板均已通过 ksadk web、/v1/responses 本地对话和 ksadk deploy --dry-run 请求规划验证。ADK、LangGraph 另已完成隔离环境中的真实部署和调用；Codex 真实云端部署待上述服务端 Runtime 上线后复验。
• PyPI、tag、GitHub Release 与公开文档站通过受信 workflow 发布

KsADK 0.8.0

[0.8.0] - 2026-07-29

亮点

• 统一 Runtime 基座：冻结 RuntimeEvent v1 信封和六动词 RuntimeAdapter，补齐事件存储、按会话事件序号（seq_id）续订的订阅、共享 parser 与历史回放。ADK、LangGraph、A2A、Harness 和 Codex 新集成均以这一契约交换运行状态，而不是各自定义一套 SSE 语义。
• Hosted UI 进入 AG-UI + A2UI 轨道：在不改变 OpenAI Responses 既有请求/响应语义的前提下，增加 capability 协商后的 AG-UI transport 和 A2UI activity 投影；无法协商时仍走 Responses fallback。
• 可诊断的会话连续性：runtime storage 成为会话状态的权威来源，补全结构化 Responses 历史投影、请求 metadata 透传、run 订阅心跳与 idle SSE 保活，刷新、续订、审批和恢复都能基于已持久化事件排查。
• Codex 成为一等 Runtime：支持 macOS、Windows 和 Linux 原生子进程调试；agentengine.yaml 即 Agent，无需 agent.py 或 Docker。ManagedRuntime 使用内联 manifest 部署，不把代码、凭据或开发机平台二进制打进云端制品。
• 可组合的运行形态：加入 A2A wire 1.0 runtime、HarnessApp、CodexRuntime 和 Skill Space 路由；这些能力均保留本地与契约测试，生产环境互操作仍按各部署环境的 Runtime catalog 和凭据策略验收。

新增

• 事件与 adapter：新增 RuntimeEvent schema、严格反序列化校验、RuntimeEventStore、session 级订阅、共享 projection/replay parser，以及 ADK/LangGraph 的 adapter contract tests。未知事件不能绕过事件边界进入 replay。
• AG-UI 与 A2UI：新增 AG-UI route group、RuntimeEvent 到 activity 的投影、A2UI core/renderer/fixture viewer 和可持久化 action 记录。审批不是另一套 UI 协议，而是事件流中的受控交互状态。
• A2A：新增 Agent Card、Protocol Runtime、PostgreSQL TaskStore、account + runtime 复合 owner identity、Task cancel/resume adapter、Space 内动态发现、credential provider、egress policy 与 A2A event adapter。AgentEngine 的托管 composition root 使用 Gateway 验证的五元目标绑定和受信 Card probe；它将 resume state 留在 Runtime 本地 durable storage，并为 external_public 提供 HTTPS-only、DNS/IP pin、禁代理、拒绝 3xx 的 NAT transport。app factory 直接装配 A2A 数据面路由；external_vpc 仍需单独的 VPC dialer。
• Harness 与 Codex：新增声明式 HarnessApp composition root，模型/MCP/tool 配置校验和默认只读 sandbox policy；新增基于官方 app-server transport 的 CodexRuntime、生命周期 phase 映射、Responses ↔ Chat 模型代理，以及 ksadk init --framework codex、ManagedRuntime build/deploy 契约。
• 框架与 App Factory：新增 ADK 1.34.x/2.x 兼容层及 CI matrix；server 创建改为 per-app factory/state，路由按职责拆组，WebSocket 也在请求上下文中运行。
• CLI 与诊断：新增 agentengine a2a 和 ksadk replay <session-id>。replay 只读取已持久化的 RuntimeEvent，按 --after-seq-id / --before-seq-id 定位窗口并输出 text 或 JSON transcript；它不重跑模型、工具或副作用，旧式 SessionEvent 也不在此命令的回放范围内。
• Skills、工具与可观测性：新增按 space_id 定向的 Skill Space 消费路径，并完成 tools、memory、sandbox 和 tracing adapter 的迁移，以便 Harness/runner 在同一运行边界消费它们。

修复与性能

• 修复 local/hosted session history 的投影和 metadata 边界，避免刷新后漏失正文、reasoning、tool、approval 或附件状态；恢复请求会先落盘 resuming 状态，避免 SSE 返回与持久化状态竞态。
• 修复 run-event 订阅缺少心跳、空闲 SSE 被中间网络断开、MCP API/delete error 行为漂移、Windows ADK 安装与 create-agent streaming 兼容问题。
• 修复 E2B sandbox 执行硬化、workspace 编辑工具选择、Hermes 项目创建，以及 PostgreSQL/in-memory session 后端的连续性与 fail-open 行为。
• 为 agent-scoped session/event 查询增加 covering indexes，降低多会话历史和回放场景下的数据库扫描成本。
• 托管 A2A 在 public-egress 最终投影缺失时按关闭处理；不把 Runtime reasoning、checkpoint handle 或 resume target 写入公开 A2A Task/Message metadata，取消成功后清除 Runtime-local resume state。

兼容性、迁移与评审边界

• OpenAI Responses 和 Chat Completions 兼容入口仍是默认基线。AG-UI/A2UI 是可选 Hosted UI 能力，不会要求现有 Responses 客户端改协议。
• 旧版 LangChain 连续性 / HITL 路径不再是 0.8 的兼容性承诺。新接入应使用 LangGraph、ADK 或 RuntimeAdapter；迁移时先验证 checkpoint、interrupt 和工具语义。
• 本次 Python 版本为 0.8.0，配套 Web 为 @kingsoftcloud/ksadk-web@0.3.0。Python release workflow 固定请求该版本，并逐文件校验 npm tarball 的 dist-ksadk、同步目录和 wheel 内静态资源；不会静默回退到旧 Web 版本。
• ManagedRuntime 云端运行依赖 AgentEngine Runtime catalog 启用；未配置时保持关闭，不回退到 CodeBuilder。平台控制面和生产 Runtime rollout 仍按各环境独立发布与验收。

文档

• 新增 Codex YAML 即 Agent、Codex ManagedRuntime、HarnessApp 与 A2A Runtime 中英文指南。
• 文档导航按开始、本地调试、运行时能力、互操作、构建部署和高级维护重组，并增加 README、站内链接和 A2A Card schema 回归门禁。

发布记录

• 已评审 GitHub main 源提交：a76f2de7565ffe34d44a9d17257401fa805de0de
• Tag：v0.8.0
• Python：ksadk==0.8.0
• 兼容别名：agentengine-sdk-python==0.8.0
• 内置 Web UI：@kingsoftcloud/ksadk-web@0.3.0（source a35ee0411ee0c2a3d64730be4c8ababe4712c59a）
• macOS / Windows / Linux Codex native smoke、CI、CodeQL、Secret Pattern Audit 和 make public-preflight：已通过

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：已通过

KsADK 0.6.9

[0.6.9] - 2026-07-07

亮点

• 控制台会话恢复更稳：Session 直接返回活跃 run 的结构化状态，刷新、切会话和分享链接进入时不再依赖前端全量扫描事件流来猜测是否需要重连。
• checkpoint 恢复按钮更准：ListSessionCheckpoints 返回可恢复 checkpoint 聚合结果，避免把终态、过期或禁用 checkpoint 误判成可恢复。
• 长会话历史加载更可靠：事件列表补齐向后增量续订和向前翻页语义，in-memory、SQLite、Postgres 后端保持一致，支持从最新窗口进入再加载更早历史。
• token usage 不再少算：ADK、LangChain、LangGraph runner 会聚合同一轮里的多次模型调用，同时保留最后一次模型调用的 usage，便于服务端同时计算累计消耗和上下文窗口占用。
• 公开发布门禁收敛：公开仓 CI、源码审计、产物审计、Trusted Publishing 和 GitHub Pages 部署边界继续收紧，发版依赖 GitHub 可信流水线。

变更

• Session 响应新增活跃 run 的模式和触发来源字段，用于替代从事件流猜测运行形态的前端逻辑。
• run_status 事件继续保持原 content 结构，新元数据写入 metadata / state_delta.active_run，避免破坏旧消费方。
• Runtime event paging 的语义明确为：AfterSeqId 用于向后增量，BeforeSeqId 用于加载更早历史。

修复

• 修复多次 LLM 调用只统计最后一次 usage，导致会话累计 token 消耗少算的问题。
• 修复 runtime 历史分页只靠 offset/limit，长会话首次打开、向上翻页和重连补事件容易错页的问题。
• 修复 SubscribeRunEvents hosted/runtime 双链路续订语义不一致，断线重连可能重复消费旧事件的问题。

KsADK 0.6.8

[0.6.8] - 2026-07-03

亮点

• Coding Agent 内置工具升级：内置工具从基础 toolset 升级为可组合的 coding agent 工具层，覆盖文件读取、目录浏览、搜索、单点编辑、批量编辑、命令/代码运行和 Web 访问，并能通过 dispatcher、tool search 或 direct tools 在主流框架中稳定接入。
• Workspace 编辑体验增强：读取文件会返回行号、读取范围和文件元数据；搜索会返回搜索范围、匹配数量、上下文行和实际搜索后端；编辑前要求先读取并校验文件状态，片段缺失或多处命中时会给出可重试诊断；新增原子批量编辑能力。
• Web 工具主线化：新增 web_fetch 和 web_search，web_fetch 带 SSRF 防护、redirect 后重复校验和 HTML 转文本；web_search 支持 fake/http/ksyun provider，只返回 title/url/snippet/rank，不自动抓全文。
• 分层 Compaction Pipeline：compact_conversation_history 从单点 LLM 摘要升级为 L2→L3→L4→L5 分层管道，长会话成本与稳定性显著改善。L2 Snip / L3 Microcompact 是零 LLM 成本的确定性裁剪，仅作用投影层，绝不删 append-only transcript；L5 在 compact 后恢复 working set metadata（最近文件路径、激活工具、pinned state），降低模型失忆。
• Sandbox 生命周期管理：会话级 sandbox 支持后台清理、进程退出清理和服务关闭清理，避免空闲 sandbox 长时间占用资源；默认执行超时缩短到 10 分钟，空闲 5 分钟后回收。
• 金山云星流 AI搜索 Provider：web_search 新增 ksyun provider，对接金山云星流平台 AI搜索（POST + webpages 数组），复用 KSADK_MCP_KEY/KSC_AIPRO_API_KEY 凭证，返回真实时效 date 字段，KSADK_WEB_SEARCH_SCOPE 支持 webpage/document/scholar/podcast/video。
• Hermes / OpenClaw 默认镜像刷新：Hermes 与 OpenClaw 的默认运行时镜像跟随最新发布版本刷新；具体镜像构建和发布仍以 agentengine-images 仓库为准，ksadk changelog 仅记录 SDK 侧默认消费语义。
• 公开仓治理对齐：补齐公开仓所需的贡献指南、安全策略、双语 README、Issue/PR 模板、CI、CodeQL、Gitleaks、源码审计、产物审计和发布审批门禁，为统一公开主干做准备。
• Fumadocs 文档站：文档站从 mkdocs 迁移到 Fumadocs（docs-site/），对标 veadk github.io，发版时同步部署到 GitHub Pages。

新增

• 新增 tool_dispatcher 和 tool_search：模型可以先搜索工具，再通过统一 dispatcher 调用；旧的 agentengine_tool_dispatcher 继续兼容。
• 新增 get_ksadk_builtin_tools()、工具描述接口和 built-in tools profile，便于 ADK、LangChain/LangGraph、Remote Responses 等框架接入同一套内置工具。
• Workspace 工具新增批量编辑、行号读取、带上下文搜索、编辑失败诊断和大 diff 输出预算，减少 coding agent 改文件时的误改风险。
• 新增 web_fetch，支持公开网页抓取、HTML 转文本、大输出预算和 SSRF 防护。
• 新增分层上下文压缩管道：先做低成本的确定性裁剪和冷上下文压缩，再进入语义摘要，并在压缩后保留最近文件、激活工具和 pinned state 等工作集信息。
• 新增 sandbox 会话管理与自动回收能力，服务退出或会话空闲时会主动释放 sandbox 资源。
• 新增公开发布审计和产物审计命令，覆盖源码、wheel、sdist 和 GitHub Pages 候选内容。
• 新增 GitHub Actions：CI、CodeQL、Release Check、Secret Pattern Audit 和 Publish PyPI；PyPI 发布只由 GitHub Release 发布或手工触发，普通 push main 不会发版。
• 新增公开治理文件：贡献指南、安全策略、双语 README、Issue/PR 模板、Dependabot 配置和分支保护基线说明。
• 环境变量：KSADK_SANDBOX_SWEEP_INTERVAL_SECONDS（默认 60，0 禁用后台 sweep）、KSADK_MAX_CONSECUTIVE_SEMANTIC_FAILURES（默认 0 opt-in）、KSADK_COMPACT_SNIP_ENABLED/KSADK_COMPACT_MICROCOMPACT_ENABLED/KSADK_COMPACT_MICROCOMPACT_COLD_ROUNDS、KSADK_WORKING_SET_MAX_FILES、KSADK_WEB_SEARCH_SCOPE、KSADK_MCP_KEY（注册到 env_registry）。

变更

• 长会话压缩接入主流程，并在 checkpoint metadata 中记录压缩阶段、token 变化和工作集信息，便于审计和恢复；原始 transcript 仍保持 append-only。
• ADK 和 Remote Responses 支持 deferred tools 动态注入：模型先通过 tool_search 选择工具，下一轮请求再注入对应 direct tool；无法动态绑定 direct tool 的框架继续使用 dispatcher fallback。
• run_code 明确定位为 sandbox snippet runner，不作为 shell 替代品；run_command 和 run_code 继续走 sandbox backend，托管环境不会自动退化到 pod local process。
• semantic summary 增加可配置失败熔断；LLM 摘要失败时可回退到 extractive 摘要，避免长会话压缩因为临时模型错误而中断。
• sandbox 默认超时和空闲回收策略收紧，降低托管运行时的资源占用。
• Serverless 部署默认挂盘策略收敛：仅 Hermes / OpenClaw 默认挂盘，其他框架需显式配置挂盘路径。
• 发布候选同步 @kingsoftcloud/ksadk-web@0.2.16 静态资源，确保 PyPI wheel 内置 Web UI 与最新 npm 发布版本一致。
• 公开审计规则更准确，减少文档站和公开服务 endpoint 的误报，同时继续拦截内部路径、私有地址、凭证样例和不应发布的构建产物。
• 公开包元数据和 schema URL 统一指向 GitHub / GitHub Pages。
• 清理测试和示例中的本地路径、内部域名样例，避免公开仓携带开发机或内部环境信息。
• .gitignore 补齐公开仓规则，继续放行 .github/，并防止 .pypirc 等发布凭证误提交。

修复

• 修复并行工具调用场景下，压缩裁剪可能留下孤立 tool result 的问题。
• 修复 semantic summary 熔断默认值与文档不一致的问题，默认保持关闭，由用户显式启用。
• 修复真实运行事件中工具名称和参数位置不同导致 L2 裁剪无法生效的问题。
• 清理未完成的失败工具配对统计，避免 checkpoint metadata 误导排障。

移除

• 内部部署材料：Makefile.openclaw、Makefile.promo.Dockerfile、.pypirc.example、deploy/helm/ksadk-docs/（文档站已迁 github.io）。
• 内部文档：docs/internal/、docs/archive/、docs/superpowers/、docs/preview/、docs/reference/OpenClaw*、docs/reference/assets/openclaw_*、docs/README.md、docs/release/。
• 内部运维 skills：skills/agentengine-cli-ops、skills/agentengine-cluster-debug、skills/agentengine-hermes-lifecycle、skills/agentengine-openclaw-oneclick-deploy。
• examples/（已迁移到 ksadk-samples 仓库）。
• .env.example（ksadk 本体不需要，各 demo 自带）。

文档

• 文档站从 mkdocs（public-docs/）迁移到 Fumadocs（docs-site/），对标 veadk github.io：品牌色、hero 动效、架构图 SVG、mermaid 时序图、ImageZoom、双语切换、CLI 顶层入口、best-practices 教程、llms.mdx 等。
• docs/reference/ksadk环境变量参考.md：补齐 0.6.8 新增环境变量（sandbox sweep/compaction pipeline/web search ksyun）。
• 发版时同步部署 Fumadocs 文档站到 GitHub Pages。

KsADK 0.6.6

KsADK 0.6.6 Release Notes Review Draft

[0.6.6] - 2026-06-23

亮点

• 统一模型策略 v1：新增 AGENTENGINE_MODEL_POLICY_JSON 运行时策略契约，默认主模型为 glm-5.2，多模态模型为 kimi-k2.7-code，fallback 模型为 deepseek-v4-pro，为 Hermes、OpenClaw 和通用 Agent 提供同一套默认模型语义。
• 通用 Agent fallback：conversation runtime 对超时、限流、5xx、模型不可用、权限/配额等可恢复模型错误支持 fallback 重试；普通 400 参数错误、业务错误和 tool 错误不会被吞掉。
• 真实 usage 透传：Chat Completions、Responses、LangGraph、LangChain、ADK 和 Remote runner 的 invoke/stream 路径统一透传下游真实 token usage，stream 结束补 final usage，不再伪造空 token 统计。
• 运行时附件与 Hosted 附件打通：本地 ksadk-upload:// 与平台 ae-upload:// 上传引用统一解析，支持通过 KOP Action 下载 Hosted 附件内容、恢复本地缓存，并在会话/浏览器刷新后继续读取文件。
• Workspace zip 导出修复：本地与 Hosted 场景统一使用 KsADK runtime workspace 导出契约，修复 share link / Hosted UI 下载 workspace 目录时报错的问题。
• 会话列表与事件分页增强：Session service 新增 count_sessions / count_events，ListSessions 返回 Total/Page/PageSize，ListSessionEvents 支持 Offset/Limit/Total，便于 UI 恢复长任务和历史事件。
• Hosted TUI 会话复用：配合 @kingsoftcloud/ksadk-web@0.2.11，Hosted 原生终端按业务会话复用 terminal session，并保留显式新建终端入口，避免刷新或切换页面时重复创建终端。
• Hermes 终端执行策略收敛：抽出共享 terminal exec allowlist policy，OpenClaw/Hermes 终端命令校验共用同一匹配逻辑，简化 allowlist 配置并降低误放行风险。
• 部署与运行调试体验增强：CLI dry-run / JSON 输出、构建缓存、framework passthrough、OpenClaw/Hermes 更新语义、网络参数和凭证边界补齐更多测试，减少发布前后手工排障成本。
• 长任务验证脚本补齐：新增 Hosted long-task、checkpoint resume、cancel/resume 和长期运行 pilot 验证脚本，作为 SDK 发布候选的环境验收辅助工具。

变更

• 默认模型从 glm-5.1 升级为 glm-5.2，配置向导、项目模板、README、dry-run/help snapshot 和 DEFAULT_MODEL_NAME 同步更新。
• kimi-k2.7-code 默认模型参数补齐 temperature=1，并透传到 Chat Completions / Responses 的 temperature、top_p、max_tokens、max_completion_tokens 等 model options。
• OpenClaw 默认 catalog 包含 glm-5.2、kimi-k2.7-code 和 deepseek-v4-pro；图像场景默认优先使用 kimi-k2.7-code，显式 OPENCLAW_MODEL_CATALOG_JSON 仍保持 catalog 首项优先。
• Hermes deploy 与 OpenClaw deploy 均会注入同一模型策略 env，保留 OPENAI_MODEL_NAME、MODEL_NAME、OPENCLAW_DEFAULT_MODEL、HERMES_DEFAULT_MODEL、HERMES_FALLBACK_MODEL 等显式覆盖。
• Hermes 本地默认主模型更新为 glm-5.2，不再按旧主模型名称硬编码 fallback 到 kimi-k2.6，fallback 改由统一策略或显式 env 决定。
• OpenClaw provider catalog 合并逻辑支持在已有 OPENCLAW_MODEL_CATALOG_JSON 上补齐 provider metadata，避免请求级 catalog 被平台默认值覆盖。
• AgentEngineClient 新增 AttachmentContent 与 download_attachment_content()，并修正 list_sessions() 请求字段为 PageSize。
• conversation runtime 会把 runner 返回的 usage 写入 assistant event metadata，并在 Chat Completions / Responses 输出中按官方 usage 字段返回，同时保留 prompt_tokens_details、completion_tokens_details、input_token_details、output_token_details 等明细字段。
• LangGraph、LangChain、ADK 和 Remote runner 的 invoke/stream 均会从 message metadata、state values、event usage metadata 或 OpenAI-compatible response 中提取真实 usage；流式路径在 final chunk 中带出最终 usage，避免 UI 和调用方只能看到空统计。
• runtime 上传附件会持久化 metadata、本地路径和 MIME 信息；Hosted 附件下载后会写回本地 cache，供 runner、workspace preview 和会话恢复复用。
• Workspace zip 导出优先走新的 runtime raw export endpoint，并保留 legacy runtime archive fallback，降低不同 KsADK runtime 版本混跑时的兼容风险。
• Native terminal session manager 新增 HTTP session lifecycle 与 WebSocket attach 语义，断线默认 detach 而不是杀掉 PTY；Hermes 使用 --resume、OpenClaw 使用 --session 绑定同一 terminal session。
• agentengine deploy、agentengine launch、agentengine mcp deploy 和 OpenClaw/Hermes 相关命令补齐 no-cache、dry-run JSON envelope、网络参数、环境变量和显式配置覆盖测试。
• AgentEngineClient 与远程 runner 补齐 framework passthrough、权限预检查、错误日志、MCP payload、workspace files 和 attachment content 的契约测试。
• LangGraph、LangChain、ADK、DeepAgents、A2A、本地 re-exec、session continuity、Postgres session service、sandbox backend 和 Skill Runtime 相关路径补齐回归覆盖。
• docs/ksadk环境变量参考.md 和 docs/远程Agent运行时接口说明.md 纳入公开参考文档，集中描述 SDK/runtime 可配置项、Hosted action 与 runtime local API 的边界。

修复

• 修复长期记忆 save 返回 accepted 时没有被视为完成 tool receipt，导致 conversation runtime 误判工具调用未完成的问题。
• 修复 ADK 短期记忆与运行时附件连续性，避免上传文件、memory context 和 runner payload 在多轮会话中丢失。
• 修复终端执行 allowlist 匹配过复杂、容易误判的问题，统一按共享策略做命令匹配与错误提示。
• 修复 Hosted UI 上传文件在本地 runtime 中只能看到 ae-upload:// 引用、无法读取真实内容的问题。
• 修复 Hosted Workspace zip 下载返回 Public action is not exposed on data plane 的问题，导出请求现在统一转到 runtime workspace export 契约。
• 修复 session/event 列表缺少总数和分页字段，导致 UI 无法稳定展示历史会话、历史事件或长任务恢复状态的问题。
• 修复 Hosted TUI WebSocket keepalive 使用裸换行污染终端输出的问题；ks-terminal.v1 和 terminal path 改用结构化 pong 消息。
• 修复 0.6.6 发布候选漏打 env_options.py、reasoning_markup.py、terminal_exec_policy.py 模块，导致部分 CLI、conversation runtime 和终端策略导入失败的问题。
• 修复 Python 3.10 环境下 workspace files router 使用 datetime.UTC 带来的兼容性问题。
• 修复 E2B sandbox 可选依赖缺失时测试不能跳过的问题，降低最小开发环境运行公开测试的成本。
• 修复公开仓库审计误拦截受控公开文档和受控外部引用的问题，并继续禁止内部 endpoint、私有 header、真实凭证和 kubeconfig 进入公开材料。
• 修复 Hermes / OpenClaw --dry-run 在全局 dry-run 下无法读取 bootstrap 只读配置的问题；dry-run 现在会渲染实际将使用的运行时 artifact 与模型策略。
• 修复 OpenClaw TUI 新建 terminal session 时误传不支持的 --resume 参数导致启动失败的问题。
• 修复 agentengine hermes open --chat 调用 dashboard open 时缺少 region source，导致命令行打开 Hosted Chat 报错的问题。
• 修复 OpenClaw 已存在 OPENCLAW_MODEL_CATALOG_JSON 时默认主模型可能被 catalog 首项带偏的问题，并在默认模型目录中声明 reasoning=true 以启用思考能力。

测试与发布

• 新增模型策略、fallback、流式 fallback、usage 透传、OpenClaw env、Hermes env、LangChain patch、附件恢复、session 分页、Hosted UI 上传文件、workspace zip、终端 session 复用和终端 allowlist 覆盖测试。
• 公开发布版本从 0.6.5 升级到 0.6.6，发布包继续通过 make public-preflight 同步 KSADK Web 静态资源并执行 wheel 内容检查；本次发布候选固定使用 PUBLIC_KSADK_WEB_VERSION=0.2.11 对应的 @kingsoftcloud/ksadk-web 静态 UI。
• make public-preflight 覆盖 secret audit、public path audit、全量 pytest、sdist/wheel build、wheel 内容检查和 twine check；PyPI 发布继续使用 PyPI Trusted Publishing。
• GitHub Release / PyPI / npm 发布仍由对应 GitHub workflow 执行，并需要等待 CI 门禁和人工确认。
• 公开仓库审计规则补充受控白名单，允许受控文档引用与受控外部引用，并把 docs/ksadk环境变量参考.md、docs/远程Agent运行时接口说明.md 作为公开参考文档纳入门禁。
• README 的发布表述在 0.6.6 真正发布前保持候选态文案，避免公开页面提前显示“已发布”，同时保留发布后 wording 的测试兼容。

KsADK 0.6.5

[0.6.5] - 2026-06-15

重点

• UI 真源收敛到 npm 包：@kingsoftcloud/ksadk-web@0.2.8 已作为 npm latest 发布；agentengine web 静态资源默认从该 npm 包的 dist-ksadk 同步，ksadk-python 源码分支不再跟踪生成的 ksadk/server/static/** 或旧 ksadk/server/web-ui/** 副本。
• PyPI Trusted Publishing：新增 GitHub Actions PyPI Trusted Publishing workflow，发布前同步 KSADK Web static、运行 make public-preflight，再通过 OIDC 上传到 PyPI，不依赖长期 PyPI token。
• 发布包自包含 static：PyPI wheel 构建前会同步 dist-ksadk 并把 ksadk/server/static/index.html 与静态资源打入 wheel；源码 checkout 缺少 static 时只提示运行同步命令，不在运行时联网拉 npm。
• 知识库/长期记忆 SDK 更新：ksadk[kb] 中的 kingsoftcloud-sdk-python 依赖下限提升到 1.5.8.94，用于适配最新知识库和长期记忆 SDK 返回结构。
• 长期记忆查询兼容修复：内置 load_memory 查询解析兼容 SDK 返回的 Memory 字段，避免记忆已写入但查询结果为空。
• Sandbox 稳定性兜底：E2B sandbox 创建后增加命令与文件系统 readiness 探测，并对短暂 NotFoundException / FileNotFoundException 做指数退避重试，降低首次调用 run_code / run_command 的偶发失败。
• 会话连续性与长任务恢复增强：runner payload 增加 invocation_id，LangGraph checkpoint resume 保留 checkpoint_ns，checkpoint event 透传业务阶段、摘要、下一步动作和状态，便于 UI 恢复长任务语义。
• 部署环境变量边界修复：agentengine deploy 和 agentengine launch 支持 --env / --env-file 显式传入运行时环境变量；真实 .env / .env.local 不再进入 Code、Container 或 MCP 构建上下文，模板文件继续保留。

修复

• /v1/responses、/v1/chat/completions 和 RunAgentAction 支持透传 account_id / AccountId，并写入 PlatformInvocationContext，便于运行时能力按账号边界读取当前调用上下文。
• 新增 get_current_invocation_context_or_default()、get_current_user_id() 和 get_current_account_id()，工具或业务代码可在当前 turn 内安全读取用户和账号上下文；无调用上下文时返回显式默认值。
• 修复 LangGraph checkpoint resume 丢失 namespace、checkpoint 列表缺少业务阶段字段的问题。
• 修复 Python 3.10 环境中 workspace router 误用 Python 3.11 datetime.UTC 的兼容性问题。

构建与发布

• make sync-ksadk-web-static 默认改为 npm pack @kingsoftcloud/ksadk-web@latest，并保留 KSADK_WEB_RELEASE_URL 显式 tarball 兜底。
• public-build-check 在 uv build 和 twine check 之间增加 wheel 内容检查，确保旧 ksadk/server/web-ui/ 源码、node_modules 和历史构建产物不会混入发布包。
• Code、Container、MCP 构建统一排除真实 .env*，只保留 .env.example / .env.sample / .env.template 这类模板文件。

发布治理

• 0.6.5 通过 GitHub Release 和 PyPI Trusted Publishing 发布，发布包在构建时同步 @kingsoftcloud/ksadk-web@latest 静态资源。
• 公开 CHANGELOG 不记录非公开环境名、内网 endpoint、真实账号、真实 Skill Space ID 或临时凭证；这些只允许出现在内部联调记录里。

KsADK 0.6.4

0.6.4 - 2026-06-10

重点

• 项目定位重构：README、文档首页和包元数据统一为 Agent Runtime Platform 口径，突出统一运行、浏览器调试、OpenAI-Compatible API、Sandbox、部署和可观测价值。
• 中文优先首页：默认 README 与中文文档首页使用中文主叙述，英文 README 作为补充入口保留。
• README 简洁化：README 聚焦项目定位、30 秒上手、真实截图/GIF、核心能力和贡献入口；版本变更迁回 CHANGELOG 与 GitHub Releases。
• 真实视觉资产：首页首屏使用真实浅色 CLI 截图，30 秒体验后展示真实本地 Web UI 截图和 GIF。
• 文档信息架构调整：MkDocs 导航改为 Getting Started / Build / Run / Deploy / Observe / Extend / Reference，并新增 Why KsADK、Architecture、Comparison 三个认知入口页。
• 默认线上地域说明：公开 README 和文档首页使用 KSYUN_REGION=cn-beijing-6 作为线上默认 region 示例。

修复

• 新增 ksadk.markdown.repair_markdown(text, enabled=True) 可选业务侧 Markdown 形态修复工具，覆盖未闭合 fenced code block、列表/表格/代码块周边空行和换行归一化；默认关闭，运行时不自动改写 raw LLM output。
• 清理 README、CHANGELOG、文档首页和 runtime product 文档中的环境特定表述。
• 将公开定位、视觉资产存在性、中文优先标题、敏感词扫描和 README 场景入口要求纳入本地门禁。
• 将 agentengine-sdk-python 别名包版本占用检查纳入 public-publish-check。

运行时修复

• /v1/responses、/v1/chat/completions 和 RunAgentAction 支持透传 account_id / AccountId，并写入 PlatformInvocationContext。
• 新增 get_current_invocation_context_or_default()、get_current_user_id() 和 get_current_account_id()，便于工具或业务代码读取当前调用上下文。

发布治理

• GitHub Release 页面保留历史版本 v0.6.1、v0.6.2 和 v0.6.3；0.6.4 仅新增 release。
• 公开 CHANGELOG 不记录非公开环境名、内网 endpoint、真实账号、真实 Skill Space ID 或临时凭证。