tauri-app-logging

用途

该技能用于为 Tauri v2 应用添加统一的日志记录能力，覆盖 Rust 后端与前端两侧。当用户提到统一日志、日志级别配置、日志过滤、文件输出、诊断信息或调试日志等需求时，应使用本技能。它适用于开发与发布两种构建环境，并强调在不泄露敏感数据的前提下进行安全诊断。

主要能力

• 通过 Tauri v2 官方日志插件（tauri-plugin-log）实现 Rust 与前端统一日志。
• 支持配置日志级别（如 Info、Debug、Trace、Warn 等）与过滤。
• 支持多种输出目标，包括标准输出（Stdout）与日志目录文件（LogDir）。
• 支持针对开发构建与发布构建使用不同的日志级别。
• 提供敏感数据脱敏规则，避免记录令牌、密码或个人信息（PII）。

使用方式

1. 安装日志插件：

cargo add tauri-plugin-log

1. 注册插件并配置级别与目标：

use tauri_plugin_log::{Target, TargetKind};
tauri::Builder::default()
    .plugin(tauri_plugin_log::Builder::new()
        .targets([Target::new(TargetKind::Stdout), Target::new(TargetKind::LogDir { file_name: None })])
        .level(log::LevelFilter::Info)
        .build())

1. 在 src-tauri/capabilities/default.json 中配置能力权限：

{ "permissions": ["log:default"] }

1. 在前端调用日志：

import { info, warn, error } from '@tauri-apps/plugin-log';
await info('App started');
await error('Something went wrong');

1. 针对开发构建（Debug/Trace）与发布构建（Info/Warn）使用不同的日志级别。

2. 在记录日志前对敏感数据进行脱敏，切勿记录令牌、密码或 PII。

适用场景

• 需要为 Tauri 应用建立统一日志体系的开发场景。
• 需要按环境区分日志级别、进行日志过滤或输出到文件的场景。
• 需要在诊断问题时避免泄露敏感数据的场景。

限制

资料未提供关于该技能的具体限制说明。