debug

LobeHub 的 Debug 工具是為開發者設計的標準化機制，用於監控系統行為並排查平台架構內的技術問題。透過利用業界標準的 debug 套件，它為內部模組提供了統一的日誌記錄體驗。此技能為開發者提供了命名、格式化和啟用日誌的必要規範，確保在代理或服務開發過程中保持良好的可觀測性。

• 針對桌面端、伺服器、客戶端和路由器組件的模組化追蹤提供標準化的命名空間規範。

• 支援進階格式說明符，包括用於物件展開的 %O、以及 %o、%s 和 %d，以進行精確的數據視覺化。

• 提供針對不同環境的啟用指令，包括瀏覽器 (localStorage)、Node.js (DEBUG 環境變數) 和 Electron (process.env)。

• 提供核心後端路由器和前端模組的整合範例，示範日誌實作的最佳實踐。

• 使用 lobe-[module]:[submodule] 的命名空間格式，以確保日誌在開發過程中易於篩選。

• 將 DEBUG 環境變數設定為 lobe-* 以啟用調試日誌，從而捕捉全面的系統事件。

• 在排查 JSON 負載或狀態輸入時，請在日誌語句中使用 %O 進行複雜物件展開。

• 此工具嚴格用於開發階段的診斷；請確保生產環境中不會記錄敏感數據。

• 該工具設計用於無縫整合在 LobeHub 的單體倉庫 (monorepo) 結構中，為本地開發伺服器和基於 Electron 的桌面應用程式提供可見性。