create-lumfall 1.0.0 → 1.1.1

package/templates/document/app/pages/docs/styles/vars.less

@@ -1,87 +0,0 @@
-// 文档站设计变量：所有颜色走 CSS 变量，暗色模式通过 body[arco-theme="dark"]
-// 覆盖变量实现（Arco 组件的暗色也由同一属性驱动，两边自动同步）。
-
-:root {
-  // 基础色板
-  --doc-bg: #ffffff;
-  --doc-bg-soft: #f7f8fa;
-  --doc-navbar-bg: rgba(255, 255, 255, 0.86);
-  --doc-sidebar-bg: #ffffff;
-  --doc-text-1: #1d2129;
-  --doc-text-2: #4e5969;
-  --doc-text-3: #86909c;
-  --doc-border: #e5e6eb;
-  --doc-brand: #165dff;
-  --doc-brand-soft: rgba(22, 93, 255, 0.08);
-  --doc-mark-bg: rgba(22, 93, 255, 0.16);
-
-  // 代码块
-  --doc-code-bg: #f7f8fa;
-  --doc-code-bar-bg: #f0f1f3;
-  --doc-code-border: #e5e6eb;
-  --doc-code-text: #24292f;
-  --doc-inline-code-bg: rgba(22, 93, 255, 0.06);
-  --doc-inline-code-text: #165dff;
-
-  // highlight.js 语法高亮（亮色：接近 GitHub Light）
-  --doc-hl-keyword: #cf222e;
-  --doc-hl-built-in: #0550ae;
-  --doc-hl-type: #953800;
-  --doc-hl-literal: #0550ae;
-  --doc-hl-number: #0550ae;
-  --doc-hl-string: #0a3069;
-  --doc-hl-comment: #6e7781;
-  --doc-hl-function: #8250df;
-  --doc-hl-tag: #116329;
-  --doc-hl-attr: #0550ae;
-  --doc-hl-variable: #953800;
-  --doc-hl-meta: #6e7781;
-  --doc-hl-section: #0550ae;
-  --doc-hl-selector: #6639ba;
-  --doc-hl-addition-bg: #dafbe1;
-  --doc-hl-deletion-bg: #ffebe9;
-
-  // 阴影
-  --doc-shadow: 0 4px 10px rgba(0, 0, 0, 0.06);
-}
-
-body[arco-theme="dark"] {
-  --doc-bg: #0d0e10;
-  --doc-bg-soft: #17181a;
-  --doc-navbar-bg: rgba(23, 24, 26, 0.86);
-  --doc-sidebar-bg: #0d0e10;
-  --doc-text-1: #f2f3f5;
-  --doc-text-2: #c2c7cc;
-  --doc-text-3: #8a9099;
-  --doc-border: #333335;
-  --doc-brand: #3c7eff;
-  --doc-brand-soft: rgba(60, 126, 255, 0.16);
-  --doc-mark-bg: rgba(60, 126, 255, 0.32);
-
-  --doc-code-bg: #17181a;
-  --doc-code-bar-bg: #1f2022;
-  --doc-code-border: #333335;
-  --doc-code-text: #e6e8eb;
-  --doc-inline-code-bg: rgba(60, 126, 255, 0.14);
-  --doc-inline-code-text: #84a8ff;
-
-  // 暗色语法高亮（接近 GitHub Dark）
-  --doc-hl-keyword: #ff7b72;
-  --doc-hl-built-in: #79c0ff;
-  --doc-hl-type: #ffa657;
-  --doc-hl-literal: #79c0ff;
-  --doc-hl-number: #79c0ff;
-  --doc-hl-string: #a5d6ff;
-  --doc-hl-comment: #8b949e;
-  --doc-hl-function: #d2a8ff;
-  --doc-hl-tag: #7ee787;
-  --doc-hl-attr: #79c0ff;
-  --doc-hl-variable: #ffa657;
-  --doc-hl-meta: #8b949e;
-  --doc-hl-section: #79c0ff;
-  --doc-hl-selector: #d2a8ff;
-  --doc-hl-addition-bg: rgba(46, 160, 67, 0.28);
-  --doc-hl-deletion-bg: rgba(248, 81, 73, 0.24);
-
-  --doc-shadow: 0 4px 10px rgba(0, 0, 0, 0.4);
-}

