diff --git a/pipeline_core/agent_config.py b/pipeline_core/agent_config.py
index 3df8f91..6c16cb8 100644
--- a/pipeline_core/agent_config.py
+++ b/pipeline_core/agent_config.py
@@ -228,8 +228,8 @@ GENERAL_TOOLS = [
     # ── 通用工具集（Hermes CLI 能力子集：文件/搜索/会话/规划）──
     ToolDefinition(
         name="read_file",
-        description="读取工作空间中的文件内容。支持 docx/txt/md/json 等文本格式，docx 会自动解析提取正文文本，直接调用即可读取 docx 内容",
-        parameters={"path": "相对路径"},
+        description="读取工作空间中的文件内容。支持 docx/txt/md/json 等文本格式，docx 会自动解析提取正文文本，直接调用即可读取 docx 内容。单次最多 30000 字符；返回带截断提示时，用 offset 参数分段读后文",
+        parameters={"path": "相对路径", "offset": "可选：从第几个字符开始读（分段读大文件）"},
         category="file",
     ),
     ToolDefinition(