什么是 OpenBug CLI？

OpenBug CLI 是一款革命性的智能命令行界面，旨在改变开发人员调试复杂应用程序的方式。它将强大的人工智能直接集成到您的终端工作流程中，允许您在不离开 shell 环境的情况下运行命令、流式传输日志并接收即时、上下文感知的洞察。通过捕获运行时日志和访问本地代码库，OpenBug 为正在运行的服务创建了一个整体视图，使人工智能能够以前所未有的准确性诊断问题。

此工具消除了困扰现代调试会话的繁琐的上下文切换——不断地在终端窗口、日志文件和代码编辑器之间跳转。相反，OpenBug 将整个调试循环集中化。它专为在多服务环境中工作的开发人员而构建，提供了无缝跨互连微服务跟踪问题的能力，使复杂的系统调试更快、更不令人沮丧。

核心特性

• 实时 AI 调试： 基于实时应用程序日志和当前代码状态，立即获得人工智能驱动的调试问题解答。
• 自动日志捕获： 无缝捕获并流式传输来自正在运行的进程（例如 npm run dev、docker-compose up）的日志到人工智能助手。
• 自然语言代码搜索： 用简单的英语询问有关代码库的问题（例如，“支付 webhook 在哪里处理？”），并根据实际代码片段获得答案，而不是通用的互联网搜索结果。
• 跨服务跟踪： 通过将多个服务连接到一个集群来调试分布式系统；人工智能可以跨服务边界跟踪错误。
• 本地代码库访问（注重隐私）： 人工智能在本地分析您的代码。只有特定的、被查询的代码片段才会发送到服务器，确保了高隐私标准。
• 交互式终端界面： 所有交互、日志记录和查询都在统一的交互式终端体验中进行。
• 自托管能力： 为希望运行自己的 OpenBug AI 服务器以实现最大控制权的用户提供说明和配置选项。

如何使用 OpenBug CLI

开始使用 OpenBug CLI 非常简单，需要安装并快速设置 AI 连接：

1. 安装： 使用 npm 全局安装 CLI：

   npm install -g @openbug/cli
   

2. 初始设置： 首次运行 debug 命令。系统将提示您通过 OpenBug Web 应用程序登录，并将您的唯一 API 密钥粘贴到终端中以验证您的会话。
3. 启动调试会话： 在一个终端窗口中，启动 AI 助手：

   debug
   

   这会打开交互式 AI 界面。
4. 运行应用程序： 在第二个终端窗口中，运行您的服务命令，并在前面加上 debug 前缀：

   debug npm run dev
   # 或者
   debug python app.py
   

   您的应用程序正常运行，但其日志会安全地流式传输到第一个终端中运行的 AI 助手。
5. 查询 AI： 在 AI 终端中提出具体问题，例如“为什么数据库连接在启动时失败？”人工智能会将日志与您的代码库上下文关联起来，提供可操作的答案。

使用场景

1. 调试微服务故障： 当 API 网关报告的错误源自下游服务时，OpenBug 可以同时监控两个服务的日志，并跟踪请求流，以精确定位跨边界导致故障的确切代码行。
2. 熟悉不熟悉的代码库： 新团队成员可以通过询问自然语言问题来快速理解复杂的应用程序逻辑（例如，“向我展示用户注册的代码路径”），而不是手动浏览数百个文件。
3. 诊断配置漂移： 通过询问人工智能将运行时设置与代码库配置进行比较，快速识别暂存环境和生产环境之间环境变量或配置文件存在差异的问题。
4. 解决竞态条件： 通过关联多个并发日志流中的时间戳，开发人员可以让 AI 分析对时间敏感的交互，并识别手动难以发现的潜在竞态条件。
5. CI/CD 管道调试： 将 CLI 集成到部署前检查中，以运行自动化测试并立即向 AI 查询任何失败情况，从而在部署前加速反馈循环。

常见问题解答

问：我的专有源代码是否会上传到 OpenBug 服务器？ 答：不会。OpenBug 优先考虑隐私。您的代码库由 CLI 代理在本地访问。只有回答直接查询所需的特定、必要的代码片段才会发送到 AI 服务器，这由您的使用情况控制。

问：OpenBug 能否调试在 Docker 或 Kubernetes 中运行的应用程序？ 答：可以，只要 CLI 能够执行服务命令（例如 docker-compose up）并捕获产生的 stdout/stderr 流，OpenBug 就可以监控和调试这些日志。

问：OpenBug 利用了哪些类型的人工智能模型？ 答：底层技术利用了先进的大型语言模型（LLMs），通常要求用户为其服务器组件提供自己的 OpenAI API 密钥，以确保 AI 后端的灵活性和控制权。

问：如果我想自己运行 AI 服务器而不是使用公共服务，该怎么办？ 答：OpenBug 支持自托管。您可以克隆服务器存储库，使用您首选的 API 密钥进行配置，并将 CLI 指向本地 WebSocket URL（例如 export WEB_SOCKET_URL=ws://localhost:4466/v2/ws）。

问：OpenBug CLI 仅适用于 Node.js 或 JavaScript 项目吗？ 答：CLI 在日志捕获方面是语言无关的。它捕获标准输出流。但是，其代码库搜索能力针对常见的项目结构进行了优化，使其对任何运行时日志可以流式传输到终端的语言都非常有效。