diff --git a/README.md b/README.md
index a4dd876..83ad6c4 100644
--- a/README.md
+++ b/README.md
@@ -61,6 +61,15 @@ composable Python framework and becomes a durable runtime designed for
production deployment. The existing Session-first Python API remains intact;
the release adds a production execution and operations layer around it.
+
+
+
+
+The diagram summarizes this production path: Python definitions compile into
+immutable plans, durable Runs are governed by checkpoints, leases, effects, and
+interrupts, and PostgreSQL, Redis, and S3-compatible storage provide the
+operational data plane.
+
| Production concern | What OpenRath provides |
| --- | --- |
| Durable execution | Explicit `@step` / `@router` boundaries compile into immutable execution plans. Runs, Events, and Checkpoints survive process and worker restarts. |
@@ -70,22 +79,6 @@ the release adds a production execution and operations layer around it.
| Security and tenancy | Agent Server tokens carry explicit action grants; tenant/project scope, policy checks, secret references, trust labels, and audit remain separate boundaries. |
| Production operations | PostgreSQL is the durable source of truth, Redis can accelerate signaling, S3-compatible storage holds artifacts, and health, migration, telemetry, container, and Kubernetes references are included. |
-```text
-@step / @router
- |
- v
-ExecutionPlan -> Run -> Event -> Checkpoint
- | |
- | +-> Interrupt / Effect Ledger
- |
- +-> PostgreSQL durable state
- +-> optional Redis signals
- +-> S3-compatible artifacts
- |
- v
- Agent Server HTTP + SSE
-```
-
Embedded mode remains useful inside a trusted process. Agent Server mode is the
strict production profile:
diff --git a/README_zh.md b/README_zh.md
index a6195ef..5e42b89 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -60,6 +60,14 @@ OpenRath v2.0.0 最重要的变化,是 OpenRath 从一个可组合的 Python
进入可部署、可恢复、可运维的生产环境。原有以 Session 为核心的 Python API
保持不变;这个版本在其外层增加了一套生产级执行与运维体系。
+
+
+
+
+这张图概括了 OpenRath 的生产执行路径:Python 定义先编译为不可变执行计划,
+持久化 Run 由 Checkpoint、Lease、Effect 与 Interrupt 共同保障,
+PostgreSQL、Redis 和 S3 兼容存储则构成生产环境的数据与信号层。
+
| 生产环境关注点 | OpenRath 提供的能力 |
| --- | --- |
| 持久化执行 | 显式的 `@step` / `@router` 边界会编译成不可变执行计划;Run、Event 与 Checkpoint 能跨进程和 Worker 重启保留。 |
@@ -69,22 +77,6 @@ OpenRath v2.0.0 最重要的变化,是 OpenRath 从一个可组合的 Python
| 安全与租户隔离 | Agent Server Token 使用显式 Action Grant;Tenant/Project Scope、Policy、Secret Reference、Trust Label 与 Audit 保持为独立边界。 |
| 生产运维 | PostgreSQL 是持久化事实来源,Redis 可加速信号传递,S3 兼容存储保存 Artifact,并提供健康检查、迁移、遥测、容器与 Kubernetes 参考。 |
-```text
-@step / @router
- |
- v
-ExecutionPlan -> Run -> Event -> Checkpoint
- | |
- | +-> Interrupt / Effect Ledger
- |
- +-> PostgreSQL 持久化状态
- +-> 可选 Redis 信号
- +-> S3 兼容 Artifact
- |
- v
- Agent Server HTTP + SSE
-```
-
Embedded mode 仍适合可信进程内部使用。Agent Server mode 是严格的生产
Profile:
diff --git a/assets/readme/diagrams/v2-durable-runtime.png b/assets/readme/diagrams/v2-durable-runtime.png
new file mode 100644
index 0000000..1d5c2a3
Binary files /dev/null and b/assets/readme/diagrams/v2-durable-runtime.png differ