From dd69eee237f22db41c1ad56cc5835dcafea546ac Mon Sep 17 00:00:00 2001 From: xiayu Date: Wed, 29 Jul 2026 17:43:25 +0800 Subject: [PATCH] fix(readme): remove unreleased candidate messaging --- README.en.md | 12 ------------ README.md | 12 ------------ README.zh-CN.md | 12 ------------ tests/test_public_release_positioning.py | 12 ++++++------ 4 files changed, 6 insertions(+), 42 deletions(-) diff --git a/README.en.md b/README.en.md index c62b913..e9949b1 100644 --- a/README.en.md +++ b/README.en.md @@ -41,18 +41,6 @@ agentengine web . --no-open

Real local Web UI demo

-## 0.8.0 Review Candidate - -`0.8.0` is an in-review candidate branch, not a published PyPI or npm release. It brings RuntimeEvent, AG-UI/A2UI, A2A, Harness, and CodexRuntime into one runtime boundary while retaining the `/v1/responses` and `/v1/chat/completions` compatibility surfaces. - -- **Hosted UI:** AG-UI/A2UI is capability-selected; the established Responses transport remains the fallback when it is unavailable. -- **Event diagnosis:** `ksadk replay ` reads persisted RuntimeEvent history and can narrow investigation with `--after-seq-id` / `--before-seq-id`. It never runs a model, tool, or approval side effect again. -- **Managed A2A (experimental):** AgentEngine composes trusted ingress through its Gateway and Space-scoped outbound clients. The first external-Agent release supports only `external_public`, governed by `Network.EnablePublicAccess` and a constrained NAT transport; `external_vpc` is not yet available. -- **Codex Managed Runtime (new):** use an `agentengine.yaml` without `agent.py` to debug Codex natively on macOS, Windows, and Linux. Direct deployment sends an inline manifest rather than a KS3 code archive; the cloud selects a pinned Linux Runtime image. -- **Framework migration:** Prefer LangGraph, Google ADK, or the `RuntimeAdapter` contract for new integrations. Legacy LangChain continuity/HITL is not a `0.8` compatibility commitment. - -Read the [Codex Managed Runtime guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/managed-runtime/), the [Hosted UI and event replay guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/hosted-ui-events/), the [managed A2A Runtime guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/a2a-runtime/), the [HarnessApp guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/harness-app/), and the [0.8.0 changelog](CHANGELOG.md). - ## Why KsADK Most agent frameworks solve how to build agents. KsADK solves how to run, debug, deploy, and observe them. diff --git a/README.md b/README.md index 6098479..c749e22 100644 --- a/README.md +++ b/README.md @@ -41,18 +41,6 @@ agentengine web . --no-open

KsADK 真实本地 Web UI 演示

-## 0.8.0 评审候选 - -`0.8.0` 是正在评审的候选分支，不是已发布的 PyPI/npm 版本。它把 RuntimeEvent、AG-UI/A2UI、A2A、Harness 和 CodexRuntime 统一到同一运行时边界，同时保持 `/v1/responses` 和 `/v1/chat/completions` 兼容入口可用。 - -- **Hosted UI**：AG-UI/A2UI 通过能力协商启用；不能协商时继续使用既有 Responses transport。 -- **事件诊断**：`ksadk replay ` 只读回放新 RuntimeEvent 历史，可用事件序号（`seq_id`）窗口缩小排查范围，不会再次执行模型、工具或审批副作用。 -- **托管 A2A（实验性）**：AgentEngine 通过 Gateway 装配可信入站和 Space-scoped 出站 client。首期 external Agent 仅支持 `external_public`；它受 `Network.EnablePublicAccess` 控制并使用受限 NAT transport，`external_vpc` 尚不可用。 -- **Codex Managed Runtime（新增）**：使用无 `agent.py` 的 `agentengine.yaml` 在 macOS、Windows 和 Linux 原生调试 Codex；直接部署发送内联 manifest，不上传 KS3 代码包，云端选择锁定的 Linux Runtime 镜像。 -- **框架迁移**：新接入优先使用 LangGraph、Google ADK 或 `RuntimeAdapter`。旧 LangChain 连续性 / HITL 路径不属于 `0.8` 兼容性承诺。 - -详见[Codex Managed Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/managed-runtime/)、[Hosted UI 与事件回放指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/hosted-ui-events/)、[托管 A2A Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/a2a-runtime/)、[HarnessApp 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/harness-app/)和 [0.8.0 更新日志](CHANGELOG.md)。 - ## 为什么需要 KsADK 大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。 diff --git a/README.zh-CN.md b/README.zh-CN.md index bfa97e2..4d3355e 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -41,18 +41,6 @@ agentengine web . --no-open

