EdithAI - 智能日志分析命令行工具

EdithAI 是一个基于 Go 语言的命令行工具，结合自然语言处理与强大的内置工具，实现全面的日志分析。它利用 DeepSeek API 提供对日志数据的智能洞察，通过简单命令即可实现复杂的日志分析。

特性

核心能力

• 智能日志分析：使用自然语言查询分析日志
• 30+ 内置工具：支持文件操作、系统诊断、数据处理和模式识别
• 多格式支持：兼容多种日志格式和时间戳
• 实时处理：高效处理流程，优化令牌使用
• 成本估算：集成 DeepSeek 定价机制，跟踪 API 使用成本

关键工具

• 文件操作：读取、写入和搜索文件
• 终端命令：安全执行诊断命令
• 日志分析：模式检测、时间线分析和错误追踪
• 数据处理：支持 CSV、JSON 和文本操作
• 系统诊断：网络、进程和性能监控

使用示例

基础日志分析

# 分析当前目录中的错误日志
edithai -query "analyze error logs in current directory"

# 搜索特定模式
edithai -query "find all database connection errors"

# 生成性能报告
edithai -query "create performance summary from application logs"

交互模式

# 启动交互会话
edithai -i

# 多轮对话分析日志
> show me memory usage trends
> find memory leaks in the last 24 hours
> export analysis to report.html

安装要求

安装 EdithAI CLI 工具

首先安装 EdithAI CLI 工具：

npm install -g @xin9min9/edithai-cli

环境变量

• DEEPSEEK_API_KEY: 用于 AI 智能分析的 DeepSeek API 密钥

系统要求

• Node.js >= 14.0.0（npm 所需）
• 最小 512MB 内存
• 可连接 DeepSeek API 的网络环境

配置

默认设置

• 工具输出截断长度：2000 字符
• API 超时时间：30 秒
• 历史文件路径：~/.edithai/history.json
• 日志目录：当前工作目录

高级配置

在 ~/.edithai/config.json 创建配置文件：

{
  "api": {
    "timeout": 30,
    "max_tokens": 4000
  },
  "security": {
    "whitelist_commands": ["ls", "cat", "grep"],
    "blacklist_commands": ["rm", "dd", "mkfs"],
    "tool_payload_max_chars": 2000
  }
}

安全特性

• 命令白名单/黑名单：限制终端命令执行
• 文件扩展名保护：防止危险文件类型执行
• 路径遍历防护：防范目录遍历攻击
• 命令注入检测：阻止 shell 操作符和危险模式

文件结构

~/.edithai/
├── config.json       # 用户配置文件
└── history.json      # 会话历史记录

支持的日志格式

• 纯文本日志
• JSON 日志
• CSV 数据文件
• 带时间戳的日志文件
• 应用日志（Web 服务器、数据库等）
• 系统日志（Linux/Windows）

获取最佳结果的建议

1. 描述清晰：使用明确、详细的查询以获得更准确的分析结果
2. 提供上下文：包含相关的时间范围和日志位置信息
3. 迭代分析：使用交互模式进行多步骤分析
4. 关注成本：留意令牌使用量和 DeepSeek 服务的成本

许可证

MIT-0 许可证 - 详情请见 LICENSE 文件。

支持

如遇问题或有功能需求，请访问 [EdithAI GitHub 仓库](https://github.com/your-org/edithai-clawhub-skill)。