feat(admin): 集成1688分销严选商品功能

- 添加1688分销严选商品相关路由配置
- 新增AlibabaAgentBaseService基础服务类，提供OAuth 2.0认证和API请求功能
- 实现ProductService商品服务类，支持商品搜索和详情查询
- 添加AdminController商品控制器，提供商品列表和详情接口
- 配置1688分销严选相关第三方配置参数
- 实现1688 API签名算法和参数格式化处理逻辑
- 添加完整的错误处理和日志记录机制

app/controller/admin/alibaba/Goods.php

@@ -0,0 +1,110 @@
+<?php
+
+namespace app\controller\admin\alibaba;
+
+use app\services\ThirdParty\AlibabaAgent\ProductService;
+
+/**
+ * 1688分销严选 - 商品管理
+ *
+ * API文档:
+ *   商品列表: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.fenxiao%3Ajxhy.product.getPageList-1
+ *   商品详情: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.fenxiao%3Aalibaba.fenxiao.productInfo.get-1
+ */
+class Goods
+{
+    /**
+     * 获取1688分销商品分页列表
+     *
+     * @param ProductService $productService
+     * @return \think\response\Json
+     *
+     * @api {GET} /admin/alibaba/goods/lst 获取商品列表
+     * @apiParam {string}  [access_token]  1688 access_token（不传则使用配置中的默认token）
+     * @apiParam {int}     [page=1]        页码
+     * @apiParam {int}     [limit=20]      每页条数（最大50）
+     * @apiParam {string}  [keyword]       关键词搜索
+     * @apiParam {int}     [categoryId]    类目ID
+     * @apiParam {number}  [minPrice]      最低价格
+     * @apiParam {number}  [maxPrice]      最高价格
+     * @apiParam {string}  [sort]          排序方式
+     */
+    public function lst(ProductService $productService)
+    {
+        $request = app('request');
+
+        // 获取请求参数
+        $page = (int)$request->param('page', 1);
+        $limit = (int)$request->param('limit', 20);
+        $keyword = $request->param('keyword', '');
+        $categoryId = $request->param('categoryId', '');
+        $minPrice = $request->param('minPrice', '');
+        $maxPrice = $request->param('maxPrice', '');
+        $sort = $request->param('sort', '');
+
+        // 构建搜索参数
+        $params = [
+            'page' => max(1, $page),
+            'limit' => min(max(1, $limit), 50),
+        ];
+
+        if (!empty($keyword)) {
+            $params['keyword'] = $keyword;
+        }
+
+        if (!empty($categoryId)) {
+            $params['categoryId'] = (int)$categoryId;
+        }
+
+        if ($minPrice !== '' && $minPrice > 0) {
+            $params['minPrice'] = (float)$minPrice;
+        }
+
+        if ($maxPrice !== '' && $maxPrice > 0) {
+            $params['maxPrice'] = (float)$maxPrice;
+        }
+
+        if (!empty($sort)) {
+            $params['sort'] = $sort;
+        }
+
+        // 调用1688 API获取商品列表
+        $result = $productService->searchProducts($params);
+
+        if ($result === false) {
+            return app('json')->fail('获取1688商品列表失败，请查看日志');
+        }
+
+        return app('json')->success($result);
+    }
+
+    /**
+     * 获取1688分销商品详情
+     *
+     * @param ProductService $productService
+     * @return \think\response\Json
+     *
+     * @api {GET} /admin/alibaba/goods/detail 获取商品详情
+     * @apiParam {string}  [access_token]  1688 access_token（不传则使用配置中的默认token）
+     * @apiParam {int}     productId       1688商品ID（必填）
+     */
+    public function detail(ProductService $productService)
+    {
+        $request = app('request');
+
+        $productId = $request->param('productId', '');
+
+        if (empty($productId)) {
+            return app('json')->fail('参数错误：productId不能为空');
+        }
+
+        // 调用1688 API获取商品详情
+        $result = $productService->getProductDetail($productId);
+
+        if ($result === false) {
+            return app('json')->fail('获取1688商品详情失败，请查看日志');
+        }
+
+        return app('json')->success($result);
+    }
+}

