快速开始

安装

**见 gitlab 该项目的 Readme.md 文件"

基础用法

import { createLogger } from '@duty/logs-sdk/web';

const logger = createLogger({
  appId: 'my-app',
  appName: 'My Application',
  version: '1.0.0',
  apiKey: 'your-api-key',
});

// 记录日志
logger.info('用户登录成功', { userId: 123 });
logger.warn('请求超时', { url: '/api/data', timeout: 5000 });
logger.error('支付失败', { orderId: 'abc', error: 'insufficient funds' });

使用场景

SDK 提供三种入口，适配不同运行环境：

入口	适用场景	导入路径
Web	普通网页、SPA 应用	@duty/logs-sdk/web
Browser Background	浏览器扩展 Background Script	@duty/logs-sdk/browser-background
Browser Content	浏览器扩展 Content Script	@duty/logs-sdk/browser-content

详细用法请参考各场景的专属页面。

工作原理

SDK 通过 HTTP 将日志发送到本地运行的 Duty Logs 桌面应用（localhost:5842），桌面应用将日志持久化到本地文件。

你的应用/插件  ──SDK──▶  localhost:5842  ──▶  本地 JSONL 文件

当桌面应用未运行时，SDK 会自动将日志缓存到内存中（默认 100 条），等桌面应用恢复后批量发送。