package/templates/document/app/pages/docs/theme.js

@@ -1,47 +0,0 @@
-// 主题（亮 / 暗）管理。Arco Design 通过 body 上的 arco-theme 属性切换暗色，
-// 文档站自己的样式全部走 CSS 变量（见 styles/vars.less），跟随该属性变化。
-const STORAGE_KEY = "lumfall-docs-theme";
-
-function apply(mode) {
-  if (mode === "dark") {
-    document.body.setAttribute("arco-theme", "dark");
-  } else {
-    document.body.removeAttribute("arco-theme");
-  }
-}
-
-export function isDark() {
-  return document.body.getAttribute("arco-theme") === "dark";
-}
-
-/** 进站时调用：优先用户上次选择，否则跟随系统偏好 */
-export function initTheme() {
-  let saved = null;
-  try {
-    saved = localStorage.getItem(STORAGE_KEY);
-  } catch (e) {
-    // localStorage 不可用（如隐私模式）时只跟随系统
-  }
-  if (saved === "dark" || saved === "light") {
-    apply(saved);
-    return;
-  }
-  if (
-    window.matchMedia &&
-    window.matchMedia("(prefers-color-scheme: dark)").matches
-  ) {
-    apply("dark");
-  }
-}
-
-/** 切换主题并持久化，返回切换后的模式 */
-export function toggleTheme() {
-  const next = isDark() ? "light" : "dark";
-  apply(next);
-  try {
-    localStorage.setItem(STORAGE_KEY, next);
-  } catch (e) {
-    // 忽略持久化失败
-  }
-  return next;
-}

package/templates/document/app/pages/docs/utils.js

