178 lines
2.3 KiB
Markdown
178 lines
2.3 KiB
Markdown
# 工具返回格式（高信息密度文本，非 JSON）
|
||
|
||
> 说明：工具真实执行会产生完整 JSON 结果，仅用于存储/审计；**返回给模型的内容必须是高信息密度文本**。参考项目中的“JSON -> 文本摘要”逻辑，但按 easyagent 需求进一步压缩。
|
||
|
||
---
|
||
|
||
## read_file
|
||
|
||
### type=read
|
||
**仅返回 content 原文**（不加标题、不加行号、不加路径）。
|
||
|
||
返回示例：
|
||
```
|
||
<文件内容原文>
|
||
```
|
||
|
||
### type=search
|
||
返回“命中片段拼接文本”，每个片段用极简头标识（保留行号对定位有价值），不返回其他噪声。
|
||
|
||
返回示例：
|
||
```
|
||
[match_1] L10-14 hits:12
|
||
<片段内容>
|
||
|
||
[match_2] L88-92 hits:90,91
|
||
<片段内容>
|
||
```
|
||
|
||
### type=extract
|
||
返回“抽取片段拼接文本”，每个片段带 label/行号（若有）。
|
||
|
||
返回示例：
|
||
```
|
||
[segment_init] L10-20
|
||
<片段内容>
|
||
|
||
[segment_2] L40-45
|
||
<片段内容>
|
||
```
|
||
|
||
### error
|
||
```
|
||
失败: <错误信息>
|
||
```
|
||
|
||
---
|
||
|
||
## edit_file
|
||
|
||
成功：
|
||
```
|
||
已替换 <N> 处: <path>
|
||
```
|
||
|
||
失败：
|
||
```
|
||
失败: <错误信息>
|
||
```
|
||
|
||
---
|
||
|
||
## web_search
|
||
|
||
仅返回搜索摘要文本（来自 search_with_summary 的 summary），不返回 JSON 结果。
|
||
|
||
返回示例：
|
||
```
|
||
🔍 搜索查询: xxx
|
||
📅 搜索时间: 2025-01-01T12:00:00
|
||
|
||
📝 AI摘要:
|
||
...
|
||
|
||
---
|
||
|
||
📊 搜索结果:
|
||
1. 标题...
|
||
🔗 URL
|
||
📄 摘要...
|
||
```
|
||
|
||
失败：
|
||
```
|
||
失败: <错误信息>
|
||
```
|
||
|
||
---
|
||
|
||
## extract_webpage
|
||
|
||
### mode=read
|
||
返回网页正文为主，保留最小必要标识（URL）。
|
||
|
||
返回示例：
|
||
```
|
||
URL: https://example.com/...
|
||
<网页正文>
|
||
```
|
||
|
||
### mode=save
|
||
返回保存结果的简短确认信息。
|
||
|
||
成功：
|
||
```
|
||
已保存: <path> (chars=<N>, bytes=<N>)
|
||
```
|
||
|
||
失败：
|
||
```
|
||
失败: <错误信息>
|
||
```
|
||
|
||
---
|
||
|
||
## run_command
|
||
|
||
仅返回命令输出；如超时/错误则在前缀标注状态。
|
||
|
||
成功：
|
||
```
|
||
<stdout/stderr 合并输出>
|
||
```
|
||
|
||
超时：
|
||
```
|
||
[timeout after <Ns>]
|
||
<已捕获输出>
|
||
```
|
||
|
||
失败：
|
||
```
|
||
[error rc=<code>] <错误信息或输出>
|
||
```
|
||
|
||
---
|
||
|
||
## read_mediafile
|
||
|
||
成功（文字提示 + 附加媒体 payload）：
|
||
```
|
||
已附加图片: <path>
|
||
```
|
||
或
|
||
```
|
||
已附加视频: <path>
|
||
```
|
||
|
||
失败：
|
||
```
|
||
失败: <错误信息>
|
||
```
|
||
|
||
---
|
||
|
||
## search_workspace
|
||
|
||
### mode=file
|
||
```
|
||
命中文件(<N>):
|
||
1) <path>
|
||
2) <path>
|
||
```
|
||
|
||
### mode=content
|
||
```
|
||
<path>
|
||
- L12: <snippet>
|
||
- L30: <snippet>
|
||
|
||
<path>
|
||
- L5: <snippet>
|
||
```
|
||
|
||
失败：
|
||
```
|
||
失败: <错误信息>
|
||
```
|