KsADK 真实本地 Web UI 演示

-## 0.8.0 评审候选 - -`0.8.0` 是正在评审的候选分支，不是已发布的 PyPI/npm 版本。它把 RuntimeEvent、AG-UI/A2UI、A2A、Harness 和 CodexRuntime 统一到同一运行时边界，同时保持 `/v1/responses` 和 `/v1/chat/completions` 兼容入口可用。 - -- **Hosted UI**：AG-UI/A2UI 通过能力协商启用；不能协商时继续使用既有 Responses transport。 -- **事件诊断**：`ksadk replay ` 只读回放新 RuntimeEvent 历史，可用 `--after-seq-id` / `--before-seq-id` 缩小排查窗口，不会再次执行模型、工具或审批副作用。 -- **托管 A2A（实验性）**：AgentEngine 通过 Gateway 装配可信入站和 Space-scoped 出站 client。首期 external Agent 仅支持 `external_public`；它受 `Network.EnablePublicAccess` 控制并使用受限 NAT transport，`external_vpc` 尚不可用。 -- **Codex Managed Runtime（新增）**：使用无 `agent.py` 的 `agentengine.yaml` 在 macOS、Windows 和 Linux 原生调试 Codex；直接部署发送内联 manifest，不上传 KS3 代码包，云端选择锁定的 Linux Runtime 镜像。 -- **框架迁移**：新接入优先使用 LangGraph、Google ADK 或 `RuntimeAdapter`。旧 LangChain 连续性 / HITL 路径不属于 `0.8` 兼容性承诺。 - -详见[Codex Managed Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/managed-runtime/)、[Hosted UI 与事件回放指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/hosted-ui-events/)、[托管 A2A Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/a2a-runtime/)、[HarnessApp 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/harness-app/)和 [0.8.0 更新日志](CHANGELOG.md)。 - ## 为什么需要 KsADK 大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。 diff --git a/tests/test_public_release_positioning.py b/tests/test_public_release_positioning.py index 8ac5127..d7c62b1 100644 --- a/tests/test_public_release_positioning.py +++ b/tests/test_public_release_positioning.py @@ -18,9 +18,6 @@ f"{DOCS_ROOT_URL}cn/docs/framework/guides/observability-tracing/", f"{DOCS_ROOT_URL}cn/docs/framework/guides/cloud-deployment/", f"{DOCS_ROOT_URL}cn/docs/framework/guides/hosted-ui-events/", - f"{DOCS_ROOT_URL}cn/docs/framework/guides/a2a-runtime/", - f"{DOCS_ROOT_URL}cn/docs/framework/guides/managed-runtime/", - f"{DOCS_ROOT_URL}cn/docs/framework/guides/harness-app/", } EN_DOC_URLS = { f"{DOCS_ROOT_URL}en/docs/framework/getting-started/quickstart/", @@ -30,9 +27,6 @@ f"{DOCS_ROOT_URL}en/docs/framework/guides/observability-tracing/", f"{DOCS_ROOT_URL}en/docs/framework/guides/cloud-deployment/", f"{DOCS_ROOT_URL}en/docs/framework/guides/hosted-ui-events/", - f"{DOCS_ROOT_URL}en/docs/framework/guides/a2a-runtime/", - f"{DOCS_ROOT_URL}en/docs/framework/guides/managed-runtime/", - f"{DOCS_ROOT_URL}en/docs/framework/guides/harness-app/", } _DOCS_LINK_PATTERN = re.compile( @@ -105,6 +99,8 @@ def test_public_readme_positions_ksadk_as_runtime_platform(): assert "当前版本：" not in readme assert "发布版本：" not in readme assert "## 0.6." not in readme + assert "0.8.0" not in readme + assert "评审候选" not in readme def test_public_readme_language_variants_keep_homepage_shape(): @@ -120,6 +116,8 @@ def test_public_readme_language_variants_keep_homepage_shape(): assert "ksadk-runtime-architecture.png" in text assert "发布版本：" not in text assert "## 0.6." not in text + assert "0.8.0" not in text + assert "评审候选" not in text assert "Kingsoft Cloud Agent Development Kit" in en_readme assert "ksadk-runtime-platform-hero-wide.png" in en_readme @@ -129,6 +127,8 @@ def test_public_readme_language_variants_keep_homepage_shape(): assert "ksadk-runtime-architecture.png" not in en_readme assert "发布版本：" not in en_readme assert "## 0.6." not in en_readme + assert "0.8.0" not in en_readme + assert "Review Candidate" not in en_readme assert _github_pages_urls(root_readme) == {DOCS_ROOT_URL, *ZH_DOC_URLS} assert _github_pages_urls(zh_readme) == {DOCS_ROOT_URL, *ZH_DOC_URLS}