name: debug-package
description: 'LobeHub debug package and log namespace guide. Use when adding debug() logging, choosing lobe-* namespaces, troubleshooting DEBUG output, localStorage.debug, or log format specifiers.'
user-invocable: false
Debug Package Usage Guide
Basic Usage
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);
Namespace Conventions
- Desktop:
lobe-desktop:[module]
- Server:
lobe-server:[module]
- Client:
lobe-client:[module]
- Router:
lobe-[type]-router:[module]
Format Specifiers
%O - Object expanded (recommended for complex objects)%o - Object%s - String%d - Number
Enable Debug Output
Browser
localStorage.debug = 'lobe-*';
Node.js
DEBUG=lobe-* npm run dev
DEBUG=lobe-* pnpm dev
Electron
process.env.DEBUG = 'lobe-*';
Example
// apps/server/src/routers/edge/market/index.ts
import debug from 'debug';
const log = debug('lobe-edge-router:market');
log('getAgent input: %O', input);
By