@nokecy/qc-ui 1.0.96 → 1.0.98

package/dist/cjs/ag-grid-plus/context/gridContext.d.ts

@@ -1,10 +1,20 @@
 import React from "react";
 import type { ColumnScheme, QueryScheme, CurrentSchemeDto } from "../shared/storage/schemeStorageAdapter";
-import type { BackendApiAdapterConfig } from "../shared/storage/backendApiAdapter";
 /**
  * 方案管理 API 接口
  *
- * 这些 API 由 useGridSchemes Hook 自动提供，不需要在 Provider 中手动配置
+ * ⚠️ 必须通过 useSchemeManager Hook 创建，然后传入 Provider
+ *
+ * @example
+ * ```tsx
+ * const adapter = useMemo(() => new BackendApiSchemeAdapter({ ... }), []);
+ * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
+ *
+ * <GridPlusContext.Provider value={{
+ *   ...otherValues,
+ *   ...schemeManager  // 展开方案管理状态
+ * }}>
+ * ```
  */
 export interface SchemeManagementAPI {
     /**
@@ -74,7 +84,7 @@ export interface SchemeManagementAPI {
 /**
  * GridPlus Context 值接口
  *
- * 注意：方案管理 API 不需要在 Provider 中配置，它们由 useGridSchemes Hook 自动提供
+ * ⚠️ 必须包含方案管理 API，通过 useSchemeManager Hook 创建后传入
  */
 export interface GridPlusContextValue extends SchemeManagementAPI {
     /**
@@ -123,32 +133,10 @@ export interface GridPlusContextValue extends SchemeManagementAPI {
      */
     updateQueryOrder?: (order: string[]) => void;
     /**
-     * 后端 API 配置（可选）
-     *
-     * 如果提供此配置，useGridSchemes Hook 将自动使用 BackendApiSchemeAdapter
-     * 否则将使用 LocalStorageSchemeAdapter
-     *
-     * @example
-     * ```tsx
-     * backendApiConfig: {
-     *   apiBaseUrl: 'https://api.example.com',
-     *   getToken: () => localStorage.getItem('token'),
-     *   getUserId: () => localStorage.getItem('userId'),
-     *   timeout: 10000
-     * }
-     * ```
-     */
-    backendApiConfig?: Omit<BackendApiAdapterConfig, 'enableDebugLog'>;
-    /**
-     * 当前用户ID（可选）
-     *
-     * 用于监听用户切换，自动重新加载方案数据
-     * 当此值变化时，系统会自动调用 refreshSchemes() 重新加载所有方案
+     * 当前用户ID（内部使用）
      *
-     * @example
-     * ```tsx
-     * currentUserId: currentUser?.id
-     * ```
+     * 用于 SchemeManager 监听用户切换，自动重新加载方案数据
+     * 此字段由 useSchemeManager 自动管理，无需手动设置
      */
     currentUserId?: string | null;
 }

package/dist/cjs/ag-grid-plus/context/gridContext.js

@@ -9,13 +9,24 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 /**
  * 方案管理 API 接口
  *
- * 这些 API 由 useGridSchemes Hook 自动提供，不需要在 Provider 中手动配置
+ * ⚠️ 必须通过 useSchemeManager Hook 创建，然后传入 Provider
+ *
+ * @example
+ * ```tsx
+ * const adapter = useMemo(() => new BackendApiSchemeAdapter({ ... }), []);
+ * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
+ *
+ * <GridPlusContext.Provider value={{
+ *   ...otherValues,
+ *   ...schemeManager  // 展开方案管理状态
+ * }}>
+ * ```
  */
 
 /**
  * GridPlus Context 值接口
  *
- * 注意：方案管理 API 不需要在 Provider 中配置，它们由 useGridSchemes Hook 自动提供
+ * ⚠️ 必须包含方案管理 API，通过 useSchemeManager Hook 创建后传入
  */
 
 var GridPlusContext = exports.GridPlusContext = /*#__PURE__*/_react.default.createContext({

package/dist/cjs/ag-grid-plus/context/useSchemeManager.d.ts

@@ -55,43 +55,46 @@ export declare function useSchemeManager(config: UseSchemeManagerConfig): {
 /**
  * 在组件中使用集中式方案管理
  *
- * 支持两种模式（根据 Context 配置自动选择）:
- * 1. Backend API 模式: Context 提供 backendApiConfig，使用后端适配器
- * 2. LocalStorage 模式: 不提供配置，使用本地存储适配器
+ * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
  *
  * @example
  * ```tsx
- * // 模式1：提供后端 API 配置
- * <GridPlusContext.Provider value={{
- *   extensibleColumns: [],
- *   columnState: undefined,
- *   onSaveColumnState: () => {},
- *   applyToGlobal: () => {},
- *   resetCurrent: () => {},
- *   resetAll: () => {},
- *   queryFormItems: [],
- *   backendApiConfig: {
- *     apiBaseUrl: 'https://api.example.com',
- *     getToken: () => localStorage.getItem('token'),
- *     getUserId: () => localStorage.getItem('userId')
- *   }
- * }}>
- *   <MyGrid />
- * </GridPlusContext.Provider>
+ * // 1. 创建适配器和方案管理器
+ * function App() {
+ *   const adapter = useMemo(
+ *     () => new BackendApiSchemeAdapter({
+ *       apiBaseUrl: 'https://api.example.com',
+ *       getToken: () => localStorage.getItem('token'),
+ *       getUserId: () => localStorage.getItem('userId')
+ *     }),
+ *     []
+ *   );
+ *
+ *   const schemeManager = useSchemeManager({
+ *     adapter,
+ *     autoLoad: true,
+ *     showErrorMessage: true,
+ *     currentUserId: currentUser?.id
+ *   });
  *
- * // 模式2：无配置，自动使用 LocalStorage
- * <GridPlusContext.Provider value={{
- *   extensibleColumns: [],
- *   columnState: undefined,
- *   onSaveColumnState: () => {},
- *   applyToGlobal: () => {},
- *   resetCurrent: () => {},
- *   resetAll: () => {},
- *   queryFormItems: []
- * }}>
- *   <MyGrid />
- * </GridPlusContext.Provider>
+ *   // 2. 传入 Provider
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       extensibleColumns: [],
+ *       columnState: undefined,
+ *       onSaveColumnState: () => {},
+ *       applyToGlobal: () => {},
+ *       resetCurrent: () => {},
+ *       resetAll: () => {},
+ *       queryFormItems: [],
+ *       ...schemeManager  // 展开方案管理状态
+ *     }}>
+ *       <MyGrid />
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
  *
+ * // 3. 在子组件中使用
  * function MyGrid() {
  *   const {
  *     columnSchemes,

package/dist/cjs/ag-grid-plus/context/useSchemeManager.js

@@ -481,93 +481,49 @@ function useSchemeManager(config) {
   };
 }
 
-/**
- * Fallback 模式：根据后端 API 配置自动选择适配器
- */
-function useFallbackSchemeManager(backendApiConfig, currentUserId) {
-  // 根据配置选择适配器
-  var adapter = (0, _react.useRef)(function () {
-    if (backendApiConfig) {
-      // 如果提供了后端 API 配置，使用后端适配器
-      var _require = require("../shared/storage/backendApiAdapter"),
-        BackendApiSchemeAdapter = _require.BackendApiSchemeAdapter;
-      console.log('[useFallbackSchemeManager] 使用后端 API 适配器');
-      return new BackendApiSchemeAdapter(_objectSpread(_objectSpread({}, backendApiConfig), {}, {
-        enableDebugLog: false
-      }));
-    } else {
-      // 否则使用本地存储适配器
-      var _require2 = require("../shared/storage/localStorageAdapter"),
-        LocalStorageSchemeAdapter = _require2.LocalStorageSchemeAdapter;
-      console.log('[useFallbackSchemeManager] 使用本地存储适配器');
-      return new LocalStorageSchemeAdapter({
-        storageKey: 'ag-grid-plus-schemes',
-        enableDebugLog: false
-      });
-    }
-  }).current();
-
-  // 使用选定的适配器进行状态管理
-  var manager = useSchemeManager({
-    adapter: adapter,
-    autoLoad: true,
-    showErrorMessage: true,
-    currentUserId: currentUserId
-  });
-
-  // 返回与 Context 相同的接口
-  return _objectSpread({
-    // 保留必需的默认值
-    extensibleColumns: [],
-    columnState: undefined,
-    onSaveColumnState: function onSaveColumnState() {},
-    applyToGlobal: function applyToGlobal() {},
-    resetCurrent: function resetCurrent() {},
-    resetAll: function resetAll() {},
-    queryFormItems: []
-  }, manager);
-}
-
 /**
  * 在组件中使用集中式方案管理
  *
- * 支持两种模式（根据 Context 配置自动选择）:
- * 1. Backend API 模式: Context 提供 backendApiConfig，使用后端适配器
- * 2. LocalStorage 模式: 不提供配置，使用本地存储适配器
+ * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
  *
  * @example
  * ```tsx
- * // 模式1：提供后端 API 配置
- * <GridPlusContext.Provider value={{
- *   extensibleColumns: [],
- *   columnState: undefined,
- *   onSaveColumnState: () => {},
- *   applyToGlobal: () => {},
- *   resetCurrent: () => {},
- *   resetAll: () => {},
- *   queryFormItems: [],
- *   backendApiConfig: {
- *     apiBaseUrl: 'https://api.example.com',
- *     getToken: () => localStorage.getItem('token'),
- *     getUserId: () => localStorage.getItem('userId')
- *   }
- * }}>
- *   <MyGrid />
- * </GridPlusContext.Provider>
+ * // 1. 创建适配器和方案管理器
+ * function App() {
+ *   const adapter = useMemo(
+ *     () => new BackendApiSchemeAdapter({
+ *       apiBaseUrl: 'https://api.example.com',
+ *       getToken: () => localStorage.getItem('token'),
+ *       getUserId: () => localStorage.getItem('userId')
+ *     }),
+ *     []
+ *   );
  *
- * // 模式2：无配置，自动使用 LocalStorage
- * <GridPlusContext.Provider value={{
- *   extensibleColumns: [],
- *   columnState: undefined,
- *   onSaveColumnState: () => {},
- *   applyToGlobal: () => {},
- *   resetCurrent: () => {},
- *   resetAll: () => {},
- *   queryFormItems: []
- * }}>
- *   <MyGrid />
- * </GridPlusContext.Provider>
+ *   const schemeManager = useSchemeManager({
+ *     adapter,
+ *     autoLoad: true,
+ *     showErrorMessage: true,
+ *     currentUserId: currentUser?.id
+ *   });
  *
+ *   // 2. 传入 Provider
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       extensibleColumns: [],
+ *       columnState: undefined,
+ *       onSaveColumnState: () => {},
+ *       applyToGlobal: () => {},
+ *       resetCurrent: () => {},
+ *       resetAll: () => {},
+ *       queryFormItems: [],
+ *       ...schemeManager  // 展开方案管理状态
+ *     }}>
+ *       <MyGrid />
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
+ *
+ * // 3. 在子组件中使用
  * function MyGrid() {
  *   const {
  *     columnSchemes,
@@ -587,10 +543,11 @@ function useFallbackSchemeManager(backendApiConfig, currentUserId) {
 function useGridSchemes() {
   var context = (0, _react.useContext)(_gridContext.GridPlusContext);
 
-  // 根据后端 API 配置自动选择适配器
-  var adapterType = context !== null && context !== void 0 && context.backendApiConfig ? '后端 API' : 'LocalStorage';
-  console.log("[useGridSchemes] \u4F7F\u7528 ".concat(adapterType, " \u9002\u914D\u5668"));
-
-  // eslint-disable-next-line react-hooks/rules-of-hooks
-  return useFallbackSchemeManager(context === null || context === void 0 ? void 0 : context.backendApiConfig, context === null || context === void 0 ? void 0 : context.currentUserId);
+  // 检查是否传入了方案管理状态
+  var hasSchemeManagement = !!((context === null || context === void 0 ? void 0 : context.columnSchemes) !== undefined || context !== null && context !== void 0 && context.saveColumnScheme || context !== null && context !== void 0 && context.deleteColumnScheme);
+  if (!hasSchemeManagement) {
+    throw new Error('[useGridSchemes] 必须在 GridPlusContext.Provider 中传入 SchemeManager 状态。\n' + '请使用 useSchemeManager hook 创建方案管理器，然后通过 Provider 传递：\n' + '  const schemeManager = useSchemeManager({ adapter, ... });\n' + '  <GridPlusContext.Provider value={{ ...otherValues, ...schemeManager }}>');
+  }
+  console.log('[useGridSchemes] 使用 Context 中的方案管理状态');
+  return context;
 }

package/dist/cjs/ag-grid-plus/shared/storage/backendApiAdapter.js

@@ -24,7 +24,16 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * 内部配置类型(所有字段必填)
  */
 /**
- * 后端 API 响应格式
+ * 后端 API 响应格式 - 基础响应
+ */
+/**
+ * 保存方案结果
+ */
+/**
+ * 删除方案结果
+ */
+/**
+ * 设置当前方案结果
  */
 /**
  * 后端 API 方案存储适配器
@@ -184,7 +193,7 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
             case 0:
               _context2.prev = 0;
               this.log('加载所有方案数据');
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/user-schemes");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/schemes");
               _context2.next = 5;
               return this.request(url);
             case 5:
@@ -216,13 +225,13 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
     key: "saveColumnScheme",
     value: function () {
       var _saveColumnScheme = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(gridId, scheme) {
-        var _response$data, url, response;
+        var url, response;
         return _regeneratorRuntime().wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
               _context3.prev = 0;
               this.log("\u4FDD\u5B58\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(scheme.name));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/column-scheme");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/save-column-scheme");
               _context3.next = 5;
               return this.request(url, {
                 method: 'POST',
@@ -239,8 +248,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
               }
               throw new Error(response.message || '保存失败');
             case 8:
-              this.log('保存成功', (_response$data = response.data) === null || _response$data === void 0 ? void 0 : _response$data.scheme.id);
-              return _context3.abrupt("return", response.data.scheme);
+              this.log('保存成功', response.scheme);
+              return _context3.abrupt("return", response.scheme);
             case 12:
               _context3.prev = 12;
               _context3.t0 = _context3["catch"](0);
@@ -268,10 +277,10 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
             case 0:
               _context4.prev = 0;
               this.log("\u5220\u9664\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/column-scheme/").concat(schemeId, "?gridId=").concat(gridId);
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/delete-column-scheme?schemeId=").concat(schemeId, "&gridId=").concat(gridId);
               _context4.next = 5;
               return this.request(url, {
-                method: 'DELETE'
+                method: 'POST'
               });
             case 5:
               response = _context4.sent;
@@ -305,13 +314,13 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
     key: "saveQueryScheme",
     value: function () {
       var _saveQueryScheme = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(gridId, scheme) {
-        var _response$data2, url, response;
+        var url, response;
         return _regeneratorRuntime().wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
               _context5.prev = 0;
               this.log("\u4FDD\u5B58\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(scheme.name));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/query-scheme");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/save-query-scheme");
               _context5.next = 5;
               return this.request(url, {
                 method: 'POST',
@@ -328,8 +337,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
               }
               throw new Error(response.message || '保存失败');
             case 8:
-              this.log('保存成功', (_response$data2 = response.data) === null || _response$data2 === void 0 ? void 0 : _response$data2.scheme.id);
-              return _context5.abrupt("return", response.data.scheme);
+              this.log('保存成功', response.scheme);
+              return _context5.abrupt("return", response.scheme);
             case 12:
               _context5.prev = 12;
               _context5.t0 = _context5["catch"](0);
@@ -357,10 +366,10 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
             case 0:
               _context6.prev = 0;
               this.log("\u5220\u9664\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/query-scheme/").concat(schemeId, "?gridId=").concat(gridId);
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/delete-query-scheme?schemeId=").concat(schemeId, "&gridId=").concat(gridId);
               _context6.next = 5;
               return this.request(url, {
-                method: 'DELETE'
+                method: 'POST'
               });
             case 5:
               response = _context6.sent;
@@ -403,10 +412,10 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
                 columnSchemeId: columnSchemeId,
                 querySchemeId: querySchemeId
               });
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/current-scheme");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/set-current-scheme");
               _context7.next = 5;
               return this.request(url, {
-                method: 'PUT',
+                method: 'POST',
                 body: JSON.stringify({
                   gridId: gridId,
                   columnSchemeId: columnSchemeId,

package/dist/esm/ag-grid-plus/context/gridContext.d.ts

@@ -1,10 +1,20 @@
 import React from "react";
 import type { ColumnScheme, QueryScheme, CurrentSchemeDto } from "../shared/storage/schemeStorageAdapter";
-import type { BackendApiAdapterConfig } from "../shared/storage/backendApiAdapter";
 /**
  * 方案管理 API 接口
  *
- * 这些 API 由 useGridSchemes Hook 自动提供，不需要在 Provider 中手动配置
+ * ⚠️ 必须通过 useSchemeManager Hook 创建，然后传入 Provider
+ *
+ * @example
+ * ```tsx
+ * const adapter = useMemo(() => new BackendApiSchemeAdapter({ ... }), []);
+ * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
+ *
+ * <GridPlusContext.Provider value={{
+ *   ...otherValues,
+ *   ...schemeManager  // 展开方案管理状态
+ * }}>
+ * ```
  */
 export interface SchemeManagementAPI {
     /**
@@ -74,7 +84,7 @@ export interface SchemeManagementAPI {
 /**
  * GridPlus Context 值接口
  *
- * 注意：方案管理 API 不需要在 Provider 中配置，它们由 useGridSchemes Hook 自动提供
+ * ⚠️ 必须包含方案管理 API，通过 useSchemeManager Hook 创建后传入
  */
 export interface GridPlusContextValue extends SchemeManagementAPI {
     /**
@@ -123,32 +133,10 @@ export interface GridPlusContextValue extends SchemeManagementAPI {
      */
     updateQueryOrder?: (order: string[]) => void;
     /**
-     * 后端 API 配置（可选）
-     *
-     * 如果提供此配置，useGridSchemes Hook 将自动使用 BackendApiSchemeAdapter
-     * 否则将使用 LocalStorageSchemeAdapter
-     *
-     * @example
-     * ```tsx
-     * backendApiConfig: {
-     *   apiBaseUrl: 'https://api.example.com',
-     *   getToken: () => localStorage.getItem('token'),
-     *   getUserId: () => localStorage.getItem('userId'),
-     *   timeout: 10000
-     * }
-     * ```
-     */
-    backendApiConfig?: Omit<BackendApiAdapterConfig, 'enableDebugLog'>;
-    /**
-     * 当前用户ID（可选）
-     *
-     * 用于监听用户切换，自动重新加载方案数据
-     * 当此值变化时，系统会自动调用 refreshSchemes() 重新加载所有方案
+     * 当前用户ID（内部使用）
      *
-     * @example
-     * ```tsx
-     * currentUserId: currentUser?.id
-     * ```
+     * 用于 SchemeManager 监听用户切换，自动重新加载方案数据
+     * 此字段由 useSchemeManager 自动管理，无需手动设置
      */
     currentUserId?: string | null;
 }

package/dist/esm/ag-grid-plus/context/gridContext.js

@@ -3,13 +3,24 @@ import React from "react";
 /**
  * 方案管理 API 接口
  *
- * 这些 API 由 useGridSchemes Hook 自动提供，不需要在 Provider 中手动配置
+ * ⚠️ 必须通过 useSchemeManager Hook 创建，然后传入 Provider
+ *
+ * @example
+ * ```tsx
+ * const adapter = useMemo(() => new BackendApiSchemeAdapter({ ... }), []);
+ * const schemeManager = useSchemeManager({ adapter, autoLoad: true });
+ *
+ * <GridPlusContext.Provider value={{
+ *   ...otherValues,
+ *   ...schemeManager  // 展开方案管理状态
+ * }}>
+ * ```
  */
 
 /**
  * GridPlus Context 值接口
  *
- * 注意：方案管理 API 不需要在 Provider 中配置，它们由 useGridSchemes Hook 自动提供
+ * ⚠️ 必须包含方案管理 API，通过 useSchemeManager Hook 创建后传入
  */
 
 export var GridPlusContext = /*#__PURE__*/React.createContext({

package/dist/esm/ag-grid-plus/context/useSchemeManager.d.ts

@@ -55,43 +55,46 @@ export declare function useSchemeManager(config: UseSchemeManagerConfig): {
 /**
  * 在组件中使用集中式方案管理
  *
- * 支持两种模式（根据 Context 配置自动选择）:
- * 1. Backend API 模式: Context 提供 backendApiConfig，使用后端适配器
- * 2. LocalStorage 模式: 不提供配置，使用本地存储适配器
+ * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
  *
  * @example
  * ```tsx
- * // 模式1：提供后端 API 配置
- * <GridPlusContext.Provider value={{
- *   extensibleColumns: [],
- *   columnState: undefined,
- *   onSaveColumnState: () => {},
- *   applyToGlobal: () => {},
- *   resetCurrent: () => {},
- *   resetAll: () => {},
- *   queryFormItems: [],
- *   backendApiConfig: {
- *     apiBaseUrl: 'https://api.example.com',
- *     getToken: () => localStorage.getItem('token'),
- *     getUserId: () => localStorage.getItem('userId')
- *   }
- * }}>
- *   <MyGrid />
- * </GridPlusContext.Provider>
+ * // 1. 创建适配器和方案管理器
+ * function App() {
+ *   const adapter = useMemo(
+ *     () => new BackendApiSchemeAdapter({
+ *       apiBaseUrl: 'https://api.example.com',
+ *       getToken: () => localStorage.getItem('token'),
+ *       getUserId: () => localStorage.getItem('userId')
+ *     }),
+ *     []
+ *   );
+ *
+ *   const schemeManager = useSchemeManager({
+ *     adapter,
+ *     autoLoad: true,
+ *     showErrorMessage: true,
+ *     currentUserId: currentUser?.id
+ *   });
  *
- * // 模式2：无配置，自动使用 LocalStorage
- * <GridPlusContext.Provider value={{
- *   extensibleColumns: [],
- *   columnState: undefined,
- *   onSaveColumnState: () => {},
- *   applyToGlobal: () => {},
- *   resetCurrent: () => {},
- *   resetAll: () => {},
- *   queryFormItems: []
- * }}>
- *   <MyGrid />
- * </GridPlusContext.Provider>
+ *   // 2. 传入 Provider
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       extensibleColumns: [],
+ *       columnState: undefined,
+ *       onSaveColumnState: () => {},
+ *       applyToGlobal: () => {},
+ *       resetCurrent: () => {},
+ *       resetAll: () => {},
+ *       queryFormItems: [],
+ *       ...schemeManager  // 展开方案管理状态
+ *     }}>
+ *       <MyGrid />
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
  *
+ * // 3. 在子组件中使用
  * function MyGrid() {
  *   const {
  *     columnSchemes,