@@ -1,58 +0,0 @@
-/**
- * 标题 → url slug。保留中文等 unicode 字母数字，空格转 -，
- * 与 markdown 渲染器的标题 id 规则保持一致（搜索跳转锚点也用它）。
- */
-export function slugify(text) {
-  return String(text)
-    .trim()
-    .toLowerCase()
-    .replace(/[^\p{L}\p{N}\s-]/gu, "")
-    .replace(/\s+/g, "-");
-}
-
-/** "/view/docs/guide/intro" → "guide/intro" */
-export function pathOfDoc(viewPath) {
-  return String(viewPath || "")
-    .replace(/^\/view\/docs\/?/, "")
-    .replace(/\/+$/, "");
-}
-
-/**
- * 解析文档内相对链接（xxx.md / ./xxx.md / ../xxx.md，可带 #锚点）。
- * 返回 { path, hash }；不是 .md 链接时返回 null（外链、页内锚点走默认规则）。
- * @param {string} currentDocPath 当前文档路径，如 "guide/getting-started"
- * @param {string} href markdown 里的 href
- */
-export function resolveDocHref(currentDocPath, href) {
-  const [raw = "", hash = ""] = String(href).split("#");
-  if (!/\.md$/.test(raw)) {
-    return null;
-  }
-
-  const baseParts = String(currentDocPath).split("/").slice(0, -1);
-  raw
-    .replace(/^\.\//, "")
-    .split("/")
-    .forEach((seg) => {
-      if (seg === "..") {
-        baseParts.pop();
-      } else if (seg && seg !== ".") {
-        baseParts.push(seg);
-      }
-    });
-
-  const resolved = baseParts.join("/").replace(/\.md$/, "");
-  return {
-    path: `/view/docs/${resolved}`,
-    hash: hash ? `#${hash}` : "",
-  };
-}
-
-/** HTML 转义（搜索高亮等场景） */
-export function escapeHtml(text) {
-  return String(text)
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;");
-}

package/templates/document/app/pages/docs/views/doc-home.vue

@@ -1,56 +0,0 @@
-<template>
-  <DocLayout :sidebar="false">
-    <div class="doc-home">
-      <section class="doc-hero">
-        <h1 class="doc-hero-name">{{ hero.name }}</h1>
-        <p class="doc-hero-tagline">{{ hero.tagline }}</p>
-        <p class="doc-hero-text">{{ hero.text }}</p>
-        <div class="doc-hero-actions">
-          <template v-for="action in hero.actions" :key="action.text">
-            <router-link
-              v-if="action.path"
-              :to="action.path"
-              class="doc-hero-btn"
-              :class="action.theme || ''"
-            >
-              {{ action.text }}
-            </router-link>
-            <a
-              v-else
-              :href="action.link"
-              target="_blank"
-              rel="noopener noreferrer"
-              class="doc-hero-btn"
-              :class="action.theme || ''"
-            >
-              {{ action.text }}
-            </a>
-          </template>
-        </div>
-      </section>
-
-      <section class="doc-features">
-        <div v-for="feature in hero.features" :key="feature.title" class="doc-feature-card">
-          <div class="doc-feature-icon">{{ feature.icon }}</div>
-          <h3 class="doc-feature-title">{{ feature.title }}</h3>
-          <p class="doc-feature-details">{{ feature.details }}</p>
-        </div>
-      </section>
-
-      <footer v-if="footerText" class="doc-home-footer">{{ footerText }}</footer>
-    </div>
-  </DocLayout>
-</template>
-
-<script setup>
-import { computed } from "vue";
-import DocLayout from "../components/doc-layout.vue";
-import docsConfig from "../docs-config";
-
-const hero = docsConfig.hero;
-const footerText = computed(
-  () => docsConfig.footer.text || docsConfig.footer.copyright || ""
-);
-
-document.title = docsConfig.site.description;
-</script>

package/templates/document/app/pages/docs/views/doc-page.vue

@@ -1,147 +0,0 @@
-<template>
-  <DocLayout :sidebar="true">
-    <template v-if="source !== undefined">
-      <div class="doc-content-wrap">
-        <article class="doc-markdown" v-html="rendered.html"></article>
-
-        <div class="doc-pager">
-          <router-link v-if="prev" :to="prev.path" class="doc-pager-item prev">
-            <span class="doc-pager-label">上一篇</span>
-            <span class="doc-pager-title"><icon-left /> {{ prev.text }}</span>
-          </router-link>
-          <span v-else class="doc-pager-item placeholder"></span>
-
-          <router-link v-if="next" :to="next.path" class="doc-pager-item next">
-            <span class="doc-pager-label">下一篇</span>
-            <span class="doc-pager-title">{{ next.text }} <icon-right /></span>
-          </router-link>
-        </div>
-
-        <div v-if="footer.text" class="doc-content-footer">{{ footer.text }}</div>
-      </div>
-
-      <DocToc class="doc-toc-rail" :items="rendered.toc" :active-id="activeHeadingId" />
-    </template>
-
-    <div v-else class="doc-content-wrap">
-      <div class="doc-not-found">
-        <h1>404</h1>
-        <p>没有找到文档：<code>/{{ docPath }}</code></p>
-        <p>
-          检查 docs/ 目录下是否存在对应的 markdown 文件，以及
-          docs-config.js 的侧边栏路径是否正确。
-        </p>
-        <router-link to="/view/docs" class="doc-not-found-home">返回首页</router-link>
-      </div>
-    </div>
-  </DocLayout>
-</template>
-
-<script setup>
-import { computed, onBeforeUnmount, onMounted, ref, watch, nextTick } from "vue";
-import { useRoute } from "vue-router";
-import DocLayout from "../components/doc-layout.vue";
-import DocToc from "../components/doc-toc.vue";
-import { renderMarkdown } from "../markdown/index";
-import { getDocSource } from "../content";
-import docsConfig from "../docs-config";
-import { pathOfDoc } from "../utils";
-
-const route = useRoute();
-
-const docPath = computed(() => pathOfDoc(decodeURIComponent(route.params.path || "")));
-const source = computed(() => getDocSource(docPath.value));
-const rendered = computed(() =>
-  source.value === undefined
-    ? { html: "", toc: [] }
-    : renderMarkdown(source.value, docPath.value)
-);
-const footer = docsConfig.footer;
-
-const activeHeadingId = ref("");
-
-// ---- 上一篇 / 下一篇：按侧边栏顺序 ----
-const flatItems = docsConfig.sidebar.flatMap((group) =>
-  (group.items || []).map((item) => ({
-    text: item.text,
-    path: item.path,
-    docPath: pathOfDoc(item.path),
-  }))
-);
-
-const currentIndex = computed(() =>
-  flatItems.findIndex((item) => item.docPath === docPath.value)
-);
-const prev = computed(() =>
-  currentIndex.value > 0 ? flatItems[currentIndex.value - 1] : null
-);
-const next = computed(() =>
-  currentIndex.value >= 0 && currentIndex.value < flatItems.length - 1
-    ? flatItems[currentIndex.value + 1]
-    : null
-);
-
-// ---- 标题与描述 ----
-watch(
-  docPath,
-  (path) => {
-    const sidebarItem = flatItems.find((item) => item.docPath === path);
-    document.title = sidebarItem
-      ? `${sidebarItem.text} · ${docsConfig.site.title}`
-      : docsConfig.site.description;
-  },
-  { immediate: true }
-);
-
-// ---- 路由变化：滚动到锚点或页首 ----
-watch(
-  docPath,
-  () => {
-    activeHeadingId.value = "";
-    nextTick(() => {
-      if (route.hash) {
-        const el = document.getElementById(decodeURIComponent(route.hash.slice(1)));
-        if (el) {
-          el.scrollIntoView();
-          return;
-        }
-      }
-      window.scrollTo(0, 0);
-    });
-  },
-  { immediate: true }
-);
-
-// ---- TOC 滚动联动（滚动监听当前所在小节）----
-let ticking = false;
-
-const updateActiveHeading = () => {
-  ticking = false;
-  const headings = document.querySelectorAll(
-    ".doc-markdown h2[id], .doc-markdown h3[id]"
-  );
-  let current = "";
-  headings.forEach((el) => {
-    if (el.getBoundingClientRect().top <= 96) {
-      current = el.id;
-    }
-  });
-  activeHeadingId.value = current;
-};
-
-const onScroll = () => {
-  if (!ticking) {
-    ticking = true;
-    window.requestAnimationFrame(updateActiveHeading);
-  }
-};
-
-onMounted(() => {
-  window.addEventListener("scroll", onScroll, { passive: true });
-  updateActiveHeading();
-});
-
-onBeforeUnmount(() => {
-  window.removeEventListener("scroll", onScroll);
-});
-</script>

package/templates/document/app/webpack.config.js

@@ -1,15 +0,0 @@
-// 业务 Webpack 扩展配置：与框架基础配置 webpack-merge.merge.smart 合并。
-//
-// 文档站把项目根目录 docs/ 下的 markdown 按原始文本打进产物
-// （页面里通过 require.context 读取），因此在这里声明 asset/source 规则。
-module.exports = {
-  module: {
-    rules: [
-      {
-        test: /\.md$/,
-        // webpack 5 内置资源模块：把文件内容作为字符串导出（default export）
-        type: "asset/source",
-      },
-    ],
-  },
-};

package/templates/document/build.js

@@ -1,6 +0,0 @@
-const { frontendBuild } = require("lumfall");
-
-// 环境由 _ENV 决定（不是 NODE_ENV）：
-//   _ENV=local  启动 Webpack dev server（HMR 热更新，默认 127.0.0.1:9002）
-//   _ENV=prod   产物构建到 app/public/dist/prod/，同时产出各页面 .tpl 模板
-frontendBuild(process.env._ENV);

package/templates/document/config/config.beta.js

@@ -1,2 +0,0 @@
-// _ENV=beta 时加载，覆盖 config.default.js 的同名键（浅合并）
-module.exports = {};

package/templates/document/config/config.default.js

@@ -1,9 +0,0 @@
-// 所有环境共享的基础配置。合并顺序（后者覆盖前者同名键）：
-//   框架 config.default -> 业务 config.default -> 框架 config.<env> -> 业务 config.<env>
-module.exports = {
-  name: "lumfall-document",
-  apiBasePath: "/api",
-
-  // 文档站是纯静态站点，默认不暴露 /api 路由；security 的默认值
-  // （签名关闭 + projectKey 开启）保持框架默认即可，见框架文档「安全策略」
-};

package/templates/document/config/config.local.js

@@ -1,2 +0,0 @@
-// _ENV=local 时加载，覆盖 config.default.js 的同名键（浅合并）
-module.exports = {};

package/templates/document/config/config.prod.js

@@ -1,2 +0,0 @@
-// _ENV=prod 时加载，覆盖 config.default.js 的同名键（浅合并）
-module.exports = {};

package/templates/document/docs/advanced/dashboard.md

@@ -1,66 +0,0 @@
-# Dashboard 与 Model 配置
-
-框架自带开箱即用的 B 端控制台页面 `/view/dashboard`。它本身**不含任何业务代码**：
-页面结构、菜单、每个入口的形态，全部由业务项目 `model/` 目录下的
-**Dashboard DSL** 声明，启动时自动扫描合并。
-
-::: tip 编写配置请看 DSL 章节
-本页讲 Dashboard 页面如何**消费** DSL；如何**编写** DSL（Model / Project /
-菜单 / schema 模块 / 接口契约）见 [DSL 章节](../dsl/overview.md)。
-:::
-
-## 前端消费链路
-
-```
-1. 浏览器访问 /view/dashboard/schema?projectKey=pdd&key=product
-   （history 模式，服务端由 /view/:page/* 兜底渲染）
-2. dashboard.vue 挂载：
-   ├── GET /api/project/list?projectKey=pdd  → 项目列表（头部项目切换）
-   └── GET /api/project?projectKey=pdd       → 合并后的完整项目配置（含 menu）
-3. menuStore.setMenuList(menu)               → 菜单存入 Pinia
-4. header-view 渲染菜单                      → 含 subMenu 的项渲染为下拉子菜单
-5. 点击菜单项 → 按 moduleType 决定路由跳转
-   ├── custom → dashboard 基址 + customConfig.path
-   ├── sider  → /sider（左侧子菜单，子项跳转带 siderKey）
-   ├── iframe → /iframe
-   └── schema → /schema → schema-view
-6. schema-view 内部：
-   useSchema() 按路由 query 的 key / siderKey 从 menuStore 找到菜单项
-   → buildDtoSchema 按 xxxOption 拆出表格 / 搜索 / 动态组件 schema
-   → 搜索栏 + 表格渲染，URL query 同名字段预填搜索默认值
-7. 动态组件（配置了 tableConfig.componentConfig 时）：
-   按钮 eventKey=showComponent 打开 createForm / editForm / detailPanel 抽屉
-   → 保存成功 emit loadTableData → 表格刷新
-```
-
-## Dashboard 前端路由
-
-| 路由（基址 `/view/dashboard`） | 组件 | 说明 |
-| --- | --- | --- |
-| `/sider` | sider-view | 侧边复合视图，含子路由 `/sider/iframe`、`/sider/schema` 等 |
-| `/iframe` | iframe-view | iframe 嵌入页 |
-| `/schema` | schema-view | schema 驱动页 |
-| `/sider/:chapters+` | sider-view | sider 多级路径兜底 |
-
-## 内置数据接口
-
-| 接口 | 免 project_key | 说明 |
-| --- | --- | --- |
-| `GET /api/project/model_list` | ✓ | 全部 Model 及其 Project 概要（DTO） |
-| `GET /api/project/list?projectKey=` | ✓ | 项目列表（可按 key 过滤） |
-| `GET /api/project?projectKey=` | ✗（需 `project_key` 头） | 合并后的完整项目配置（含 menu） |
-
-Dashboard 页面启动时用 `$lumfallCurl` 拉取这些接口渲染菜单；URL 带
-`?projectKey=xxx` 时 curl 自动带 `project_key` 头（见[请求工具](../frontend/curl.md)）。
-
-## 项目切换
-
-头部右上角的下拉会列出**同 Model 下的其他 Project**（来自
-`/api/project/list`），切换后以新项目的 `homePage` 作为落点——这就是
-Model + Project 两层 DSL 在体验上的意义：一套公共菜单骨架，多个项目按需覆盖。
-
-## 下一步
-
-- [DSL 总览](../dsl/overview.md)：从零声明一个管理台
-- [接口契约](../dsl/api-contract.md)：schema 模块的后端接口标准
-- [安全策略](./security.md)：`/api/project/*` 的 project_key 校验

package/templates/document/docs/advanced/health.md

@@ -1,72 +0,0 @@
-# 健康检查
-
-框架自带两个健康检查接口与一个探针注册器，用于容器编排 / 负载均衡的探活。
-
-## 内置接口
-
-| 接口 | 用途 | 行为 |
-| --- | --- | --- |
-| `GET /health/live` | 存活探针 | 进程能响应即 200 `{"status":"ok"}` |
-| `GET /health/ready` | 就绪探针 | 并行执行全部已注册探针，全部通过 200；任一抛错 / 超时 / 返回 `false` 则 503 |
-
-两个接口都带 `Cache-Control: no-store`。`/health/ready` 的响应只包含探针名与状态，
-不包含错误详情（避免泄露内部信息）：
-
-```json
-{
-  "status": "error",
-  "checks": [
-    { "name": "database", "status": "ok" },
-    { "name": "cache", "status": "error" }
-  ]
-}
-```
-
-`/view/health` 是框架自带的人工查看页面。
-
-## 注册业务探针
-
-通过 extend 把业务依赖（数据库、缓存、下游服务）注册为探针：
-
-```js
-// app/extend/health-check.js
-module.exports = (app) => {
-  app.health.register("database", async () => {
-    await app.services.db.ping(); // 抛错或返回 false 视为不健康
-  });
-
-  app.health.register("cache", async () => {
-    const ok = await redisClient.ping();
-    return ok === "PONG";
-  }, { timeoutMs: 1000 }); // 默认 3000ms
-
-  return {}; // extend 的返回值挂到 app.healthCheck（返回 {} 占位即可）
-};
-```
-
-探针要求：
-
-- `register(name, probe, { timeoutMs })`：name 唯一非空；probe 是返回
-  Promise / 布尔的函数；抛错、超时、返回 `false` 都判为不健康
-- 同名重复注册会启动失败
-- `app.health.list()` 查看已注册探针（也会出现在
-  `app.diagnostics.getManifest().healthChecks`）
-
-## 接入编排系统
-
-```yaml
-# Kubernetes 示例
-livenessProbe:
-  httpGet:
-    path: /health/live
-    port: 3000
-readinessProbe:
-  httpGet:
-    path: /health/ready
-    port: 3000
-```
-
-- 存活探针只证明进程能响应，不要挂重探针
-- 就绪探针反映真实依赖状态：依赖故障时摘除流量，但不重启进程
-- 文档站这类无外部依赖的纯静态项目，不注册探针即可，`/health/ready`
-  恒为 200（`checks` 为空）

package/templates/document/docs/advanced/monitoring.md

@@ -1,60 +0,0 @@
-# 请求观测 monitoring
-
-`serviceStart({ monitoring })` 提供请求级的观测钩子（可选配置，
-不配置就是纯 passthrough，对默认行为零影响）。
-
-## 基本用法
-
-```js
-serviceStart({
-  monitoring: {
-    // 透传 / 生成 trace id 的请求头，默认 "x-trace-id"
-    traceHeader: "x-trace-id",
-
-    onRequestStart({ traceId, method, path }) {
-      // 请求进入
-    },
-    onRequestEnd({ traceId, method, path, status, durationMs }) {
-      // 响应完成（正常路径）
-    },
-    onRequestError({ traceId, method, path, error, durationMs }) {
-      // 内层抛出异常时（异常还会继续向上交给 errorHandler）
-    },
-  },
-});
-```
-
-## trace id
-
-- 请求头里已有 `traceHeader` 就复用，否则生成（UUID），并回显到**同名响应头**
-- trace id 同时写入 `ctx.traceId`，业务代码可直接读
-- 跨服务串日志：上游把 trace id 放进请求头，下游自动复用
-
-## 行为约定
-
-- 钩子自己抛错只记 warning，**不影响响应**——观测故障不拖垮业务
-- monitoring 位于 `errorHandler` 内侧：内层异常先触发 `onRequestError`，
-  再由 errorHandler 渲染响应，所以每个请求都会且只会触发一次
-  `onRequestEnd` 或 `onRequestError`
-- 校验：未知 hook 名、非函数 hook、非法 `traceHeader` 都会导致**启动失败**
-
-## 典型用法
-
-```js
-serviceStart({
-  monitoring: {
-    onRequestStart({ traceId, method, path }) {
-      app.logger.info(`[start] ${traceId} ${method} ${path}`);
-    },
-    onRequestEnd({ traceId, method, path, status, durationMs }) {
-      app.logger.info(`[end] ${traceId} ${method} ${path} ${status} ${durationMs}ms`);
-    },
-  },
-});
-```
-
-::: tip 与全局中间件的分工
-- monitoring：请求级「开始 / 结束 / 出错」三点观测 + trace 透传
-- 业务全局中间件：需要修改请求 / 响应（加 header、改 body）的逻辑
-只做观测就用 monitoring，它有框架级的错误隔离。
-:::