Gospy

🚀 Go 進程 inspector

Go 進程 inspector 是一款用於檢查和分析運行中的 Go 進程的工具，它能夠提供 goroutine 狀態、內存統計信息和二進制信息等關鍵數據，助力開發者更高效地排查問題。

🚀 快速開始

要使用 Go 進程 inspector，你可以按照以下步驟進行安裝和使用。

✨ 主要特性

• 詳細的 goroutine 信息：可查看詳細的 goroutine 信息，包括狀態、調度信息。
• 內存統計分析：能對進程內存統計進行分析。
• 跨平臺支持：支持 Linux 和 macOS 等跨平臺系統。
• 交互式終端 UI：終端 UI 提供交互式檢查功能。
• API 程序化訪問：HTTP API 實現程序化訪問，MCP 服務器還提供 SSE 端點。

📦 安裝指南

使用以下命令進行安裝：

go install github.com/monsterxx03/gospy@latest

💻 使用示例

基礎用法

CLI 接口

# 交互式終端 UI
sudo gospy top --pid <進程 ID>

# HTTP API 服務器
sudo gospy serve --port 8974

# 獲取進程摘要
sudo gospy summary --pid <進程 ID>

# 在 JSON 格式下獲取進程摘要
sudo gospy summary --pid <進程 ID> --json

摘要命令選項

• --pid/-p - 目標進程 ID（必需）
• --bin/-b - 可執行文件路徑（可選）
• --json/-j - 以 JSON 格式輸出結果

API 端點

• GET /goroutines?pid=<PID> - 列出所有 goroutine
• GET /memstats?pid=<PID> - 獲取內存統計信息
• GET /runtime?pid=<PID> - 獲取運行時版本信息

MCP 服務器

MCP 服務器提供了一個 SSE（Server-Sent Events）端點。要啟用：

>>> sudo gospy serve --enable-mcp --port 8974

啟動 API 服務器，監聽端口 8974
端點：
  GET /runtime?pid=<PID>     - 獲取運行時信息
  GET /goroutines?pid=<PID> - 獲取 goroutine 列表
  GET /memstats?pid=<PID>   - 獲取內存統計
  GET /mcp/sse   - MCP SSE 端點

可用的 MCP 工具：

• goroutines - 轉儲 Go 進程中的 goroutine
• gomemstats - 轉儲內存統計信息
• goruntime - 獲取運行時信息
• pgrep - 根據進程名稱查找 PID

高級用法

終端 UI 控制

• q - 退出
• r - 刷新數據
• s - 暫停/恢復 top 視圖
• / - 搜索/過濾 goroutine

終端 UI 截圖

從源代碼構建

git clone https://github.com/monsterxx03/gospy.git
cd gospy
make

🔧 技術細節

要求

• Go 1.20+ 版本
• Linux 或 macOS（僅限 Apple Silicon）
• 根權限（讀取進程內存所需）

根權限說明

gospy 需要根權限來：

• 讀取進程內存 (/proc//mem on Linux)
• 訪問 macOS 的 Mach API

使用 sudo 運行：

sudo gospy top --pid <進程 ID>

對於開發/調試，可能需要：

1. 先構建二進制文件：make
2. 使用 sudo 運行：sudo ./gospy [命令]

📄 許可證

本項目採用 MIT 許可證，有關詳細信息，請參閱 LICENSE 文件。

致謝

版本 0.7.0 完全從頭開始重寫，並由 aider 完成，編寫了 >90% 的代碼。其他協助來自：

• DeepSeek（R1 + V3 模型）- AI 編碼助手

總 AI 計算成本：~$2 美元