debug-package

Align debug logger namespaces to the LobeHub log taxonomy.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kingheu0818-sketch/lobehub_yu --skill debug-package
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-package
Source: https://github.com/kingheu0818-sketch/lobehub_yu/tree/main/.agents/skills/debug-package
Command: npx skills add https://github.com/kingheu0818-sketch/lobehub_yu --skill debug-package

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you diagnose why expected debug output is not appearing in a LobeHub codebase and guides you to choose the correct debug namespace for server, desktop, client, and router logging.

Core Features & Use Cases

  • Namespace conventions: Standardizes log namespace selection so DEBUG=lobe-* captures the right code paths.
  • Log format specifiers: Shows how to use %O, %o, %s, and %d to log values in a useful way.
  • Enablement instructions: Provides browser, Node.js, and Electron environment setups so debugging works across platforms.

Quick Start

Set DEBUG to lobe-* (or set localStorage.debug = lobe-*) and create your logger using the appropriate namespace like lobe-server:market before retrying the action you want to inspect.

Frequently Asked Questions about debug-package

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my DEBUG=lobe-* output not showing in Node.js or the browser?▼

Missing debug logs usually mean the logger namespace is misaligned with the LobeHub taxonomy. You must use the correct prefix, like lobe-server:market, and enable it via the DEBUG env var or localStorage.debug = lobe-*.

How do I enable debug logging in an Electron application for LobeHub?▼

To enable debug logging in Electron, set process.env.DEBUG to lobe-* before the application starts. This ensures the debug package captures the correct server, desktop, client, or router code paths.

What debug format specifiers are supported for logging values?▼

The debug package supports %O, %o, %s, and %d format specifiers for logging values. Using these specifiers correctly ensures your debug output renders objects and variables in a readable format.

How do I choose the right debug namespace for LobeHub server and client code?▼

Choosing the right debug namespace requires aligning your logger to the LobeHub log taxonomy. Use specific prefixes like lobe-server or lobe-client so DEBUG=lobe-* captures the intended code paths.

Can I use localStorage to turn on debug logs for a desktop client?▼

Yes, you can enable debug logs in browser environments by setting localStorage.debug = lobe-*. For Electron desktop applications, you need to configure process.env.DEBUG to ensure output is displayed.