app/services/ThirdParty/AlibabaAgent/AlibabaAgentBaseService.php

@@ -0,0 +1,449 @@
+<?php
+/**
+ * 1688分销严选采购解决方案（分销买家版） - 基础服务类
+ *
+ * 提供OAuth 2.0认证、API请求签名、HTTP请求等基础能力
+ *
+ * @author: yourname
+ * @day: 2026/04/27
+ */
+
+namespace app\services\ThirdParty\AlibabaAgent;
+
+use crmeb\services\HttpService;
+use think\facade\Config;
+use think\facade\Log;
+
+class AlibabaAgentBaseService
+{
+    /** @var array 配置 */
+    protected $config;
+
+    /** @var string App Key */
+    protected $appKey;
+
+    /** @var string App Secret */
+    protected $appSecret;
+
+    /** @var string 网关地址 */
+    protected $gatewayUrl;
+
+    /** @var string 访问令牌 */
+    protected $accessToken = '';
+
+    /** @var string 刷新令牌 */
+    protected $refreshToken = '';
+
+    /**
+     * 构造函数
+     */
+    public function __construct()
+    {
+        $this->config = Config::get('third_party.alibaba_agent', []);
+        $this->appKey = $this->config['appKey'] ?? '';
+        $this->appSecret = $this->config['appSecret'] ?? '';
+        $this->accessToken = $this->config['accessToken'] ?? '';
+        $this->gatewayUrl = $this->config['gatewayUrl'] ?? 'https://gw.open.1688.com/openapi/';
+    }
+
+    /**
+     * 设置访问令牌
+     *
+     * @param string $accessToken
+     * @return $this
+     */
+    public function setAccessToken(string $accessToken): self
+    {
+        $this->accessToken = $accessToken;
+        return $this;
+    }
+
+    /**
+     * 设置刷新令牌
+     *
+     * @param string $refreshToken
+     * @return $this
+     */
+    public function setRefreshToken(string $refreshToken): self
+    {
+        $this->refreshToken = $refreshToken;
+        return $this;
+    }
+
+    /**
+     * 获取访问令牌
+     *
+     * @return string
+     */
+    public function getAccessToken(): string
+    {
+        return $this->accessToken;
+    }
+
+    /**
+     * 获取OAuth 2.0授权URL
+     *
+     * @param string $state 防CSRF状态码
+     * @return string
+     */
+    public function getAuthUrl(string $state = ''): string
+    {
+        $params = [
+            'client_id' => $this->appKey,
+            'redirect_uri' => $this->config['redirectUri'] ?? '',
+            'response_type' => 'code',
+            'state' => $state,
+        ];
+        return 'https://auth.1688.com/oauth/authorize?' . http_build_query($params);
+    }
+
+    /**
+     * 通过授权码获取访问令牌
+     *
+     * @param string $code 授权码
+     * @return array|false
+     */
+    public function getAccessTokenByCode(string $code)
+    {
+        $url = 'https://gw.open.1688.com/openapi/http/1/system.oauth2/getAccessTokenByCode/' . $this->appKey;
+
+        $params = [
+            'code' => $code,
+            'appKey' => $this->appKey,
+            'appSecret' => $this->appSecret,
+            'redirect_uri' => $this->config['redirectUri'] ?? '',
+            'grant_type' => 'authorization_code',
+        ];
+
+        return $this->parseResponse(
+            HttpService::postRequest($url, $params)
+        );
+    }
+
+    /**
+     * 刷新访问令牌
+     *
+     * @param string $refreshToken
+     * @return array|false
+     */
+    public function refreshAccessToken(string $refreshToken)
+    {
+        $url = 'https://gw.open.1688.com/openapi/http/1/system.oauth2/getAccessTokenByCode/' . $this->appKey;
+
+        $params = [
+            'refreshToken' => $refreshToken,
+            'appKey' => $this->appKey,
+            'appSecret' => $this->appSecret,
+            'grant_type' => 'refresh_token',
+        ];
+
+        $result = $this->parseResponse(
+            HttpService::postRequest($url, $params)
+        );
+
+        if ($result && isset($result['access_token'])) {
+            $this->setAccessToken($result['access_token']);
+            if (isset($result['refresh_token'])) {
+                $this->setRefreshToken($result['refresh_token']);
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * 生成1688 API签名（param2方式）
+     *
+     * 参考可调通的代码：
+     *   $aliParams = array();
+     *   foreach ($code_arr as $key => $val) {
+     *       if (is_array($val)) { $val = json_encode($val); }
+     *       $aliParams[] = $key . $val;
+     *   }
+     *   sort($aliParams);
+     *   $sign_str = join('', $aliParams);
+     *   $sign_str = $param . $apiInfo . $sign_str;
+     *   return strtoupper(bin2hex(hash_hmac("sha1", $sign_str, $appSecret, true)));
+     *
+     * @param string $param 协议前缀，如 "param2/1/"
+     * @param string $apiInfo API路径（含appKey），如 "com.alibaba.fenxiao/jxhy.product.getPageList/6512262"
+     * @param array $params 所有请求参数（含access_token，不含_aop_signature）
+     * @return string
+     */
+    protected function generateSignature(string $param, string $apiInfo, array $params): string
+    {
+        $aliParams = array();
+        foreach ($params as $key => $val) {
+            // 数组参数需要json_encode
+            if (is_array($val)) {
+                $val = json_encode($val);
+            }
+            $aliParams[] = $key . $val;
+        }
+        sort($aliParams);
+        $sign_str = join('', $aliParams);
+        // 注意顺序: param + apiInfo + 参数拼装
+        $sign_str = $param . $apiInfo . $sign_str;
+        
+        return strtoupper(bin2hex(hash_hmac("sha1", $sign_str, $this->appSecret, true)));
+    }
+
+    /**
+     * 执行API请求（param2方式 - RESTful风格）
+     *
+     * @param string $namespace API命名空间
+     * @param string $name API名称
+     * @param int $version API版本号
+     * @param array $businessParams 业务参数
+     * @return array|false
+     */
+    protected function executeParam2(
+        string $namespace,
+        string $name,
+        int $version = 1,
+        array $businessParams = []
+    ) {
+        // param2方式URL格式: https://gw.open.1688.com/openapi/param2/{version}/{namespace}/{name}/{appKey}
+        // 注意: URL路径最后一部分是 appKey，不是API版本号
+        $appKey = $this->getConfig('appKey', '');
+        
+        // 协议前缀: param2/{version}/
+        $param = 'param2/' . $version . '/';
+        
+        // API路径（含appKey）: {namespace}/{name}/{appKey}
+        $apiInfo = $namespace . '/' . $name . '/' . $appKey;
+        
+        // 完整URL（不含query参数，参数通过POST body发送）
+        $url = rtrim($this->gatewayUrl, '/') . '/' . $param . $apiInfo;
+
+        // 所有参数（包括access_token和业务参数）
+        $allParams = array_merge(
+            ['access_token' => $this->accessToken],
+            $businessParams
+        );
+
+        // 生成签名
+        // 注意: generateSignature($param, $apiInfo, $params)
+        // sign_str = $param . $apiInfo . 参数拼装
+        $signature = $this->generateSignature($param, $apiInfo, $allParams);
+        $allParams['_aop_signature'] = $signature;
+
+        $this->logRequest($url, $allParams);
+
+        try {
+            // 使用POST方式发送请求，参数放在POST body中（参考可调通的代码）
+            $ch = curl_init();
+            curl_setopt($ch, CURLOPT_URL, $url);
+            curl_setopt($ch, CURLOPT_POST, true);
+            curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($allParams));
+            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+            curl_setopt($ch, CURLOPT_TIMEOUT, 15);
+            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+            curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+            curl_setopt($ch, CURLOPT_FAILONERROR, false);
+            $response = curl_exec($ch);
+            $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+            $curlError = curl_error($ch);
+            curl_close($ch);
+
+            if ($response === false) {
+                $this->logError('HTTP请求失败', $curlError ?: '未知curl错误');
+                return false;
+            }
+
+            $this->logResponse($url, $response);
+
+            return $this->parseResponse($response, $httpCode);
+        } catch (\Exception $e) {
+            $this->logError('API请求异常', $e->getMessage());
+            return false;
+        }
+    }
+
+    /**
+     * 执行API请求（http方式 - 传统POST方式）
+     *
+     * @param string $namespace API命名空间
+     * @param string $name API名称
+     * @param int $version API版本号
+     * @param array $businessParams 业务参数
+     * @return array|false
+     */
+    protected function executeHttp(
+        string $namespace,
+        string $name,
+        int $version = 1,
+        array $businessParams = []
+    ) {
+        // 构建URL: https://gw.open.1688.com/openapi/http/1/cn.alibaba.open/offer.get/1
+        $url = rtrim($this->gatewayUrl, '/') . '/http/' . $version . '/' . $namespace . '/' . $name . '/' . $version;
+
+        // 构建请求参数
+        $params = [
+            'access_token' => $this->accessToken,
+            'appKey' => $this->appKey,
+            'appSecret' => $this->appSecret,
+        ];
+
+        // 业务参数
+        if (!empty($businessParams)) {
+            $params = array_merge($params, $businessParams);
+        }
+
+        $this->logRequest($url, $params);
+
+        try {
+            $response = HttpService::postRequest($url, $params);
+
+            $this->logResponse($url, $response);
+
+            return $this->parseResponse($response);
+        } catch (\Exception $e) {
+            $this->logError('API请求异常', $e->getMessage());
+            return false;
+        }
+    }
+
+    /**
+     * 解析响应
+     *
+     * @param string|false $response 响应体
+     * @param int $httpCode HTTP状态码
+     * @return array|false
+     */
+    protected function parseResponse($response, int $httpCode = 200)
+    {
+        if ($response === false || empty($response)) {
+            $this->logError('HTTP请求失败', '响应为空或请求失败');
+            return false;
+        }
+
+        $result = json_decode($response, true);
+
+        if (json_last_error() !== JSON_ERROR_NONE) {
+            $this->logError('JSON解析失败', json_last_error_msg() . ' | 原始响应: ' . substr($response, 0, 500));
+            return false;
+        }
+
+        // HTTP状态码非200，记录错误并返回false
+        if ($httpCode !== 200) {
+            $errorMsg = json_encode($result, JSON_UNESCAPED_UNICODE);
+            $this->logError("HTTP请求失败(status:{$httpCode})", $errorMsg);
+            return false;
+        }
+
+        // 检查1688 API标准错误格式
+        if (isset($result['error_code']) || isset($result['errorMessage'])) {
+            $errorMsg = $result['errorMessage'] ?? ($result['error_message'] ?? '未知错误');
+            $errorCode = $result['error_code'] ?? ($result['code'] ?? 0);
+            $this->logError('1688 API错误', "[{$errorCode}] {$errorMsg}");
+            return false;
+        }
+
+        // 检查result中的错误
+        if (isset($result['result']) && isset($result['result']['errorCode'])) {
+            $errorMsg = $result['result']['errorMessage'] ?? '未知错误';
+            $errorCode = $result['result']['errorCode'];
+            $this->logError('1688 API业务错误', "[{$errorCode}] {$errorMsg}");
+            return false;
+        }
+
+        // 检查alibaba标准错误响应格式
+        if (isset($result['errorResponse']) && isset($result['errorResponse']['code'])) {
+            $errorMsg = $result['errorResponse']['message'] ?? '未知错误';
+            $errorCode = $result['errorResponse']['code'];
+            $this->logError('1688 API错误响应', "[{$errorCode}] {$errorMsg}");
+            return false;
+        }
+
+        return $result;
+    }
+
+    /**
+     * 记录请求日志
+     *
+     * @param string $url
+     * @param array $params
+     */
+    protected function logRequest(string $url, array $params): void
+    {
+        if (!($this->config['logEnabled'] ?? false)) {
+            return;
+        }
+
+        $logData = [
+            'url' => $url,
+            'params' => $this->maskSensitiveData($params),
+        ];
+
+        Log::info('[1688分销采购] 请求: ' . json_encode($logData, JSON_UNESCAPED_UNICODE));
+    }
+
+    /**
+     * 记录响应日志
+     *
+     * @param string $url
+     * @param string|false $response
+     */
+    protected function logResponse(string $url, $response): void
+    {
+        if (!($this->config['logEnabled'] ?? false)) {
+            return;
+        }
+
+        Log::info('[1688分销采购] 响应: ' . substr((string)$response, 0, 2000));
+    }
+
+    /**
+     * 记录错误日志
+     *
+     * @param string $title
+     * @param string $message
+     */
+    protected function logError(string $title, string $message): void
+    {
+        Log::error("[1688分销采购] {$title}: {$message}");
+
+        // 同时写入文件日志
+        $logPath = $this->config['logPath'] ?? runtime_path() . 'alibaba/';
+        $logFile = $logPath . 'error_' . date('Y-m-d') . '.log';
+        $logDir = dirname($logFile);
+        if (!is_dir($logDir)) {
+            @mkdir($logDir, 0755, true);
+        }
+        @file_put_contents(
+            $logFile,
+            '[' . date('Y-m-d H:i:s') . "] {$title}: {$message}\n",
+            FILE_APPEND
+        );
+    }
+
+    /**
+     * 脱敏敏感数据
+     *
+     * @param array $data
+     * @return array
+     */
+    protected function maskSensitiveData(array $data): array
+    {
+        $sensitiveKeys = ['appSecret', 'access_token', 'refreshToken'];
+        foreach ($data as $key => $value) {
+            if (in_array($key, $sensitiveKeys) && is_string($value)) {
+                $data[$key] = substr($value, 0, 4) . '****' . substr($value, -4);
+            }
+        }
+        return $data;
+    }
+
+    /**
+     * 获取配置项
+     *
+     * @param string $key
+     * @param mixed $default
+     * @return mixed
+     */
+    protected function getConfig(string $key, $default = null)
+    {
+        return $this->config[$key] ?? $default;
+    }
+}

app/services/ThirdParty/AlibabaAgent/ProductService.php

@@ -0,0 +1,349 @@
+<?php
+/**
+ * 1688分销严选采购解决方案 - 商品服务类
+ *
+ * 提供商品搜索/列表查询功能
+ * API文档: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.fenxiao%3Ajxhy.product.getPageList-1&aopApiCategory=category_new
+ *
+ * @author: yourname
+ * @day: 2026/04/27
+ */
+
+namespace app\services\ThirdParty\AlibabaAgent;
+
+class ProductService extends AlibabaAgentBaseService
+{
+    /**
+     * 获取分销商品分页列表
+     *
+     * API: com.alibaba.fenxiao:jxhy.product.getPageList-1
+     *
+     * @param array $params 搜索参数
+     * @return array|false
+     */
+    public function searchProducts(array $params = [])
+    {
+        $businessParams = [];
+
+        // 关键词搜索
+        if (!empty($params['keyword'])) {
+            $businessParams['keyword'] = $params['keyword'];
+        }
+
+        // 类目ID
+        if (!empty($params['categoryId'])) {
+            $businessParams['categoryId'] = $params['categoryId'];
+        }
+
+        // 页码，默认1
+        $businessParams['pageNo'] = $params['page'] ?? 1;
+
+        // 每页条数，最大50
+        $businessParams['pageSize'] = min($params['limit'] ?? 20, 50);
+
+        // 排序方式
+        if (!empty($params['sort'])) {
+            $businessParams['sort'] = $params['sort'];
+        }
+
+        // 最低价格过滤（仅当 > 0 时传入）
+        if (!empty($params['minPrice']) && $params['minPrice'] > 0) {
+            $businessParams['priceStart'] = $params['minPrice'];
+        }
+
+        // 最高价格过滤（仅当 > 0 时传入）
+        if (!empty($params['maxPrice']) && $params['maxPrice'] > 0) {
+            $businessParams['priceEnd'] = $params['maxPrice'];
+        }
+
+        $result = $this->executeParam2(
+            'com.alibaba.fenxiao',
+            'jxhy.product.getPageList',
+            1,
+            $businessParams
+        );
+
+        if ($result === false) {
+            return false;
+        }
+
+        return $this->formatSearchResult($result);
+    }
+
+    /**
+     * 格式化搜索结果
+     *
+     * @param array $result
+     * @return array
+     */
+    protected function formatSearchResult(array $result): array
+    {
+        $productList = [];
+
+        // 1688 API返回结构:
+        // {
+        //   "result": {
+        //     "success": true,
+        //     "code": "0",
+        //     "result": [ {商品1}, {商品2}, ... ],  // 商品列表
+        //     "pageInfo": {
+        //       "currentPage": 1,
+        //       "totalRecords": 2000,
+        //       "pageSize": 10
+        //     }
+        //   }
+        // }
+        $data = $result['result'] ?? $result;
+        $products = $data['result'] ?? [];  // 商品列表在 result.result 中
+        $pageInfo = $data['pageInfo'] ?? [];
+
+        if (empty($products)) {
+            return [
+                'total' => 0,
+                'page' => (int)($pageInfo['currentPage'] ?? 1),
+                'pageSize' => (int)($pageInfo['pageSize'] ?? 20),
+                'list' => [],
+            ];
+        }
+
+        foreach ($products as $product) {
+            $productList[] = $this->formatProduct($product);
+        }
+
+        return [
+            'total' => (int)($pageInfo['totalRecords'] ?? count($productList)),
+            'page' => (int)($pageInfo['currentPage'] ?? 1),
+            'pageSize' => (int)($pageInfo['pageSize'] ?? 20),
+            'list' => $productList,
+        ];
+    }
+
+    /**
+     * 格式化商品数据为统一格式
+     *
+     * @param array $product
+     * @return array
+     */
+    public function formatProduct(array $product): array
+    {
+        // 1688分销商品列表API返回字段:
+        // itemId, title, imgUrl, minPrice, maxPrice, salesCnt90d, skuCnt, serviceList
+
+        // 主图
+        $mainImage = $product['imgUrl'] ?? $product['mainImage'] ?? $product['mainPicture'] ?? '';
+
+        // 服务标签
+        $serviceTags = [];
+        if (!empty($product['serviceList'])) {
+            foreach ($product['serviceList'] as $service) {
+                $serviceTags[] = $service['name'] ?? '';
+            }
+        }
+
+        return [
+            // 基础信息
+            'productId' => $product['itemId'] ?? $product['productId'] ?? $product['offerId'] ?? $product['id'] ?? 0,
+            'productType' => $product['productType'] ?? '',
+            'categoryId' => $product['categoryId'] ?? $product['catId'] ?? 0,
+            'categoryName' => $product['categoryName'] ?? '',
+
+            // 标题与描述
+            'title' => $product['title'] ?? $product['subject'] ?? $product['name'] ?? '',
+            'description' => $product['description'] ?? $product['detail'] ?? '',
+
+            // 价格信息
+            'price' => $product['minPrice'] ?? $product['price'] ?? $product['offerPrice'] ?? 0,
+            'salePrice' => $product['maxPrice'] ?? $product['salePrice'] ?? $product['price'] ?? 0,
+            'minPrice' => $product['minPrice'] ?? $product['price'] ?? 0,
+            'maxPrice' => $product['maxPrice'] ?? $product['price'] ?? 0,
+
+            // 库存信息（该接口不返回库存，用skuCnt作为参考）
+            'stock' => $product['stock'] ?? $product['totalAvailableStock'] ?? 0,
+            'unit' => $product['unit'] ?? '件',
+
+            // 图片信息
+            'mainImage' => $mainImage,
+            'imageList' => [$mainImage],
+
+            // SKU数量
+            'skuCnt' => $product['skuCnt'] ?? 0,
+
+            // 销售信息
+            'monthSales' => $product['monthSales'] ?? $product['salesCnt90d'] ?? 0,
+            'totalSales' => $product['totalSales'] ?? 0,
+
+            // 服务标签
+            'serviceTags' => $serviceTags,
+
+            // 分销属性
+            'isDistribution' => $product['isDistribution'] ?? false,
+            'isStrictSelected' => $product['isStrictSelected'] ?? false,
+            'distributorPrice' => $product['distributorPrice'] ?? 0,
+
+            // 店铺信息（该接口不返回店铺信息）
+            'shopName' => $product['shopName'] ?? $product['companyName'] ?? '',
+            'shopId' => $product['shopId'] ?? $product['memberId'] ?? '',
+
+            // 链接
+            'detailUrl' => $product['detailUrl'] ?? $product['offerUrl'] ?? '',
+        ];
+    }
+
+    /**
+     * 获取分销商品详情（含SKU、图片等完整信息）
+     *
+     * API: com.alibaba.fenxiao:alibaba.pifatuan.product.detail.list-2
+     * 文档: https://open.1688.com/api/apidocdetail.htm?id=com.alibaba.fenxiao%3Aalibaba.pifatuan.product.detail.list-2
+     *
+     * @param int|string $productId 1688商品ID
+     * @return array|false
+     */
+    public function getProductDetail($productId)
+    {
+        if (empty($productId)) {
+            $this->logError('参数错误', 'productId不能为空');
+            return false;
+        }
+
+        // API要求参数名为 offerIds，类型为 Long[]（数组）
+        $businessParams = [
+            'offerIds' => '[' . $productId . ']',
+        ];
+
+        $result = $this->executeParam2(
+            'com.alibaba.fenxiao',
+            'alibaba.pifatuan.product.detail.list',
+            2,
+            $businessParams
+        );
+
+        if ($result === false) {
+            return false;
+        }
+
+        // 临时：直接返回原始数据，方便查看结构
+        return $result;
+    }
+
+    /**
+     * 格式化商品详情结果
+     *
+     * 1688商品详情API返回结构:
+     * {
+     *   "result": {
+     *     "success": true,
+     *     "code": "0",
+     *     "result": {
+     *       "productInfo": { 商品详细信息 },
+     *       "skuList": [ SKU列表 ],
+     *       "productImgList": [ 图片列表 ]
+     *     }
+     *   }
+     * }
+     *
+     * @param array $result
+     * @return array
+     */
+    protected function formatDetailResult(array $result): array
+    {
+        $data = $result['result'] ?? $result;
+        $detailData = $data['result'] ?? [];
+
+        if (empty($detailData)) {
+            return [];
+        }
+
+        $productInfo = $detailData['productInfo'] ?? $detailData;
+        $skuList = $detailData['skuList'] ?? [];
+        $productImgList = $detailData['productImgList'] ?? [];
+
+        // 格式化SKU
+        $formattedSkus = [];
+        if (!empty($skuList)) {
+            foreach ($skuList as $sku) {
+                $formattedSkus[] = [
+                    'skuId' => $sku['skuId'] ?? '',
+                    'specId' => $sku['specId'] ?? '',
+                    'price' => $sku['price'] ?? $sku['retailPrice'] ?? 0,
+                    'salePrice' => $sku['salePrice'] ?? $sku['price'] ?? 0,
+                    'stock' => $sku['stock'] ?? $sku['availableStock'] ?? 0,
+                    'specName' => $sku['specName'] ?? $sku['name'] ?? '',
+                    'image' => $sku['image'] ?? '',
+                ];
+            }
+        }
+
+        // 格式化图片列表
+        $imageList = [];
+        if (!empty($productImgList)) {
+            foreach ($productImgList as $img) {
+                $url = is_string($img) ? $img : ($img['url'] ?? $img['imgUrl'] ?? '');
+                if (!empty($url)) {
+                    $imageList[] = $url;
+                }
+            }
+        }
+
+        // 主图
+        $mainImage = $productInfo['imgUrl'] ?? $productInfo['mainImage'] ?? $productInfo['mainPicture'] ?? '';
+        if (empty($mainImage) && !empty($imageList)) {
+            $mainImage = $imageList[0];
+        }
+
+        // 服务标签
+        $serviceTags = [];
+        if (!empty($productInfo['serviceList'])) {
+            foreach ($productInfo['serviceList'] as $service) {
+                $serviceTags[] = $service['name'] ?? '';
+            }
+        }
+
+        return [
+            // 基础信息
+            'productId' => $productInfo['itemId'] ?? $productInfo['productId'] ?? $productInfo['offerId'] ?? 0,
+            'productType' => $productInfo['productType'] ?? '',
+            'categoryId' => $productInfo['categoryId'] ?? $productInfo['catId'] ?? 0,
+            'categoryName' => $productInfo['categoryName'] ?? '',
+
+            // 标题与描述
+            'title' => $productInfo['title'] ?? $productInfo['subject'] ?? $productInfo['name'] ?? '',
+            'description' => $productInfo['description'] ?? $productInfo['detail'] ?? '',
+
+            // 价格信息
+            'price' => $productInfo['minPrice'] ?? $productInfo['price'] ?? $productInfo['offerPrice'] ?? 0,
+            'salePrice' => $productInfo['maxPrice'] ?? $productInfo['salePrice'] ?? $productInfo['price'] ?? 0,
+            'minPrice' => $productInfo['minPrice'] ?? $productInfo['price'] ?? 0,
+            'maxPrice' => $productInfo['maxPrice'] ?? $productInfo['price'] ?? 0,
+
+            // 库存信息
+            'stock' => $productInfo['stock'] ?? $productInfo['totalAvailableStock'] ?? 0,
+            'unit' => $productInfo['unit'] ?? '件',
+
+            // 图片信息
+            'mainImage' => $mainImage,
+            'imageList' => $imageList,
+
+            // SKU列表
+            'skuList' => $formattedSkus,
+
+            // 销售信息
+            'monthSales' => $productInfo['monthSales'] ?? $productInfo['salesCnt90d'] ?? 0,
+            'totalSales' => $productInfo['totalSales'] ?? 0,
+
+            // 服务标签
+            'serviceTags' => $serviceTags,
+
+            // 分销属性
+            'isDistribution' => $productInfo['isDistribution'] ?? false,
+            'isStrictSelected' => $productInfo['isStrictSelected'] ?? false,
+            'distributorPrice' => $productInfo['distributorPrice'] ?? 0,
+
+            // 店铺信息
+            'shopName' => $productInfo['shopName'] ?? $productInfo['companyName'] ?? '',
+            'shopId' => $productInfo['shopId'] ?? $productInfo['memberId'] ?? '',
+
+            // 链接
+            'detailUrl' => $productInfo['detailUrl'] ?? $productInfo['offerUrl'] ?? '',
+        ];
+    }
+}

config/third_party.php

@@ -8,5 +8,23 @@ return [
         'adzoneId' => 116174700455,
         // 商品筛选-后台类目ID。用,分割，最大10个
         'cat' => '50016422,50012486,50008164,50002766,50050359,50022703,50000436,50011130,50011277,50020579'
+    ],
+    // 1688分销严选采购解决方案（分销买家版）
+    'alibaba_agent' => [
+        'appKey' => '6512262',
+        'appSecret' => 'uNPRZE7895',
+        'accessToken' => 'dc8eab20-f10f-4688-9e45-9ebfa182c7c2',
+        // 授权回调地址
+        // 'redirectUri' => 'https://yourdomain.com/api/alibaba/callback',
+        // 1688 API网关地址
+        'gatewayUrl' => 'https://gw.open.1688.com/openapi/',
+        // 协议版本
+        'version' => '1',
+        // 分销买家ID（在1688分销平台获取）
+        'distributorId' => '',
+        // 日志开关
+        'logEnabled' => true,
+        // 日志目录
+        'logPath' => runtime_path() . 'alibaba/',
     ]
 ];

route/admin.php

@@ -713,6 +713,13 @@ Route::group(config('admin.api_admin_prefix') . '/', function () {
         Route::get('/gong/category', 'admin.gong.Goods/category');
 
 
+        //1688分销严选商品
+        Route::group('alibaba/goods',function(){
+            Route::get('lst', '/lst')->name('alibabaGoodsLst');
+            Route::get('detail', '/detail')->name('alibabaGoodsDetail');
+        })->prefix('admin.alibaba.Goods');
+
+
         //直播间
         Route::group('broadcast/room', function () {
             Route::get('lst', '/lst')->name('systemBroadcastRoomLst');