style: 修复接口文件中的缩进和重复代码问题

实现订单总数统计接口，包括：
1. 在ISiteAdapter接口添加countOrders方法
2. 在WooCommerce和Shopyy适配器中实现该方法
3. 添加控制器端点暴露该功能
4. 优化订单查询参数映射逻辑

refactor(Shopyy): 重构搜索参数映射逻辑

将通用的搜索参数映射逻辑提取为独立方法，提高代码复用性

refactor(interface): 重构站点适配器接口，按功能模块组织方法

重构 ISiteAdapter 接口，将相关方法按功能模块（客户、媒体、订单、产品等）分组
移除废弃的 fulfillOrder 方法
新增多个数据映射方法以支持统一数据格式转换

refactor(api): 统一接口参数为对象形式并支持多条件查询

重构所有接口方法，将直接传递id参数改为接受where条件对象
支持通过id、sku、email等多条件查询实体
优化产品服务逻辑，支持通过sku直接查询产品
统一各适配器实现，确保接口一致性

feat(订单): 添加获取订单总数功能

实现订单总数统计接口，包括：
1. 在ISiteAdapter接口添加countOrders方法
2. 在WooCommerce和Shopyy适配器中实现该方法
3. 添加控制器端点暴露该功能
4. 优化订单查询参数映射逻辑

refactor(Shopyy): 重构搜索参数映射逻辑

将通用的搜索参数映射逻辑提取为独立方法，提高代码复用性

refactor(interface): 重构站点适配器接口，按功能模块组织方法

重构 ISiteAdapter 接口，将相关方法按功能模块（客户、媒体、订单、产品等）分组
移除废弃的 fulfillOrder 方法
新增多个数据映射方法以支持统一数据格式转换

refactor(api): 统一接口参数为对象形式并支持多条件查询

重构所有接口方法，将直接传递id参数改为接受where条件对象
支持通过id、sku、email等多条件查询实体
优化产品服务逻辑，支持通过sku直接查询产品
统一各适配器实现，确保接口一致性

feat: 增强产品同步功能并优化SKU生成逻辑

添加字典排序字段支持
优化产品同步流程，支持通过SKU同步
重构SKU模板生成逻辑，支持分类属性排序
完善产品导入导出功能，增加分类字段处理
统一产品操作方法，提升代码可维护性

fix(sync_shipment): 捕获运单状态更新时的异常并记录日志

添加try-catch块来捕获updateShipmentState过程中可能出现的错误
使用logger记录错误信息以便后续排查

feat(shopyy): 实现全量商品查询功能并优化产品相关逻辑

- 新增ShopyyAllProductQuery类支持全量商品查询参数
- 实现getAllProducts方法支持带条件查询
- 优化getProductBySku方法使用新查询接口
- 公开request方法便于子类调用
- 增加错误日志记录产品查找失败情况
- 修复产品permalink生成逻辑

refactor(adapter): 清理重复代码并统一订单映射方法命名

移除shopyy和woocommerce适配器中的重复代码
将mapOrder重命名为mapPlatformToUnifiedOrder以保持命名一致性

feat(订单): 添加获取订单总数功能

实现订单总数统计接口，包括：
1. 在ISiteAdapter接口添加countOrders方法
2. 在WooCommerce和Shopyy适配器中实现该方法
3. 添加控制器端点暴露该功能
4. 优化订单查询参数映射逻辑

refactor(Shopyy): 重构搜索参数映射逻辑

将通用的搜索参数映射逻辑提取为独立方法，提高代码复用性

refactor(interface): 重构站点适配器接口，按功能模块组织方法

重构 ISiteAdapter 接口，将相关方法按功能模块（客户、媒体、订单、产品等）分组
移除废弃的 fulfillOrder 方法
新增多个数据映射方法以支持统一数据格式转换

feat(订单): 添加获取订单总数功能

实现订单总数统计接口，包括：
1. 在ISiteAdapter接口添加countOrders方法
2. 在WooCommerce和Shopyy适配器中实现该方法
3. 添加控制器端点暴露该功能
4. 优化订单查询参数映射逻辑

refactor(Shopyy): 重构搜索参数映射逻辑

将通用的搜索参数映射逻辑提取为独立方法，提高代码复用性

refactor(interface): 重构站点适配器接口，按功能模块组织方法

重构 ISiteAdapter 接口，将相关方法按功能模块（客户、媒体、订单、产品等）分组
移除废弃的 fulfillOrder 方法
新增多个数据映射方法以支持统一数据格式转换

docs: 统一中文括号格式为全角括号

将代码中的中文括号格式从半角"()"统一修改为全角"（）"，并删除测试文档文件test-site-sku-methods.md

chore: config.local 还原

docs(dto): 修正注释中的中文括号格式

docs(dto): 修正注释中的括号格式

docs: 修正中文标点符号和注释格式

统一将中文注释和文档中的全角括号和冒号改为半角格式
修正部分TODO注释的标点符号
统一接口文档中的描述符号格式

