用途：为 Make App 建立并维护默认 Trace ID 链路，覆盖 UI、可选 Service 与 Make Gateway 的追踪生成、传递、关联日志、错误分类与统一展示。新建 App 默认接入；存量 App 在本次任务涉及业务请求、AI transport、错误出口或发布门禁时核对并补齐缺失环节，无关改动只报告缺失、不扩大范围。追踪范围是 App 业务请求及其错误出口（含启用时的 AI JSON、SSE、二进制传输）；静态资源和 OAuth 回调不属于 UI 业务请求适配器范围。
主要能力：在共享、已认证的 UI 请求适配器内于每次业务请求创建 W3C Trace 上下文并保存 128-bit 非零 Trace ID，Header 同时写入 traceparent 和值等于其 trace-id 的 X-Log-Id，重试视为新网络尝试重新创建；Service-fronted 模式在入口校验入站 Header、缺失或非法时生成安全 Trace ID，响应返回 X-Log-Id，转发 Gateway 只用已校验且一致的追踪 Header；统一错误出口区分 HTTP 非 2xx、网络异常和 2xx 业务码异常，记录实际 HTTP 状态码，保留安全的 kind/status/title/description/traceId，展示可复制 Trace ID。
使用方式：安装 @qfei-design/make-app-observability@0.1.8+，使用 MakeAppErrorNotice，全局错误队列须由单个 MakeAppErrorNoticeViewport 包裹。审计命令：node skills/make-app-observability/scripts/audit-trace-contract.mjs <project-root> --mode auto；复制到 App 项目本地的脚本才可写入 package.json，不引用绝对路径。按需阅读 references/package-integration.md、references/trace-chain.md、references/testing-and-audit.md。
限制：该包只提供错误呈现模型与 React 组件，不发请求、创建 Span、传 Header、记日志或配置导出器，安装不等同完成 Trace 链路，也不等于接入集中式 Trace 后端。认证交给 make-app-auth，Service 合同交给 make-app-service，AI 路由交给 make-ai-assistant，发布门禁交给 make-app-runtime。不记录或传递 Authorization、Cookie、token、请求正文、AI 提示词或原始内部错误；不要通过 URL query 传 Trace 信息。发布检查包含 trace:audit。安装或升级时按目标包 package.ai.json 的 readOrder 阅读公开文档，不从 src 或 dist 深层导入。