文件浏览器技能 (File Explorer)
此技能专为 Alice 探索复杂项目而设计,提供比原生 ls/cat 更安全、更高效的手段。
核心功能
- 项目树生成 (
--tree): 快速展示项目目录结构,支持忽略忽略文件。 - 模糊搜索 (
--search): 像fzf一样根据文件名快速定位。 - 安全读取 (
--read): 自动检测文件大小。如果文件过大,提供分块读取建议,防止上下文溢出。
使用方法
在终端运行:
# 查看项目树状结构 (深度默认为 2)
python skills/file_explorer/explorer.py --tree --depth 3
# 模糊搜索包含 "config" 的文件
python skills/file_explorer/explorer.py --search "config"
# 安全读取文件内容
python skills/file_explorer/explorer.py --read "agent.py"
注意事项
Alice 已被权限锁定。此技能仅能访问项目根目录下的文件。严禁尝试访问路径外的内容。
对于 10KB 以上的文件,请优先使用 --read 以获取安全分段。