English | Tiếng Việt | 中文 | 繁體中文 | Español | Português do Brasil | 日本語 | 한국어 | Français | Deutsch | Italiano | Türkçe | Polski | Nederlands | Русский | Українська | العربية | فارسی | বাংলা | Română | ქართული
適用於 macOS 的開源、可審核的調試代理程式。
使用您可以檢查、建置和信任的本機 Swift 應用程式攔截、檢查和修改 HTTP/HTTPS/WebSocket/GraphQL 流量。
隨著 Rockxy 的發展，專為 API、行動、MCP 輔助、人工智慧和區塊鏈時代調試工作流程而建置。
本地優先的 AGPL-3.0 替代品 代理人和查爾斯·代理人.
檢查來自任何 Mac 應用程式、CLI 或 iOS 裝置的 HTTP、HTTPS、WebSocket 和 GraphQL 流量。瀏覽器 DevTools 在瀏覽器結束 — Rockxy 可以看到堆疊的其餘部分。
`HTTP / HTTPS` · `WebSocket` · `GraphQL` · `iOS Device & Simulator` · `Filter by Process ID` · `Timing Waterfall`
### 進階過濾和搜尋
在幾秒鐘內縮小數千個捕獲的請求。組合方法、主機、狀態、標頭、正文和進程過濾器 - 或在整個會話中執行全文搜尋。
`Multi-Field Filters` · `Full-Text Search` · `Status / Method` · `Header / Body Match` · `Process / Host` · `Saved Filters`
### AI助理MCP伺服器
讓 Claude Desktop 或 Cursor 透過本地 MCP 伺服器讀取捕獲的流量。問「為什麼要做這個500？」而不是將標題貼到聊天中。本地、編輯感知且開源。
`Claude Desktop` · `Cursor` · `Local stdio` · `Redaction` · `Open Source`
### 開發者設定中心
複製貼上 Python、Node.js、Go、Rust、cURL、Docker 和瀏覽器的代理片段，然後按一下「執行測試」以確認流量確實在流動。
`Python` · `Node.js` · `Go / Rust / Java` · `cURL / Docker` · `One-Click Verify` · `Trust Diagnostics`
### HTTPS 偵錯的憑證管理
首次啟動時產生的 P-256 ECDSA 根 CA，密封在您的鑰匙圈中。第一次嘗試就解密 HTTPS；固定的主機會自動通過。
`P-256 ECDSA Root CA` · `Keychain-Sealed Key` · `Per-Host Leaf Certs` · `Trust Wizard` · `Pinned-Host Passthrough` · `Rotate / Reset`
### SSL 代理程式和 HTTPS 解密
選擇哪些主機進行 TLS 解密。解密後的流量顯示真實的標頭和 JSON；其他一切都經過加密。通配符規則讓您可以一鍵按域確定範圍。
`Per-Host Decryption` · `Wildcard Rules` · `Allow / Deny List` · `TLS 1.2 / 1.3` · `Pinned Host Passthrough`
### 繞過代理
跳過特定主機，因此憑證固定的應用程式、內部服務或雜訊的遙測永遠不會進入擷取範圍。通配符使清單保持簡短，並且您的請求日誌集中於您真正關心的內容。
`Per-Host Bypass` · `Wildcard Patterns` · `Skip Pinned Hosts` · `Mute Telemetry` · `Reduce Noise` · `Toggle Anytime`
### 阻止列表
使任何主機發生故障。放棄廣告網路、第三方追蹤器或片狀依賴項，即可查看應用程式在消失後如何降級，而無需更改任何程式碼。
`Per-Host Block` · `Wildcard Match` · `Simulate Outage` · `Test Fallbacks` · `Strip Trackers` · `Toggle Anytime`
### 本地地圖
提供已儲存的檔案或目錄樹來代替即時回應。在偵錯時交換 JSON 負載、重播快照或將不穩定的第三方 API 固定到本機副本。
`File or Directory` · `Response Snapshot` · `Regex Patterns`
### 地圖遙控
重寫捕獲的請求的目標，而不觸及應用程式代碼或 /etc/hosts。將生產流量指向登台、您的開發伺服器或同事的機器，以進行可重現的錯誤重現。
`Host Rewrite` · `Regex Patterns` · `Preserve Host Header`
### 斷點和規則
暫停請求或回應，編輯方法、標頭、正文或狀態，然後繼續。測試「如果 API 回傳 401 該怎麼辦？」的最快方法無需觸及後端。
`Request Breakpoints` · `Response Breakpoints` · `Block` · `Throttle` · `Regex / Wildcard Match` · `Inject Failure States`
### 修改標題
在任何主機上新增、刪除或取代標頭，無需重新部署。使用內建預設在幾秒鐘內測試 CORS、身份驗證或快取變更。
`Add / Remove / Replace` · `CORS Presets` · `Auth Stripping` · `Request Phase` · `Response Phase` · `URL Pattern Scope`
### 自訂請求和回應標頭
覆蓋每個主機的標頭，並完全控制兩個階段。在傳出請求中註入身份驗證令牌，在回應中刪除 Set-Cookie，或固定自訂使用者代理程式 - 儲存為您可以隨時切換的命名規則。
`Per-Host Override` · `Request Phase` · `Response Phase` · `Auth Token Inject` · `Cookie Strip` · `Named Rules`
### 網路狀況
調整至 3G、EDGE、LTE、WiFi 或自訂延遲。您的筆記型電腦使用光纖；您的用戶還沒有——在他們之前查看 400 毫秒 RTT 的用戶體驗。
`3G` · `EDGE` · `LTE` · `WiFi` · `Very Bad Network` · `Custom Latency`
### 撰寫 — 編輯與重播
重建任何捕獲的 HTTP 請求 - 更改方法、URL、標頭、查詢參數或正文 - 並在不離開 Rockxy 的情況下重新發送。沒有郵差、失眠或捲曲複製貼上循環。迭代 LLM 提示、模糊身份驗證邊界，或在幾秒鐘內重現 OpenAI、Anthropic 和 Cohere 端點的失敗案例。
`Edit Headers` · `Edit Body` · `Edit Query` · `Edit Method` · `LLM Prompt Iteration` · `Postman Alternative` · `OAuth Flow Debug` · `Webhook Replay`
### 比較
將兩個捕獲的回應並排堆疊，並發現每個翻轉的欄位 - 狀態、標頭、JSON 鍵、正文字節。擷取靜默 API 迴歸、非確定性 LLM 輸出和提示漂移，而無需將任何內容傳輸到第三方 diff 工具中。並排差異突出顯示了發生的變化；深度 JSON 比較忽略鍵排序。
`Diff Compare` · `Side-by-Side` · `JSON Diff` · `Header Diff` · `Body Diff` · `LLM Output Compare` · `Non-determinism` · `API Regression` · `Schema Drift`
### 自訂預覽器標籤
按照您想要的方式呈現請求和回應正文。將額外的選項卡固定到 JSON、GraphQL、JWT、圖像或您自己的格式的檢查器上 - 可在每個捕獲的請求中重複使用。
`JSON` · `GraphQL` · `JWT Decoder` · `Image / Hex` · `Custom Format` · `Pinned per Inspector`
### 會話和導出
儲存會話，匯入/匯出 HAR 以進行跨工具切換，將任何請求複製為 cURL 或 JSON。在共享之前編輯授權標頭、cookie 和不記名令牌 — 在不洩露秘密的情況下向隊友提供工作錯誤重現。
`.rockxysession` · `HAR Import / Export` · `Copy as cURL` · `Copy as JSON` · `Raw HTTP` · `Secret Redaction` · `Token Sanitize` · `Privacy-Safe Share`
### 多選項卡工作區
並排運行獨立的捕獲會話 - 一個選項卡用於暫存，一個選項卡用於生產，一個選項卡用於 iOS 設備構建。每個選項卡都有自己的過濾器、選擇和檢查器狀態，因此上下文切換不需要任何成本。
`Independent Sessions` · `Per-Tab Filters` · `Per-Tab Inspector` · `Compare Environments` · `Mac & iOS Together` · `Detach & Rename`
### JavaScript 腳本
JS 掛鉤靜態規則無法涵蓋的情況的請求和回應 - 編輯 PII、簽名令牌、重寫有效負載。錯誤會內聯顯示，而不是破壞流量。
`Request Hooks` · `Response Hooks` · `Programmatic Filtering` · `PII Redaction` · `Inline Error Feedback`
## 更多功能即將推出
未來的功能將被公開跟踪，並且只有在實現、測試、隱私行為和文件準備就緒後才會發布。
### 人工智慧交通巡檢 `即將推出`
使模型流量在正常擷取工作流程中更容易調試。偵測 AI 請求、檢查選定的模型呼叫、診斷流回應、比較提示/輸出行為以及了解工具呼叫鏈，而無需將敏感負載貼到其他服務中。
`AI Requests` · `Model Inspector` · `Streaming Diagnostics` · `Tool Calls` · `Prompt Safety` · `Usage Signals`
### Web3/RPC 檢查 `即將推出`
將區塊鏈時代的網路呼叫轉化為可讀的調試證據。檢查 JSON-RPC 和 Solana RPC 流量，將相關呼叫分組到流中，解釋常見的 RPC 錯誤，並重播選定的請求，而無需成為錢包或區塊瀏覽器。
`JSON-RPC` · `Solana RPC` · `Wallet Flows` · `RPC Errors` · `Replay Helpers` · `Network Evidence`
### x402支付流程調試 `即將推出`
了解來自網路層的支付門控 HTTP 流。突出顯示需要付款的回應，遵循重試路徑，並將調試證據保留在本地並具有編輯意識。
`Payment Required` · `Retry Flow` · `Headers` · `Redaction` · `Local First`
### 已編輯的證據包 `即將推出`
分享重現錯誤所需的事實而不洩露秘密。將選定的流量與協議摘要、編輯預覽和團隊成員可以審核的來源支援的上下文打包在一起。
`Debug Bundles` · `Protocol Summary` · `Export Preview` · `Secret Redaction` · `Repro Context`
### 協議感知過濾器和規則 `即將推出`
使用 Rockxy 已經可用的 AI 和 Web3 元資料：過濾器、徽章、可選列、比較、規則、開發人員設定和本機 MCP 摘要。
`Smart Filters` · `Request Badges` · `Optional Columns` · `Rules` · `Compare` · `Local MCP`
### 團隊共享與協作 `即將推出`
一鍵將捕獲的會話傳送給隊友。內嵌註解失敗的請求，即時查看誰在查看什麼內容，並在無需螢幕共享的情況下對 HTTPS 流量進行配對偵錯。面向未來版本。
`Shared Sessions` · `Team Workspaces` · `Inline Comments` · `Live Cursor` · `Cloud Sync` · `Pair Debug` · `SSO` · `Audit Log`
> 100% 原生 macOS。沒有電子。沒有網頁瀏覽量。 SwiftUI + AppKit + SwiftNIO。
## 快速入門
```bash
git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj
```
在 Xcode 中建置並運行。歡迎視窗將引導您完成根 CA 設定、幫助程式安裝和代理程式啟動。
**要求：** macOS 14.0+、Xcode 16+、Swift 5.9
如果您想在安裝後將 Rockxy 連接到本機 MCP 用戶端，請參閱 [MCP 整合指南](docs/features/mcp.mdx).
## Rockxy 與替代品
| | **Rockxy** | **Proxyman** | **Charles Proxy** |
|---|---|---|---|
| **專案模型** | AGPL-3.0開源項目 | 專有商業應用程式 | 專有商業應用程式 |
| **原始碼** | 公開、可審計、可分叉 | 閉源 | 閉源 |
| **從原始碼構建** | 免費使用此儲存庫中的 Xcode | 無法從公共來源獲得 | 無法從公共來源獲得 |
| **原生 macOS 基礎** | Swift + SwiftNIO + SwiftUI/AppKit | 原生 macOS 商業應用 | 跨平台商業應用 |
| **本地優先捕獲** | 本機代理程式、憑證、幫助程式和擷取資料保留在您的 Mac 上 | 桌面代理應用程式 | 桌面代理應用程式 |
| **開發人員設定工作流程** | 適用於運行時、客戶端、設備、框架和環境的內建開發人員設定中心 | 產品特定設定指南 | 產品特定設定指南 |
| **外部代理+PAC路由** | HTTP/HTTPS 上游代理、PAC 自動設定和繞過規則 | 成熟的商業代理工具 | 成熟的商業代理工具 |
| **MCP/本地自動化橋** | 內建、令牌驗證、預設密文 | 未在已審查的公共文件中聲明 | 未在已審查的公共文件中聲明 |
| **開放貢獻路徑** | 公共議題、討論、路線圖和 PR | 供應商控制的產品 | 供應商控制的產品 |
路線圖包括：更深入的重播/差異/規則/腳本工作流程、改進的 WebSocket 和 GraphQL 檢查、協議感知 AI 和 Web3/RPC 調試、x402 式支付流可見性以及 gRPC/Protobuf 以及 HTTP/2 和 HTTP/3 支援的探索。
## 安全性
Rockxy 攔截網路流量－安全性是基礎，而不是可選的。
- XPC 助手透過以下方式驗證呼叫者 **憑證鏈比較**，不僅僅是包 ID
- 插件運行在 **沙盒 JavaScriptCore** 5 秒超時，無檔案系統/網路訪問
- **輸入驗證** 所有邊界 - 正文大小上限、URI 限制、正規表示式 DoS 保護、路徑遍歷預防
- 憑證 **自動編輯** 在捕獲的日誌中
- 儲存的敏感文件 **0o600 權限**
透過報告漏洞 [安全.md](SECURITY.md)。請參閱 [完整的安全架構](docs/development/security.mdx) 了解詳情。
## 路線圖
Rockxy 的公共路線圖以工作流程為導向且無日期限制。它專注於可靠性、原生 macOS UX、調試工作流程、協議支援、AI/Web3 時代的流量可見性、文件和貢獻者入門。
- [路線圖.md](ROADMAP.md)：高層次公共工程方向
- [Rockxy 公共路線圖](https://github.com/orgs/RockxyApp/projects/1)：路線圖追蹤問題的營運可見性
## 文件
完整文檔可在 [Rockxy 文檔](docs/index.mdx):
- [快速入門指南](docs/quickstart.mdx) — 幾分鐘內即可啟動並運行
- [開發者設定中心](docs/features/developer-setup-hub.mdx) — 運行時片段、設備指南、驗證探針和支援矩陣
- [MCP集成](docs/features/mcp.mdx) — 將 Rockxy 連接到本機 MCP 用戶端
- [大樓](docs/development/architecture.mdx) — 代理引擎、參與者模型、資料流
- [安全模型](docs/development/security.mdx) — 信任邊界、XPC 驗證、憑證管理
- [設計決策](docs/development/design-decisions.mdx) — 為什麼要使用 SwiftNIO、NSTableView、actors
- [從源頭構建](docs/development/building.mdx) — 建置、測試、lint 和調試
- [程式碼風格](docs/development/code-style.mdx) — SwiftLint、SwiftFormat 與約定
- [變更日誌](CHANGELOG.md) - 未發布的作品和標記的版本
## 貢獻
歡迎貢獻—程式碼、測試、文件、錯誤報告和使用者體驗回饋。
參見 **[貢獻.md](CONTRIBUTING.md)** 有關設定說明、程式碼樣式和完整的 PR 清單。
好的第一個問題已被標記 [`good first issue`](https://github.com/RockxyApp/Rockxy/labels/good%20first%20issue)。提交 PR 即表示您同意 [共軛亞麻油酸](CLA.md).
## 贊助商及合作夥伴
Rockxy 由獨立開發人員建造和維護。贊助資金用於持續開發、安全審計和新功能。
製造者： 史蒂芬。使用 Swift、SwiftNIO、SwiftUI 和 AppKit 建置。