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.