外部工具装备系统
概述
外部工具装备系统遵循"整合 > 创造"的核心理念，通过深度整合成熟的CLI工具，为AI Runtime提供强大的外部能力扩展。系统支持10+个经过社区验证的工具，无需重复造轮子。
核心能力
工具生态
- 基础必备: fzf、eza、bat、ripgrep、zoxide、jq
- 搜索增强: fd、ripgrep的高性能代码搜索
- 数据处理: jq的强大JSON处理能力
- 界面优化: 美化文件列表、语法高亮、智能跳转
深度整合
- 自动检测: 系统自动发现已安装的工具
- 元数据管理: 标准化的工具描述和参数定义
- 统一接口: 通过discover-toolkit.py统一调用
快速开始
安装推荐工具
macOS:
brew install fzf eza zoxide fd bat ripgrep jq
Ubuntu/Debian:
sudo apt-get install fzf ripgrep jq bat
基本使用
# 进入工具装备目录
cd .ai-runtime/toolkit
# 查看外部工具
python3 discover-toolkit.py list --external
# 检查安装状态
python3 discover-toolkit.py check-external
推荐工具详解
基础必备工具
fzf - 模糊查找器
# 交互式文件选择
find . -name "*.py" | fzf
# 历史命令搜索
history | fzf
eza - 现代化ls
# 美化文件列表
eza -la
# 树状结构显示
eza -T
bat - 语法高亮cat
# 带语法高亮的代码查看
bat script.py
# 与fzf结合使用
find . -name "*.md" | fzf | xargs bat
ripgrep - 极速搜索
# 递归搜索代码
rg "TODO|FIXME"
# 搜索特定文件类型
rg "function" --type py
zoxide - 智能跳转
# 跳转到常用目录
z project-name
# 查看权重统计
zoxide query
jq - JSON处理器
# 格式化JSON
cat data.json | jq '.'
# 提取字段
cat package.json | jq '.dependencies | keys[]'
渐进式披露文档
工具详解
- fzf使用指南 - 模糊查找器的完整指南
- eza使用指南 - 现代化文件列表工具
- bat使用指南 - 语法高亮文件查看器
- ripgrep使用指南 - 高性能代码搜索工具
- zoxide使用指南 - 智能目录跳转工具
- jq使用指南 - JSON命令行处理器
整合指南
- 外部工具整合详解 - 如何整合更多第三方工具
使用场景
代码开发
# 搜索代码模式
rg "class.*Test" src/
# 交互式文件选择和查看
find src/ -name "*.py" | fzf | xargs bat
# 智能目录跳转
z projects/my-api
数据处理
# 处理API响应
curl -s http://api.example.com/data | jq '.items[] | select(.active == true)'
# 日志分析
cat app.log | rg "ERROR" | jq -R 'fromjson?' 2>/dev/null || cat app.log | rg "ERROR"
系统管理
# 美化文件列表
eza -la --git
# 快速文件预览
bat /etc/hosts
# 历史命令搜索
history | fzf | bash
相关系统
版本信息
- 版本: 2.0.0
- 工具数量: 10+个外部CLI工具
- 最后更新: 2025-11-14
基于 anthropics/skills 渐进式披露架构设计