zhongwei/gh-dwsy-ai-runtime-ai-runtime-toolkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8cd5c7679d582dd843788ba46a681ea99f1ff425
gh-dwsy-ai-runtime-ai-runti…/skills/toolkit/docs/references/internal-tools.md
Zhongwei Li 8cd5c7679d Initial commit
2025-11-29 18:24:37 +08:00

7.7 KiB
Raw Blame History

name, description, category, version
name description category version
internal-tools-reference AI Runtime内部工具完整参考 - 包含所有内部创建的工具详细信息 reference 1.0.0

内部工具完整参考

最后更新: 2025-11-14

工具概览

AI Runtime工具装备系统包含以下内部创建的工具（按语言分类）：

Python工具 (python/)

工具名称 ID 用途 复杂度 文件位置
依赖关系分析器 PY-DEPENDENCY-ANALYZER-001 CODE,DATA level-3 python/analysis/dependency-analyzer.py
代码统计器 PY-CODE-STATS-004 CODE,DATA level-2 python/analysis/code-stats.py
图形生成器 PY-GRAPH-GENERATOR-002 DATA,VISUAL level-3 python/graph/generate-graph.py
报告生成器 PY-REPORT-GENERATOR-005 DOC,REPORT level-3 python/report/generate-report.py

PY-DEPENDENCY-ANALYZER-001 依赖关系分析器

元文件: python/analysis/dependency-analyzer.meta.yml

用途: 分析Python/JavaScript项目的依赖关系，生成可视化报告

功能特性:

  • 解析Python requirements.txt
  • 解析JavaScript package.json
  • 识别安全风险
  • 生成Markdown报告
  • 导出JSON格式

使用方法:

# 分析当前目录
python3 python/analysis/dependency-analyzer.py

# 分析指定项目
python3 python/analysis/dependency-analyzer.py /path/to/project

# 保存JSON报告
python3 python/analysis/dependency-analyzer.py . -o report.json

# 详细输出
python3 python/analysis/dependency-analyzer.py -v

依赖要求:

  • Python >= 3.8
  • 无第三方依赖（仅标准库）

输入输出:

  • 输入: requirements.txt, package.json
  • 输出: Markdown报告到stdout, JSON到文件（如果指定-o）

上次使用:

  • 时间: 2025-11-14 10:30:00
  • 用途: 分析ai-runtime项目依赖
  • 满意度: 0.92

PY-CODE-STATS-004 代码统计器

元文件: python/analysis/code-stats.meta.yml

用途: 分析代码库统计信息，包括行数、函数、类、注释率和代码健康指标

功能特性:

  • 统计代码行数（LOC）
  • 统计函数和类数量
  • 计算注释率
  • 识别代码质量问题（长函数、复杂文件）

使用方法:

# 统计当前目录
python3 python/analysis/code-stats.py

# 统计指定目录
python3 python/analysis/code-stats.py src/

# 详细输出
python3 python/analysis/code-stats.py -v

上次使用:

  • 时间: 2025-11-14 11:15:00
  • 用途: 统计项目代码规模
  • 满意度: 0.88

Bash工具 (bash/)

工具名称 ID 用途 复杂度 文件位置
服务健康检查器 SERVICE-CHECK-001 MONITOR level-1 bash/system/check-service.sh
日志分析器 BASH-ANALYZE-LOGS-002 DATA,MONITOR level-2 bash/analysis/analyze-logs.sh
磁盘健康检查器 BASH-CHECK-DISK-003 MONITOR level-2 bash/system/check-disk.sh

SERVICE-CHECK-001 服务健康检查器

元文件: bash/system/check-service.meta.yml

用途: 检查HTTP服务、数据库、Redis的健康状态

功能特性:

  • HTTP服务健康检查（/health端点）
  • PostgreSQL数据库连接检查
  • Redis连接和ping测试
  • 可配置超时

使用方法:

# 检查HTTP服务
bash bash/system/check-service.sh auth-service http

# 检查数据库
bash bash/system/check-service.sh db-service db

# 检查Redis
bash bash/system/check-service.sh cache redis

# 自定义超时（10秒）
bash bash/system/check-service.sh myapp http 10

依赖要求:

  • curl（HTTP检查）
  • pg_isready（PostgreSQL检查）
  • redis-cli（Redis检查）

