From 57e2cc991beeae4c9f76d2f2a6743bf55b2a0e4e Mon Sep 17 00:00:00 2001
From: Louis <8515500@gmail.com>
Date: Wed, 13 May 2026 13:18:13 +0800
Subject: [PATCH] docs: refresh architecture overview diagram

---
 README.en.md | 16 +++++++++++++---
 README.md    | 16 +++++++++++++---
 2 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/README.en.md b/README.en.md
index 68275dd04..bf07dfa5f 100644
--- a/README.en.md
+++ b/README.en.md
@@ -83,6 +83,7 @@ flowchart LR
 
         subgraph Runtime["Runtime + Core Capabilities"]
             Compat["PromptCompat\n(API -> web-chat plain text context)"]
+            ContextEngine["Context Engine\n(ContextPlan / token budget / reasoning summary)"]
             Completion["Completion Runtime\n(session / PoW / completion)"]
             Turn["AssistantTurn\n(output semantic normalization)"]
             Auth["Auth Resolver\n(API key / bearer / x-goog-api-key)"]
@@ -90,7 +91,13 @@ flowchart LR
             DSClient["DeepSeek Client\n(session / auth / completion / files)"]
             Pow["PoW Solver\n(Pure Go)"]
             Tool["Tool Sieve\n(Go/Node semantic parity)"]
-            History["Current Input File\n(DS2API_HISTORY.txt)"]
+            CurrentInput["Current Input File\n(hybrid_recent / neutral_random)"]
+            ToolRef["Tool Reference\n(neutral_random)"]
+        end
+
+        subgraph Offline["Offline Diagnostics / Release (not on request path)"]
+            HistoryAnalyzer["History Analyzer\n(cmd/history-analyzer)"]
+            ReleaseReadiness["Release Readiness\n(cmd/release-readiness)"]
         end
     end
 
@@ -102,8 +109,9 @@ flowchart LR
 
     OA --> Compat
     CA & GA --> Compat
-    Compat --> Completion
-    Completion -.full context.-> History
+    Compat --> ContextEngine --> Completion
+    Completion -.full context.-> CurrentInput
+    Completion -.tool reference.-> ToolRef
     Completion --> Turn
     Vercel -.Go prepare.-> Completion
     Vercel -.Node SSE.-> Tool
@@ -118,6 +126,8 @@ flowchart LR
     Vercel --> Client
 ```
 
+Recent additions such as `Context Engine`, `Current Input File / Tool Reference`, `History Analyzer`, and `Release Readiness` are now shown above; the offline tools are listed as sidecars and are not on the request path.
+
 For the full module-by-module architecture and directory responsibilities, see [docs/ARCHITECTURE.en.md](docs/ARCHITECTURE.en.md).
 
 - **Backend**: Go (`cmd/ds2api/`, `api/`, `internal/`), no Python runtime
diff --git a/README.md b/README.md
index 4c255cbe1..a8d0ae43b 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,7 @@ flowchart LR
 
         subgraph Runtime["运行时核心能力"]
             Compat["PromptCompat\n(API -> 网页纯文本上下文)"]
+            ContextEngine["Context Engine\n(ContextPlan / token budget / reasoning summary)"]
             Completion["Completion Runtime\n(Session / PoW / Completion)"]
             Turn["AssistantTurn\n(输出语义归一)"]
             Auth["Auth Resolver\n(API key / bearer / x-goog-api-key)"]
@@ -94,7 +95,13 @@ flowchart LR
             DSClient["DeepSeek Client\n(Session / Auth / Completion / Files)"]
             Pow["PoW 实现\n(纯 Go)"]
             Tool["Tool Sieve\n(Go/Node 语义对齐)"]
-            History["Current Input File\n(DS2API_HISTORY.txt)"]
+            CurrentInput["Current Input File\n(hybrid_recent / neutral_random)"]
+            ToolRef["Tool Reference\n(neutral_random)"]
+        end
+
+        subgraph Offline["离线诊断 / 发布（不在请求链路）"]
+            HistoryAnalyzer["History Analyzer\n(cmd/history-analyzer)"]
+            ReleaseReadiness["Release Readiness\n(cmd/release-readiness)"]
         end
     end
 
@@ -106,8 +113,9 @@ flowchart LR
 
     OA --> Compat
     CA & GA --> Compat
-    Compat --> Completion
-    Completion -.完整上下文.-> History
+    Compat --> ContextEngine --> Completion
+    Completion -.完整上下文.-> CurrentInput
+    Completion -.工具引用.-> ToolRef
     Completion --> Turn
     Vercel -.Go prepare.-> Completion
     Vercel -.Node SSE.-> Tool
@@ -122,6 +130,8 @@ flowchart LR
     Vercel --> Client
 ```
 
+最近新增的 `Context Engine`、`Current Input File / Tool Reference`、`History Analyzer` 和 `Release Readiness` 已纳入上图；其中离线工具以 sidecar 方式单列，不在请求链路内。
+
 详细架构拆分与目录职责见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
 
 - **后端**：Go（`cmd/ds2api/`、`api/`、`internal/`），不依赖 Python 运行时