docs(eino): sync chinese docs from feishu

shentongmartin · shentongmartin · commit 7a80b264f924 · 2026-03-10T08:28:25.000+08:00
diff --git a/content/zh/docs/eino/FAQ.md b/content/zh/docs/eino/FAQ.md
@@ -146,7 +146,7 @@ eino-ext 部分 module 报错 undefined: schema.NewParamsOneOfByOpenAPIV3 等问
 
 # Q:  Eino-ext 提供的 ChatModel 有哪些模型是支持 Response API 形式调用嘛？
 
-- Eino-Ext 中目前只有 ARK 的 Chat Model 可通过 **NewResponsesAPIChatModel **创建 ResponsesAPI ChatModel，其他模型目前不支持 ResponsesAPI 的创建与使用。
+- Eino-Ext 中目前只有 ARK 的 Chat Model 可通过 **NewResponsesAPIChatModel **创建 ResponsesAPI ChatModel，其他模型目前不支持 ResponsesAPI 的创建与使用，
 
 # Q: 如何排查 ChatModel 调用报错？比如[NodeRunError] failed to create chat completion: error, status code: 400, status: 400 Bad Request。
 
@@ -170,3 +170,6 @@ ChatModel 产生的 Tool Call 中，Argument 字段是 string。Eino 框架在
 
 - Flow/React Agent 场景下获取中间结构参考文档 [Eino: ReAct Agent 使用手册](/zh/docs/eino/core_modules/flow_integration_components/react_agent_manual)
 
