本地文件检索
Purpose
在用户指定(或默认工作区)目录中,按名称模式、扩展名、修改时间与内容关键词定位文件,返回结构化结果供后续技能(表格统计、报告生成)复用。
Instructions
- 解析参数:
query:文件名/关键词(必填)root:搜索根目录(默认D:\skill-office-agent\data,也允许用户给绝对路径)ext:扩展名过滤,如xlsx,csvlimit:最多返回条数(默认 20)
- 调用
search_files工具,优先匹配文件名,其次可选content搜索。 - 输出 JSON:
{ "skill": "file-search", "count": 2, "files": [{"path": "...", "name": "...", "ext": ".xlsx", "size": 1234, "mtime": "..."}], "root": "D:\\..." } - 若 0 结果:扩大 ext 范围再搜一次;仍为 0 则查本地知识库
office_kb.json的file_hints给建议。
Multi-skill hooks
outputs.files[0].path可作为table-stats/report-gen的输入。- 触发串联示例:「找一下销售表并统计」→ file-search → table-stats。
Examples
User: 帮我找 D:\skill-office-agent\data 下所有 csv → search_files(root=D:\skill-office-agent\data, query="*", ext="csv") → 返回文件列表
User: 哪个文件里有"季度销售" → search_files(query="季度销售", content=true)
Troubleshooting
| 错误 | 原因 | 处理 |
|---|---|---|
| PermissionError | 无目录权限 | 跳过该目录并记入 warnings |
| 路径不存在 | root 错误 | 回退到默认 data 目录 |
| 结果过多 | query 过宽 | 使用 limit + 按 mtime 排序 |