mcpField
D
debug

debug

github.com/lobehub开发83.6k1.5k 次安装今天更新
代码仓库

关于 debug

面向 LobeHub 开发者的 debug 包使用指南，介绍如何为不同模块设置日志命名空间、格式化日志内容并启用调试输出。

主要功能

  1. 01按模块约定日志命名空间
  2. 02支持对象和数值格式说明符
  3. 03通过浏览器配置调试输出
  4. 04通过 Node.js 环境变量启用日志
  5. 05提供 Electron 配置示例

适用场景

  1. 01按服务或客户端模块筛选日志
  2. 02调试包含对象的日志信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lobehub/lobehub --skill debug

安装后在 Claude Code 中输入/debug确认已加载。

详细介绍

调试包使用指南

基本用法

import debug from 'debug';

// Format: lobe-[module]:[submodule]
const log = debug('lobe-server:market');

log('Simple message');
log('With variable: %O', object);
log('Formatted number: %d', number);

命名空间约定

  • 桌面端：lobe-desktop:[module]
  • 服务端：lobe-server:[module]
  • 客户端：lobe-client:[module]
  • 路由器：lobe-[type]-router:[module]

格式说明符

  • %O - 展开对象（复杂对象推荐使用）
  • %o - 对象
  • %s - 字符串
  • %d - 数字

启用调试输出

浏览器
localStorage.debug = 'lobe-*';
Node.js
DEBUG=lobe-* npm run dev
DEBUG=lobe-* pnpm dev
Electron
process.env.DEBUG = 'lobe-*';

示例

// src/server/routers/edge/market/index.ts
import debug from 'debug';

const log = debug('lobe-edge-router:market');

log('getAgent input: %O', input);

评论

支持 Markdown