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 代码库中的集成问题。