Title: DebugBundle Author: Owen Far Published: 2026 年 7 月 4 日 Last modified: 2026 年 7 月 6 日 --- 搜尋外掛 ![](https://ps.w.org/debugbundle/assets/banner-772x250.jpg?rev=3597780) ![](https://ps.w.org/debugbundle/assets/icon.svg?rev=3597780) # DebugBundle 由 [Owen Far](https://profiles.wordpress.org/owenfar/) 開發 [下載](https://downloads.wordpress.org/plugin/debugbundle.1.2.5.zip) * [詳細資料](https://tw.wordpress.org/plugins/debugbundle/#description) * [使用者評論](https://tw.wordpress.org/plugins/debugbundle/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/debugbundle/#installation) * [開發資訊](https://tw.wordpress.org/plugins/debugbundle/#developers) [技術支援](https://wordpress.org/support/plugin/debugbundle/) ## 外掛說明 DebugBundle helps you understand what went wrong when a WordPress site breaks. Instead of piecing together PHP logs, browser errors, request details, and plugin or theme context by hand, the plugin sends the important debugging evidence to your DebugBundle project. Use it when you want a clearer answer than “something broke.” DebugBundle gives the developer or AI agent fixing the site the backend and visitor-side context around an incident, so they can see what happened, where it happened, and what evidence is available. DebugBundle is built for agent-first debugging workflows. If you use an AI coding agent, DebugBundle reports give the agent structured incident evidence instead of a vague error message or copied log snippet. That helps the agent investigate plugin, theme, integration, and frontend failures with the same context a developer would need. Setup stays simple: install the plugin, paste your DebugBundle project token, and run the built-in test buttons. You do not need Composer, npm, shell access, CDN scripts, or a custom relay setup. Useful for: * production PHP errors, fatal errors, and uncaught exceptions * browser exceptions that visitors hit on public pages * failed or slow first-party requests seen by the browser * recent visitor actions and page changes that help explain a frontend error * WordPress, PHP, service, environment, and SDK version context for developers or AI coding agents * AI-assisted debugging workflows where an agent needs structured incident evidence instead of copied logs What gets captured: * PHP errors, uncaught exceptions, fatal shutdown errors, request metadata, and logs at or above the configured level * frontend browser exceptions from public pages * error-only browser breadcrumbs such as clicks, route changes, and first-party request failures * service, environment, WordPress, PHP, and SDK version context useful for debugging How delivery works: * backend events are sent server-side through `debugbundle/sdk-php` * browser events are posted to `/wp-json/debugbundle/v1/browser` and forwarded server-side * transient browser relay delivery failures are retried through a bounded local spool * the browser SDK is served from this plugin package, not from a third-party CDN What it does not do: * it does not contact DebugBundle until an administrator saves a project token or defines `DEBUGBUNDLE_PROJECT_TOKEN` * it does not expose the project token to page JavaScript * it does not capture `wp-admin` traffic by default * it does not add incident browsing, billing, account management, or dashboard features inside WordPress * it does not let an agent change WordPress settings, content, users, plugins, or themes ### External services This plugin connects to the DebugBundle service at `https://api.debugbundle.com` to send production incident telemetry and to fetch SDK capture configuration for the connected DebugBundle project. The plugin only sends data after a site administrator enters a DebugBundle project token in the plugin settings and saves it. Backend PHP/WordPress incidents may include sanitized exception, request, response, environment, service, log, and WordPress context needed for debugging. Browser incidents are posted to a same-origin WordPress REST route first and then forwarded server-side to DebugBundle, so the project token stays server-side and is never exposed to page JavaScript. Browser JavaScript is served from this plugin package, not from a third-party CDN. The service is provided by DebugBundle: * Service: https://debugbundle.com * Terms of Service: https://debugbundle.com/terms * Privacy Policy: https://debugbundle.com/privacy ## 螢幕擷圖 [⌊The standard WordPress settings form for connecting a site to a DebugBundle project and choosing capture options.⌉⌊The standard WordPress settings form for connecting a site to a DebugBundle project and choosing capture options.⌉[ The standard WordPress settings form for connecting a site to a DebugBundle project and choosing capture options. [⌊The status and test delivery section with SDK versions, relay details, spool size, and backend/frontend test buttons.⌉⌊The status and test delivery section with SDK versions, relay details, spool size, and backend/frontend test buttons.⌉[ The status and test delivery section with SDK versions, relay details, spool size, and backend/frontend test buttons. ## 安裝方式 1. In WordPress, go to Plugins -> Add New. 2. Search for DebugBundle, then install and activate the plugin. 3. Open Settings -> DebugBundle. 4. Paste your DebugBundle project token and save. 5. Use the backend and frontend test-event buttons to verify delivery. If you cannot install from the WordPress.org plugin directory, download the ZIP from the [DebugBundle WordPress plugin GitHub releases page](https://github.com/debugbundle/debugbundle-wordpress/releases) and upload it under Plugins -> Add New -> Upload Plugin. ## 常見問題集 ### Do I need a DebugBundle project? Yes. The plugin needs a DebugBundle project token before it can send backend or browser incidents. ### Does the browser SDK get my project token? No. The plugin keeps the project token on the server and receives browser events through a same-origin relay route. ### Does this capture wp-admin by default? No. The first release is focused on public-site capture. ### Does the plugin contact DebugBundle before I configure it? No. The plugin requires a saved project token before it can forward backend or browser incidents to DebugBundle. ### Can I use this instead of installing the PHP or browser SDK manually? Yes for normal WordPress sites. The plugin vendors the PHP SDK, bundles the browser SDK, and registers the WordPress REST browser relay for you. ## 使用者評論 ![](https://secure.gravatar.com/avatar/407bbdad0f8ea6b4c5f12671e5eafdf9c697b81b9279d1d2685e1f514eb726c4? s=60&d=retro&r=g) ### 󠀁[An essential tool for a smooth-running site](https://wordpress.org/support/topic/an-essential-tool-for-a-smooth-running-site/)󠁿 [arnoldfarrugia](https://profiles.wordpress.org/arnoldfarrugia/) 2026 年 7 月 7 日 Finding bugs on a live WordPress site can be stressful, but DebugBundle completely takes the pressure off. I love how it captures everything from server-side PHP exceptions to frontend browser failures automatically. It’s simple to set up and gives me the peace of mind that everything is running exactly as it should. Fantastic plugin! [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/debugbundle/reviews/) ## 參與者及開發者 以下人員參與了開源軟體〈DebugBundle〉的開發相關工作。 參與者 * [ Owen Far ](https://profiles.wordpress.org/owenfar/) [將〈DebugBundle〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/debugbundle) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/debugbundle/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/debugbundle/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/debugbundle/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/debugbundle/)。 ## 變更記錄 #### 1.2.5 * Add the WordPress.org submitter to plugin contributors, document the DebugBundle external service with terms and privacy links, and tighten WordPress-native sanitization around request metadata, settings, and remote configuration fetches. #### 1.2.4 * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `1.4.0` so the plugin ships the latest capture-rule suggestion contract and bundle metadata updates across the stable browser SDK line. #### 1.2.2 * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `1.3.0` so the plugin ships the browser fetch-header preservation fix on the current stable JS SDK line. #### 1.2.1 * Replace the remaining `parse_url()` relay-origin parsing calls with `wp_parse_url()` so the plugin passes current WordPress Plugin Check URL-parsing guidance consistently. #### 1.2.0 * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `1.2.0` so the plugin ships the browser `beforeSend` hook, bounded rejection-reason capture, and bot-aware browser noise controls on the stable SDK line. #### 1.1.0 * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `1.1.0` and require` debugbundle/sdk-php` `^1.1.0` so the plugin ships the path-scoped client-error capture updates across the stable PHP and browser SDK line. #### 1.0.1 * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `1.0.1` so the plugin ships the opaque browser-error enrichment and head-loading defaults together on the stable SDK line. #### 1.0.0 * Mark the first stable WordPress plugin release after the browser relay, spool, and diagnostics model settled across live smoke coverage. * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `1.0.0` and require` debugbundle/sdk-php` `^1.0.0` so the plugin ships on the stable SDK line. #### 0.1.7 * Rebuild the bundled browser SDK on `@debugbundle/sdk-browser` `0.1.8` so the shipped WordPress asset includes the trace-allowlist hardening fix. #### 0.1.6 * Replace the remaining raw config-fetch error propagation with a stable plugin- owned failure message so WordPress Plugin Check no longer flags the exception path. #### 0.1.5 * Address WordPress Plugin Check compliance issues around metadata, direct-access guards, WordPress-safe request handling, and filesystem APIs. #### 0.1.4 * Break long sampling and log-level helper text into stacked description lines so the settings page reads more cleanly. #### 0.1.3 * Complete browser relay correlation fields before forwarding so frontend events satisfy the current ingestion schema. #### 0.1.2 * Report the DebugBundle ingestion response for frontend relay deliveries, including accepted and rejected counts. * Treat ingestion-level rejected events as relay test failures even when the HTTP request itself returned 202. #### 0.1.1 * Hide the saved project token in a password field on the settings page. * Clarify sampling and log-level settings with concrete explanations. * Send a schema-valid frontend relay test event and report relay forwarding errors instead of showing a false success. #### 0.1.0 * Initial pre-release plugin scaffold. ## 中繼資料 * 版本 **1.2.5** * 最後更新 **3 天前** * 啟用安裝數 **少於 10 次** * WordPress 版本需求 ** 6.5 或更新版本 ** * 已測試相容的 WordPress 版本 **7.0.1** * PHP 版本需求 ** 8.2 或更新版本 ** * 語言 * [English (US)](https://wordpress.org/plugins/debugbundle/) * 標籤: * [AI](https://tw.wordpress.org/plugins/tags/ai/)[debugging](https://tw.wordpress.org/plugins/tags/debugging/) [error tracking](https://tw.wordpress.org/plugins/tags/error-tracking/)[monitoring](https://tw.wordpress.org/plugins/tags/monitoring/) [observability](https://tw.wordpress.org/plugins/tags/observability/) * [進階檢視](https://tw.wordpress.org/plugins/debugbundle/advanced/) ## 評分 5 星，滿分為 5 星 * [ 1 個 5 星使用者評論 ](https://wordpress.org/support/plugin/debugbundle/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/debugbundle/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/debugbundle/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/debugbundle/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/debugbundle/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/debugbundle/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/debugbundle/reviews/) ## 參與者 * [ Owen Far ](https://profiles.wordpress.org/owenfar/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/debugbundle/)