+# Q: Gemini 模型报错 missing a `thought_signature`
+
+Gemini 模型协议不是 openai-compatible，应使用 gemini 封装 [https://github.com/cloudwego/eino-ext/tree/main/components/model/gemini](https://github.com/cloudwego/eino-ext/tree/main/components/model/gemini)，初始化参考代码。
diff --git a/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_PatchToolCalls.md b/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_PatchToolCalls.md
@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-02"
+date: "2026-03-09"
 lastmod: ""
 tags: []
 title: PatchToolCalls
@@ -10,7 +10,7 @@ weight: 7
 adk/middlewares/patchtoolcalls
 
 > 💡
-> PatchToolCalls 中间件用于修复消息历史中「悬空的工具调用」（dangling tool calls）问题。本中间件在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入。
+> PatchToolCalls 中间件用于修复消息历史中「悬空的工具调用」（dangling tool calls）问题。本中间件在 v0.8.0 版本引入。
 
 ## 概述
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_PlanTask.md b/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_PlanTask.md
@@ -12,7 +12,7 @@ weight: 4
 adk/middlewares/plantask
 
 > 💡
-> 本中间件在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入。
+> 本中间件在 v0.8.0 版本引入。
 
 ## 概述
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_Summarization.md b/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_Summarization.md
@@ -12,7 +12,7 @@ weight: 3
 Summarization 中间件会在对话的 token 数量超过配置阈值时，自动压缩对话历史。这有助于在长对话中保持上下文连续性，同时控制在模型的 token 限制范围内。
 
 > 💡
-> 本中间件在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入。
+> 本中间件在 v0.8.0 版本引入。
 
 ## 快速开始
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_ToolReduction.md b/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_ToolReduction.md
@@ -12,7 +12,7 @@ weight: 6
 adk/middlewares/reduction
 
 > 💡
-> 本中间件在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入。
+> 本中间件在 v0.8.0 版本引入。
 
 ## 概述
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_ToolSearch.md b/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_ToolSearch.md
@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-02"
+date: "2026-03-09"
 lastmod: ""
 tags: []
 title: ToolSearch
@@ -12,7 +12,7 @@ weight: 5
 adk/middlewares/dynamictool/toolsearch
 
 > 💡
-> 本中间件在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入。
+> 本中间件在 v0.8.0 版本引入。
 
 ## 概述
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/_index.md b/content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/_index.md
@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-02"
+date: "2026-03-09"
 lastmod: ""
 tags: []
 title: ChatModelAgentMiddleware
@@ -16,7 +16,7 @@ weight: 8
 **重要说明：** 此接口专为 `ChatModelAgent` 及基于它构建的 Agent（如 `DeepAgent`）设计。
 
 > 💡
-> ChatModelAgentMiddleware 接口在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入
+> ChatModelAgentMiddleware 接口在 v0.8.0 版本引入
 
 ### 为什么使用 ChatModelAgentMiddleware 而非 AgentMiddleware？
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/adk_agent_callback.md b/content/zh/docs/eino/core_modules/eino_adk/adk_agent_callback.md
@@ -23,7 +23,7 @@ ADK Agent Callback 机制与 Eino compose 中的回调系统共享相同的基
 - 可以与其他组件回调（如 ChatModel、Tool 等）组合使用
 
 > 💡
-> 通过 Agent Callback，你可以在 Agent 执行的关键节点介入，实现 tracing、logging、metrics 等可观测性能力。本能力在 [v0.8.0.Beta](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1) 版本引入。
+> 通过 Agent Callback，你可以在 Agent 执行的关键节点介入，实现 tracing、logging、metrics 等可观测性能力。本能力在 v0.8.0 版本引入。
 
 ## 核心类型
 
diff --git a/content/zh/docs/eino/core_modules/eino_adk/agent_preview.md b/content/zh/docs/eino/core_modules/eino_adk/agent_preview.md
@@ -145,7 +145,7 @@ AgentRunner 是 Agent 的执行器，为 Agent 运行所需要的拓展功能加
 只有通过 Runner 执行 agent 时，才可以使用 ADK 的如下功能：
 
 - Interrupt & Resume
-- 切面机制（1226 测试版本支持，正式发布前不保证 api 兼容，详见 [[WIP] Eino ADK: 切面](https://bytedance.larkoffice.com/wiki/JM9mwNJuGij69UkrvIpcHwXdnhf)）。
+- 切面机制（1226 测试版本支持，正式发布前不保证 api 兼容，详见 [[WIP] Eino ADK: 切面](https://bytedance.larkoffice.com/wiki/JM9mwNJuGij69UkrvIpcHwXdnhf)）
 
   ```go
   go get github.com/cloudwego/eino@v0.8.0-alpha.1
diff --git a/content/zh/docs/eino/overview/_index.md b/content/zh/docs/eino/overview/_index.md
@@ -346,8 +346,6 @@ Eino 框架由几个部分组成：
 
 > 💡
 > 针对字节内部使用的组件，有对应的内部代码仓库：
->
-> EinoBytedExt: [https://code.byted.org/flow/eino-byted-ext](https://code.byted.org/flow/eino-byted-ext)
 
 - [Eino Devops](https://github.com/cloudwego/eino-ext/tree/main/devops)：可视化开发、可视化调试等。
 - [EinoExamples](https://github.com/cloudwego/eino-examples)：是包含示例应用程序和最佳实践的代码仓库。
diff --git a/content/zh/docs/eino/release_notes_and_migration/Eino_v0.8._-adk_middlewares/Eino_v0.8_不兼容更新.md b/content/zh/docs/eino/release_notes_and_migration/Eino_v0.8._-adk_middlewares/Eino_v0.8_不兼容更新.md
@@ -1,19 +1,17 @@
 ---
 Description: ""
-date: "2026-03-02"
+date: "2026-03-09"
 lastmod: ""
 tags: []
 title: Eino v0.8 不兼容更新
 weight: 1
 ---
 
-> 本文档记录了 `v0.8.0.Beta` 分支相比 `main` 分支的所有不兼容变更。
-
 ## 1. API 不兼容变更
 
 ### 1.1 filesystem Shell 接口重命名
 
-**位置**: `adk/filesystem/backend.go` **变更描述**: Shell 相关接口被重命名，且不再嵌入 `Backend` 接口。**Before (main)**:
+**位置**: `adk/filesystem/backend.go` **变更描述**: Shell 相关接口被重命名，且不再嵌入 `Backend` 接口。**Before (v0.7.x)**:
 
 ```go
 type ShellBackend interface {
@@ -27,7 +25,7 @@ type StreamingShellBackend interface {
 }
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 type Shell interface {
@@ -60,15 +58,46 @@ func (s *MyShell) Execute(...) {...}
 
 ---
 
+### 1.2 Filesystem Backend：Read 返回值不兼容变更
+
+- **位置** ： adk/filesystem/backend.go
+- **变更说明** ： Backend.Read 的返回值发生不兼容调整，由原先返回 string 修改为返回 *FileContent 结构体
+
+**Before (v0.7.x)**:
+
+```go
+type Backend interface {
+    ...
+    Read(ctx context.Context, req *ReadRequest) (string, error)
+    ...
+ }
+```
+
+**After (v0.8.0)**:
+
+```go
+type Backend interface {
+    ...
+    Read(ctx context.Context, req *ReadRequest) (*FileContent, error)
+    ...
+ }
+```
+
+**影响：**
+
+- v0.7.x 的 Read 接口返回 `string`。`v0.8.0` 的 Read 接口返回结构体 `FileContent`，属于不兼容变更。
+- 对 Backend 实现方：需要替换 Read 方法实现，从返回 String 改为返回 *FileContent。
+- 对 Backend 使用方：需要升级 Backend 实现为支持 v0.8 的版本。同时需要修改 Backend.Read 的调用，改为使用新返回的 *FileContent。
+
 ## 2. 行为不兼容变更
 
 ### 2.1 AgentEvent 发送机制变更
 
-**位置**: `adk/chatmodel.go` **变更描述**: `ChatModelAgent` 的 `AgentEvent` 发送机制从 eino callback 机制改为 Middleware 机制。**Before (main)**:
+**位置**: `adk/chatmodel.go` **变更描述**: `ChatModelAgent` 的 `AgentEvent` 发送机制从 eino callback 机制改为 Middleware 机制。**Before (v0.7.x)**:
 
 - `AgentEvent` 通过 eino 的 callback 机制发送
 - 如果用户自定义了 ChatModel 或 Tool 的 Decorator/Wrapper，且原始 ChatModel/Tool 内部埋入了 Callback 点位，则 `AgentEvent` 会在 Decorator/Wrapper 的**内部**发送
-- 这对 eino-ext 实现的所有 ChatModel 适用，但对大部分用户自行实现的 Tool 以及 eino 一方提供的 Tool 可能不适用 **After (v0.8.0.Beta)**:
+- 这对 eino-ext 实现的所有 ChatModel 适用，但对大部分用户自行实现的 Tool 以及 eino 一方提供的 Tool 可能不适用 **After (v0.8.0)**:
 - `AgentEvent` 通过 Middleware 机制发送
 - `AgentEvent` 会在用户自定义的 Decorator/Wrapper 的**外部**发送**影响**:
 - 正常情况下用户不感知此变更
@@ -99,7 +128,7 @@ func (m *MyMiddleware) WrapModel(ctx context.Context, chatModel model.BaseChatMo
 
 ### 2.2 filesystem.ReadRequest.Offset 语义变更
 
-**位置**: `adk/filesystem/backend.go` **变更描述**: `Offset` 字段从 0-based 改为 1-based。**Before (main)**:
+**位置**: `adk/filesystem/backend.go` **变更描述**: `Offset` 字段从 0-based 改为 1-based。**Before (v0.7.x)**:
 
 ```go
 type ReadRequest struct {
@@ -110,10 +139,11 @@ type ReadRequest struct {
 }
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 type ReadRequest struct {
+
     FilePath string
     // Offset specifies the starting line number (1-based) for reading.
     // Line 1 is the first line of the file.
@@ -140,7 +170,7 @@ req := &ReadRequest{Offset: 1, Limit: 100}
 
 ### 2.3 filesystem.FileInfo.Path 语义变更
 
-**位置**: `adk/filesystem/backend.go` **变更描述**: `FileInfo.Path` 字段不再保证是绝对路径。**Before (main)**:
+**位置**: `adk/filesystem/backend.go` **变更描述**: `FileInfo.Path` 字段不再保证是绝对路径。**Before (v0.7.x)**:
 
 ```go
 type FileInfo struct {
@@ -149,7 +179,7 @@ type FileInfo struct {
 }
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 type FileInfo struct {
@@ -169,38 +199,52 @@ type FileInfo struct {
 
 ### 2.4 filesystem.WriteRequest 行为变更
 
-**位置**: `adk/filesystem/backend.go` **变更描述**: `WriteRequest` 的写入行为从"文件存在则报错"变更为"文件存在则覆盖"。**Before (main)**:
+**位置**: `adk/filesystem/backend.go` **变更描述**: `WriteRequest` 的写入行为从"文件存在则报错"变更为"文件存在则覆盖"。**Before (v0.7.x)**:
 
 ```go
 // WriteRequest 注释说明:
 // The file will be created if it does not exist, or error if file exists.
+type WriteRequest struct {
+    // FilePath is the absolute path of the file to write. Must start with '/'.
+    // The file will be created if it does not exist, or error if file exists.
+    FilePath string
+
+    ...
+}
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 // WriteRequest 注释说明:
 // Creates the file if it does not exist, overwrites if it exists.
+type WriteRequest struct {
+    // FilePath is the path of the file to write.
+    FilePath string
+
+    ....
+}
 ```
 
 **影响**:
 
 - 原来依赖"文件存在报错"行为的代码将不再报错，而是直接覆盖
 - 可能导致意外的数据丢失**迁移指南**:
 - 如果需要保留原有行为，在写入前先检查文件是否存在
+- 原有 FilePath 代表 绝对路径，新版本未规定 FilePath 为绝对路径，原有依赖绝对路径的场景需要做对应 FilePath 的适配
 
 ---
 
 ### 2.5 GrepRequest.Pattern 语义变更
 
-**位置**: `adk/filesystem/backend.go` **变更描述**: `GrepRequest.Pattern` 从字面量匹配变更为正则表达式匹配。**Before (main)**:
+**位置**: `adk/filesystem/backend.go` **变更描述**: `GrepRequest.Pattern` 从字面量匹配变更为正则表达式匹配。**Before (v0.7.x)**:
 
 ```go
 // Pattern is the literal string to search for. This is not a regular expression.
 // The search performs an exact substring match within the file's content.
 ```
 
-**After (v0.8.0.Beta)**:
+**After (v0.8.0)**:
 
 ```go
 // Pattern is the search pattern, supports full regular expression syntax.
@@ -228,6 +272,32 @@ req := &GrepRequest{Pattern: "config\\.json"}
 
 ---
 
+### 2.6 EditRequest.FilePath 语义变更
+
+**位置**: `adk/filesystem/backend.go` **变更描述**: EditRequest.FilePath 注释移除注释中的强制描述绝对路径。**Before (****v0.7.x****)**:
+
+```go
+type EditRequest struct {
+     // FilePath is the absolute path of the file to edit. Must start with '/'.
+      FilePath string
+    ....
+    }
+  }
+```
+
+**After (v0.8.0)**:
+
+```go
+type EditRequest struct {
+   // FilePath is the path of the file to edit.
+    FilePath string
+}
+```
+
+**影响**:
+
+- 旧版本中 `FilePath` 默认表示绝对路径；新版本不再保证 `FilePath` 为绝对路径。  原先依赖 `FilePath` 为绝对路径的逻辑需要相应适配 。
+
 ## 迁移建议
 
 1. **优先处理编译错误**: 类型变更（如 Shell 接口重命名）会导致编译失败，需要首先修复
diff --git a/content/zh/docs/eino/release_notes_and_migration/Eino_v0.8._-adk_middlewares/_index.md b/content/zh/docs/eino/release_notes_and_migration/Eino_v0.8._-adk_middlewares/_index.md
@@ -9,9 +9,6 @@ weight: 8
 
 本文档介绍 Eino ADK v0.8.* 版本的主要新功能和改进。
 
-> 💡
-> 目前尚处于 v0.8.0.Beta 版本阶段：[https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1](https://github.com/cloudwego/eino/releases/tag/v0.8.0-beta.1)
-
 ## 版本亮点
 
 v0.8 是一个重要的功能增强版本，引入了全新的中间件接口架构，新增多个实用中间件，并提供了增强的可观测性支持。
