docs(eino): sync chinese docs from feishu

Author: shentongmartin

content/zh/docs/eino/FAQ.md

@@ -142,7 +142,7 @@ eino-ext 支持的多模态输入输出场景，可以查阅 [https://www.cloudw
 
 eino-ext 部分 module 报错 undefined: schema.NewParamsOneOfByOpenAPIV3 等问题，升级报错的 eino-ext module 到最新版本即可。
 
-如果 schema 改造比较复杂，可以使用现有的 OpenAPI 3.0 → JSONSchema 转换工具方法辅助转换。
+如果 schema 改造比较复杂，可以使用 JSONSchema 转换工具方法辅助转换。
 
 # Q:  Eino-ext 提供的 ChatModel 有哪些模型是支持 Response API 形式调用嘛？
 

content/zh/docs/eino/core_modules/chain_and_graph_orchestration/stream_programming_essentials.md

@@ -101,7 +101,7 @@ Collect 和 Transform 两种流式范式，目前只在编排场景有用到。
 上面的 Concat message stream 是 Eino 框架自动提供的能力，即使不是 message，是任意的 T，只要满足特定的条件，Eino 框架都会自动去做这个 StreamReader[T] 到 T 的转化，这个条件是：**在编排中，当一个组件的上游输出是 StreamReader[T]，但是组件只提供了 T 作为输入的业务接口时，框架会自动将 StreamReader[T] concat 成 T，再输入给这个组件。**
 
 > 💡
-> 框架自动将 StreamReader[T] concat 成 T 的过程，可能需要用户提供一个 Concat function。详见 [Eino: 编排的设计理念](/zh/docs/eino/core_modules/chain_and_graph_orchestration/orchestration_design_principles) 中关于“合并帧”的章节。
+> 框架自动将 StreamReader[T] concat 成 T 的过程，可能需要用户提供一个 Concat function。详见 [Eino: 编排的设计理念](/zh/docs/eino/core_modules/chain_and_graph_orchestration/orchestration_design_principles#share-FaVnd9E2foy4fAxtbTqcsgq3n5f) 中关于“合并帧”的章节。
 
 另一方面，考虑一个相反的例子。还是 React Agent，这次是一个更完整的编排示意图：
 

content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_FileSystem/Backend_本地文件系统.md

@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-10"
+date: "2026-03-12"
 lastmod: ""
 tags: []
 title: 本地文件系统
@@ -218,6 +218,10 @@ absPath, _ := filepath.Abs("./relative/path")
 
 ### 常见问题
 
+**Q: 为什么运行 grep 命令报错  ripgrep (rg) is not installed or not in PATH. Please install it: ****[https://github.com/BurntSushi/ripgrep#installation](https://github.com/BurntSushi/ripgrep#installation)**
+
+local 的 Grep 命令默认依赖** ripgrep **指令，如系统没有预装 ripgrep 则需要通过文档安装 ripgrep
+
 **Q: GrepRaw 支持正则吗？**
 
 支持正则匹配，GrepRaw 底层使用的是 ripgrep 命令做的 Grep 操作

content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_FileSystem/_index.md

@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-02"
+date: "2026-03-12"
 lastmod: ""
 tags: []
 title: FileSystem

content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_Skill.md

@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-10"
+date: "2026-03-12"
 lastmod: ""
 tags: []
 title: Skill
@@ -283,7 +283,7 @@ type Config struct {
 
 # 快速开始
 
-以从本地加载 pdf skill 为例， 完整代码见 [https://github.com/cloudwego/eino-examples/tree/alpha/08/adk/middlewares/skill](https://github.com/cloudwego/eino-examples/tree/alpha/08/adk/middlewares/skill)。
+以从本地加载 pdf skill 为例， 完整代码见 [https://github.com/cloudwego/eino-examples/tree/main/adk/middlewares/skill](https://github.com/cloudwego/eino-examples/tree/main/adk/middlewares/skill)。
 
 - 在工作目录中创建 skills 目录：
 
@@ -305,20 +305,24 @@ import (
     "github.com/cloudwego/eino-ext/adk/backend/local"
 )
 
+ctx := context.Background() 
 
 be, err := local.NewBackend(ctx, &local.Config{})
 if err != nil {
     log.Fatal(err)
 }
 
-wd, _ := os.Getwd()
-workDir := filepath.Join(wd, "adk", "middlewares", "skill", "workdir")
 skillBackend, err := skill.NewBackendFromFilesystem(ctx, &skill.BackendFromFilesystemConfig{
     Backend: be,
     BaseDir: skillsDir,
 })
+if err != nil {
+    log.Fatalf("Failed to create skill backend: %v", err)
+}
 
-skillMiddleware, err := NewMiddleware(ctx, &Config{Backend: backend})
+sm, err := skill.NewMiddleware(ctx, &skill.Config{
+    Backend: skillBackend,
+})
 ```
 
 - 基于 backend 创建本地 Filesystem Middleware，供 agent 读取 skill 其他文件以及执行脚本：
@@ -329,8 +333,8 @@ import (
 )
 
 fsm, err := filesystem.New(ctx, &filesystem.MiddlewareConfig{
-    Backend:                          be,
-    WithoutLargeToolResultOffloading: true,
+    Backend:        be,
+    StreamingShell: be,
 })
 ```
 
@@ -342,7 +346,7 @@ agent, err := adk.NewChatModelAgent(ctx, &adk.ChatModelAgentConfig{
     Description: "An agent that can analyze logs",
     Instruction: "You are a helpful assistant.",
     Model:       cm,
-    Handlers:    []adk.ChatModelAgentMiddleware{fsm, skillMiddleware},
+    Handlers:    []adk.ChatModelAgentMiddleware{fsm, sm},
 })
 ```
 
@@ -502,4 +506,4 @@ Important:
 <a href="/img/eino/GzIObeN6roy2SAxpEXBcMqrRnYb.png" target="_blank"><img src="/img/eino/GzIObeN6roy2SAxpEXBcMqrRnYb.png" width="100%" /></a>
 
 > 💡
-> Skill Middleware 仅提供了如上图所示的加载 SKILL.md 能力，如果 Skill 本身需要读取文件、执行脚本等，需要用户另外为 agent 配置相关能力。
+> Skill Middleware 仅提供了如上图所示的加载 SKILL.md 能力，如果 Skill 需要 agent 具备读取文件、执行脚本等能力，需要用户另外为 agent 配置。

content/zh/docs/eino/core_modules/eino_adk/Eino_ADK_ChatModelAgentMiddleware/Middleware_ToolReduction.md

@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-09"
+date: "2026-03-12"
 lastmod: ""
 tags: []
 title: Reduction

content/zh/docs/eino/core_modules/eino_adk/adk_agent_callback.md

@@ -1,6 +1,6 @@
 ---
 Description: ""
-date: "2026-03-10"
+date: "2026-03-12"
 lastmod: ""
 tags: []
 title: Agent Callback

content/zh/docs/eino/ecosystem_integration/_index.md

@@ -11,9 +11,9 @@ weight: 6
 
 ### ChatModel
 
-- openai: [ChatModel - OpenAI](https://github.com/cloudwego/eino-ext/blob/main/components/model/openai/README_zh.md)
-- ark: [ChatModel - ARK](https://github.com/cloudwego/eino-ext/blob/main/components/model/ark/README_zh.md)
-- ollama: [ChatModel - Ollama](https://github.com/cloudwego/eino-ext/blob/main/components/model/ollama/README_zh.md)
+- openai: [OpenAI](/zh/docs/eino/ecosystem_integration/chat_model/agentic_model_openai)
+- ark: [ARK](/zh/docs/eino/ecosystem_integration/chat_model/agentic_model_ark)
+- 更多组件请见：[ChatModel 组件列表](/zh/docs/eino/ecosystem_integration/chat_model)
 
 ### Document
 

content/zh/docs/eino/quick_start/_index.md

@@ -19,7 +19,7 @@ Eino 提供了多种面向 AI 应用开发场景的组件抽象，同时也提
 
 AI 的应用中，最基础的场景就是 prompt + chat model 的场景，这也是互联网上各类 AI 应用平台提供的最重要的功能。你可以定义 `System Prompt` 来约束大模型的回答逻辑，比如 “你在扮演一个 XXX 角色” 等等。这个示例中，你可以用 Eino 的 `PromptTemplate` 组件 和 `ChatModel` 组件来构建一个角色扮演应用。
 
-- [实现一个最简 LLM 应用-ChatModel](/zh/docs/eino/quick_start/simple_llm_application)
+- [第一章：ChatModel 与 Message（Console）](/zh/docs/eino/quick_start/chapter_01_chatmodel_and_message)
 
 ### 示例：创建一个 Agent
 
@@ -31,7 +31,7 @@ AI 的应用中，最基础的场景就是 prompt + chat model 的场景，这
 
 在这个示例中，我们将使用 react agent 来构建一个可以和现实世界交互的智能体。
 
-- [Agent-让大模型拥有双手](/zh/docs/eino/quick_start/agent_llm_with_tools)
+- [第四章：Tool 与文件系统访问](/zh/docs/eino/quick_start/chapter_04_tool_and_filesystem)
 
 ## 下一步探索