القائمة
使用 fx_trace 进行应用级异常/日志追踪。统一收集网络异常、业务提示、调试日志，支持级别过滤和 State 生命周期绑定。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
使用 fx_boot_starter 接入 App 启动流程。适用于需要闪屏页、初始化异步任务、启动状态管理的场景。
使用 fx_dio 进行 Flutter HTTP 请求开发。基于实际项目实践的模式，包含 Host 定义、请求发起、返回值处理、异常追踪等核心流程。
使用 fx_event 进行类型化事件通信。适用于回调层级过深、跨模块通信、远距离组件交互、异步请求-响应等场景。
使用 fx_exception 构建统一异常追踪体系。提供 Code、Trace、TraceMixin 三个核心协议，各模块基于此扩展自定义异常。
| name | fx-trace-usage |
| description | 使用 fx_trace 进行应用级异常/日志追踪。统一收集网络异常、业务提示、调试日志，支持级别过滤和 State 生命周期绑定。 |
| metadata | {"author":"toly","version":"0.1.0","tags":["fx","trace","log","exception","error","flutter"]} |
fx_trace: 0.1.0 | fx_exception: 0.0.1+2
检查项目是否包含 fx_trace 依赖。
| 概念 | 说明 |
|---|---|
| Trace | 异常/日志协议 mixin（来自 fx_exception） |
| FxTrace | 全局追踪分发单例 |
| LogTrace | 日志追踪，支持级别过滤 |
| TipTrace | 提示追踪（info/warning/error/success） |
| CatchTrace | 捕获的异常包装 |
| TraceStateMixin | 在 State 中自动监听 Trace |
1. 注册监听 → FxTrace().addTraceListener(...)
2. 发送 Trace → trace.emit()
3. 设置级别 → FxTrace.minLogLevel = LogLevel.xxx
4. 桥接 fx_dio（可选） → 网络异常统一收集
注册全局 listener 或使用 State mixin。
#[[file:references/listen.md]]
使用 LogTrace / TipTrace / CatchTrace 或自定义 Trace。
#[[file:references/emit_trace.md]]
通过 minLogLevel 控制 LogTrace 的过滤阈值。
#[[file:references/log_level.md]]
将 fx_dio 的网络异常统一收入 FxTrace。
#[[file:references/bridge_dio.md]]
| API | 作用 |
|---|---|
FxTrace().addTraceListener(callback) | 注册监听 |
FxTrace().removeTraceListener(callback) | 移除监听 |
FxTrace().emit(trace) | 手动发送 |
trace.emit() | 便捷发送（扩展方法） |
FxTrace.minLogLevel | 全局日志级别阈值 |
LogTrace(msg, level: ...) | 日志 |
TipTrace(msg, code) | 提示 |
TipTrace.warning(msg, code) | 警告提示 |
CatchTrace(error, stack) | 捕获异常 |
Trace mixin