@yoooloo42/beat 1.0.16 → 1.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoooloo42/beat",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -22,6 +22,7 @@
   },
   "exports": {
     "./libs/*": "./src/libs/*.js",
+    "./libs/Ali/*": "./src/libs/Ali/*.js",
     "./libs/crypto/*": "./src/libs/crypto/*.js"
   },
   "files": [

package/src/libs/Ali/Carlpate-AppKey.js

@@ -0,0 +1,70 @@
+// 优化后的第二个程序：API签名认证调用方法（AppKey & AppSecret）
+
+import ali from 'aliyun-api-gateway'
+
+/**
+ * 使用阿里云市场 API 网关进行车牌识别 (AppKey & AppSecret 签名认证)
+ * @param {object} para - 参数对象
+ * @param {string} para.imageUrl - 图片的公网 URL
+ * @param {string} [para.appKey] - 可选，AppKey，优先从环境变量 ALIBABA_CLOUD_APP_KEY 获取
+ * @param {string} [para.appSecret] - 可选，AppSecret，优先从环境变量 ALIBABA_CLOUD_APP_SECRET 获取
+ * @returns {Promise<object>} 包含识别结果的对象
+ */
+async function carplate(para) {
+    // 1. **规范:** 优先从环境变量读取 AppKey 和 AppSecret，提高安全性。
+    const appKey = para.appKey || process.env.ALIBABA_CLOUD_APP_KEY;
+    const appSecret = para.appSecret || process.env.ALIBABA_CLOUD_APP_SECRET;
+
+    if (!appKey || !appSecret) {
+        return {
+            code: -1,
+            message: "AppKey 或 AppSecret 缺失，请配置或传入！"
+        };
+    }
+
+    const Client = ali.Client
+    const client = new Client(appKey, appSecret)
+
+    try {
+        const requestUrl = 'https://ocrcp.market.alicloudapi.com/rest/160601/ocr/ocr_vehicle_plate.json'
+
+        // 发起 POST 请求
+        const result = await client.post(requestUrl, {
+            data: {
+                'image': para.imageUrl,
+                'configure': '{"multi_crop":false}'
+            },
+            headers: {
+                accept: 'application/json'
+            }
+        })
+
+        // 2. 检查返回结构，确保结果有效
+        if (result && result.plates && result.plates.length > 0) {
+            return {
+                code: 0,
+                message: "车牌识别成功",
+                result: result.plates[0]
+            }
+        } else {
+            return {
+                code: 1,
+                message: "车牌识别成功，但未检测到有效车牌。",
+                result: null
+            };
+        }
+
+    } catch (err) {
+        // 3. **规范:** 使用 try...catch 捕获错误，并返回非零 code
+        const errorMessage = err.message || err.stack || "未知错误";
+
+        return {
+            code: -1,
+            message: "车牌识别失败：" + errorMessage
+        }
+    }
+}
+
+export default {
+    carplate
+}

package/src/libs/Ali/Carplate-AppCode.js

@@ -0,0 +1,68 @@
+// 优化后的第一个程序：API简单身份认证调用方法（APPCODE）
+
+import ali from 'aliyun-api-gateway'
+
+/**
+ * 使用阿里云市场 API 网关进行车牌识别 (APPCODE 认证)
+ * @param {object} para - 参数对象
+ * @param {string} para.imageUrl - 图片的公网 URL
+ * @param {string} [para.appCode] - 可选，APPCODE，优先从环境变量 ALIBABA_CLOUD_APPCODE 获取
+ * @returns {Promise<object>} 包含识别结果的对象
+ */
+async function carplate(para) {
+    // 1. **规范:** 优先从环境变量读取 APPCODE，提高安全性。
+    const appCode = para.appCode || process.env.ALIBABA_CLOUD_APPCODE;
+
+    if (!appCode) {
+        return {
+            code: -1,
+            message: "APPCODE 缺失，请配置环境变量 ALIBABA_CLOUD_APPCODE 或传入！"
+        };
+    }
+
+    const SimpleClient = ali.SimpleClient
+    const client = new SimpleClient(appCode)
+
+    try {
+        const requestUrl = 'https://ocrcp.market.alicloudapi.com/rest/160601/ocr/ocr_vehicle_plate.json'
+
+        // 发起 POST 请求
+        const result = await client.post(requestUrl, {
+            data: {
+                'image': para.imageUrl,
+                'configure': '{"multi_crop":false}'
+            },
+            headers: {
+                accept: 'application/json'
+            }
+        })
+
+        // 2. 检查返回结构，确保结果有效
+        if (result && result.plates && result.plates.length > 0) {
+            return {
+                code: 0,
+                message: "车牌识别成功",
+                result: result.plates[0]
+            }
+        } else {
+            return {
+                code: 1,
+                message: "车牌识别成功，但未检测到有效车牌。",
+                result: null
+            };
+        }
+
+    } catch (err) {
+        // 3. **规范:** 使用 try...catch 捕获错误，并返回非零 code
+        const errorMessage = err.message || err.stack || "未知错误";
+
+        return {
+            code: -1,
+            message: "车牌识别失败：" + errorMessage
+        }
+    }
+}
+
+export default {
+    carplate
+}

package/src/libs/Ali/Carplate-VIAPI.js

@@ -0,0 +1,85 @@
+// 规范优化后的车牌识别程序 (基于 VIAPI 官方 SDK)
+
+import OcrClient from '@alicloud/ocr20191230'
+import OpenapiClient from '@alicloud/openapi-client'
+import TeaUtil from '@alicloud/tea-util'
+
+/**
+ * 使用阿里云 VIAPI 官方 SDK 进行车牌识别 (AccessKey 认证)
+ * @param {object} para - 参数对象
+ * @param {string} para.imageUrl - 图片的公网 URL
+ * @param {string} [para.accessKeyId] - 可选，AccessKey ID，优先从环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 获取
+ * @param {string} [para.accessKeySecret] - 可选，AccessKey Secret，优先从环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET 获取
+ * @returns {Promise<object>} 包含识别结果的对象
+ */
+async function carplate(para) {
+    // 1. **规范:** 优先从环境变量读取密钥，提高安全性。
+    const accessKeyId = para.accessKeyId || process.env.ALIBABA_CLOUD_ACCESS_KEY_ID || 'YOUR_DEFAULT_ACCESS_KEY_ID';
+    const accessKeySecret = para.accessKeySecret || process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET || 'YOUR_DEFAULT_ACCESS_KEY_SECRET';
+
+    // **注意：生产环境中必须配置环境变量，并移除默认硬编码值！**
+
+    if (!accessKeyId || !accessKeySecret) {
+        throw new Error("AccessKeyId 和 AccessKeySecret 缺失，请配置或传入！");
+    }
+
+    const config = new OpenapiClient.Config({
+        accessKeyId: accessKeyId,
+        accessKeySecret: accessKeySecret
+    });
+
+    // 访问的域名
+    config.endpoint = `ocr.cn-shanghai.aliyuncs.com`;
+    const client = new OcrClient.default(config);
+
+    try {
+        // 2. **规范:** 使用 RecognizeLicensePlateRequest，直接传入 ImageURL 字符串，简化调用
+        let recognizeLicensePlateRequest = new OcrClient.RecognizeLicensePlateRequest({
+            imageURL: para.imageUrl, // 直接传入 URL 字符串
+        });
+
+        let runtime = new TeaUtil.RuntimeOptions({
+            // 可以配置网络超时等参数
+            connectTimeout: 5000,
+            readTimeout: 10000,
+        });
+
+        const response = await client.recognizeLicensePlateWithOptions(recognizeLicensePlateRequest, runtime);
+
+        // 确保结果有效
+        if (response.body && response.body.data && response.body.data.plates && response.body.data.plates.length > 0) {
+            return {
+                code: 0,
+                message: "车牌识别成功",
+                result: response.body.data.plates[0]
+            };
+        } else {
+            return {
+                code: 1,
+                message: "车牌识别成功，但未检测到有效车牌。",
+                result: null
+            };
+        }
+
+    } catch (error) {
+        // 3. **规范:** 使用 try...catch 捕获错误，并 reject 或 throw Error，而不是返回 code: 0。
+
+        // 提取阿里云的错误码和信息
+        const errorCode = error.data ? error.data.Code : 'UNKNOWN_ERROR';
+        const errorMessage = error.message || '未知错误';
+
+        // 统一返回失败信息
+        return {
+            code: -1, // 使用 -1 或其他负值表示系统级/网络级错误
+            message: `车牌识别失败: [${errorCode}] ${errorMessage}`,
+            error: error
+        };
+
+        // 另一种规范是直接 throw Error，让调用方处理
+        // throw new Error(`车牌识别失败: [${errorCode}] ${errorMessage}`);
+    }
+}
+
+export default {
+    carplate
+}