环境变量:

  • DB_HOST (默认: localhost)
  • DB_PORT (默认: 5432)
  • DB_NAME
  • DB_USER
  • REDIS_HOST (默认: localhost)
  • REDIS_PORT (默认: 6379)

上次使用:

  • 时间: 2025-11-14 16:45:00
  • 用途: 验证auth-service修复后状态
  • 满意度: 0.9

BASH-ANALYZE-LOGS-002 日志分析器

元文件: bash/analysis/analyze-logs.meta.yml

用途: 分析日志文件，按级别过滤、时间范围筛选、模式匹配和错误统计

功能特性:

  • 按日志级别过滤（ERROR, WARN, INFO, DEBUG）
  • 时间范围筛选
  • 模式匹配
  • 错误统计
  • 生成摘要报告

使用方法:

# 分析日志并统计ERROR
bash bash/analysis/analyze-logs.sh /var/log/app.log --level ERROR

# 分析最近1小时的日志
bash bash/analysis/analyze-logs.sh /var/log/app.log --since "1 hour ago"

# 搜索特定模式
bash bash/analysis/analyze-logs.sh /var/log/app.log --pattern "connection failed"

上次使用:

  • 时间: 2025-11-14 14:20:00
  • 用途: 分析生产环境错误日志
  • 满意度: 0.85

BASH-CHECK-DISK-003 磁盘健康检查器

元文件: bash/system/check-disk.meta.yml

用途: 检查磁盘空间、inode使用和健康状态，提供详细的分析和建议

功能特性:

  • 磁盘空间使用检查（总容量、已使用、可用）
  • Inode使用检查
  • 使用阈值警报（可配置，默认80%）
  • 文件系统类型检测
  • 挂载点和权限检查
  • 性能指标分析
  • 智能建议生成

使用方法:

# 检查根目录（阈值80%）
bash bash/system/check-disk.sh /

# 检查日志目录自定义阈值（90%）
bash bash/system/check-disk.sh /var/log 90

# 检查所有挂载点
bash bash/system/check-disk.sh --all

上次使用:

  • 时间: 2025-11-14 13:30:00
  • 用途: 预防性检查服务器磁盘空间
  • 满意度: 0.87

Node.js工具 (node/)

工具名称 ID 用途 复杂度 文件位置
API测试工具 NODE-API-TESTER-001 TEST,API level-2 node/api/test-api.js

NODE-API-TESTER-001 API测试工具

元文件: node/api/test-api.meta.yml

用途: 测试RESTful API端点

功能特性:

  • HTTP GET/POST/PUT/DELETE请求
  • JSON请求体支持
  • 响应验证
  • 批量测试

使用方法:

# 测试API健康检查
node node/api/test-api.js http://localhost:3000

# 测试指定端点
node node/api/test-api.js http://localhost:3000/api/users

# POST测试（需要修改脚本）
node node/api/test-api.js post http://localhost:3000/api/users '{"name":"test"}'

依赖要求:

  • Node.js 14+
  • npm包: axios, chalk, commander（根据实际实现）

工具分类说明

按语言分类

语言 工具数量 主要用途
python 4 代码分析、数据处理、报告生成
bash 3 系统监控、日志分析、服务检查
node 1 API测试、网络操作

按复杂度分类

复杂度 数量 说明
level-1 1-5行 简单命令别名
level-2 6-20行 简单脚本（4个工具）
level-3 21-50行 中等复杂度（3个工具）
level-4 50+行 系统级工具（1个工具）

按用途分类

用途 工具数量 代表工具
CODE 3 依赖分析器、代码统计器
DATA 3 依赖分析器、日志分析器
MONITOR 3 服务检查、磁盘检查、日志分析
TEST 1 API测试工具
API 1 API测试工具
VISUAL 1 图形生成器
REPORT 1 报告生成器
DOC 2 报告生成器

维护信息

最后审查: 2025-11-14 下次审查: 2025-12-14 维护者: CodeConscious 状态: Active

相关文档

  • 快速开始指南: @docs/guides/quickstart.md
  • 创建工具指南: @docs/guides/creating-tools.md
  • 外部工具整合: @docs/guides/external-integration.md
  • 工具分类说明: @docs/references/tool-categories.md
Reference in New Issue View Git Blame Copy Permalink