AgentSkillsCN

debug

调试包使用指南。在添加调试日志、理解日志命名空间,或实现调试功能时使用。可在调试日志请求或日志实现过程中触发。

SKILL.md
--- frontmatter
name: debug
description: Debug package usage guide. Use when adding debug logging, understanding log namespaces, or implementing debugging features. Triggers on debug logging requests or logging implementation.
user-invocable: false

Debug Package Usage Guide

Basic Usage

typescript
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

javascript
localStorage.debug = "lobe-*";

Node.js

bash
DEBUG=lobe-* npm run dev
DEBUG=lobe-* pnpm dev

Electron

typescript
process.env.DEBUG = "lobe-*";

Example

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

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

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