免费在 GitHub 公开中文介绍

debug-package

用于使用 `debug` 库添加或查看日志，了解统一的 `lobe-*` 命名空间和格式指定符，并按浏览器、Node.js 或 Electron 环境启用日志输出。

原文查看原文说明

Use for debug() logging, lobe-* namespaces, DEBUG/localStorage.debug configuration and log formatting.

lobehub/lobehub星标 83,500(GitHub 83,500 + cccskills 0)

实测评分未实测

查看安装方法

适用场景

为模块添加调试日志
确定日志命名空间
在浏览器中启用日志
在 Node.js 或 Electron 中查看日志

中文介绍

功能

此指南介绍如何使用 debug 库输出日志，以及如何为不同模块设置命名空间。示例展示了如何创建 lobe-server:market 这样的日志函数，并使用格式指定符输出字符串、数字和对象。指南还说明了如何启用 lobe-* 日志：浏览器中设置 localStorage.debug，Node.js 中设置 DEBUG 环境变量，Electron 中设置 process.env.DEBUG。

适用场景

添加日志以跟踪应用运行情况、了解现有日志的命名规则，或在开发过程中查看特定命名空间的输出时，可以参考此指南。它也提供了服务器、客户端、桌面端和路由器日志的不同命名方式。

使用示例

“为这个模块添加 debug 日志。”
“说明服务器端日志命名空间应如何设置。”
“在浏览器中启用 lobe-* 日志。”

注意事项

示例使用 debug 库。浏览器、Node.js 和 Electron 的日志启用方式各不相同。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

文档检查

AI 根据 SKILL.md 的内容检查了需要注意的操作和使用前提。评分只依据实际运行的结果（实测对比）。

安全性发送数据、删除文件、执行命令等是否有说明: A良好资料主要说明日志配置，没有要求删除或向外发送数据。
安装难易度所需工具和 API 密钥是否少且有说明: B部分不足需要 `debug` 库，但资料未说明安装步骤或环境要求。

不计入评分。由 AI（OpenAI Codex）于 2026年10月26日评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

包含的文件（1）

SKILL.md1.1 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

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-* bun run dev
DEBUG=lobe-* pnpm dev

Electron

process.env.DEBUG = 'lobe-*';

Example

// apps/server/src/routers/lambda/agentEval.ts
import debug from 'debug';

const log = debug('lobe-lambda-router:agent-eval');

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

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能