| name | file_reader |
| version | 1.2.0 |
| description | 读取与摘要文本类文件（txt、md、json、yaml、csv、log、代码文件等）。PDF 与 Office 文件由专用技能处理。 |
| dependencies | {"tools":["read_file","execute_shell_command"]} |
文件读取
当用户要求读取或摘要本地文本文件时使用本技能。
不在范围内：PDF、Word (.docx)、Excel (.xlsx)、PPT (.pptx)、图片、音视频 — 这些由专用技能处理。
工作流程
第一步：类型探测（可选）
不确定文件类型时，先探测：
macOS / Linux：
execute_shell_command(command="file -b --mime-type \"/path/to/file\"")
Windows：
execute_shell_command(command="cmd /c \"echo %~x1\" & exit", timeoutSeconds=10)
或直接根据扩展名判断。
第二步：读取文件
read_file(filePath="/absolute/or/relative/path/to/file.txt")
读取特定行范围（大文件时）：
read_file(filePath="/path/to/large.log", startLine=1, endLine=200)
第三步：处理内容
根据文件类型采用对应策略：
| 类型 | 处理方式 |
|---|
.txt / .md | 直接摘要或按用户需求处理 |
.json / .yaml | 先列出顶层键，再展开用户关注的字段 |
.csv / .tsv | 展示表头 + 前 5 行，再描述各列含义和数据规模 |
.log | 读取最后 200 行，聚焦错误/警告模式 |
| 源代码 | 说明文件作用，摘要核心逻辑，不逐行复述 |
大文件策略
文件超过 500 行时分段读取：
# 先读前 100 行了解结构
read_file(filePath="/path/to/big.log", startLine=1, endLine=100)
# 再读末尾 200 行看最新内容
read_file(filePath="/path/to/big.log", startLine=-200)
日志文件也可用系统命令读取末尾：
macOS / Linux：
execute_shell_command(command="tail -n 200 \"/path/to/file.log\"")
Windows：
execute_shell_command(command="powershell Get-Content -Tail 200 \"/path/to/file.log\"")
跨平台路径注意事项
- Windows：路径使用反斜杠
\ 或正斜杠 / 均可，但含空格时须加引号
- macOS / Linux：使用正斜杠
/，含空格时须加引号或转义
安全规范
- 只读取文件，不执行其内容
- 优先读取所需的最小部分，避免加载超大文件到上下文
- 如文件包含敏感信息（密码、密钥），提醒用户注意但不拒绝读取