refactor(shopyy): 移除重复的订单相关方法

src/interface/site-adapter.interface.ts

@@ -1,496 +1,496 @@
 import {
-  CreateReviewDTO,
-  UpdateReviewDTO,
-  UnifiedMediaDTO,
-  UnifiedOrderDTO,
-  UnifiedProductDTO,
-  UnifiedReviewDTO,
-  UnifiedSubscriptionDTO,
-  UnifiedCustomerDTO,
-  UnifiedWebhookDTO,
-  UnifiedWebhookPaginationDTO,
-  CreateWebhookDTO,
-  UpdateWebhookDTO,
-  CreateVariationDTO,
-  UpdateVariationDTO,
-  UnifiedProductVariationDTO,
-  UnifiedVariationPaginationDTO,
+   CreateReviewDTO,
+   UpdateReviewDTO,
+   UnifiedMediaDTO,
+   UnifiedOrderDTO,
+   UnifiedProductDTO,
+   UnifiedReviewDTO,
+   UnifiedSubscriptionDTO,
+   UnifiedCustomerDTO,
+   UnifiedWebhookDTO,
+   UnifiedWebhookPaginationDTO,
+   CreateWebhookDTO,
+   UpdateWebhookDTO,
+   CreateVariationDTO,
+   UpdateVariationDTO,
+   UnifiedProductVariationDTO,
+   UnifiedVariationPaginationDTO,
 } from '../dto/site-api.dto';
 import { UnifiedPaginationDTO, UnifiedSearchParamsDTO } from '../dto/api.dto';
 import { BatchOperationDTO, BatchOperationResultDTO } from '../dto/batch.dto';
 
 export interface ISiteAdapter {
-  // ========== 客户映射方法 ==========
-  /**
-   * 将平台客户数据转换为统一客户数据格式
-   * @param data 平台特定客户数据
-   * @returns 统一客户数据格式
-   */
-  mapPlatformToUnifiedCustomer(data: any): UnifiedCustomerDTO;
-
-  /**
-   * 将统一客户数据格式转换为平台客户数据
-   * @param data 统一客户数据格式
-   * @returns 平台特定客户数据
-   */
-  mapUnifiedToPlatformCustomer(data: Partial<UnifiedCustomerDTO>): any;
-
-  /**
-   * 获取单个客户
-   */
-  getCustomer(where: Partial<Pick<UnifiedCustomerDTO, 'id' | 'email' | 'phone'>>): Promise<UnifiedCustomerDTO>;
-
-  /**
-   * 获取客户列表
-   */
-  getCustomers(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedCustomerDTO>>;
-
-  /**
-   * 获取所有客户
-   */
-  getAllCustomers(params?: UnifiedSearchParamsDTO): Promise<UnifiedCustomerDTO[]>;
-
-  /**
-   * 创建客户
-   */
-  createCustomer(data: Partial<UnifiedCustomerDTO>): Promise<UnifiedCustomerDTO>;
-
-  /**
-   * 更新客户
-   */
-  updateCustomer(where: Partial<Pick<UnifiedCustomerDTO, 'id' | 'email' | 'phone'>>, data: Partial<UnifiedCustomerDTO>): Promise<UnifiedCustomerDTO>;
-
-  /**
-   * 删除客户
-   */
-  deleteCustomer(where: Partial<Pick<UnifiedCustomerDTO, 'id' | 'email' | 'phone'>>): Promise<boolean>;
-
-  /**
-   * 批量处理客户
-   */
-  batchProcessCustomers?(data: BatchOperationDTO): Promise<BatchOperationResultDTO>;
-
-  // ========== 媒体映射方法 ==========
-  /**
-   * 将平台媒体数据转换为统一媒体数据格式
-   * @param data 平台特定媒体数据
-   * @returns 统一媒体数据格式
-   */
-  mapPlatformToUnifiedMedia(data: any): UnifiedMediaDTO;
-
-  /**
-   * 将统一媒体数据格式转换为平台媒体数据
-   * @param data 统一媒体数据格式
-   * @returns 平台特定媒体数据
-   */
-  mapUnifiedToPlatformMedia(data: Partial<UnifiedMediaDTO>): any;
-
-  /**
-   * 获取媒体列表
-   */
-  getMedia(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedMediaDTO>>;
-
-  /**
-   * 获取所有媒体
-   */
-  getAllMedia(params?: UnifiedSearchParamsDTO): Promise<UnifiedMediaDTO[]>;
-
-  /**
-   * 创建媒体
-   */
-  createMedia(file: any): Promise<UnifiedMediaDTO>;
-
-  // ========== 订单映射方法 ==========
-  /**
-   * 将平台订单数据转换为统一订单数据格式
-   * @param data 平台特定订单数据
-   * @returns 统一订单数据格式
-   */
-  mapPlatformToUnifiedOrder(data: any): UnifiedOrderDTO;
-
-  /**
-   * 将统一订单数据格式转换为平台订单数据
-   * @param data 统一订单数据格式
-   * @returns 平台特定订单数据
-   */
-  mapUnifiedToPlatformOrder(data: Partial<UnifiedOrderDTO>): any;
-
-  /**
-   * 将统一订单创建参数转换为平台订单创建参数
-   * @param data 统一订单创建参数
-   * @returns 平台订单创建参数
-   */
-  mapCreateOrderParams(data: Partial<UnifiedOrderDTO>): any;
-
-  /**
-   * 将统一订单更新参数转换为平台订单更新参数
-   * @param data 统一订单更新参数
-   * @returns 平台订单更新参数
-   */
-  mapUpdateOrderParams(data: Partial<UnifiedOrderDTO>): any;
-
-  /**
-   * 获取单个订单
-   */
-  getOrder(where: Partial<Pick<UnifiedOrderDTO, 'id'>>): Promise<UnifiedOrderDTO>;
-
-  /**
-   * 获取订单列表
-   */
-  getOrders(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedOrderDTO>>;
-
-  /**
-   * 获取所有订单
-   */
-  getAllOrders(params?: UnifiedSearchParamsDTO): Promise<UnifiedOrderDTO[]>;
-
-  /**
-   * 获取订单总数
-   */
-  countOrders(params: Record<string, any>): Promise<number>;
-
-  /**
-   * 创建订单
-   */
-  createOrder(data: Partial<UnifiedOrderDTO>): Promise<UnifiedOrderDTO>;
-
-  /**
-   * 更新订单
-   */
-  updateOrder(where: Partial<Pick<UnifiedOrderDTO, 'id'>>, data: Partial<UnifiedOrderDTO>): Promise<boolean>;
-
-  /**
-   * 删除订单
-   */
-  deleteOrder(where: Partial<Pick<UnifiedOrderDTO, 'id'>>): Promise<boolean>;
-
-  /**
-   * 获取订单备注
-   */
-  getOrderNotes(orderId: string | number): Promise<any[]>;
-
-  /**
-   * 创建订单备注
-   */
-  createOrderNote(orderId: string | number, data: any): Promise<any>;
-
-  /**
-   * 取消订单履行
-   */
-  cancelFulfillment(orderId: string | number, data: {
-    reason?: string;
-    shipment_id?: string;
-  }): Promise<any>;
-
-  /**
-   * 获取订单履行信息
-   */
-  getOrderFulfillments(orderId: string | number): Promise<any[]>;
-
-  /**
-   * 创建订单履行信息
-   */
-  createOrderFulfillment(orderId: string | number, data: {
-    tracking_number: string;
-    shipping_provider: string;
-    shipping_method?: string;
-    status?: string;
-    date_created?: string;
-    items?: Array<{
-      order_item_id: number;
-      quantity: number;
-    }>;
-  }): Promise<any>;
-
-  /**
-   * 更新订单履行信息
-   */
-  updateOrderFulfillment(orderId: string | number, fulfillmentId: string, data: {
-    tracking_number?: string;
-    shipping_provider?: string;
-    shipping_method?: string;
-    status?: string;
-    date_created?: string;
-    items?: Array<{
-      order_item_id: number;
-      quantity: number;
-    }>;
-  }): Promise<any>;
-
-  /**
-   * 删除订单履行信息
-   */
-  deleteOrderFulfillment(orderId: string | number, fulfillmentId: string): Promise<boolean>;
-
-  /**
-   * 批量处理订单
-   */
-  batchProcessOrders?(data: BatchOperationDTO): Promise<BatchOperationResultDTO>;
-
-  // ========== 产品映射方法 ==========
-  /**
-   * 将平台产品数据转换为统一产品数据格式
-   * @param data 平台特定产品数据
-   * @returns 统一产品数据格式
-   */
-  mapPlatformToUnifiedProduct(data: any): UnifiedProductDTO;
-
-  /**
-   * 将统一产品数据格式转换为平台产品数据
-   * @param data 统一产品数据格式
-   * @returns 平台特定产品数据
-   */
-  mapUnifiedToPlatformProduct(data: Partial<UnifiedProductDTO>): any;
-
-  /**
-   * 将统一产品创建参数转换为平台产品创建参数
-   * @param data 统一产品创建参数
-   * @returns 平台产品创建参数
-   */
-  mapCreateProductParams(data: Partial<UnifiedProductDTO>): any;
-
-  /**
-   * 将统一产品更新参数转换为平台产品更新参数
-   * @param data 统一产品更新参数
-   * @returns 平台产品更新参数
-   */
-  mapUpdateProductParams(data: Partial<UnifiedProductDTO>): any;
-
-  /**
-   * 获取单个产品
-   */
-  getProduct(where: Partial<Pick<UnifiedProductDTO, 'id' | 'sku'>>): Promise<UnifiedProductDTO>;
-
-  /**
-   * 获取产品列表
-   */
-  getProducts(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedProductDTO>>;
-
-  /**
-   * 获取所有产品
-   */
-  getAllProducts(params?: UnifiedSearchParamsDTO): Promise<UnifiedProductDTO[]>;
-
-  /**
-   * 创建产品
-   */
-  createProduct(data: Partial<UnifiedProductDTO>): Promise<UnifiedProductDTO>;
-
-  /**
-   * 更新产品
-   */
-  updateProduct(where: Partial<Pick<UnifiedProductDTO, 'id' | 'sku'>>, data: Partial<UnifiedProductDTO>): Promise<boolean>;
-
-  /**
-   * 删除产品
-   */
-  deleteProduct(where: Partial<Pick<UnifiedProductDTO, 'id' | 'sku'>>): Promise<boolean>;
-
-  /**
-   * 批量处理产品
-   */
-  batchProcessProducts?(data: BatchOperationDTO): Promise<BatchOperationResultDTO>;
-
-  // ========== 评论映射方法 ==========
-  /**
-   * 将平台评论数据转换为统一评论数据格式
-   * @param data 平台特定评论数据
-   * @returns 统一评论数据格式
-   */
-  mapPlatformToUnifiedReview(data: any): UnifiedReviewDTO;
-
-  /**
-   * 将统一评论数据格式转换为平台评论数据
-   * @param data 统一评论数据格式
-   * @returns 平台特定评论数据
-   */
-  mapUnifiedToPlatformReview(data: Partial<UnifiedReviewDTO>): any;
-
-  /**
-   * 将统一评论创建参数转换为平台评论创建参数
-   * @param data 统一评论创建参数
-   * @returns 平台评论创建参数
-   */
-  mapCreateReviewParams(data: CreateReviewDTO): any;
-
-  /**
-   * 将统一评论更新参数转换为平台评论更新参数
-   * @param data 统一评论更新参数
-   * @returns 平台评论更新参数
-   */
-  mapUpdateReviewParams(data: UpdateReviewDTO): any;
-
-  /**
-   * 获取评论列表
-   */
-  getReviews(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedReviewDTO>>;
-
-  /**
-   * 获取所有评论
-   */
-  getAllReviews(params?: UnifiedSearchParamsDTO): Promise<UnifiedReviewDTO[]>;
-
-  /**
-   * 创建评论
-   */
-  createReview(data: CreateReviewDTO): Promise<UnifiedReviewDTO>;
-
-  /**
-   * 更新评论
-   */
-  updateReview(where: Partial<Pick<UnifiedReviewDTO, 'id'>>, data: UpdateReviewDTO): Promise<UnifiedReviewDTO>;
-
-  /**
-   * 删除评论
-   */
-  deleteReview(where: Partial<Pick<UnifiedReviewDTO, 'id'>>): Promise<boolean>;
-
-  // ========== 订阅映射方法 ==========
-  /**
-   * 将平台订阅数据转换为统一订阅数据格式
-   * @param data 平台特定订阅数据
-   * @returns 统一订阅数据格式
-   */
-  mapPlatformToUnifiedSubscription(data: any): UnifiedSubscriptionDTO;
-
-  /**
-   * 将统一订阅数据格式转换为平台订阅数据
-   * @param data 统一订阅数据格式
-   * @returns 平台特定订阅数据
-   */
-  mapUnifiedToPlatformSubscription(data: Partial<UnifiedSubscriptionDTO>): any;
-
-  /**
-   * 获取订阅列表
-   */
-  getSubscriptions(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedSubscriptionDTO>>;
-
-  /**
-   * 获取所有订阅
-   */
-  getAllSubscriptions(params?: UnifiedSearchParamsDTO): Promise<UnifiedSubscriptionDTO[]>;
-
-  // ========== 产品变体映射方法 ==========
-  /**
-   * 将平台产品变体数据转换为统一产品变体数据格式
-   * @param data 平台特定产品变体数据
-   * @returns 统一产品变体数据格式
-   */
-  mapPlatformToUnifiedVariation(data: any): UnifiedProductVariationDTO;
-
-  /**
-   * 将统一产品变体数据格式转换为平台产品变体数据
-   * @param data 统一产品变体数据格式
-   * @returns 平台特定产品变体数据
-   */
-  mapUnifiedToPlatformVariation(data: Partial<UnifiedProductVariationDTO>): any;
-
-  /**
-   * 将统一产品变体创建参数转换为平台产品变体创建参数
-   * @param data 统一产品变体创建参数
-   * @returns 平台产品变体创建参数
-   */
-  mapCreateVariationParams(data: CreateVariationDTO): any;
-
-  /**
-   * 将统一产品变体更新参数转换为平台产品变体更新参数
-   * @param data 统一产品变体更新参数
-   * @returns 平台产品变体更新参数
-   */
-  mapUpdateVariationParams(data: UpdateVariationDTO): any;
-
-  /**
-   * 获取单个产品变体
-   */
-  getVariation(productId: string | number, variationId: string | number): Promise<UnifiedProductVariationDTO>;
-
-  /**
-   * 获取产品变体列表
-   */
-  getVariations(productId: string | number, params: UnifiedSearchParamsDTO): Promise<UnifiedVariationPaginationDTO>;
-
-  /**
-   * 获取所有产品变体
-   */
-  getAllVariations(productId: string | number, params?: UnifiedSearchParamsDTO): Promise<UnifiedProductVariationDTO[]>;
-
-  /**
-   * 创建产品变体
-   */
-  createVariation(productId: string | number, data: CreateVariationDTO): Promise<UnifiedProductVariationDTO>;
-
-  /**
-   * 更新产品变体
-   */
-  updateVariation(productId: string | number, variationId: string | number, data: UpdateVariationDTO): Promise<UnifiedProductVariationDTO>;
-
-  /**
-   * 删除产品变体
-   */
-  deleteVariation(productId: string | number, variationId: string | number): Promise<boolean>;
-
-  // ========== Webhook映射方法 ==========
-  /**
-   * 将平台Webhook数据转换为统一Webhook数据格式
-   * @param data 平台特定Webhook数据
-   * @returns 统一Webhook数据格式
-   */
-  mapPlatformToUnifiedWebhook(data: any): UnifiedWebhookDTO;
-
-  /**
-   * 将统一Webhook数据格式转换为平台Webhook数据
-   * @param data 统一Webhook数据格式
-   * @returns 平台特定Webhook数据
-   */
-  mapUnifiedToPlatformWebhook(data: Partial<UnifiedWebhookDTO>): any;
-
-  /**
-   * 将统一Webhook创建参数转换为平台Webhook创建参数
-   * @param data 统一Webhook创建参数
-   * @returns 平台Webhook创建参数
-   */
-  mapCreateWebhookParams(data: CreateWebhookDTO): any;
-
-  /**
-   * 将统一Webhook更新参数转换为平台Webhook更新参数
-   * @param data 统一Webhook更新参数
-   * @returns 平台Webhook更新参数
-   */
-  mapUpdateWebhookParams(data: UpdateWebhookDTO): any;
-
-  /**
-   * 获取单个webhook
-   */
-  getWebhook(where: Partial<Pick<UnifiedWebhookDTO, 'id'>>): Promise<UnifiedWebhookDTO>;
-
-  /**
-   * 获取webhooks列表
-   */
-  getWebhooks(params: UnifiedSearchParamsDTO): Promise<UnifiedWebhookPaginationDTO>;
-
-  /**
-   * 获取所有webhooks
-   */
-  getAllWebhooks(params?: UnifiedSearchParamsDTO): Promise<UnifiedWebhookDTO[]>;
-
-  /**
-   * 创建webhook
-   */
-  createWebhook(data: CreateWebhookDTO): Promise<UnifiedWebhookDTO>;
-
-  /**
-   * 更新webhook
-   */
-  updateWebhook(where: Partial<Pick<UnifiedWebhookDTO, 'id'>>, data: UpdateWebhookDTO): Promise<UnifiedWebhookDTO>;
-
-  /**
-   * 删除webhook
-   */
-  deleteWebhook(where: Partial<Pick<UnifiedWebhookDTO, 'id'>>): Promise<boolean>;
-
-  // ========== 站点/其他方法 ==========
-  /**
-   * 获取站点链接列表
-   */
-  getLinks(): Promise<Array<{ title: string, url: string }>>;
+   // ========== 客户映射方法 ==========
+   /**
+    * 将平台客户数据转换为统一客户数据格式
+    * @param data 平台特定客户数据
+    * @returns 统一客户数据格式
+    */
+   mapPlatformToUnifiedCustomer(data: any): UnifiedCustomerDTO;
+
+   /**
+    * 将统一客户数据格式转换为平台客户数据
+    * @param data 统一客户数据格式
+    * @returns 平台特定客户数据
+    */
+   mapUnifiedToPlatformCustomer(data: Partial<UnifiedCustomerDTO>): any;
+
+   /**
+    * 获取单个客户
+    */
+   getCustomer(where: Partial<Pick<UnifiedCustomerDTO, 'id' | 'email' | 'phone'>>): Promise<UnifiedCustomerDTO>;
+
+   /**
+    * 获取客户列表
+    */
+   getCustomers(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedCustomerDTO>>;
+
+   /**
+    * 获取所有客户
+    */
+   getAllCustomers(params?: UnifiedSearchParamsDTO): Promise<UnifiedCustomerDTO[]>;
+
+   /**
+    * 创建客户
+    */
+   createCustomer(data: Partial<UnifiedCustomerDTO>): Promise<UnifiedCustomerDTO>;
+
+   /**
+    * 更新客户
+    */
+   updateCustomer(where: Partial<Pick<UnifiedCustomerDTO, 'id' | 'email' | 'phone'>>, data: Partial<UnifiedCustomerDTO>): Promise<UnifiedCustomerDTO>;
+
+   /**
+    * 删除客户
+    */
+   deleteCustomer(where: Partial<Pick<UnifiedCustomerDTO, 'id' | 'email' | 'phone'>>): Promise<boolean>;
+
+   /**
+    * 批量处理客户
+    */
+   batchProcessCustomers?(data: BatchOperationDTO): Promise<BatchOperationResultDTO>;
+
+   // ========== 媒体映射方法 ==========
+   /**
+    * 将平台媒体数据转换为统一媒体数据格式
+    * @param data 平台特定媒体数据
+    * @returns 统一媒体数据格式
+    */
+   mapPlatformToUnifiedMedia(data: any): UnifiedMediaDTO;
+
+   /**
+    * 将统一媒体数据格式转换为平台媒体数据
+    * @param data 统一媒体数据格式
+    * @returns 平台特定媒体数据
+    */
+   mapUnifiedToPlatformMedia(data: Partial<UnifiedMediaDTO>): any;
+
+   /**
+    * 获取媒体列表
+    */
+   getMedia(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedMediaDTO>>;
+
+   /**
+    * 获取所有媒体
+    */
+   getAllMedia(params?: UnifiedSearchParamsDTO): Promise<UnifiedMediaDTO[]>;
+
+   /**
+    * 创建媒体
+    */
+   createMedia(file: any): Promise<UnifiedMediaDTO>;
+
+   // ========== 订单映射方法 ==========
+   /**
+    * 将平台订单数据转换为统一订单数据格式
+    * @param data 平台特定订单数据
+    * @returns 统一订单数据格式
+    */
+   mapPlatformToUnifiedOrder(data: any): UnifiedOrderDTO;
+
+   /**
+    * 将统一订单数据格式转换为平台订单数据
+    * @param data 统一订单数据格式
+    * @returns 平台特定订单数据
+    */
+   mapUnifiedToPlatformOrder(data: Partial<UnifiedOrderDTO>): any;
+
+   /**
+    * 将统一订单创建参数转换为平台订单创建参数
+    * @param data 统一订单创建参数
+    * @returns 平台订单创建参数
+    */
+   mapCreateOrderParams(data: Partial<UnifiedOrderDTO>): any;
+
+   /**
+    * 将统一订单更新参数转换为平台订单更新参数
+    * @param data 统一订单更新参数
+    * @returns 平台订单更新参数
+    */
+   mapUpdateOrderParams(data: Partial<UnifiedOrderDTO>): any;
+
+   /**
+    * 获取单个订单
+    */
+   getOrder(where: Partial<Pick<UnifiedOrderDTO, 'id'>>): Promise<UnifiedOrderDTO>;
+
+   /**
+    * 获取订单列表
+    */
+   getOrders(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedOrderDTO>>;
+
+   /**
+    * 获取所有订单
+    */
+   getAllOrders(params?: UnifiedSearchParamsDTO): Promise<UnifiedOrderDTO[]>;
+
+   /**
+    * 获取订单总数
+    */
+   countOrders(params: Record<string, any>): Promise<number>;
+
+   /**
+    * 创建订单
+    */
+   createOrder(data: Partial<UnifiedOrderDTO>): Promise<UnifiedOrderDTO>;
+
+   /**
+    * 更新订单
+    */
+   updateOrder(where: Partial<Pick<UnifiedOrderDTO, 'id'>>, data: Partial<UnifiedOrderDTO>): Promise<boolean>;
+
+   /**
+    * 删除订单
+    */
+   deleteOrder(where: Partial<Pick<UnifiedOrderDTO, 'id'>>): Promise<boolean>;
+
+   /**
+    * 获取订单备注
+    */
+   getOrderNotes(orderId: string | number): Promise<any[]>;
+
+   /**
+    * 创建订单备注
+    */
+   createOrderNote(orderId: string | number, data: any): Promise<any>;
+
+   /**
+    * 取消订单履行
+    */
+   cancelFulfillment(orderId: string | number, data: {
+      reason?: string;
+      shipment_id?: string;
+   }): Promise<any>;
+
+   /**
+    * 获取订单履行信息
+    */
+   getOrderFulfillments(orderId: string | number): Promise<any[]>;
+
+   /**
+    * 创建订单履行信息
+    */
+   createOrderFulfillment(orderId: string | number, data: {
+      tracking_number: string;
+      shipping_provider: string;
+      shipping_method?: string;
+      status?: string;
+      date_created?: string;
+      items?: Array<{
+         order_item_id: number;
+         quantity: number;
+      }>;
+   }): Promise<any>;
+
+   /**
+    * 更新订单履行信息
+    */
+   updateOrderFulfillment(orderId: string | number, fulfillmentId: string, data: {
+      tracking_number?: string;
+      shipping_provider?: string;
+      shipping_method?: string;
+      status?: string;
+      date_created?: string;
+      items?: Array<{
+         order_item_id: number;
+         quantity: number;
+      }>;
+   }): Promise<any>;
+
+   /**
+    * 删除订单履行信息
+    */
+   deleteOrderFulfillment(orderId: string | number, fulfillmentId: string): Promise<boolean>;
+
+   /**
+    * 批量处理订单
+    */
+   batchProcessOrders?(data: BatchOperationDTO): Promise<BatchOperationResultDTO>;
+
+   // ========== 产品映射方法 ==========
+   /**
+    * 将平台产品数据转换为统一产品数据格式
+    * @param data 平台特定产品数据
+    * @returns 统一产品数据格式
+    */
+   mapPlatformToUnifiedProduct(data: any): UnifiedProductDTO;
+
+   /**
+    * 将统一产品数据格式转换为平台产品数据
+    * @param data 统一产品数据格式
+    * @returns 平台特定产品数据
+    */
+   mapUnifiedToPlatformProduct(data: Partial<UnifiedProductDTO>): any;
+
+   /**
+    * 将统一产品创建参数转换为平台产品创建参数
+    * @param data 统一产品创建参数
+    * @returns 平台产品创建参数
+    */
+   mapCreateProductParams(data: Partial<UnifiedProductDTO>): any;
+
+   /**
+    * 将统一产品更新参数转换为平台产品更新参数
+    * @param data 统一产品更新参数
+    * @returns 平台产品更新参数
+    */
+   mapUpdateProductParams(data: Partial<UnifiedProductDTO>): any;
+
+   /**
+    * 获取单个产品
+    */
+   getProduct(where: Partial<Pick<UnifiedProductDTO, 'id' | 'sku'>>): Promise<UnifiedProductDTO>;
+
+   /**
+    * 获取产品列表
+    */
+   getProducts(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedProductDTO>>;
+
+   /**
+    * 获取所有产品
+    */
+   getAllProducts(params?: UnifiedSearchParamsDTO): Promise<UnifiedProductDTO[]>;
+
+   /**
+    * 创建产品
+    */
+   createProduct(data: Partial<UnifiedProductDTO>): Promise<UnifiedProductDTO>;
+
+   /**
+    * 更新产品
+    */
+   updateProduct(where: Partial<Pick<UnifiedProductDTO, 'id' | 'sku'>>, data: Partial<UnifiedProductDTO>): Promise<boolean>;
+
+   /**
+    * 删除产品
+    */
+   deleteProduct(where: Partial<Pick<UnifiedProductDTO, 'id' | 'sku'>>): Promise<boolean>;
+
+   /**
+    * 批量处理产品
+    */
+   batchProcessProducts?(data: BatchOperationDTO): Promise<BatchOperationResultDTO>;
+
+   // ========== 评论映射方法 ==========
+   /**
+    * 将平台评论数据转换为统一评论数据格式
+    * @param data 平台特定评论数据
+    * @returns 统一评论数据格式
+    */
+   mapPlatformToUnifiedReview(data: any): UnifiedReviewDTO;
+
+   /**
+    * 将统一评论数据格式转换为平台评论数据
+    * @param data 统一评论数据格式
+    * @returns 平台特定评论数据
+    */
+   mapUnifiedToPlatformReview(data: Partial<UnifiedReviewDTO>): any;
+
+   /**
+    * 将统一评论创建参数转换为平台评论创建参数
+    * @param data 统一评论创建参数
+    * @returns 平台评论创建参数
+    */
+   mapCreateReviewParams(data: CreateReviewDTO): any;
+
+   /**
+    * 将统一评论更新参数转换为平台评论更新参数
+    * @param data 统一评论更新参数
+    * @returns 平台评论更新参数
+    */
+   mapUpdateReviewParams(data: UpdateReviewDTO): any;
+
+   /**
+    * 获取评论列表
+    */
+   getReviews(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedReviewDTO>>;
+
+   /**
+    * 获取所有评论
+    */
+   getAllReviews(params?: UnifiedSearchParamsDTO): Promise<UnifiedReviewDTO[]>;
+
+   /**
+    * 创建评论
+    */
+   createReview(data: CreateReviewDTO): Promise<UnifiedReviewDTO>;
+
+   /**
+    * 更新评论
+    */
+   updateReview(where: Partial<Pick<UnifiedReviewDTO, 'id'>>, data: UpdateReviewDTO): Promise<UnifiedReviewDTO>;
+
+   /**
+    * 删除评论
+    */
+   deleteReview(where: Partial<Pick<UnifiedReviewDTO, 'id'>>): Promise<boolean>;
+
+   // ========== 订阅映射方法 ==========
+   /**
+    * 将平台订阅数据转换为统一订阅数据格式
+    * @param data 平台特定订阅数据
+    * @returns 统一订阅数据格式
+    */
+   mapPlatformToUnifiedSubscription(data: any): UnifiedSubscriptionDTO;
+
+   /**
+    * 将统一订阅数据格式转换为平台订阅数据
+    * @param data 统一订阅数据格式
+    * @returns 平台特定订阅数据
+    */
+   mapUnifiedToPlatformSubscription(data: Partial<UnifiedSubscriptionDTO>): any;
+
+   /**
+    * 获取订阅列表
+    */
+   getSubscriptions(params: UnifiedSearchParamsDTO): Promise<UnifiedPaginationDTO<UnifiedSubscriptionDTO>>;
+
+   /**
+    * 获取所有订阅
+    */
+   getAllSubscriptions(params?: UnifiedSearchParamsDTO): Promise<UnifiedSubscriptionDTO[]>;
+
+   // ========== 产品变体映射方法 ==========
+   /**
+    * 将平台产品变体数据转换为统一产品变体数据格式
+    * @param data 平台特定产品变体数据
+    * @returns 统一产品变体数据格式
+    */
+   mapPlatformToUnifiedVariation(data: any): UnifiedProductVariationDTO;
+
+   /**
+    * 将统一产品变体数据格式转换为平台产品变体数据
+    * @param data 统一产品变体数据格式
+    * @returns 平台特定产品变体数据
+    */
+   mapUnifiedToPlatformVariation(data: Partial<UnifiedProductVariationDTO>): any;
+
+   /**
+    * 将统一产品变体创建参数转换为平台产品变体创建参数
+    * @param data 统一产品变体创建参数
+    * @returns 平台产品变体创建参数
+    */
+   mapCreateVariationParams(data: CreateVariationDTO): any;
+
+   /**
+    * 将统一产品变体更新参数转换为平台产品变体更新参数
+    * @param data 统一产品变体更新参数
+    * @returns 平台产品变体更新参数
+    */
+   mapUpdateVariationParams(data: UpdateVariationDTO): any;
+
+   /**
+    * 获取单个产品变体
+    */
+   getVariation(productId: string | number, variationId: string | number): Promise<UnifiedProductVariationDTO>;
+
+   /**
+    * 获取产品变体列表
+    */
+   getVariations(productId: string | number, params: UnifiedSearchParamsDTO): Promise<UnifiedVariationPaginationDTO>;
+
+   /**
+    * 获取所有产品变体
+    */
+   getAllVariations(productId: string | number, params?: UnifiedSearchParamsDTO): Promise<UnifiedProductVariationDTO[]>;
+
+   /**
+    * 创建产品变体
+    */
+   createVariation(productId: string | number, data: CreateVariationDTO): Promise<UnifiedProductVariationDTO>;
+
+   /**
+    * 更新产品变体
+    */
+   updateVariation(productId: string | number, variationId: string | number, data: UpdateVariationDTO): Promise<UnifiedProductVariationDTO>;
+
+   /**
+    * 删除产品变体
+    */
+   deleteVariation(productId: string | number, variationId: string | number): Promise<boolean>;
+
+   // ========== Webhook映射方法 ==========
+   /**
+    * 将平台Webhook数据转换为统一Webhook数据格式
+    * @param data 平台特定Webhook数据
+    * @returns 统一Webhook数据格式
+    */
+   mapPlatformToUnifiedWebhook(data: any): UnifiedWebhookDTO;
+
+   /**
+    * 将统一Webhook数据格式转换为平台Webhook数据
+    * @param data 统一Webhook数据格式
+    * @returns 平台特定Webhook数据
+    */
+   mapUnifiedToPlatformWebhook(data: Partial<UnifiedWebhookDTO>): any;
+
+   /**
+    * 将统一Webhook创建参数转换为平台Webhook创建参数
+    * @param data 统一Webhook创建参数
+    * @returns 平台Webhook创建参数
+    */
+   mapCreateWebhookParams(data: CreateWebhookDTO): any;
+
+   /**
+    * 将统一Webhook更新参数转换为平台Webhook更新参数
+    * @param data 统一Webhook更新参数
+    * @returns 平台Webhook更新参数
+    */
+   mapUpdateWebhookParams(data: UpdateWebhookDTO): any;
+
+   /**
+    * 获取单个webhook
+    */
+   getWebhook(where: Partial<Pick<UnifiedWebhookDTO, 'id'>>): Promise<UnifiedWebhookDTO>;
+
+   /**
+    * 获取webhooks列表
+    */
+   getWebhooks(params: UnifiedSearchParamsDTO): Promise<UnifiedWebhookPaginationDTO>;
+
+   /**
+    * 获取所有webhooks
+    */
+   getAllWebhooks(params?: UnifiedSearchParamsDTO): Promise<UnifiedWebhookDTO[]>;
+
+   /**
+    * 创建webhook
+    */
+   createWebhook(data: CreateWebhookDTO): Promise<UnifiedWebhookDTO>;
+
+   /**
+    * 更新webhook
+    */
+   updateWebhook(where: Partial<Pick<UnifiedWebhookDTO, 'id'>>, data: UpdateWebhookDTO): Promise<UnifiedWebhookDTO>;
+
+   /**
+    * 删除webhook
+    */
+   deleteWebhook(where: Partial<Pick<UnifiedWebhookDTO, 'id'>>): Promise<boolean>;
+
+   // ========== 站点/其他方法 ==========
+   /**
+    * 获取站点链接列表
+    */
+   getLinks(): Promise<Array<{ title: string, url: string }>>;
 }