debug

此技能為在 LobeHub 生態系統中工作的開發人員提供了一份關於實作、管理與設定 debug 日誌的全面指南。透過標準化 'debug' 套件的使用，確保整個平台在開發與除錯過程中的日誌輸出具有一致性、可檢索性與可管理性。此資源適用於軟體工程師、插件開發者以及致力於 LobeHub 伺服器路由、桌面應用模組或前端組件的貢獻者。

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

• 提供在瀏覽器控制台、Node.js 終端環境與 Electron 進程日誌中啟用 debug 輸出的實作說明。

• 包含格式化符號的詳細說明，例如用於展開物件檢視的 %O，以及 %o、%s 和 %d，協助精確除錯複雜的變數與應用程式狀態。

• 提供常見 LobeHub 程式碼路徑的實作範例，例如代理市場路由與網路請求日誌記錄。

• 在實作日誌時，請務必遵循既定的命名空間格式：lobe-[module]:[submodule]。

• 針對瀏覽器環境，請使用本地儲存配置 (localStorage.debug = 'lobe-*') 進行快速除錯。

• 針對 Node.js 或 Electron 應用程式，利用環境變數 (DEBUG=lobe-*) 來控制日誌輸出詳細程度，而無需更改核心應用程式碼。

• 記錄物件時請優先使用 %O，因為它在開發期間於控制台中提供了最實用且可展開的輸出。

• 此工具專為開發人員設計，不適用於生產環境的監控，主要用於活躍開發階段、本地環境測試以及識別 LobeHub 程式碼庫中的整合問題。