diff --git a/README.md b/README.md
index d33fd7dd..914fcbe6 100644
--- a/README.md
+++ b/README.md
@@ -1,29 +1,22 @@
-# KsADK
+KsADK
-[](https://zread.ai/kingsoftcloud/ksadk-python)
+一次构建 Agent，到处运行。
-Build agents once. Run them anywhere.
+
+ KsADK 是面向 AI Agent 的运行时平台（Agent Runtime Platform）。
+ 继续使用 Google ADK、LangGraph、LangChain 或 DeepAgents 编写业务 Agent，再用统一 CLI、Web UI、OpenAI-Compatible API、工具运行时、沙箱、部署和可观测链路把它跑起来。
+
-KsADK 是面向 AI Agent 的 Agent Runtime Platform。你可以继续使用 Google ADK、LangGraph、LangChain 或 DeepAgents 编写业务 Agent，再用 KsADK 获得统一的本地运行、浏览器调试、OpenAI-Compatible API、沙箱执行、部署和可观测体验。
+简体中文（默认） · English
-当前源码版本：`0.6.6`。正式发布通过 GitHub Release 和 PyPI Trusted Publishing 提供。
+
+ 
+ 
+ 
+ 
+
-## Why KsADK
-
-Most agent frameworks solve agent development.
-
-KsADK solves agent runtime.
-
-KsADK 不替换你已经选择的 Agent 框架，而是在框架之上补齐运行时平台层：
-
-- Development：统一 `agentengine init`、`agentengine config`、`agentengine run`。
-- Debugging：本地 Web UI、会话、附件、workspace 文件和流式输出。
-- Runtime：统一 Runner、OpenAI-Compatible API 和多框架入口。
-- Sandbox：Skill Runtime、Workspace 和 sandbox backend 的隔离执行边界。
-- Deployment：Serverless、Hermes、OpenClaw 和远端 AgentEngine 入口。
-- Observability：OpenTelemetry-first tracing，可对接多种观测后端。
-
-Keep using your preferred framework. Get a complete runtime platform.
+
## 30 秒快速体验
@@ -38,154 +31,53 @@ agentengine config set OPENAI_API_KEY=your-api-key OPENAI_MODEL_NAME=gpt-4o-mini
agentengine run -i
```
-打开本地浏览器调试界面：
+启动本地调试 Web UI：
```bash
agentengine web . --no-open
```
-如果你的模型服务不是默认 OpenAI endpoint，再额外配置：
-
-```bash
-agentengine config set OPENAI_BASE_URL=https://api.example.com/v1
-```
-
-如果需要调用金山云 AgentEngine、Skill Service、知识库或长期记忆等线上能力，建议显式设置线上默认地域：
-
-```bash
-agentengine config set KSYUN_REGION=cn-beijing-6
-```
-
-## Architecture
-
-```text
-Agent Code
- ADK / LangGraph / LangChain / DeepAgents
- |
- v
-KsADK SDK
- runner adapters / config / toolsets
- |
- v
-Unified Runtime
- CLI / Web UI / OpenAI-Compatible API
- |
- +-- Skill Runtime
- +-- Workspace Tools
- +-- Sandbox Runtime
- +-- Memory & Knowledge
- |
- v
-AgentEngine
- Serverless / Hermes / OpenClaw Runtime
-```
-
-## Supported Frameworks
-
-| Framework | KsADK 负责什么 |
-| --- | --- |
-| Google ADK | 项目模板、Runner 适配、本地运行、Web UI 调试和部署入口。 |
-| LangGraph | 图状态入口、工具调用、streaming、Skill Runtime 和 workspace toolsets。 |
-| LangChain | Runnable/chain 适配、本地 OpenAI-Compatible API 和 tracing。 |
-| DeepAgents | 项目入口、运行时包装、浏览器调试和部署制品。 |
-
-## Comparison
-
-| Capability | ADK | LangGraph | OpenAI Agents SDK | KsADK |
-| --- | --- | --- | --- | --- |
-| Agent Development | Yes | Yes | Yes | Yes |
-| Browser Debugging UI | No | No | No | Yes |
-| Unified CLI | No | No | No | Yes |
-| OpenAI Compatible API | No | No | Partial | Yes |
-| Sandbox Runtime | No | No | No | Yes |
-| Deployment Workflow | No | No | No | Yes |
-| Multi Runtime Backend | No | No | No | Yes |
-
-这张表只比较“项目自带的统一运行时平台能力”。KsADK 的设计目标不是替代这些框架，而是把它们放进同一套运行、调试、部署和观测体验里。
+
-## Core Capabilities
+
-- `agentengine init`：创建或导入 Agent 项目。
-- `agentengine config`：管理 `.env` 和 `agentengine.yaml`。
-- `agentengine run`：本地终端运行和交互调试。
-- `agentengine web`：启动本地 Web UI，验证 streaming、附件、workspace、工具调用和会话。
-- `/v1/responses` 与 `/v1/chat/completions`：提供 OpenAI-Compatible API。
-- `ksadk.toolsets`：提供 Skill、Workspace、Platform、Sandbox 内置工具。
-- Skill Runtime：发现、下载、校验、加载并隔离执行 Skill workflow。
-- Sandbox Runtime：通过可配置后端隔离执行命令或代码。
-- Hermes & OpenClaw：面向更完整 runtime 后端的部署和更新路径。
+## 为什么需要 KsADK
-## Examples
+大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
-样例仓库按场景组织，而不是只按技术框架分类：
+- 本地开发：`agentengine init`、`agentengine run`、`agentengine web`。
+- 统一调试：浏览器 Web UI、streaming、附件、workspace 文件、工具调用和会话。
+- 统一协议：本地 `/v1/responses` 与 `/v1/chat/completions`。
+- 工具边界：Skill Runtime、Workspace、Sandbox、Memory、Knowledge。
+- 工程链路：打包、部署、OpenTelemetry 可观测。
-- [KSADK Samples](https://github.com/kingsoftcloud/ksadk-samples)
-- Knowledge Assistant：知识库问答和 RAG。
-- Workflow Agent：LangGraph + AgentEngine toolsets。
-- Tool-Using Agent：自定义工具调用。
-- Memory-aware Agent：短期记忆和长期记忆接入。
+## 架构
-每个公开 demo 都应包含中文 README、运行命令、环境变量说明、降级行为和验证问题。
+
-## Deployment
+## 文档与样例
-KsADK 支持本地优先的开发路径，也提供经过审核后可使用的部署入口：
+- 文档：
+- 快速开始：
+- 为什么需要 KsADK：
+- 架构：
+- 生态定位对比：
+- 可观测：
+- 样例仓库：
-```bash
-agentengine build .
-agentengine launch . --target serverless
-agentengine dashboard open
-```
+## 相关项目
-Hermes 和 OpenClaw 更新已有实例时默认保留服务端已有 env、storage、network、memory 配置，只在显式传入对应 CLI 参数时覆盖，避免升级镜像时误改用户配置。
+- KsADK 仓库：
+- Web UI 仓库：
+- Wiki：
+- PyPI：
-## Observability
+## 参与贡献
-KsADK is OpenTelemetry-native.
+欢迎通过 issue、PR、样例和文档改进参与贡献。提交前建议运行：
```bash
-OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.example.com
-OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer%20token
+make public-preflight
```
-Compatible with:
-
-- Langfuse
-- Arize
-- Datadog
-- Grafana
-- Phoenix
-
-Export once. Observe anywhere.
-
-## 0.6.6 重点
-
-- 统一模型策略 v1：默认主模型 `glm-5.2`、多模态模型 `kimi-k2.7-code`、fallback 模型 `deepseek-v4-pro`，Hermes、OpenClaw 和通用 Agent 使用同一套默认语义。
-- Hosted 附件内容恢复：本地 runtime 现在可以直接消费服务端 `ae-upload://...` 文件引用，并通过 `AttachmentContent` 恢复真实文件内容与本地缓存。
-- Hosted Workspace 导出修复：Workspace zip 下载通过受控 facade 转发到 runtime export，避免 share link / Hosted UI 下载目录时被公共 action 规则误拦截。
-- 会话与历史事件增强：`ListSessions` / `ListSessionEvents` 补齐分页与总数字段，本地 Web UI 支持更长历史会话列表和按需回加载旧事件。
-- Hosted TUI 会话复用：配合 `@kingsoftcloud/ksadk-web@0.2.11`，原生终端默认按当前业务会话复用 terminal session，并保留显式新建入口。
-- 长任务与终端验证脚本增强：新增 Hosted long-task、checkpoint resume、cancel/resume 和 terminal reconnect 验证脚本，发布前需结合目标环境完成 E2E。
-- CLI 与部署路径增强：dry-run JSON、no-cache、网络参数、环境变量覆盖、framework passthrough、远程 runner、A2A、Skill Runtime 和 sandbox 路径补齐回归覆盖。
-- 将公开定位从普通 SDK 调整为 Agent Runtime Platform，首页补齐 Why KsADK、30 秒体验、架构说明、Deployment、Observability 和 Community。
-- 清理 README、CHANGELOG 和后续 PyPI 元数据中的环境特定表述，避免公开页面出现内部环境名、内部 header 或私有 endpoint 示例。
-- 为公开定位、敏感词和 PyPI metadata 增加回归测试，防止后续回退。
-- 本地开发可从 `@kingsoftcloud/ksadk-web@latest` 同步 Web UI static；0.6.6 发布候选固定使用 `@kingsoftcloud/ksadk-web@0.2.11`，避免 npm `latest` 变化影响发布包。
-- PyPI 发布默认走 GitHub Actions Trusted Publishing，发布前按发布候选固定同步 KSADK Web static，并执行 `make public-preflight`。
-
-## Documentation
-
-- 文档：
-- 中文文档：
-- English documentation：
-- 命令行参考：
-- OpenAI-Compatible API：
-
-## Community
-
-- 仓库：
-- Wiki：
-- 示例仓库：
-- Web UI 仓库：
-- PyPI：
-- 开源协议：Apache-2.0
+开源协议：Apache-2.0。
diff --git a/tests/test_public_release_positioning.py b/tests/test_public_release_positioning.py
index 3c48759d..a9501615 100644
--- a/tests/test_public_release_positioning.py
+++ b/tests/test_public_release_positioning.py
@@ -26,30 +26,33 @@ def _changelog_section(version: str) -> str:
def test_public_readme_positions_ksadk_as_runtime_platform():
readme = _read("README.md")
for expected in (
- "Build agents once. Run them anywhere.",
+ "一次构建 Agent，到处运行。",
"Agent Runtime Platform",
- "Why KsADK",
+ "简体中文（默认）",
+ "README.en.md",
"30 秒快速体验",
- "Architecture",
- "Comparison",
- "Examples",
- "Deployment",
- "Observability",
- "Documentation",
- "Community",
- "KSYUN_REGION=cn-beijing-6",
+ "为什么需要 KsADK",
+ "KsADK 解决“如何运行、调试、部署和观测 Agent”",
+ "文档与样例",
+ "相关项目",
+ "参与贡献",
):
assert expected in readme
+ english_readme = _read("README.en.md")
+ for expected in (
+ "Build agents once. Run them anywhere.",
+ "Agent Runtime Platform",
+ "30 Seconds Quick Start",
+ "Why KsADK",
+ "Docs And Examples",
+ ):
+ assert expected in english_readme
+
assert "Agent Development Kit" not in readme
assert "KSADK_SKILL_SERVICE_REGION=pre-online" not in readme
assert "```mermaid" not in readme
- assert "```text" in readme
assert "当前版本：" not in readme
- assert (
- "发布版本：`0.6.6`" in readme
- or "当前源码版本：`0.6.6`。正式发布通过 GitHub Release 和 PyPI Trusted Publishing 提供。" in readme
- )
def test_public_metadata_uses_runtime_platform_positioning():
