From 9f8814b3ce6ca4be84a6de244987c617be3a51fd Mon Sep 17 00:00:00 2001 From: Calvin <179209347@qq.com> Date: Wed, 22 Mar 2023 11:01:16 +0800 Subject: [PATCH] update comments --- .../aias/service/impl/AudioServiceImpl.java | 3 +- .../aias/service/impl/SearchServiceImpl.java | 2 +- .../face_search-ui/src/router/index.js | 4 +- .../imagesearch/component/image-card.vue | 2 +- .../imagesearch/component/image-table.vue | 16 +- .../src/views/storage/index.vue | 45 +- .../me/aias/common/constant/Constant.java | 3 + .../me/aias/common/constant/Constants.java | 6 +- .../java/me/aias/common/enums/ResEnum.java | 9 +- .../java/me/aias/common/face/FaceUtil.java | 13 +- .../me/aias/common/milvus/ConnectionPool.java | 61 ++- .../common/utils/common/DJLImageUtil.java | 11 +- .../me/aias/common/utils/common/DateUtil.java | 2 + .../me/aias/common/utils/common/FileUtil.java | 68 ++- .../aias/common/utils/common/ImageUtil.java | 11 + .../aias/common/utils/common/NDArrayUtil.java | 11 +- .../me/aias/common/utils/common/SVDUtil.java | 27 +- .../me/aias/common/utils/common/UUIDUtil.java | 1 + .../common/utils/common/UserAgentUtil.java | 4 + .../me/aias/common/utils/common/ZipUtil.java | 1 + .../common/utils/opencv/FaceAlignment.java | 9 +- .../common/utils/opencv/OpenCVImageUtil.java | 7 + .../me/aias/config/ConfigurerAdapter.java | 6 +- .../java/me/aias/config/FileProperties.java | 5 +- .../java/me/aias/config/SwaggerConfig.java | 11 +- .../me/aias/controller/DataController.java | 10 +- .../controller/LocalStorageController.java | 10 +- .../me/aias/controller/SearchController.java | 9 +- .../main/java/me/aias/domain/DataInfo.java | 12 +- .../main/java/me/aias/domain/DataInfoRes.java | 8 +- .../java/me/aias/domain/LocalStorage.java | 12 +- .../src/main/java/me/aias/domain/ResEnum.java | 16 +- .../main/java/me/aias/domain/ResultRes.java | 28 +- .../java/me/aias/service/DataService.java | 7 +- .../java/me/aias/service/DetectService.java | 1 + .../java/me/aias/service/FeatureService.java | 1 + .../me/aias/service/LocalStorageService.java | 4 + .../java/me/aias/service/SearchService.java | 19 + .../me/aias/service/impl/DataServiceImpl.java | 22 +- .../aias/service/impl/DetectServiceImpl.java | 13 + .../aias/service/impl/FeatureServiceImpl.java | 2 + .../service/impl/LocalStorageServiceImpl.java | 7 + .../aias/service/impl/SearchServiceImpl.java | 20 +- .../main/java/me/aias/tools/MilvusInit.java | 6 + .../aias/ocr/configuration/ConfigAdapter.java | 1 + .../aias/ocr/configuration/SwaggerConfig.java | 9 +- .../aias/ocr/controller/InferController.java | 6 +- .../aias/ocr/controller/TableController.java | 12 +- .../ocr/controller/TemplateController.java | 20 +- .../inference/LayoutDetectionTranslator.java | 7 +- .../ocr/inference/PerspectiveRecogition.java | 25 +- .../ocr/inference/TableDetectionModel.java | 4 + .../ocr/inference/TableStructTranslator.java | 8 +- .../service/impl/TableInferServiceImpl.java | 2 + .../ocr/service/impl/TemplateServiceImpl.java | 10 + .../me/aias/ocr/utils/ConvertHtml2Excel.java | 71 +-- .../java/me/aias/ocr/utils/DJLImageUtils.java | 15 +- .../java/me/aias/ocr/utils/DistanceUtils.java | 10 +- .../java/me/aias/ocr/utils/FileUtils.java | 34 +- .../java/me/aias/ocr/utils/NDArrayUtils.java | 10 +- .../java/me/aias/ocr/utils/OpenCVUtils.java | 7 +- .../java/me/aias/ocr/utils/UUIDUtils.java | 1 + 8_suite_hub/iocr/ocr-ui/src/router/index.js | 14 +- .../views/iocr/DrawBoard/components/tool.vue | 4 +- .../iocr/DrawBoard/components/topBar.vue | 12 +- .../ocr-ui/src/views/iocr/DrawBoard/main.vue | 9 +- .../iocr/ocr-ui/src/views/iocr/edit.vue | 14 +- .../iocr/ocr-ui/src/views/iocr/index.vue | 20 +- .../iocr/ocr-ui/src/views/iocr/list.vue | 24 +- .../iocr/ocr-ui/src/views/iocr/tabs.vue | 24 +- .../iocr/ocr-ui/src/views/iocrinfer/index.vue | 26 +- .../iocr/ocr-ui/src/views/table/index.vue | 10 +- .../question_answering_system/README.md | 174 -------- .../question_answering_system/README_cn.md | 186 -------- .../qa-system-ui/.editorconfig | 14 - .../qa-system-ui/.env.development | 6 - .../qa-system-ui/.env.production | 6 - .../qa-system-ui/.env.staging | 8 - .../qa-system-ui/.eslintignore | 4 - .../qa-system-ui/.eslintrc.js | 198 --------- .../qa-system-ui/.travis.yml | 5 - .../qa-system-ui/babel.config.js | 14 - .../qa-system-ui/build/index.js | 35 -- .../qa-system-ui/jest.config.js | 24 -- .../qa-system-ui/jsconfig.json | 9 - .../qa-system-ui/package.json | 65 --- .../qa-system-ui/postcss.config.js | 8 - .../qa-system-ui/public/favicon.ico | Bin 16958 -> 0 bytes .../qa-system-ui/public/index.html | 17 - .../qa-system-ui/src/App.vue | 11 - .../qa-system-ui/src/api/cryptojs.js | 61 --- .../qa-system-ui/src/api/localStorage.js | 46 -- .../qa-system-ui/src/api/search.js | 12 - .../src/assets/404_images/404.png | Bin 98071 -> 0 bytes .../src/assets/404_images/404_cloud.png | Bin 4766 -> 0 bytes .../qa-system-ui/src/assets/styles/base.scss | 55 --- .../qa-system-ui/src/assets/styles/btn.scss | 99 ----- .../src/assets/styles/eladmin.scss | 117 ----- .../src/assets/styles/element-ui.scss | 79 ---- .../src/assets/styles/element-variables.scss | 31 -- .../qa-system-ui/src/assets/styles/index.scss | 182 -------- .../qa-system-ui/src/assets/styles/mixin.scss | 66 --- .../src/assets/styles/sidebar.scss | 209 --------- .../src/assets/styles/transition.scss | 48 --- .../src/assets/styles/variables.scss | 35 -- .../src/common/mixin/table-mixin.js | 40 -- .../src/components/Breadcrumb/index.vue | 78 ---- .../src/components/Hamburger/index.vue | 44 -- .../src/components/SvgIcon/index.vue | 62 --- .../src/components/empty-data/EmptyData.vue | 49 --- .../src/layout/components/AppMain.vue | 40 -- .../src/layout/components/Navbar.vue | 111 ----- .../layout/components/Sidebar/FixiOSBug.js | 26 -- .../src/layout/components/Sidebar/Item.vue | 41 -- .../src/layout/components/Sidebar/Link.vue | 43 -- .../src/layout/components/Sidebar/Logo.vue | 82 ---- .../layout/components/Sidebar/SidebarItem.vue | 95 ---- .../src/layout/components/Sidebar/index.vue | 56 --- .../src/layout/components/index.js | 3 - .../qa-system-ui/src/layout/index.vue | 93 ---- .../src/layout/mixin/ResizeHandler.js | 45 -- .../qa-system-ui/src/main.js | 30 -- .../qa-system-ui/src/permission.js | 27 -- .../qa-system-ui/src/router/index.js | 81 ---- .../qa-system-ui/src/settings.js | 16 - .../qa-system-ui/src/store/getters.js | 8 - .../qa-system-ui/src/store/index.js | 17 - .../qa-system-ui/src/store/modules/app.js | 48 --- .../src/store/modules/settings.js | 32 -- .../qa-system-ui/src/styles/element-ui.scss | 49 --- .../qa-system-ui/src/styles/index.scss | 65 --- .../qa-system-ui/src/styles/mixin.scss | 28 -- .../qa-system-ui/src/styles/sidebar.scss | 226 ---------- .../qa-system-ui/src/styles/transition.scss | 48 --- .../qa-system-ui/src/styles/variables.scss | 25 -- .../qa-system-ui/src/utils/get-page-title.js | 10 - .../qa-system-ui/src/utils/index.js | 147 ------- .../qa-system-ui/src/utils/request.js | 78 ---- .../qa-system-ui/src/utils/validate.js | 16 - .../qa-system-ui/src/views/404.vue | 228 ---------- .../qa-system-ui/src/views/search/index.vue | 77 ---- .../qa-system-ui/src/views/storage/index.vue | 154 ------- .../qa-system-ui/tests/unit/.eslintrc.js | 5 - .../tests/unit/components/Breadcrumb.spec.js | 98 ----- .../tests/unit/components/Hamburger.spec.js | 18 - .../tests/unit/components/SvgIcon.spec.js | 22 - .../tests/unit/utils/formatTime.spec.js | 30 -- .../tests/unit/utils/param2Obj.spec.js | 14 - .../tests/unit/utils/parseTime.spec.js | 35 -- .../tests/unit/utils/validate.spec.js | 17 - .../qa-system-ui/vue.config.js | 121 ------ .../models/Download and put model here.md | 60 --- .../qa-system/pom.xml | 211 --------- .../src/main/java/META-INF/MANIFEST.MF | 3 - .../main/java/me/aias/MainApplication.java | 14 - .../me/aias/common/constant/Constants.java | 18 - .../java/me/aias/common/enums/ResEnum.java | 24 -- .../common/exception/BadRequestException.java | 25 -- .../common/exception/BusinessException.java | 24 -- .../me/aias/common/milvus/ConnectionPool.java | 235 ---------- .../common/sentence/FeatureComparison.java | 37 -- .../common/sentence/SentenceEncoderModel.java | 58 --- .../sentence/SentenceTransTranslator.java | 120 ------ .../java/me/aias/common/utils/FileUtil.java | 351 --------------- .../me/aias/config/ConfigurerAdapter.java | 71 --- .../java/me/aias/config/FileProperties.java | 45 -- .../me/aias/config/ModelConfiguration.java | 29 -- .../java/me/aias/config/SwaggerConfig.java | 95 ---- .../controller/LocalStorageController.java | 76 ---- .../me/aias/controller/SearchController.java | 88 ---- .../me/aias/controller/TextController.java | 114 ----- .../java/me/aias/domain/LocalStorage.java | 54 --- .../src/main/java/me/aias/domain/ResEnum.java | 22 - .../main/java/me/aias/domain/ResultBean.java | 63 --- .../main/java/me/aias/domain/ResultRes.java | 143 ------- .../main/java/me/aias/domain/TextInfoDto.java | 34 -- .../main/java/me/aias/domain/TextInfoRes.java | 30 -- .../java/me/aias/service/FeatureService.java | 18 - .../me/aias/service/LocalStorageService.java | 41 -- .../java/me/aias/service/SearchService.java | 71 --- .../java/me/aias/service/TextService.java | 34 -- .../aias/service/impl/FeatureServiceImpl.java | 39 -- .../service/impl/LocalStorageServiceImpl.java | 119 ----- .../aias/service/impl/SearchServiceImpl.java | 405 ------------------ .../me/aias/service/impl/TextServiceImpl.java | 103 ----- .../src/main/java/me/aias/tools/CsvTest.java | 34 -- .../main/java/me/aias/tools/MilvusInit.java | 108 ----- .../qa-system/src/main/main.iml | 11 - .../src/main/resources/application.yml | 56 --- .../qa-system/src/main/resources/log4j2.xml | 17 - .../qa-system/src/test/resources/example.csv | 161 ------- .../qa-system/src/test/test.iml | 12 - 192 files changed, 661 insertions(+), 8068 deletions(-) delete mode 100644 8_suite_hub/question_answering_system/README.md delete mode 100644 8_suite_hub/question_answering_system/README_cn.md delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.editorconfig delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.env.development delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.env.production delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.env.staging delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.eslintignore delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.eslintrc.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/.travis.yml delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/babel.config.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/build/index.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/jest.config.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/jsconfig.json delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/package.json delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/postcss.config.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/public/favicon.ico delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/public/index.html delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/App.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/api/cryptojs.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/api/localStorage.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/api/search.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/404_images/404.png delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/404_images/404_cloud.png delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/base.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/btn.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/eladmin.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/element-ui.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/element-variables.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/index.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/mixin.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/sidebar.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/transition.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/assets/styles/variables.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/common/mixin/table-mixin.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/components/Breadcrumb/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/components/Hamburger/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/components/SvgIcon/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/components/empty-data/EmptyData.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/AppMain.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Navbar.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Sidebar/FixiOSBug.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Sidebar/Item.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Sidebar/Link.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Sidebar/Logo.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Sidebar/SidebarItem.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/Sidebar/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/components/index.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/layout/mixin/ResizeHandler.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/main.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/permission.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/router/index.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/settings.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/store/getters.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/store/index.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/store/modules/app.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/store/modules/settings.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/styles/element-ui.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/styles/index.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/styles/mixin.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/styles/sidebar.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/styles/transition.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/styles/variables.scss delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/utils/get-page-title.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/utils/index.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/utils/request.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/utils/validate.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/views/404.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/views/search/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/src/views/storage/index.vue delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/.eslintrc.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/components/Breadcrumb.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/components/Hamburger.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/components/SvgIcon.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/utils/formatTime.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/utils/param2Obj.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/utils/parseTime.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/tests/unit/utils/validate.spec.js delete mode 100644 8_suite_hub/question_answering_system/qa-system-ui/vue.config.js delete mode 100644 8_suite_hub/question_answering_system/qa-system/models/Download and put model here.md delete mode 100644 8_suite_hub/question_answering_system/qa-system/pom.xml delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/META-INF/MANIFEST.MF delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/MainApplication.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/constant/Constants.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/enums/ResEnum.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/exception/BadRequestException.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/exception/BusinessException.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/milvus/ConnectionPool.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/sentence/FeatureComparison.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/sentence/SentenceEncoderModel.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/sentence/SentenceTransTranslator.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/common/utils/FileUtil.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/config/ConfigurerAdapter.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/config/FileProperties.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/config/ModelConfiguration.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/config/SwaggerConfig.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/controller/LocalStorageController.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/controller/SearchController.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/controller/TextController.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/domain/LocalStorage.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/domain/ResEnum.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/domain/ResultBean.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/domain/ResultRes.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/domain/TextInfoDto.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/domain/TextInfoRes.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/FeatureService.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/LocalStorageService.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/SearchService.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/TextService.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/impl/FeatureServiceImpl.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/impl/LocalStorageServiceImpl.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/impl/SearchServiceImpl.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/service/impl/TextServiceImpl.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/tools/CsvTest.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/java/me/aias/tools/MilvusInit.java delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/main.iml delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/resources/application.yml delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/main/resources/log4j2.xml delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/test/resources/example.csv delete mode 100644 8_suite_hub/question_answering_system/qa-system/src/test/test.iml diff --git a/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/AudioServiceImpl.java b/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/AudioServiceImpl.java index a4a58c51..6d5ef526 100644 --- a/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/AudioServiceImpl.java +++ b/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/AudioServiceImpl.java @@ -145,8 +145,9 @@ public class AudioServiceImpl implements AudioService { byte[] bytes = FileUtil.getByte(file); String uuid = UUIDUtil.getUUID(); audioInfo.setUuid(uuid); + // 待存储的文件名 // file name to be stored - String fileName = uuid + "." + ext; // 待存储的文件名 + String fileName = uuid + "." + ext; String relativePath = FileUtil.generatePath(rootPath); // filePath 完整路径（含uuid文件名） // filePath complete path (including uuid filename) diff --git a/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/SearchServiceImpl.java b/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/SearchServiceImpl.java index 6a3cae98..f590c424 100644 --- a/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/SearchServiceImpl.java +++ b/7_engine_hub/voiceprint_search/voiceprint-search/src/main/java/me/aias/service/impl/SearchServiceImpl.java @@ -402,7 +402,7 @@ public class SearchServiceImpl implements SearchService { } // 删除向量 - // Search Vector + // Delete Vector // String deleteExpr = ID_FIELD + " in " + deleteIds.toString(); public R delete(String expr) { System.out.println("========== delete() =========="); diff --git a/8_suite_hub/face_search/face_search-ui/src/router/index.js b/8_suite_hub/face_search/face_search-ui/src/router/index.js index 97c530ee..e3017754 100644 --- a/8_suite_hub/face_search/face_search-ui/src/router/index.js +++ b/8_suite_hub/face_search/face_search-ui/src/router/index.js @@ -44,7 +44,7 @@ export const constantRoutes = [ path: 'index', component: () => import('@/views/imagesearch/index'), name: 'storage', - meta: { title: '人脸搜索', icon: 'el-icon-search' } + meta: { title: 'Face Search', icon: 'el-icon-search' } } ] }, @@ -56,7 +56,7 @@ export const constantRoutes = [ path: 'index', component: () => import('@/views/storage/index'), name: 'storage', - meta: { title: '数据管理', icon: 'el-icon-upload' } + meta: { title: 'Data Management', icon: 'el-icon-upload' } } ] }, diff --git a/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-card.vue b/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-card.vue index 2787d9b1..49b9f284 100644 --- a/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-card.vue +++ b/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-card.vue @@ -13,7 +13,7 @@ -
距离 {{ data.score }}
+
Dis {{ data.score }}
{{ data.id }}
diff --git a/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-table.vue b/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-table.vue index a1abf001..c9388a3d 100644 --- a/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-table.vue +++ b/8_suite_hub/face_search/face_search-ui/src/views/imagesearch/component/image-table.vue @@ -2,7 +2,7 @@
- TopK： + TopK： @@ -45,8 +45,8 @@ type="primary" :disabled="!imgUrl" @click="doFaceQuery" - >查询 - 重置 + >Query + Reset
@@ -70,9 +70,9 @@ - +
@@ -159,7 +159,7 @@ export default { }, handleFileChange(file, fileList) { if (fileList[0] && fileList[0].size > 2097152) { - this.$message.warning('请上传小于2M大小的图片') + this.$message.warning('Please upload an image smaller than 2MB in size.') this.$refs.imageUploader.clearFiles() return false } @@ -168,7 +168,7 @@ export default { }, handleUploadBefore(file) { if (file.size > 2097152) { - this.$message.warning('请上传小于2M大小的图片') + this.$message.warning('Please upload an image smaller than 2MB in size.') return false } }, diff --git a/8_suite_hub/face_search/face_search-ui/src/views/storage/index.vue b/8_suite_hub/face_search/face_search-ui/src/views/storage/index.vue index b2ac4f21..f7015b50 100644 --- a/8_suite_hub/face_search/face_search-ui/src/views/storage/index.vue +++ b/8_suite_hub/face_search/face_search-ui/src/views/storage/index.vue @@ -15,16 +15,16 @@ :show-file-list="false" :auto-upload="false" > - 选取文件 + Select 上传 -
文件类型: zip
+ >Upload +
File Type: zip
@@ -41,25 +41,25 @@ {{ scope.row.id }} - + - + - + - + @@ -104,52 +104,43 @@ export default { handleError(file) { this.fullscreenLoading = false }, - // beforeUpload(file) { - // if (file.type !== 'application/zip') { - // this.fullscreenLoading = false - // this.$message.error('文件应为zip格式压缩包!') - // return false - // } else { - // return true - // } - // }, fetchData() { this.listLoading = true getStorageList().then(response => { this.list = response.data this.listLoading = false }).catch(function(response) { - console.log(response)// 发生错误时执行的代码 + console.log(response) }) }, handleDelete(row) { - this.$confirm('此操作将删除设置项，是否继续?', '删除确认', { - confirmButtonText: '确定', - cancelButtonText: '取消', + this.$confirm('This operation will delete the setting, continue?', 'Deletion Confirmation', { + confirmButtonText: 'OK', + cancelButtonText: 'Cancel', type: 'warning' }).then(() => { const id = row.id del(id).then(response => { this.$message({ type: 'success', - message: '删除成功!' + message: 'Deleted successfully!' }) this.fetchData() }) }).catch(() => { - console.log('取消成功') + console.log('Canceled successfully!') }) }, extract(row) { const id = row.id this.$message({ type: 'success', - message: '已开始提取图片特征，请耐心等待。' + message: 'In process,please waiting...' }) extract(id).then(response => { this.$message({ type: 'success', - message: '特征提取成功' + message: 'successfully!' }) }) } diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constant.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constant.java index fb79a77b..0fcd9131 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constant.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constant.java @@ -6,9 +6,12 @@ package me.aias.common.constant; **/ public class Constant { // 上传压缩文件类型 + // Upload compressed file type public static String ZIP_FILE_TYPE = "zip"; // 判断window系统 + // Determine Windows system public static String PC_WINDOW_TYPE = "WINDOWS"; // 判断苹果系统 + // Determine Apple system public static String PC_APPLE_TYPE = "MACOSX"; } diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constants.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constants.java index c2cc51ff..17af6310 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constants.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/constant/Constants.java @@ -2,17 +2,19 @@ package me.aias.common.constant; /** * 常用静态常量 + * Common Constants + * * @author Calvin * @date 2021-12-12 **/ public class Constants { /** - * win 系统 + * win */ public static final String WIN = "win"; /** - * mac 系统 + * mac */ public static final String MAC = "mac"; } diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/enums/ResEnum.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/enums/ResEnum.java index 71015576..ff25882c 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/enums/ResEnum.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/enums/ResEnum.java @@ -4,16 +4,17 @@ import lombok.Getter; /** * 状态枚举 + * Status enumeration * * @author Calvin - * @date 2021-12-12 + * @date 2021-06-20 **/ @Getter public enum ResEnum { SUCCESS("0000", "success"), - ZIP_FILE_FAIL("0001", "压缩包类型错误"), - DECOMPRESSION_FAIL("0002", "压缩包解压异常"), - SYSTEM_ERROR("1001", "内部系统错误"); + ZIP_FILE_FAIL("0001", "Incorrect compression package type"), + DECOMPRESSION_FAIL("0002", "Exception occurred during decompression of the compression package"), + SYSTEM_ERROR("1001", "Internal system error"); public String KEY; public String VALUE; diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/face/FaceUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/face/FaceUtil.java index e3eabe9e..f30a9d75 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/face/FaceUtil.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/face/FaceUtil.java @@ -8,13 +8,18 @@ import java.util.List; public class FaceUtil { - /** 返回外扩100%人脸 factor = 1, 100%, factor = 0.2, 20% */ + /** + * 返回外扩100%人脸 factor = 1, 100%, factor = 0.2, 20% + * Returns 100% expansion of face, factor = 1, 100%, factor = 0.2, 20% + * */ public static Rectangle getSubImageRect( BufferedImage image, Rectangle rectangle, int width, int height, float factor) { // 左上角坐标 + //Top left coordinate int x1 = (int) (rectangle.getX() * width); int y1 = (int) (rectangle.getY() * height); // 宽度，高度 + //Width, height int w = (int) (rectangle.getWidth() * width); int h = (int) (rectangle.getHeight() * height); // 左上角坐标 @@ -24,6 +29,7 @@ public class FaceUtil { // drawImageRect(image, x1, y1, w, h); // 外扩大100%，防止对齐后人脸出现黑边 + //Expand by 100% to prevent black edges after alignment int new_x1 = Math.max((int) (x1 + x1 * factor / 2 - x2 * factor / 2), 0); int new_x2 = Math.min((int) (x2 + x2 * factor / 2 - x1 * factor / 2), width - 1); int new_y1 = Math.max((int) (y1 + y1 * factor / 2 - y2 * factor / 2), 0); @@ -47,12 +53,15 @@ public class FaceUtil { int x = (int) (subImageRect.getX()); int y = (int) (subImageRect.getY()); // 图中关键点坐标 + // Expand by 60% of face // 1. left_eye_x , left_eye_y // 2. right_eye_x , right_eye_y // 3. nose_x , nose_y // 4. left_mouth_x , left_mouth_y // 5. right_mouth_x , right_mouth_y - double[][] pointsArray = new double[5][2]; // 保存人脸关键点 + double[][] pointsArray = new double[5][2]; + // 保存人脸关键点 + //Save facial key points for (int i = 0; i < 5; i++) { pointsArray[i][0] = points.get(i).getX() - x; pointsArray[i][1] = points.get(i).getY() - y; diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/milvus/ConnectionPool.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/milvus/ConnectionPool.java index b1567395..b2b02bfd 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/milvus/ConnectionPool.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/milvus/ConnectionPool.java @@ -8,14 +8,14 @@ import java.util.Enumeration; import java.util.Vector; public class ConnectionPool { - private String host = ""; // Milvus 主机 - private int port; // Milvus 端口号 + private String host = ""; // Milvus 主机 - Milvus host + private int port; // Milvus 端口号 - Milvus port private static volatile ConnectionPool uniqueInstance; - private int initialConnections = 10; // 连接池的初始大小 - private int incrementalConnections = 5; // 连接池自动增加的大小 - private int maxConnections = 50; // 连接池最大的大小 + private int initialConnections = 10; // 连接池的初始大小 - initial size of the connection pool + private int incrementalConnections = 5; // 连接池自动增加的大小 - automatic increase in connection pool size + private int maxConnections = 50; // 连接池最大的大小 - maximum size of the connection pool private Vector connections = null; // 存放连接池中连接的向量, 存放的对象为 PooledConnection 型 - + // vector that stores the connections in the connection pool, objects stored are of type PooledConnection private ConnectionPool(String host, int port) { this.host = host; this.port = port; @@ -40,31 +40,39 @@ public class ConnectionPool { private void createPool() { // synchronized if (connections != null) { return; // 假如己经创建，则返回 + // return if the connection pool already exists } // 创建保存连接的向量 , 初始时有 0 个元素 + // create a vector to store the connections, initially with 0 elements connections = new Vector(); // 根据 initialConnections 中设置的值，创建连接。 - + // create connections based on the value set in initialConnections createConnections(this.initialConnections); System.out.println(" Milvus连接池创建成功！"); + System.out.println("Milvus connection pool created successfully!"); } private void createConnections(int numConnections) { // 循环创建指定数目的数据库连接 + // loop to create the specified number of database connections for (int x = 0; x < numConnections; x++) { // 是否连接池中的Milvus连接数量己经达到最大？最大值由类成员 maxConnections + // if the number of Milvus connections in the connection pool has reached the maximum, break the loop. The maximum value is set by the class member maxConnections. if (this.maxConnections > 0 && this.connections.size() >= this.maxConnections) { break; } // 增加一个连接到连接池中（Vector connections） + // add a connection to the connection pool (Vector connections) connections.addElement(new PooledConnection(newConnection())); System.out.println(" Milvus连接己创建 ......"); + System.out.println("Milvus connection created......"); } } private MilvusClient newConnection() { // 创建一个 Milvus 客户端 + // create a Milvus client ConnectParam connectParam = ConnectParam.newBuilder() .withHost(host) .withPort(port) @@ -72,37 +80,49 @@ public class ConnectionPool { MilvusServiceClient milvusClient = new MilvusServiceClient(connectParam); // 返回创建的新的Milvus连接 + // return the newly created Milvus connection return milvusClient; } public synchronized MilvusClient getConnection() { // 确保连接池己被创建 + // ensure that the connection pool has been created if (connections == null) { return null; // 连接池还没创建，则返回 null + // if the connection pool has not been created, return null } MilvusClient client = getFreeConnection(); // 获得一个可用的数据库连接 + // obtain a available database connection // 假如目前没有可以使用的连接，即所有的连接都在使用中 + // if there are no available connections, i.e., all connections are in use while (client == null) { // 等一会再试 250 ms + // wait for a while and try again in 250 ms wait(250); client = getFreeConnection(); // 重新再试，直到获得可用的连接，假如 // getFreeConnection() 返回的为 null // 则表明创建一批连接后也不可获得可用连接 + // try again until an available connection is obtained, if getFreeConnection() returns null, it means that even after creating a batch of connections, no available connections can be obtained. } return client; // 返回获得的可用的连接 + // return the available connection obtained } private MilvusClient getFreeConnection() { // 从连接池中获得一个可用的Milvus连接 + // obtain an available Milvus connection from the connection pool MilvusClient client = findFreeConnection(); if (client == null) { // 假如目前连接池中没有可用的连接 // 创建一些连接 + // if there are no available connections in the connection pool, create some connections createConnections(incrementalConnections); // 重新从池中查找是否有可用连接 + // search again in the pool for available connections client = findFreeConnection(); if (client == null) { // 假如创建连接后仍获得不到可用的连接，则返回 null + // if no available connections are obtained after creating new connections, return null return null; } } @@ -113,18 +133,23 @@ public class ConnectionPool { MilvusClient client = null; PooledConnection pConn = null; // 获得连接池中所有的对象 + // obtain all objects in the connection pool Enumeration enumerate = connections.elements(); // 遍历所有的对象，看是否有可用的连接 + // traverse all the objects to see if there are any available connections while (enumerate.hasMoreElements()) { pConn = (PooledConnection) enumerate.nextElement(); if (!pConn.isBusy()) { // 假如此对象不忙，则获得它的数据库连接并把它设为忙 + // if this object is not busy, obtain its database connection and set it as busy client = pConn.getConnection(); pConn.setBusy(true); break; // 己经找到一个可用的连接，退出 + // an available connection has been found, exit } } return client; // 返回找到到的可用连接 + // return the found available connection } public void returnConnection(MilvusClient client) { @@ -136,11 +161,14 @@ public class ConnectionPool { PooledConnection pConn = null; Enumeration enumerate = connections.elements(); // 遍历连接池中的所有连接，找到这个要返回的连接对象 + // ensure that the connection pool exists, if the connection has not been created (does not exist), return directly while (enumerate.hasMoreElements()) { pConn = (PooledConnection) enumerate.nextElement(); // 先找到连接池中的要返回的连接对象 + // traverse all connections in the connection pool to find the connection object to be returned if (client == pConn.getConnection()) { // 找到了 , 设置此连接为空闲状态 + // if found, set the connection to idle status pConn.setBusy(false); break; } @@ -149,20 +177,25 @@ public class ConnectionPool { public synchronized void refreshConnections() { // 确保连接池己创新存在 + // ensure that the connection pool has been created if (connections == null) { System.out.println(" 连接池不存在，无法刷新 !"); + System.out.println("The connection pool does not exist, cannot refresh!"); return; } PooledConnection pConn = null; Enumeration enumerate = connections.elements(); while (enumerate.hasMoreElements()) { // 获得一个连接对象 + // obtain a connection object pConn = (PooledConnection) enumerate.nextElement(); // 假如对象忙则等 5 秒 ,5 秒后直接刷新 + // if the object is busy, wait for 5 seconds and then refresh it directly if (pConn.isBusy()) { wait(5000); // 等 5 秒 } // 关闭此连接，用一个新的连接代替它。 + // close this connection and replace it with a new one. closeConnection(pConn.getConnection()); pConn.setConnection(newConnection()); pConn.setBusy(false); @@ -171,8 +204,10 @@ public class ConnectionPool { public synchronized void closeConnectionPool() { // 确保连接池存在，假如不存在，返回 + // ensure that the connection pool exists, if it does not exist, return if (connections == null) { System.out.println(" 连接池不存在，无法关闭 !"); + System.out.println("The connection pool does not exist, cannot close!"); return; } PooledConnection pConn = null; @@ -180,15 +215,19 @@ public class ConnectionPool { while (enumerate.hasMoreElements()) { pConn = (PooledConnection) enumerate.nextElement(); // 假如忙，等 5 秒 + // if busy, wait for 5 seconds if (pConn.isBusy()) { wait(5000); // 等 5 秒 } // 5 秒后直接关闭它 + // close it directly after 5 seconds closeConnection(pConn.getConnection()); // 从连接池向量中删除它 + // remove it from the connection pool vector connections.removeElement(pConn); } // 置连接池为空 + // set the connection pool to null connections = null; } @@ -205,29 +244,35 @@ public class ConnectionPool { class PooledConnection { MilvusClient client = null; // Milvus连接 + // Milvus connection boolean busy = false; // 此连接是否正在使用的标志，默认没有正在使用 - + // flag indicating whether this connection is currently in use, default is not in use // 构造函数，根据一个 Connection 构告一个 PooledConnection 对象 + // constructor that constructs a PooledConnection object based on a Connection public PooledConnection(MilvusClient client) { this.client = client; } // 返回此对象中的连接 + // return the connection in this object public MilvusClient getConnection() { return client; } // 设置此对象的连接 + // set the connection in this object public void setConnection(MilvusClient client) { this.client = client; } // 获得对象连接是否忙 + // obtain the status of if the connection in the object is busy public boolean isBusy() { return busy; } // 设置对象的连接正在忙 + // set the connection in the object as busy public void setBusy(boolean busy) { this.busy = busy; } diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DJLImageUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DJLImageUtil.java index 83b300b9..9cd5bf65 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DJLImageUtil.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DJLImageUtil.java @@ -13,6 +13,8 @@ import java.nio.file.Paths; /** * DJL图片类 + * DJL Utility Class + * * @author Calvin * @date 2021-12-12 **/ @@ -23,10 +25,9 @@ public class DJLImageUtil { } public static void saveImage(BufferedImage img, String name, String path) { - Image djlImg = ImageFactory.getInstance().fromImage(img); // 支持多种图片格式，自动适配 + Image djlImg = ImageFactory.getInstance().fromImage(img); Path outputDir = Paths.get(path); Path imagePath = outputDir.resolve(name); - // OpenJDK 不能保存 jpg 图片的 alpha channel try { djlImg.save(Files.newOutputStream(imagePath), "png"); } catch (IOException e) { @@ -37,7 +38,6 @@ public class DJLImageUtil { public static void saveDJLImage(Image img, String name, String path) { Path outputDir = Paths.get(path); Path imagePath = outputDir.resolve(name); - // OpenJDK 不能保存 jpg 图片的 alpha channel try { img.save(Files.newOutputStream(imagePath), "png"); } catch (IOException e) { @@ -52,16 +52,13 @@ public class DJLImageUtil { Path outputDir = Paths.get(path); Files.createDirectories(outputDir); Path imagePath = outputDir.resolve(name); - // OpenJDK can't save jpg with alpha channel img.save(Files.newOutputStream(imagePath), "png"); } public static void drawImageRect(BufferedImage image, int x, int y, int width, int height) { - // 将绘制图像转换为Graphics2D Graphics2D g = (Graphics2D) image.getGraphics(); try { g.setColor(new Color(246, 96, 0)); - // 声明画笔属性 ：粗 细（单位像素）末端无修饰 折线处呈尖角 BasicStroke bStroke = new BasicStroke(4, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER); g.setStroke(bStroke); g.drawRect(x, y, width, height); @@ -73,11 +70,9 @@ public class DJLImageUtil { public static void drawImageRect( BufferedImage image, int x, int y, int width, int height, Color c) { - // 将绘制图像转换为Graphics2D Graphics2D g = (Graphics2D) image.getGraphics(); try { g.setColor(c); - // 声明画笔属性 ：粗 细（单位像素）末端无修饰 折线处呈尖角 BasicStroke bStroke = new BasicStroke(4, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER); g.setStroke(bStroke); g.drawRect(x, y, width, height); diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DateUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DateUtil.java index 4792f02f..f3618b06 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DateUtil.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/DateUtil.java @@ -4,6 +4,8 @@ import java.text.SimpleDateFormat; /** * 日期类 + * Date Utility Class + * * @author Calvin * @date 2021-12-12 **/ diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/FileUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/FileUtil.java index a68bb0f5..8b661373 100644 --- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/FileUtil.java +++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/FileUtil.java @@ -29,6 +29,7 @@ import java.util.Date; /** * File工具类，扩展 hutool 工具包 + * File tool class, extending hutool tool package * * @author Zheng Jie * @date 2018-12-27 @@ -39,10 +40,14 @@ public class FileUtil extends cn.hutool.core.io.FileUtil { /** * 系统临时目录 + * System temporary directory *
* windows 包含路径分割符，但Linux 不包含, * 在windows \\==\ 前提下， * 为安全起见 同意拼装 路径分割符， + * - Windows contains path separators, but Linux does not, + * - under the premise of windows \\==\, + * - for safety, agree to assemble path separators, * 
      *       java.io.tmpdir
      *       windows : C:\Users/xxx\AppData\Local\Temp\
@@ -52,30 +57,35 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
     public static final String SYS_TEM_DIR = System.getProperty("java.io.tmpdir") + File.separator;
     /**
      * 定义GB的计算常量
+     * Define GB calculation constants
      */
     private static final int GB = 1024 * 1024 * 1024;
     /**
      * 定义MB的计算常量
+     * Define MB calculation constants
      */
     private static final int MB = 1024 * 1024;
     /**
      * 定义KB的计算常量
+     * Define KB calculation constants
      */
     private static final int KB = 1024;
 
     /**
      * 格式化小数
+     * Format decimal
      */
     private static final DecimalFormat DF = new DecimalFormat("0.00");
 
-    public static final String IMAGE = "图片";
-    public static final String TXT = "文档";
-    public static final String MUSIC = "音乐";
-    public static final String VIDEO = "视频";
-    public static final String OTHER = "其他";
+    public static final String IMAGE = "IMAGE";
+    public static final String TXT = "TXT";
+    public static final String MUSIC = "MUSIC";
+    public static final String VIDEO = "VIDEO";
+    public static final String OTHER = "OTHER";
 
     /**
      * 根据日期生成本地图片相对保存路径
+     * Generate local image relative storage path based on date
      */
     public static String generatePath(String fileRoot) {
         Date date = new Date();
@@ -83,6 +93,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
         String relativePath = DateUtil.YYYY_MM_dd.get().format(date);
         String filePath = fileRoot + relativePath;
         // 如果不存在,创建文件夹
+        // If it does not exist, create a folder
         File f = new File(filePath);
         if (!f.exists()) {
             f.mkdirs();
@@ -95,12 +106,15 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
      */
     public static File toFile(MultipartFile multipartFile) {
         // 获取文件名
+        // Get file name
         String fileName = multipartFile.getOriginalFilename();
         // 获取文件后缀
+        // Get file extension
         String prefix = "." + getExtensionName(fileName);
         File file = null;
         try {
             // 用uuid作为文件名，防止生成的临时文件重复
+            // Use uuid as file name to prevent duplicate temporary files from being generated
             file = new File(SYS_TEM_DIR + IdUtil.simpleUUID() + prefix);
             // MultipartFile to File
             multipartFile.transferTo(file);
@@ -112,6 +126,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 获取文件扩展名，不带 .
+     * Get file extension name without .
      */
     public static String getExtensionName(String filename) {
         if ((filename != null) && (filename.length() > 0)) {
@@ -125,6 +140,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * Java文件操作 获取不带扩展名的文件名
+     * Java file operation, get the file name without extension
      */
     public static String getFileNameNoEx(String filename) {
         if ((filename != null) && (filename.length() > 0)) {
@@ -138,17 +154,21 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 文件大小转换
+     * File size conversion
      */
     public static String getSize(long size) {
         String resultSize;
         if (size / GB >= 1) {
             //如果当前Byte的值大于等于1GB
+            // If the current Byte value is greater than or equal to 1GB
             resultSize = DF.format(size / (float) GB) + "GB   ";
         } else if (size / MB >= 1) {
             //如果当前Byte的值大于等于1MB
+            // If the current Byte value is greater than or equal to 1MB
             resultSize = DF.format(size / (float) MB) + "MB   ";
         } else if (size / KB >= 1) {
             //如果当前Byte的值大于等于1KB
+            // If the current Byte value is greater than or equal to 1KB
             resultSize = DF.format(size / (float) KB) + "KB   ";
         } else {
             resultSize = size + "B   ";
@@ -158,6 +178,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * inputStream 转 File
+     * InputStream to File
      */
     static File inputStreamToFile(InputStream ins, String name) throws Exception {
         File file = new File(SYS_TEM_DIR + name);
@@ -178,6 +199,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 将文件名解析成文件的上传路径
+     * Parse the file name into the upload path of the file
      */
     public static File upload(MultipartFile file, String filePath) {
         Date date = new Date();
@@ -189,14 +211,17 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
             String fileName = name + nowStr + "." + suffix;
             String path = filePath + fileName;
             // getCanonicalFile 可解析正确各种路径
+            // getCanonicalFile can correctly parse various paths
             File dest = new File(path).getCanonicalFile();
             // 检测是否存在目录
+            // Check if the directory exists
             if (!dest.getParentFile().exists()) {
                 if (!dest.getParentFile().mkdirs()) {
                     System.out.println("was not successful.");
                 }
             }
             // 文件写入
+            // File write
             file.transferTo(dest);
             return dest;
         } catch (Exception e) {
@@ -227,12 +252,13 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
         // 1M
         int len = 1024 * 1024;
         if (size > (maxSize * len)) {
-            throw new BadRequestException("文件超出规定大小");
+            throw new BadRequestException("max size limitted");
         }
     }
 
     /**
      * 判断两个文件是否相同
+     * Determine whether two files are the same
      */
     public static boolean check(File file1, File file2) {
         String img1Md5 = getMd5(file1);
@@ -242,6 +268,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 判断两个文件是否相同
+     * Determine whether two files are the same
      */
     public static boolean check(String file1Md5, String file2Md5) {
         return file1Md5.equals(file2Md5);
@@ -249,6 +276,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     public static byte[] getByte(File file) {
         // 得到文件长度
+        // Get file length
         byte[] b = new byte[(int) file.length()];
         try {
             InputStream in = new FileInputStream(file);
@@ -266,15 +294,17 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 保存字节数组图片到指定path
+     * Save byte array picture to specified path
      */
     public static void bytesToFile(byte[] bs, String filePath) throws IOException {
         FileOutputStream os = new FileOutputStream(filePath);
         os.write(bs);
         os.close();
     }
-    
+
     private static String getMd5(byte[] bytes) {
         // 16进制字符
+        // 16 hexadecimal characters
         char[] hexDigits = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
         try {
             MessageDigest mdTemp = MessageDigest.getInstance("MD5");
@@ -284,6 +314,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
             char[] str = new char[j * 2];
             int k = 0;
             // 移位 输出字符串
+            // Move output string
             for (byte byte0 : md) {
                 str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                 str[k++] = hexDigits[byte0 & 0xf];
@@ -304,13 +335,18 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
         boolean flag = false;
         File file = new File(path);
         // 判断目录或文件是否存在
+        // Check if the directory or file exists
         if (!file.exists()) { // 不存在返回 false
+            //Does not exist returns false
             return flag;
         } else {
             // 判断是否为文件
+            // If it is a file, call the delete file method
             if (file.isFile()) { // 为文件时调用删除文件方法
+                // If it is a file, call the delete file method
                 return deleteFile(path);
             } else { // 为目录时调用删除目录方法
+                // If it is a directory, call the delete directory method
                 return deleteDirectory(path);
             }
         }
@@ -318,14 +354,16 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 删除单个文件
+     *Delete single file
      *
-     * @param path 被删除文件的文件名
-     * @return 单个文件删除成功返回true，否则返回false
+     * @param path 被删除文件的文件名 - path file name to be deleted
+     * @return 单个文件删除成功返回true，否则返回false - Return true if the single file is deleted successfully, otherwise return false
      */
     public static boolean deleteFile(String path) {
         boolean flag = false;
         File file = new File(path);
         // 路径为文件且不为空则进行删除
+        // If the path is a file and is not empty, delete it
         if (file.isFile() && file.exists()) {
             file.delete();
             flag = true;
@@ -335,29 +373,36 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
 
     /**
      * 删除目录（文件夹）以及目录下的文件
+     * Delete directory (file) and files under the directory
      *
-     * @param path 被删除目录的文件路径
+     * @param path 被删除目录的文件路径 - path file path of the directory to be deleted
      * @return 目录删除成功返回true，否则返回false
+     * Return true if the directory is deleted successfully, otherwise return false
      */
     public static boolean deleteDirectory(String path) {
         // 如果sPath不以文件分隔符结尾，自动添加文件分隔符
+        // If sPath does not end with a file separator, automatically add a file separator
         if (!path.endsWith(File.separator)) {
             path = path + File.separator;
         }
         File dirFile = new File(path);
         // 如果dir对应的文件不存在，或者不是一个目录，则退出
+        // If dir does not exist or is not a directory, exit
         if (!dirFile.exists() || !dirFile.isDirectory()) {
             return false;
         }
         boolean flag = true;
         // 删除文件夹下的所有文件(包括子目录)
+        // Delete all files in the folder (including subdirectories)
         File[] files = dirFile.listFiles();
         for (int i = 0; i < files.length; i++) {
             // 删除子文件
+            // Delete sub files
             if (files[i].isFile()) {
                 flag = deleteFile(files[i].getAbsolutePath());
                 if (!flag) break;
             } // 删除子目录
+            // Delete subdirectories
             else {
                 flag = deleteDirectory(files[i].getAbsolutePath());
                 if (!flag) break;
@@ -365,6 +410,7 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
         }
         if (!flag) return false;
         // 删除当前目录
+        // Delete the current directory
         if (dirFile.delete()) {
             return true;
         } else {
@@ -372,4 +418,4 @@ public class FileUtil extends cn.hutool.core.io.FileUtil {
         }
     }
 
-}
+}
\ No newline at end of file
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ImageUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ImageUtil.java
index fbc2a478..d1453648 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ImageUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ImageUtil.java
@@ -16,6 +16,8 @@ import java.util.Iterator;
 
 /**
  * 图片操作类
+ * Image manipulation class
+ *
  * @author Calvin
  * @date 2021-12-12
  **/
@@ -25,6 +27,7 @@ public class ImageUtil {
 
     /**
      * multipartFile 编码转换为 BufferedImage
+     * Convert multipartFile encoding to BufferedImage
      */
     public static BufferedImage multipartFileToBufImage(MultipartFile imageFile) {
         try {
@@ -40,6 +43,7 @@ public class ImageUtil {
 
     /**
      * MultipartFile对象转字节数组
+     * Convert MultipartFile object to byte array
      */
     public static byte[] multipartFileToBytes(MultipartFile file) {
         InputStream ins = null;
@@ -64,6 +68,7 @@ public class ImageUtil {
 
     /**
      * file 转 byte数组
+     * Convert file to byte array
      */
     public static byte[] file2Byte(File file) throws IOException {
         byte[] buffer = null;
@@ -82,6 +87,7 @@ public class ImageUtil {
 
     /**
      * 根据地址获得数据的字节流
+     * Get byte stream of data according to address
      */
     public static byte[] getImageByUrl(String strUrl) {
         try {
@@ -100,6 +106,7 @@ public class ImageUtil {
 
     /**
      * 从输入流中获取数据
+     * Get data from input stream
      */
     public static byte[] readInputStream(InputStream inStream) throws Exception {
         ByteArrayOutputStream outStream = new ByteArrayOutputStream();
@@ -114,6 +121,7 @@ public class ImageUtil {
 
     /**
      * bytes 编码转换为 BufferedImage
+     * Convert bytes encoding to BufferedImage
      */
     public static BufferedImage bytesToBufferedImage(byte[] bytes) {
         try {
@@ -127,6 +135,7 @@ public class ImageUtil {
 
     /**
      * 保存字节数组图片到指定path
+     * Save byte array image to specified path
      */
     public static void bytesToImageFile(byte[] bs, String filePath) throws IOException {
         FileOutputStream os = new FileOutputStream(filePath);
@@ -136,6 +145,7 @@ public class ImageUtil {
 
     /**
      * 根据日期生成本地图片相对保存路径
+     * Generate local image relative save path based on date
      */
     public static String generatePath(String fileRoot) {
         Date date = new Date();
@@ -152,6 +162,7 @@ public class ImageUtil {
 
     /**
      * 获得图片的后缀，例如：JPEG、GIF等
+     * Get the suffix of the image, such as: JPEG, GIF, etc.
      */
     public static String getImageFormat(Object obj) {
         ImageInputStream iis = null;
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/NDArrayUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/NDArrayUtil.java
index aee07984..d5b8e00e 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/NDArrayUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/NDArrayUtil.java
@@ -6,9 +6,15 @@ import org.bytedeco.javacpp.indexer.DoubleRawIndexer;
 import org.bytedeco.opencv.global.opencv_core;
 import org.bytedeco.opencv.opencv_core.Mat;
 import org.bytedeco.opencv.opencv_core.Point2f;
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class NDArrayUtil {
   // NDArray 转 opencv_core.Mat
+  // NDArray to opencv_core.Mat
   public static Mat toOpenCVMat(NDArray points, int rows, int cols) {
     double[] doubleArray = points.toDoubleArray();
     // CV_32F = FloatRawIndexer
@@ -27,6 +33,7 @@ public class NDArrayUtil {
   }
 
   // NDArray 转 opencv_core.Mat
+  // NDArray to opencv_core.Mat
   public static Mat toOpenCVMat(NDManager manager, NDArray srcPoints, NDArray dstPoints) {
     NDArray svdMat = SVDUtil.transformationFromPoints(manager, srcPoints, dstPoints);
 
@@ -46,6 +53,7 @@ public class NDArrayUtil {
   }
 
   // NDArray 转 opencv_core.Point2f
+  // NDArray to opencv_core.Point2f
   public static Point2f toOpenCVPoint2f(NDArray points, int rows) {
     double[] doubleArray = points.toDoubleArray();
     Point2f points2f = new Point2f(rows);
@@ -58,6 +66,7 @@ public class NDArrayUtil {
   }
 
   // DoubleArray 转 opencv_core.Point2f
+  // DoubleArray to opencv_core.Point2f
   public static Point2f toOpenCVPoint2f(double[] doubleArray, int rows) {
     Point2f points2f = new Point2f(rows);
 
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/SVDUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/SVDUtil.java
index 3be8724e..b80f7077 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/SVDUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/SVDUtil.java
@@ -5,12 +5,16 @@ import Jama.SingularValueDecomposition;
 import ai.djl.ndarray.NDArray;
 import ai.djl.ndarray.NDManager;
 
-/** 仿射变换处理工具 */
-public class SVDUtil {
+/**
+ * 仿射变换处理工具
+ * Affine transformation processing tool
+ */
+public class SVDUtils {
     // 计算全局标准差
+    // Calculate global standard deviation
     public static NDArray point112X96(NDManager manager) {
         double[][] coord5point = {
-                {30.2946f, 51.6963f}, // 112x96的目标点
+                {30.2946f, 51.6963f}, // 112x96的目标点 - Target point of 112x96
                 {65.5318f, 51.6963f},
                 {48.0252f, 71.7366f},
                 {33.5493f, 92.3655f},
@@ -22,7 +26,7 @@ public class SVDUtil {
 
     public static NDArray point112x112(NDManager manager) {
         double[][] coord5point = {
-                {30.2946f + 8.0000f, 51.6963f}, // 112x112的目标点
+                {30.2946f + 8.0000f, 51.6963f}, // 112x112的目标点 - Target point of 112x112
                 {65.5318f + 8.0000f, 51.6963f},
                 {48.0252f + 8.0000f, 71.7366f},
                 {33.5493f + 8.0000f, 92.3655f},
@@ -33,20 +37,25 @@ public class SVDUtil {
     }
 
     // 计算仿射变换矩阵
+    // Calculate affine transformation matrix
     public static NDArray transformationFromPoints(
             NDManager manager, NDArray points1, NDArray points2) {
         // 按列计算均值
-        NDArray c1 = points1.mean(new int[] {0}); // axis=0 列操作
-        NDArray c2 = points2.mean(new int[] {0}); // axis=0 列操作
+        // Calculate column-wise mean
+        NDArray c1 = points1.mean(new int[] {0}); // axis=0 列操作 - axis=0 column operation
+        NDArray c2 = points2.mean(new int[] {0}); // axis=0 列操作 - axis=0 column operation
         // 按列减去均值
+        // Subtract column-wise mean
         points1 = points1.sub(c1);
         points2 = points2.sub(c2);
 
         // 计算全局标准差
+        // Calculate global standard deviation
         double s1 = std(points1);
         double s2 = std(points2);
 
         // 矩阵除以全局标准差
+        // Matrix divided by global standard deviation
         NDArray djl_s1 = manager.create(s1);
         NDArray djl_s2 = manager.create(s2);
         points1 = points1.div(djl_s1);
@@ -56,6 +65,7 @@ public class SVDUtil {
         double[] points2D = points2.toDoubleArray();
 
         // DJL 格式转换成Jamma格式
+        // Convert DJL format to Jama format
         double[][] m1 = new double[5][2];
         double[][] m2 = new double[5][2];
         for (int i = 0; i < 5; i++) {
@@ -72,6 +82,7 @@ public class SVDUtil {
         Matrix p2 = new Matrix(m2);
 
         // 进行奇异值分解
+        // Perform singular value decomposition
         Matrix p3 = p1.transpose().times(p2);
         SingularValueDecomposition s = p3.svd();
 
@@ -79,6 +90,7 @@ public class SVDUtil {
         Matrix S = s.getS();
         Matrix V = s.getV();
         // TODO 为什么第2列的符号是反的？
+        // Why is the sign of the second column opposite?
         m1 = U.getArray();
         m1[0][1] = -m1[0][1];
         m1[1][1] = -m1[1][1];
@@ -92,6 +104,8 @@ public class SVDUtil {
         NDArray newR = manager.create(rArray);
 
         // np.vstack([np.hstack(((s2 / s1) * R, c2.T - (s2 / s1) * R * c1.T)), np.matrix([0.,0., 1.])])
+        // TODO NDArray 单行向量直接转置无效，用reshape代替
+        // // TODO NDArray single-row vector transpose is invalid, use reshape instead
         // (s2 / s1) * R
         NDArray leftPart = djl_s2.div(djl_s1).mul(newR);
         // c2.T - (s2 / s1) * R * c1.T)
@@ -109,6 +123,7 @@ public class SVDUtil {
     }
 
     // 计算全局标准差
+    // Calculate global standard deviation
     public static double std(NDArray points) {
         points = points.square();
         double[] doubleResult = points.toDoubleArray();
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UUIDUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UUIDUtil.java
index 4824b54c..3930100e 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UUIDUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UUIDUtil.java
@@ -4,6 +4,7 @@ import java.util.UUID;
 
 /**
  * 获取UUID
+ * Get UUID
  *
  * @author Calvin
  * @date 2021-12-12
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UserAgentUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UserAgentUtil.java
index 8de28a91..6dffe2ff 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UserAgentUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/UserAgentUtil.java
@@ -9,6 +9,8 @@ import java.net.UnknownHostException;
 
 /**
  * 获取系统信息
+ * Get system info
+ *
  * @author Calvin
  * @date 2021-12-12
  **/
@@ -26,6 +28,8 @@ public class UserAgentUtil {
 
     /**
      * 获取操作系统
+     * Get os info
+     *
      */
     public String getOS() {
         if (null == userAgent) {
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ZipUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ZipUtil.java
index b3b3a28d..a016e23d 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ZipUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/common/ZipUtil.java
@@ -17,6 +17,7 @@ public class ZipUtil {
 
     /**
      * 解压Zip文件
+     * unzip file
      */
     public static void unZip(String receivedZipFile, String osName, String filePath) {
         int count = -1;
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/FaceAlignment.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/FaceAlignment.java
index 608b5a37..4e5a7602 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/FaceAlignment.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/FaceAlignment.java
@@ -12,7 +12,12 @@ import java.nio.FloatBuffer;
 import static org.bytedeco.opencv.global.opencv_calib3d.findHomography;
 import static org.bytedeco.opencv.global.opencv_core.cvCreateMat;
 
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class FaceAlignment {
 
   public static Mat affineTransform(
@@ -81,11 +86,13 @@ public class FaceAlignment {
   }
 
   // 根据目标5点，进行旋转仿射变换
+  // Rotate and transform based on 5 target points
   public static Mat get5WarpAffineImg(Mat src, Mat rot_mat) {
     Mat oral = new Mat();
     src.copyTo(oral);
     Mat rot = new Mat();
     // 进行仿射变换，变换后大小为src的大小
+    // Perform affine transformation, and the size after transformation is the same as src
     opencv_imgproc.warpAffine(src, rot, rot_mat, src.size());
     return rot;
   }
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/OpenCVImageUtil.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/OpenCVImageUtil.java
index 3bedc055..122a9d2b 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/OpenCVImageUtil.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/common/utils/opencv/OpenCVImageUtil.java
@@ -10,6 +10,7 @@ import java.awt.image.DataBufferByte;
 
 /**
  * 图片类型转换
+ * Image type conversion
  *
  * @author Calvin
  */
@@ -17,6 +18,7 @@ public class OpenCVImageUtil {
 
   /**
    * 将 BufferedImage 转 Mat
+   * Convert BufferedImage to Mat
    *
    * @param original
    */
@@ -27,6 +29,7 @@ public class OpenCVImageUtil {
 
   /**
    * 将mat转BufferedImage
+   * Convert Mat to BufferedImage
    *
    * @param matrix
    */
@@ -59,12 +62,16 @@ public class OpenCVImageUtil {
     //    BufferedImage对象中最重要的两个组件为Raster和ColorModel，分别用于存储图像的像素数据与颜色数据。
     //    表示像素矩形数组的类。Raster 封装存储样本值的 DataBuffer，以及描述如何在 DataBuffer 中定位给定样本值的 SampleModel。
     //    由于Raster对象是BufferedImage对象中的像素数据存储对象，因此，BufferedImage支持从Raster对象中获取任意位置（x，y）点的像素值p（x，y）。
+    // The two most important components of the BufferedImage object are Raster and ColorModel, which are used to store pixel data and color data of the image, respectively.
+    // The Raster class represents an array of pixel rectangles. Raster encapsulates the DataBuffer that stores the sample values, and the SampleModel that describes how to locate a given sample value in the DataBuffer.
+    // Since the Raster object is the pixel data storage object in the BufferedImage object, BufferedImage supports getting the pixel value p(x,y) at any position (x,y) from the Raster object.
     image.getRaster().setDataElements(0, 0, cols, rows, data);
     return image;
   }
 
   /**
    * 将bufferImage转Mat
+   * Convert bufferImage to Mat
    *
    * @param original
    * @param matType
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/ConfigurerAdapter.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/ConfigurerAdapter.java
index 6b14ba01..69a65985 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/ConfigurerAdapter.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/ConfigurerAdapter.java
@@ -26,7 +26,10 @@ import java.util.List;
 @EnableWebMvc
 public class ConfigurerAdapter implements WebMvcConfigurer {
 
-    /** 文件配置 */
+    /**
+     * 文件配置
+     * File configuration.
+     * */
     private final FileProperties properties;
 
     public ConfigurerAdapter(FileProperties properties) {
@@ -59,6 +62,7 @@ public class ConfigurerAdapter implements WebMvcConfigurer {
     @Override
     public void configureMessageConverters(List> converters) {
         // 使用 fastjson 序列化，会导致 @JsonIgnore 失效，可以使用 @JSONField(serialize = false) 替换
+        // Use fastjson serialization, which will cause @JsonIgnore to be invalid, can be replaced with @JSONField (serialize = false)
         FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
         List supportMediaTypeList = new ArrayList<>();
         supportMediaTypeList.add(MediaType.APPLICATION_JSON_UTF8);
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/FileProperties.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/FileProperties.java
index ca906198..f62074af 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/FileProperties.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/FileProperties.java
@@ -7,6 +7,8 @@ import org.springframework.context.annotation.Configuration;
 
 /**
  * 文件操作常量类
+ * File operation constants class
+ *
  * @author Calvin
  * @date 2021-12-12
  **/
@@ -15,7 +17,8 @@ import org.springframework.context.annotation.Configuration;
 @ConfigurationProperties(prefix = "file")
 public class FileProperties {
 
-    /** 文件大小限制 */
+    // 文件大小限制
+    // File size limit
     private Long maxSize;
 
     private ElPath mac;
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/SwaggerConfig.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/SwaggerConfig.java
index 10d4a525..855cea3b 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/SwaggerConfig.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/config/SwaggerConfig.java
@@ -27,7 +27,7 @@ import static springfox.documentation.schema.AlternateTypeRules.newRule;
 
 /**
  * @author Calvin
- * @date 2021-12-12
+ * @date 2021-06-20
  **/
 @Configuration
 @EnableSwagger2
@@ -52,7 +52,7 @@ public class SwaggerConfig {
     private ApiInfo apiInfo() {
         return new ApiInfoBuilder()
                 .description("")
-                .title("接口文档")
+                .title("API Doc")
                 .version("1.0")
                 .build();
     }
@@ -61,6 +61,7 @@ public class SwaggerConfig {
 
 /**
  *  将Pageable转换展示在swagger中
+ *  Convert Pageable for display in Swagger
  */
 @Configuration
 class SwaggerDataConfig {
@@ -83,13 +84,13 @@ class SwaggerDataConfig {
     @ApiModel
     @Data
     private static class Page {
-        @ApiModelProperty("页码 (0..N)")
+        @ApiModelProperty("Page number (0..N)")
         private Integer page;
 
-        @ApiModelProperty("每页显示的数目")
+        @ApiModelProperty("Number of items per page")
         private Integer size;
 
-        @ApiModelProperty("以下列格式排序标准：property[,asc | desc]。 默认排序顺序为升序。 支持多种排序条件：如：id,asc")
+        @ApiModelProperty("Sort criteria in the following format: property[,asc|desc]. Default sort order is ascending. Multiple sort conditions are supported, such as id,asc")
         private List sort;
     }
 }
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/DataController.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/DataController.java
index a30b8e64..6cd7a471 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/DataController.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/DataController.java
@@ -37,6 +37,7 @@ import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * 数据管理
+ * Data management
  *
  * @author Calvin
  * @date 2021-12-12
@@ -44,7 +45,7 @@ import java.util.concurrent.ConcurrentHashMap;
 @Slf4j
 @RestController
 @RequiredArgsConstructor
-@Api(tags = "数据管理")
+@Api(tags = "数据管理 -Data management")
 @RequestMapping("/api/data")
 public class DataController {
     private final FileProperties properties;
@@ -61,7 +62,7 @@ public class DataController {
     @Autowired
     private LocalStorageService localStorageService;
 
-    @ApiOperation(value = "提取特征")
+    @ApiOperation(value = "提取特征 - Extract feature values")
     @GetMapping("/extractFeatures")
     public ResponseEntity extractFeatures(@RequestParam(value = "id") String id, HttpServletRequest request) throws IOException {
         LocalStorage localStorage = localStorageService.findById(Integer.parseInt(id));
@@ -72,6 +73,7 @@ public class DataController {
         }
 
         // 获取上传者操作系统
+        // Get operating system of the uploader
         UserAgentUtil userAgentGetter = new UserAgentUtil(request);
         String os = userAgentGetter.getOS();
 
@@ -79,6 +81,7 @@ public class DataController {
             new File(properties.getPath().getRootPath()).mkdirs();
         }
         //生成UUID作为解压缩的目录
+        // Generate UUID as the directory to be extracted to
         String UUID = UUIDUtil.getUUID();
         String unZipFilePath = properties.getPath().getRootPath() + UUID;
         if (!new File(unZipFilePath).exists()) {
@@ -87,6 +90,7 @@ public class DataController {
         ZipUtil.unZip(localStorage.getPath(), os, unZipFilePath);
 
         //生成视频文件提取的图片帧目录
+        // Generate directory for image frames extracted from video files
         String imagesPath = properties.getPath().getRootPath();
         if (!new File(imagesPath).exists()) {
             new File(imagesPath).mkdirs();
@@ -99,6 +103,7 @@ public class DataController {
             List> vectors = new ArrayList<>();
             for (DataInfo dataInfo : dataInfoList) {
                 // 保存图片信息
+                // save image info
                 ConcurrentHashMap map = dataService.getMap();
                 int size = map.size();
                 long imageId = size + 1;
@@ -124,6 +129,7 @@ public class DataController {
             }
 
             // 将向量插入Milvus向量引擎
+            // Insert vectors into Milvus vector engine
             try {
                 R response = searchService.hasCollection();
                 if (!response.getData()) {
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/LocalStorageController.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/LocalStorageController.java
index a060487b..ba5b3673 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/LocalStorageController.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/LocalStorageController.java
@@ -20,26 +20,28 @@ import java.util.List;
 
 /**
  * 存储管理
+ * Storage Management
+ *
  * @author Calvin
  * @date 2021-12-12
  **/
 @RestController
 @RequiredArgsConstructor
-@Api(tags = "存储管理")
+@Api(tags = "存储管理 - Storage Management")
 @RequestMapping("/api/localStorage")
 public class LocalStorageController {
 
     private final LocalStorageService localStorageService;
     private final FileProperties properties;
 
-    @ApiOperation("查询文件列表")
+    @ApiOperation("查询文件列表 -Query File List")
     @GetMapping("/list")
     public ResponseEntity getContact() {
         List result = localStorageService.getStorageList();
         return new ResponseEntity<>(ResultRes.success(result, result.size()), HttpStatus.OK);
     }
 
-    @ApiOperation("上传文件")
+    @ApiOperation("上传文件 -Upload File")
     @PostMapping("/file")
     public ResponseEntity create(@RequestParam("file") MultipartFile multipartFile) {
         FileUtil.checkSize(properties.getMaxSize(), multipartFile.getSize());
@@ -67,7 +69,7 @@ public class LocalStorageController {
         return new ResponseEntity<>(ResultRes.success(), HttpStatus.OK);
     }
 
-    @ApiOperation("删除文件")
+    @ApiOperation("删除文件 -Delete File")
     @DeleteMapping
     public ResponseEntity delete(@RequestBody LocalStorage localStorage) {
         LocalStorage storage = localStorageService.findById(localStorage.getId());
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/SearchController.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/SearchController.java
index 2c621220..cd647637 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/SearchController.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/controller/SearchController.java
@@ -34,12 +34,13 @@ import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * 搜索管理
+ * Search management
  *
  * @author Calvin
  * @date 2021-12-19
  **/
 @Slf4j
-@Api(tags = "搜索管理")
+@Api(tags = "搜索管理 -Search management")
 @RequestMapping("/api/search")
 @RequiredArgsConstructor
 @RestController
@@ -55,7 +56,7 @@ public class SearchController {
     String baseUrl;
 
     @PostMapping(value = "/image")
-    @ApiOperation(value = "搜索图片", nickname = "searchImage")
+    @ApiOperation(value = "搜索图片 - image search", nickname = "searchImage")
     public ResponseEntity searchImage(@RequestParam("image") MultipartFile imageFile, @RequestParam(value = "topK") String topk) {
         BufferedImage bufferedImage = ImageUtil.multipartFileToBufImage(imageFile);
         Image img = ImageFactory.getInstance().fromImage(bufferedImage);
@@ -63,8 +64,10 @@ public class SearchController {
         List vectorToSearch;
         try {
             //人脸检测 & 特征提取
+            // Face detection & feature extraction
             List faceObjects = detectService.faceDetect(imageFile.getName(), img);
             //如何有多个人脸，取第一个（也可以选最大的，或者一起送入搜索引擎搜索）
+            // If there are multiple faces, take the first one (or the largest, or search together with the search engine)
             vectorToSearch = faceObjects.get(0).getFeature();
         } catch (Exception e) {
             e.printStackTrace();
@@ -77,11 +80,13 @@ public class SearchController {
 
         try {
             // 根据图片向量搜索
+            // Search for vectors based on image files
             R searchResponse = searchService.search(topK, vectorsToSearch);
             SearchResultsWrapper wrapper = new SearchResultsWrapper(searchResponse.getData().getResults());
             List scores = wrapper.getIDScore(0);
 
             // 根据ID获取图片信息
+            // Get image information based on ID
             ConcurrentHashMap map = imageService.getMap();
             List imageInfoResList = new ArrayList<>();
             for (SearchResultsWrapper.IDScore score : scores) {
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfo.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfo.java
index 13370a68..ad7df9f7 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfo.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfo.java
@@ -8,9 +8,11 @@ import java.util.Date;
 
 /**
  * 数据信息对象
+ * Data Info Object
+ *
  */
 @Data
-@ApiModel(value = "DataInfo", description = "数据信息对象")
+@ApiModel(value = "DataInfo", description = "Data Info Object")
 public class DataInfo {
     @ApiModelProperty(value = "id", name = "id")
     private Long id;
@@ -21,15 +23,15 @@ public class DataInfo {
     @ApiModelProperty(value = "uuid", name = "uuid")
     private String uuid;
 
-    @ApiModelProperty(value = "原名称", name = "preName")
+    @ApiModelProperty(value = "preName", name = "preName")
     private String preName;
 
-    @ApiModelProperty(value = "全路径", name = "fullPath")
+    @ApiModelProperty(value = "fullPath", name = "fullPath")
     private String fullPath;
 
-    @ApiModelProperty(value = "相对路径", name = "relativePath")
+    @ApiModelProperty(value = "relativePath", name = "relativePath")
     private String relativePath;
 
-    @ApiModelProperty(value = "创建时间", name = "createTime")
+    @ApiModelProperty(value = "createTime", name = "createTime")
     private Date createTime;
 }
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfoRes.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfoRes.java
index d6f7bfcd..ff9fb4cf 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfoRes.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/DataInfoRes.java
@@ -8,9 +8,11 @@ import java.util.Date;
 
 /**
  * 信息返回对象
+ * Information Return Object
+ *
  */
 @Data
-@ApiModel(value = "DataInfoRes", description = "信息返回对象")
+@ApiModel(value = "DataInfoRes", description = "信息返回对象 - Information Return Object")
 public class DataInfoRes {
     @ApiModelProperty(value = "id", name = "id")
     private Long id;
@@ -21,12 +23,12 @@ public class DataInfoRes {
     @ApiModelProperty(value = "uuid", name = "uuid")
     private String uuid;
 
-    @ApiModelProperty(value = "原名称", name = "preName")
+    @ApiModelProperty(value = "preName", name = "preName")
     private String preName;
 
     @ApiModelProperty(value = "url", name = "url")
     private String url;
 
-    @ApiModelProperty(value = "创建时间", name = "createTime")
+    @ApiModelProperty(value = "createTime", name = "createTime")
     private Date createTime;
 }
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/LocalStorage.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/LocalStorage.java
index e2283c83..41063e0d 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/LocalStorage.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/LocalStorage.java
@@ -21,22 +21,22 @@ public class LocalStorage  implements Serializable {
     @ApiModelProperty(value = "ID")
     private int id;
 
-    @ApiModelProperty(value = "真实文件名")
+    @ApiModelProperty(value = "realName")
     private String realName;
 
-    @ApiModelProperty(value = "文件名")
+    @ApiModelProperty(value = "name")
     private String name;
 
-    @ApiModelProperty(value = "后缀")
+    @ApiModelProperty(value = "suffix")
     private String suffix;
 
-    @ApiModelProperty(value = "路径")
+    @ApiModelProperty(value = "path")
     private String path;
 
-    @ApiModelProperty(value = "类型")
+    @ApiModelProperty(value = "type")
     private String type;
 
-    @ApiModelProperty(value = "大小")
+    @ApiModelProperty(value = "size")
     private String size;
 
     public LocalStorage(String realName, String name, String suffix, String path, String type, String size) {
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResEnum.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResEnum.java
index ad7ddba7..c2ab07e4 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResEnum.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResEnum.java
@@ -4,17 +4,19 @@ import lombok.Getter;
 
 /**
  * 状态枚举
+ * Status enumeration
+ *
  */
 @Getter
 public enum ResEnum {
     SUCCESS("0000", "success"),
-    PACKAGE_FILE_FAIL("0001", "压缩包类型错误"),
-    PACKAGE_DECOMPRESSION_FAIL("0002", "压缩包解压异常"),
-    UPLOAD_FAIL("0003", "上传压缩包失败!"),
-    IMAGE_NOT_FOUND("0004", "上传压缩包未找到照片!"),
-    MODEL_ERROR("0005", "模型推理出错"),
-    MILVUS_CONNECTION_ERROR("0006", "向量引擎连接错误"),
-    SYSTEM_ERROR("1001", "内部系统错误");
+    PACKAGE_FILE_FAIL("0001", "Wrong compressed file type"),
+    PACKAGE_DECOMPRESSION_FAIL("0002", "Exception occurred while decompressing the package"),
+    UPLOAD_FAIL("0003", "Failed to upload compressed file!"),
+    IMAGE_NOT_FOUND("0004", "Failed to find photo in the uploaded compressed file!"),
+    MODEL_ERROR("0005", "Error occurred while inferring the model"),
+    MILVUS_CONNECTION_ERROR("0006", "Vector engine connection error"),
+    SYSTEM_ERROR("1001", "Internal system error");
     public String KEY;
     public String VALUE;
 
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResultRes.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResultRes.java
index 8252d6b4..451dd777 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResultRes.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/domain/ResultRes.java
@@ -10,15 +10,15 @@ import me.aias.common.enums.ResEnum;
 @Getter
 @Setter
 @JsonIgnoreProperties(ignoreUnknown = true)
-@ApiModel(value = "公共输出对象", description = "公共输出对象")
+@ApiModel(value = "Public Output Object", description = "Public Output Object")
 public class ResultRes {
-    @ApiModelProperty(value = "输出编码，如：0000", name = "code", example = "0000")
+    @ApiModelProperty(value = "Output code：0000", name = "code", example = "0000")
     private String code;
-    @ApiModelProperty(value = "输出消息(String)", name = "msg", example = "操作成功")
+    @ApiModelProperty(value = "Output message(String)", name = "msg", example = "Operation succeeded")
     private String msg;
-    @ApiModelProperty(value = "输出对象(Object)", name = "data")
+    @ApiModelProperty(value = "Output object(Object)", name = "data")
     private int total;
-    @ApiModelProperty(value = "输出对象数量", name = "total")
+    @ApiModelProperty(value = "Number of output objects", name = "total")
     private T data;
 
     public ResultRes(String code, String msg) {
@@ -28,8 +28,10 @@ public class ResultRes {
 
     /**
      * 系统默认返回内置错误编码
+     * System default return built-in error code
+     *
      * code : 9999
-     * msg : 系统繁忙
+     * msg : 系统繁忙 - System busy
      *
      * @return BaseRes
      */
@@ -42,10 +44,12 @@ public class ResultRes {
 
     /**
      * 系统默认返回内置错误编码
-     * code : 9999
-     * msg : 系统繁忙
+     * System default return built-in error code
      *
-     * @param data 返回消息数据
+     * code : 9999
+     * msg : 系统繁忙 - System busy
+     *
+     * @param data
      * @return BaseRes
      */
     public static ResultRes error(String data) {
@@ -57,6 +61,7 @@ public class ResultRes {
 
     /**
      * 返回错误消息编码，不包含消息体
+     * Return error message code, does not include message body
      *
      * @param code
      * @param msg
@@ -71,6 +76,7 @@ public class ResultRes {
 
     /**
      * 返回错误消息编码，包含消息体
+     * Return error message code, including message body
      *
      * @param code 编码
      * @param msg  消息
@@ -87,6 +93,7 @@ public class ResultRes {
 
     /**
      * 返回正确消息体
+     * Return correct message body
      *
      * @param data
      * @param 
@@ -98,6 +105,7 @@ public class ResultRes {
 
     /**
      * 返回正确消息体
+     *Return correct message body
      *
      * @param data
      * @param 
@@ -109,6 +117,7 @@ public class ResultRes {
 
     /**
      * 返回正确消息
+     * Return correct message
      *
      * @param 
      * @return
@@ -119,6 +128,7 @@ public class ResultRes {
 
     /**
      * 判断是否执行正确
+     * Determine whether to execute correctly
      *
      * @return
      */
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DataService.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DataService.java
index 1220fb4d..eb2cbc30 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DataService.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DataService.java
@@ -9,6 +9,7 @@ import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * 服务接口
+ * Service Interface
  *
  * @author Calvin
  * @date 2021-12-12
@@ -16,21 +17,25 @@ import java.util.concurrent.ConcurrentHashMap;
 public interface DataService {
     /**
      * 根据ID查询图片路径
+     * Query by ID
      */
     String findById(String id);
 
     /**
      * 添加图片
+     * Add file
      */
     void addData(String id, String audioPath);
 
     /**
      * 获取清单
+     * Get file list
      */
     ConcurrentHashMap getMap();
 
     /**
-     * 上传音频文件
+     * 上传文件
+     * upload file
      */
     public List uploadData(String rootPath, String UUID)
             throws BusinessException, IOException;
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DetectService.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DetectService.java
index 6ff0050e..ec074027 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DetectService.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/DetectService.java
@@ -11,6 +11,7 @@ import java.util.List;
 
 /**
  * 目标检测服务接口
+ * Object detection service
  *
  * @author Calvin
  * @date 2021-12-12
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/FeatureService.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/FeatureService.java
index 6ad3c171..9032f11d 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/FeatureService.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/FeatureService.java
@@ -9,6 +9,7 @@ import java.util.List;
 
 /**
  * 特征提取服务接口
+ * Feature Service
  *
  * @author Calvin
  * @date 2021-12-12
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/LocalStorageService.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/LocalStorageService.java
index f8a7c16f..de617e11 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/LocalStorageService.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/LocalStorageService.java
@@ -15,21 +15,25 @@ import java.util.List;
 public interface LocalStorageService {
     /**
      * 保存上传文件列表
+     * save file list
      */
     void saveStorageList();
 
     /**
      * 新增文件
+     * add file
      */
     void addStorageFile(LocalStorage localStorage);
 
     /**
      * 根据ID查询
+     * get file by id
      */
     LocalStorage findById(int id);
 
     /**
      * 删除
+     * delete
      */
     boolean delete(int id);
 
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/SearchService.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/SearchService.java
index 1b6cc80a..e31cb3d6 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/SearchService.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/SearchService.java
@@ -12,60 +12,79 @@ import java.util.List;
 
 public interface SearchService {
     // 重置向量引擎
+    // Reset vector engine
     void clearSearchEngine();
 
     // 初始化向量引擎
+    // Initialize vector engine
     void initSearchEngine();
 
     // 获取连接池
+    // Get connection pool
     ConnectionPool getConnectionPool(boolean refresh);
 
     // 获取Milvus Client
+    // Get Milvus Client
     MilvusClient getClient(ConnectionPool connPool);
 
     // 检查是否存在 collection
+    // Return connection
     void returnConnection(ConnectionPool connPool, MilvusClient client);
 
     // 检查是否存在 collection
+    // Check if collection exists
     R hasCollection(MilvusClient milvusClient);
     R hasCollection();
 
     // 创建 collection
+    // Create collection
     R createCollection(MilvusClient milvusClient, long timeoutMiliseconds);
 
     // 加载 collection
+    // Load collection
     R loadCollection(MilvusClient milvusClient);
 
     // 释放 collection
+    // Release collection
     R releaseCollection(MilvusClient milvusClient);
 
     // 删除 collection
+    // Drop collection
     R dropCollection(MilvusClient milvusClient);
 
     // 创建 分区
+    // Create partition
     R createPartition(MilvusClient milvusClient, String partitionName);
 
     // 删除 分区
+    // Drop partition
     R dropPartition(MilvusClient milvusClient, String partitionName);
 
     // 是否存在分区
+    // Check if partition exists
     R hasPartition(MilvusClient milvusClient, String partitionName);
 
     // 创建 index
+    // Create index
     R createIndex(MilvusClient client);
 
     // 删除 index
+    // Drop index
     R dropIndex(MilvusClient client);
 
     // 插入向量
+    // Insert vectors
     R insert(List vectorIds, List> vectors);
 
     // 查询向量
+    // Query vectors
     R query(String expr);
 
     // 搜索向量
+    // Search vectors
     R search(Integer topK, List> vectorsToSearch);
 
     // 删除向量
+    // Delete vectors
     R delete(String expr);
 }
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DataServiceImpl.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DataServiceImpl.java
index 48698bde..2be64aeb 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DataServiceImpl.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DataServiceImpl.java
@@ -62,6 +62,7 @@ public class DataServiceImpl implements DataService {
 
     /**
      * 新增文件
+     * Add file
      */
     public void addData(String id, String audioPath) {
         map.put(id, audioPath);
@@ -70,6 +71,7 @@ public class DataServiceImpl implements DataService {
 
     /**
      * 根据ID查询
+     * Query by ID
      */
     public String findById(String id) {
         return map.get(id);
@@ -77,6 +79,7 @@ public class DataServiceImpl implements DataService {
 
     /**
      * 获取清单
+     * Get file list
      */
     public ConcurrentHashMap getMap() {
         return map;
@@ -84,6 +87,7 @@ public class DataServiceImpl implements DataService {
 
     /**
      * 保存上传文件列表
+     * Save uploaded file list
      */
     private void saveAudioList() {
         Gson gson = new GsonBuilder().setPrettyPrinting().create();
@@ -103,14 +107,19 @@ public class DataServiceImpl implements DataService {
         if (!new File(rootPath).exists()) {
             new File(rootPath).mkdirs();
         }
-        String unZipFilePath = rootPath + UUID; // 以压缩文件名为新目录
+        String unZipFilePath = rootPath + UUID;
+        // 以压缩文件名为新目录
+        // the new directory name is the same as the compressed file name
         try {
             // 记录文件集合
+            // record the file collection
             List resultList = new ArrayList<>();
             // 解压缩后的文件
+            // decompressed files
             File[] listFiles = new File(unZipFilePath).listFiles();
 
-            // 判断上传文件是否包含音频文件
+            // 判断上传文件是否包含图片文件
+            // determine whether the uploaded file contains image files
             boolean found = false;
             for (File file : listFiles) {
                 String suffix = FileUtil.getExtensionName(file.getName());
@@ -123,10 +132,12 @@ public class DataServiceImpl implements DataService {
             }
             if (!found) {
                 // 通用异常
+                // general exception
                 throw new BadRequestException(ResEnum.IMAGE_NOT_FOUND.VALUE);
             }
 
             // 保存文件到可访问路径
+            // save file to accessible path
             for (File file : listFiles) {
                 DataInfo dataInfo = new DataInfo();
                 dataInfo.setPreName(file.getName());
@@ -138,13 +149,17 @@ public class DataServiceImpl implements DataService {
                     byte[] bytes = FileUtil.getByte(file);
                     String uuid = UUIDUtil.getUUID();
                     dataInfo.setUuid(uuid);
-                    String fileName = uuid + "." + suffix; // 待存储的文件名
+                    // 待存储的文件名
+                    // file name to be stored
+                    String fileName = uuid + "." + suffix;
                     String relativePath = FileUtil.generatePath(rootPath);
                     // filePath 完整路径（含uuid文件名）
+                    // filePath complete path (including uuid filename)
                     String filePath = rootPath + relativePath + fileName;
                     dataInfo.setFullPath(filePath);
                     dataInfo.setRelativePath(relativePath + fileName);
                     // 转成文件保存
+                    // convert to file and save
                     FileUtil.bytesToFile(bytes, filePath);
                     resultList.add(dataInfo);
                 }
@@ -152,6 +167,7 @@ public class DataServiceImpl implements DataService {
             return resultList;
         } finally {
             // unZipFilePath = rootPath + uuid; // 以压缩文件名为新目录
+            // unZipFilePath = rootPath + uuid; // the new directory name is the same as the compressed file name
             FileUtil.delete(unZipFilePath);
 
         }
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DetectServiceImpl.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DetectServiceImpl.java
index 39272ae6..af9d9183 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DetectServiceImpl.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/DetectServiceImpl.java
@@ -39,6 +39,7 @@ import java.util.List;
 
 /**
  * 目标检测服务
+ * Object detection service
  *
  * @author Calvin
  * @date 2021-12-12
@@ -73,6 +74,7 @@ public class DetectServiceImpl implements DetectService {
                 Rectangle rectangle = box.getBounds();
 
                 // 抠人脸图
+                // extract face image
                 Rectangle subImageRect =
                         FaceUtil.getSubImageRect(
                                 image, rectangle, djlImg.getWidth(), djlImg.getHeight(), 0f);
@@ -83,6 +85,7 @@ public class DetectServiceImpl implements DetectService {
                 BufferedImage subImage = image.getSubimage(x, y, w, h);
                 Image img = DJLImageUtil.bufferedImage2DJLImage(subImage);
                 //获取特征向量
+                // get feature vector
                 List feature = featureService.faceFeature(img);
 
                 FaceObject faceObject = new FaceObject();
@@ -110,6 +113,8 @@ public class DetectServiceImpl implements DetectService {
 
                 // 抠人脸图
                 // factor = 0.1f, 意思是扩大10%，防止人脸仿射变换后，人脸被部分截掉
+                // extract face image
+                // factor = 0.1f, meaning expand 10%, to prevent the face from being partially cut off after face affine transformation
                 Rectangle subImageRect =
                         FaceUtil.getSubImageRect(
                                 image, rectangle, djlImg.getWidth(), djlImg.getHeight(), 1.0f);
@@ -120,6 +125,7 @@ public class DetectServiceImpl implements DetectService {
                 BufferedImage subImage = image.getSubimage(x, y, w, h);
 
                 // debug使用：保存，抠出的人脸图
+                // for debug: save the extracted face image
                 if (save) {
                     String savePath = properties.getPath().getPath() + "detected/";
                     if (!new File(savePath).exists()) {
@@ -129,10 +135,12 @@ public class DetectServiceImpl implements DetectService {
                 }
 
                 // 计算人脸关键点在子图中的新坐标
+                // calculate the new coordinates of the face keypoints in the sub-image
                 List points = (List) box.getPath();
                 double[][] pointsArray = FaceUtil.pointsArray(subImageRect, points);
 
                 // 转 buffered image 图片格式
+                // convert to buffered image format
                 BufferedImage converted3BGRsImg =
                         new BufferedImage(
                                 subImage.getWidth(), subImage.getHeight(), BufferedImage.TYPE_3BYTE_BGR);
@@ -145,17 +153,21 @@ public class DetectServiceImpl implements DetectService {
                     NDArray dstPoints = SVDUtil.point112x112(manager);
 
                     // 定制的5点仿射变换
+                    // customized 5-point affine transformation
                     Mat svdMat = NDArrayUtil.toOpenCVMat(manager, srcPoints, dstPoints);
                     // 换仿射变换矩阵
+                    // replace affine transformation matrix
                     mat = FaceAlignment.get5WarpAffineImg(mat, svdMat);
 
                     // mat转bufferedImage类型
+                    // convert mat to buffered image type
                     BufferedImage mat2BufferedImage = OpenCVImageUtil.mat2BufferedImage(mat);
                     int width = mat2BufferedImage.getWidth() > 112 ? 112 : mat2BufferedImage.getWidth();
                     int height = mat2BufferedImage.getHeight() > 112 ? 112 : mat2BufferedImage.getHeight();
                     mat2BufferedImage = mat2BufferedImage.getSubimage(0, 0, width, height);
 
                     // debug使用：保存，对齐后的人脸图
+                    // for debug: save the aligned face image
                     if (save) {
                         String savePath = properties.getPath().getPath() + "aligned/";
                         if (!new File(savePath).exists()) {
@@ -167,6 +179,7 @@ public class DetectServiceImpl implements DetectService {
 
                     Image img = DJLImageUtil.bufferedImage2DJLImage(mat2BufferedImage);
                     //获取特征向量
+                    // get feature vector
                     List feature = featureService.faceFeature(img);
 
                     FaceObject faceObject = new FaceObject();
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/FeatureServiceImpl.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/FeatureServiceImpl.java
index 583afc88..b9bc5ddf 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/FeatureServiceImpl.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/FeatureServiceImpl.java
@@ -15,6 +15,8 @@ import java.util.List;
 
 /**
  * 特征提取服务
+ * Feature Service
+ *
  * @author Calvin
  * @date 2021-12-12
  **/
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/LocalStorageServiceImpl.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/LocalStorageServiceImpl.java
index b239b311..ae261485 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/LocalStorageServiceImpl.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/LocalStorageServiceImpl.java
@@ -16,6 +16,8 @@ import java.util.List;
 
 /**
  * 文件存储服务
+ * File Storage Service
+ *
  * @author Calvin
  * @date 2021-12-12
  **/
@@ -58,6 +60,8 @@ public class LocalStorageServiceImpl implements LocalStorageService {
 
     /**
      * 保存上传文件列表
+     * save file list
+     *
      */
     public void saveStorageList() {
         Gson gson = new GsonBuilder().setPrettyPrinting().create();
@@ -73,6 +77,7 @@ public class LocalStorageServiceImpl implements LocalStorageService {
 
     /**
      * 新增文件
+     * add file
      */
     public void addStorageFile(LocalStorage localStorage) {
         localStorage.setId(storageId);
@@ -83,6 +88,7 @@ public class LocalStorageServiceImpl implements LocalStorageService {
 
     /**
      * 根据ID查询
+     *  get file by id
      */
     public LocalStorage findById(int id) {
         for (LocalStorage localStorage : storageList) {
@@ -95,6 +101,7 @@ public class LocalStorageServiceImpl implements LocalStorageService {
 
     /**
      * 删除
+     * Delete
      */
     public boolean delete(int id) {
         for (LocalStorage localStorage : storageList) {
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/SearchServiceImpl.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/SearchServiceImpl.java
index 6c3cf75b..f590c424 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/SearchServiceImpl.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/service/impl/SearchServiceImpl.java
@@ -66,6 +66,7 @@ public class SearchServiceImpl implements SearchService {
     private static final String VECTOR_FIELD = "feature";
 
     // 重置向量引擎
+    //Reset vector engine
     public void clearSearchEngine() {
         ConnectionPool connPool = this.getConnectionPool(false);
         MilvusClient client = connPool.getConnection();
@@ -80,6 +81,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 初始化向量引擎
+    //Initialize vector engine
     public void initSearchEngine() {
         ConnectionPool connPool = this.getConnectionPool(false);
         MilvusClient client = connPool.getConnection();
@@ -105,12 +107,15 @@ public class SearchServiceImpl implements SearchService {
 
     public void returnConnection(ConnectionPool connPool, MilvusClient client) {
         // 释放 Milvus client 回连接池
+        //Release Milvus client back to the connection pool
         connPool.returnConnection(client);
         // 关闭 Milvus 连接池
+        //Close the Milvus connection pool
         // connPool.closeConnectionPool();
     }
 
     // 检查是否存在 collection
+    //Check if collection exists
     public R hasCollection(MilvusClient client) {
         R response = client.hasCollection(HasCollectionParam.newBuilder()
                 .withCollectionName(collectionName)
@@ -130,6 +135,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 创建 collection
+    //Create collection
     public R createCollection(MilvusClient milvusClient, long timeoutMiliseconds) {
         System.out.println("========== createCollection() ==========");
         FieldType fieldType1 = FieldType.newBuilder()
@@ -137,7 +143,7 @@ public class SearchServiceImpl implements SearchService {
                 .withDescription("image id")
                 .withDataType(DataType.Int64)
                 .withPrimaryKey(true)
-                .withAutoID(false) // 使用数据库生成的id
+                .withAutoID(false)
                 .build();
 
         FieldType fieldType2 = FieldType.newBuilder()
@@ -161,6 +167,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 加载 collection
+    //Load collection
     public R loadCollection(MilvusClient milvusClient) {
         System.out.println("========== loadCollection() ==========");
         R response = milvusClient.loadCollection(LoadCollectionParam.newBuilder()
@@ -170,6 +177,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 释放 collection
+    //Release collection
     public R releaseCollection(MilvusClient milvusClient) {
         System.out.println("========== releaseCollection() ==========");
         R response = milvusClient.releaseCollection(ReleaseCollectionParam.newBuilder()
@@ -179,6 +187,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 删除 collection
+    //Delete collection
     public R dropCollection(MilvusClient milvusClient) {
         System.out.println("========== dropCollection() ==========");
         R response = milvusClient.dropCollection(DropCollectionParam.newBuilder()
@@ -188,6 +197,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 创建 分区
+    //Create partition
     public R createPartition(MilvusClient milvusClient, String partitionName) {
         System.out.println("========== createPartition() ==========");
         R response = milvusClient.createPartition(CreatePartitionParam.newBuilder()
@@ -198,6 +208,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 删除 分区
+    //Delete partition
     public R dropPartition(MilvusClient milvusClient, String partitionName) {
         System.out.println("========== dropPartition() ==========");
         R response = milvusClient.dropPartition(DropPartitionParam.newBuilder()
@@ -208,6 +219,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 是否存在分区
+    //Check if partition exists
     public R hasPartition(MilvusClient milvusClient, String partitionName) {
         System.out.println("========== hasPartition() ==========");
         R response = milvusClient.hasPartition(HasPartitionParam.newBuilder()
@@ -218,6 +230,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 创建 index
+    //Create index
     public R createIndex(MilvusClient milvusClient) {
         System.out.println("========== createIndex() ==========");
         String INDEX_PARAM = "{\"nlist\":" + nlist + "}";
@@ -296,6 +309,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 删除 index
+    //Delete index
     public R dropIndex(MilvusClient milvusClient) {
         System.out.println("========== dropIndex() ==========");
         R response = milvusClient.dropIndex(DropIndexParam.newBuilder()
@@ -306,6 +320,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 插入向量
+    //Insert vectors
     public R insert(List vectorIds, List> vectors) {
         System.out.println("========== insert() ==========");
         ConnectionPool connPool = this.getConnectionPool(false);
@@ -328,6 +343,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 查询向量
+    //Query vectors
     // queryExpr = ID_FIELD + " == 60";
     public R query(String expr) {
         System.out.println("========== query() ==========");
@@ -351,6 +367,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 搜索向量
+    //Search vectors
     public R search(Integer topK, List> vectorsToSearch) {
         System.out.println("========== searchImage() ==========");
         ConnectionPool connPool = this.getConnectionPool(false);
@@ -385,6 +402,7 @@ public class SearchServiceImpl implements SearchService {
     }
 
     // 删除向量
+    // Delete Vector
     // String deleteExpr = ID_FIELD + " in " + deleteIds.toString();
     public R delete(String expr) {
         System.out.println("========== delete() ==========");
diff --git a/8_suite_hub/face_search/face_search/src/main/java/me/aias/tools/MilvusInit.java b/8_suite_hub/face_search/face_search/src/main/java/me/aias/tools/MilvusInit.java
index cb1d9542..80d98283 100644
--- a/8_suite_hub/face_search/face_search/src/main/java/me/aias/tools/MilvusInit.java
+++ b/8_suite_hub/face_search/face_search/src/main/java/me/aias/tools/MilvusInit.java
@@ -12,6 +12,7 @@ import io.milvus.param.partition.DropPartitionParam;
 
 /**
  * 搜索引擎初始化工具
+ * Search engine initialization tool
  *
  * @author Calvin
  * @date 2021-12-12
@@ -33,6 +34,7 @@ public class MilvusInit {
     public static void main(String[] args) {
         try {
             // 检查 collection 是否存在，不存在会抛异常
+            // Check if the collection exists, an exception will be thrown if it does not exist
             hasCollection();
             releaseCollection();
 //            dropPartition("p1");
@@ -43,10 +45,12 @@ public class MilvusInit {
             e.printStackTrace();
         }
         // 关闭 Milvus 连接
+        // Close Milvus connection
         milvusClient.close();
     }
 
     // 检查是否存在 collection
+    // Check if the collection exists
     private static R hasCollection() {
         System.out.println("========== hasCollection() ==========");
         R response = milvusClient.hasCollection(HasCollectionParam.newBuilder()
@@ -58,6 +62,7 @@ public class MilvusInit {
     }
 
     // 删除 collection
+    // Delete collection
     private static R dropCollection() {
         System.out.println("========== dropCollection() ==========");
         R response = milvusClient.dropCollection(DropCollectionParam.newBuilder()
@@ -78,6 +83,7 @@ public class MilvusInit {
     }
 
     // 删除 index
+    // Delete index
     private static R dropIndex() {
         System.out.println("========== dropIndex() ==========");
         R response = milvusClient.dropIndex(DropIndexParam.newBuilder()
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/ConfigAdapter.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/ConfigAdapter.java
index 85e99608..32be8841 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/ConfigAdapter.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/ConfigAdapter.java
@@ -60,6 +60,7 @@ public class ConfigAdapter implements WebMvcConfigurer {
     @Override
     public void configureMessageConverters(List> converters) {
         // 使用 fastjson 序列化，会导致 @JsonIgnore 失效，可以使用 @JSONField(serialize = false) 替换
+        // Use fastjson serialization, which will cause @JsonIgnore to be invalid, can be replaced with @JSONField (serialize = false)
         FastJsonHttpMessageConverter fastJsonHttpMessageConverter = new FastJsonHttpMessageConverter();
         List supportMediaTypeList = new ArrayList<>();
         supportMediaTypeList.add(MediaType.APPLICATION_JSON_UTF8);
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/SwaggerConfig.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/SwaggerConfig.java
index d25ca5a5..a7996373 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/SwaggerConfig.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/configuration/SwaggerConfig.java
@@ -68,7 +68,7 @@ public class SwaggerConfig {
     private ApiInfo apiInfo() {
         return new ApiInfoBuilder()
                 .description("")
-                .title("接口文档")
+                .title("API Doc")
                 .version("1.0")
                 .build();
     }
@@ -77,6 +77,7 @@ public class SwaggerConfig {
 
 /**
  *  将Pageable转换展示在swagger中
+ *  Convert Pageable for display in Swagger
  */
 @Configuration
 class SwaggerDataConfig {
@@ -99,13 +100,13 @@ class SwaggerDataConfig {
     @ApiModel
     @Data
     private static class Page {
-        @ApiModelProperty("页码 (0..N)")
+        @ApiModelProperty("Page number (0..N)")
         private Integer page;
 
-        @ApiModelProperty("每页显示的数目")
+        @ApiModelProperty("Number of items per page")
         private Integer size;
 
-        @ApiModelProperty("以下列格式排序标准：property[,asc | desc]。 默认排序顺序为升序。 支持多种排序条件：如：id,asc")
+        @ApiModelProperty("Sort criteria in the following format: property[,asc|desc]. Default sort order is ascending. Multiple sort conditions are supported, such as id,asc")
         private List sort;
     }
 }
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/InferController.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/InferController.java
index 6793bee7..c5ff2d94 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/InferController.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/InferController.java
@@ -24,7 +24,7 @@ import java.util.List;
  * @author Calvin
  * @date Oct 19, 2021
  */
-@Api(tags = "通用文字识别")
+@Api(tags = "通用文字识别 -General Text Recognition")
 @RestController
 @RequestMapping("/inference")
 public class InferController {
@@ -42,7 +42,7 @@ public class InferController {
     @Autowired
     private FileProperties properties;
 
-    @ApiOperation(value = "通用文字识别-URL")
+    @ApiOperation(value = "通用文字识别-URL -General Text Recognition-URL")
     @GetMapping(value = "/generalInfoForImageUrl", produces = "application/json;charset=utf-8")
     public ResultBean generalInfoForImageUrl(@RequestParam(value = "url") String url) throws IOException {
         try {
@@ -56,7 +56,7 @@ public class InferController {
         }
     }
 
-    @ApiOperation(value = "通用文字识别-图片")
+    @ApiOperation(value = "通用文字识别-图片 -General Text Recognition-Image")
     @PostMapping(value = "/generalInfoForImageFile", produces = "application/json;charset=utf-8")
     public ResultBean generalInfoForImageFile(@RequestParam(value = "imageFile") MultipartFile imageFile) {
         try (InputStream inputStream = imageFile.getInputStream()) {
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TableController.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TableController.java
index 72148340..01fabe2c 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TableController.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TableController.java
@@ -32,7 +32,7 @@ import java.util.concurrent.ConcurrentHashMap;
  * @author Calvin
  * @date Oct 19, 2021
  */
-@Api(tags = "表格文字识别")
+@Api(tags = "表格文字识别 - Table Text Recognition")
 @RestController
 @RequestMapping("/table")
 public class TableController {
@@ -50,13 +50,14 @@ public class TableController {
     @Autowired
     private FileProperties properties;
 
-    @ApiOperation(value = "单表格文字识别-URL")
+    @ApiOperation(value = "单表格文字识别-URL - Single Table Text Recognition - URL")
     @GetMapping(value = "/tableInfoForImageUrl")
     public ResultBean tableInfoForImageUrl(@RequestParam(value = "url") String url) {
         try {
             Image image = ImageFactory.getInstance().fromUrl(url);
             String tableHtml = tableInferService.getTableHtml(image);
             // 创建一个Excel文件
+            // Create an Excel file
             tableHtml = tableHtml.replace("", "");
             tableHtml = tableHtml.replace("", "");
             HSSFWorkbook workbook = ConvertHtml2Excel.table2Excel(tableHtml);
@@ -92,7 +93,7 @@ public class TableController {
         }
     }
 
-    @ApiOperation(value = "单表格文字识别-图片")
+    @ApiOperation(value = "单表格文字识别-图片 -Single Table Text Recognition - Image")
     @PostMapping("/tableInfoForImageFile")
     public ResultBean tableInfoForImageFile(@RequestParam(value = "imageFile") MultipartFile imageFile) {
         try (InputStream inputStream = imageFile.getInputStream()) {
@@ -100,6 +101,7 @@ public class TableController {
             Image image = ImageFactory.getInstance().fromInputStream(inputStream);
             String tableHtml = tableInferService.getTableHtml(image);
             // 创建一个Excel文件
+            // Create an Excel file
             tableHtml = tableHtml.replace("", "");
             tableHtml = tableHtml.replace("", "");
             HSSFWorkbook workbook = ConvertHtml2Excel.table2Excel(tableHtml);
@@ -138,7 +140,7 @@ public class TableController {
         }
     }
 
-    @ApiOperation(value = "表单表格自动检测文字识别-URL")
+    @ApiOperation(value = "表单表格自动检测文字识别-URL -Auto Table Text Detection and Recognition - URL")
     @GetMapping(value = "/autoTableInfoForImageUrl")
     public ResultBean autoTableInfoForImageUrl(@RequestParam(value = "url") String url) {
         try {
@@ -190,7 +192,7 @@ public class TableController {
         }
     }
 
-    @ApiOperation(value = "表单表格自动检测文字识别-URL")
+    @ApiOperation(value = "表单表格自动检测文字识别-URL -Auto Table Text Detection and Recognition - Image")
     @PostMapping("/autoTableInfoForImageFile")
     public ResultBean autoTableInfoForImageFile(@RequestParam(value = "imageFile") MultipartFile imageFile) {
         try (InputStream inputStream = imageFile.getInputStream()) {
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TemplateController.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TemplateController.java
index 5817f821..371c5348 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TemplateController.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/controller/TemplateController.java
@@ -27,7 +27,7 @@ import java.util.Map;
  * @author Calvin
  * @date Oct 19, 2021
  */
-@Api(tags = "自定义模版文字识别")
+@Api(tags = "自定义模版文字识别 - Custom Template Text Recognition")
 @RestController
 @Configuration
 @RequestMapping("/template")
@@ -42,11 +42,12 @@ public class TemplateController {
 
     /**
      * 文件配置
+     * File Configuration
      */
     @Autowired
     private FileProperties properties;
 
-    @ApiOperation(value = "获取模版")
+    @ApiOperation(value = "获取模版 Get Template")
     @GetMapping(value = "/getTemplate", produces = "application/json;charset=utf-8")
     public ResultBean getTemplate(@RequestParam(value = "uid") String uid) {
         try {
@@ -58,7 +59,7 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "获取模版列表")
+    @ApiOperation(value = "获取模版列表 Get Template List")
     @GetMapping(value = "/getTemplates", produces = "application/json;charset=utf-8")
     public ResultBean getTemplatesList() {
         try {
@@ -69,7 +70,7 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "更新模板信息")
+    @ApiOperation(value = "更新模板信息 Update Template Information")
     @PostMapping(value = "/updateTemplate", consumes = "application/json;charset=utf-8")
     public ResultBean updateTemplate(@RequestBody TemplateBean templateBean) {
         try {
@@ -81,7 +82,7 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "删除模板")
+    @ApiOperation(value = "删除模板 Remove Template")
     @PostMapping(value = "/removeTemplate", produces = "application/json;charset=utf-8")
     public ResultBean removeTemplate(@RequestParam(value = "uid") String uid) {
         try {
@@ -93,7 +94,7 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "识别标注字段")
+    @ApiOperation(value = "识别标注字段 Recognize Label Fields")
     @PostMapping(value = "/getLabelData", produces = "application/json;charset=utf-8")
     public ResultBean getLabelData(@RequestBody LabelDTO labelDTO) {
         try {
@@ -107,11 +108,12 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "创建模板")
+    @ApiOperation(value = "创建模板 Create Template")
     @PostMapping(value = "/addTemplate")
     public ResultBean addTemplate(@RequestParam(value = "name") String name, @RequestParam(value = "imageFile") MultipartFile imageFile) {
         try {
             // 要上传的目标文件存放路径
+            // Target file storage path to be uploaded
             FileProperties.ElPath path = properties.getPath();
             String imagePath = path.getPath().replace("\\", "/") + "images/";
             FileUtils.checkAndCreatePath(imagePath);
@@ -146,7 +148,7 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "模版文字识别-URL")
+    @ApiOperation(value = "模版文字识别-URL Template Text Recognition-URL")
     @GetMapping(value = "/infoForImageUrl", produces = "application/json;charset=utf-8")
     public ResultBean infoForImageUrl(@RequestParam(value = "uid") String uid, @RequestParam(value = "url") String url) {
         try {
@@ -161,7 +163,7 @@ public class TemplateController {
         }
     }
 
-    @ApiOperation(value = "模版文字识别-图片")
+    @ApiOperation(value = "模版文字识别-图片 - Template Text Recognition-Image")
     @PostMapping(value = "/infoForImageFile", produces = "application/json;charset=utf-8")
     public ResultBean infoForImageFile(@RequestParam(value = "uid") String uid, @RequestParam(value = "imageFile") MultipartFile imageFile) {
         try (InputStream inputStream = imageFile.getInputStream()) {
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/LayoutDetectionTranslator.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/LayoutDetectionTranslator.java
index 710266d8..d3c6b07d 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/LayoutDetectionTranslator.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/LayoutDetectionTranslator.java
@@ -14,7 +14,12 @@ import ai.djl.translate.TranslatorContext;
 
 import java.util.ArrayList;
 import java.util.List;
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class LayoutDetectionTranslator implements Translator {
 
   private int width;
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/PerspectiveRecogition.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/PerspectiveRecogition.java
index b9b57524..3bbd8e47 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/PerspectiveRecogition.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/PerspectiveRecogition.java
@@ -28,12 +28,14 @@ public class PerspectiveRecogition {
     public static Map recognize(NDManager manager, BufferedImage templateImg, RecognitionModel recognitionModel, Image image, List anchorlabels, List contentLabels, String fileRelativePath, String distance, boolean save) throws TranslateException {
 
         // 锚点识别区 - 计算中心点坐标，用于透视变换
+        // Anchor recognition area - calculating the center point coordinates for perspective transformation
         for (int i = 0; i < anchorlabels.size(); i++) {
             List points = anchorlabels.get(i).getPoints();
             anchorlabels.get(i).setCenterPoint(PointUtils.getCenterPoint(points));
         }
 
         // 文本检测区
+        // Text detection area
         List detectedTexts = new ArrayList<>();
         DetectedObjects textDetections = recognitionModel.predict(image);
         List dt_boxes = textDetections.items();
@@ -85,23 +87,30 @@ public class PerspectiveRecogition {
             srcPoint2f = NDArrayUtils.toOpenCVPoint2f(srcPoints, 3);
             dstPoint2f = NDArrayUtils.toOpenCVPoint2f(dstPoints, 3);
             //3点仿射变换
+            // 3-point affine transformation
             warp_mat = opencv_imgproc.getAffineTransform(srcPoint2f.position(0), dstPoint2f.position(0));
         } else if (dstPoints.size() >= 4) {
             srcPoint2f = NDArrayUtils.toOpenCVPoint2f(srcPoints, 4);
             dstPoint2f = NDArrayUtils.toOpenCVPoint2f(dstPoints, 4);
             //4点透视变换
+            // 4-point perspective transformation
             warp_mat = opencv_imgproc.getPerspectiveTransform(srcPoint2f.position(0), dstPoint2f.position(0));
         }
 
 
         if (dstPoints.size() >= 3 && save) {
             // 模板图片透视变换，跟上传图片对齐
+            // Template image perspective transformation, aligning with uploaded image
             Mat mat = Java2DFrameUtils.toMat(templateImg);
-            if (dstPoints.size() == 3) { //3点仿射变换
+            if (dstPoints.size() == 3) {
+                //3点仿射变换
+                // 3-point affine transformation
                 mat = OpenCVUtils.affineTransform(mat, srcPoint2f, dstPoint2f);
                 templateImg = Java2DFrameUtils.toBufferedImage(mat);
                 DJLImageUtils.saveImage(templateImg, "affineTransform.png", fileRelativePath);
-            } else if (dstPoints.size() >= 4) { //4点透视变换
+            } else if (dstPoints.size() >= 4) {
+                //4点透视变换
+                // 4-point perspective transformation
                 mat = OpenCVUtils.perspectiveTransform(mat, srcPoint2f, dstPoint2f);
                 templateImg = Java2DFrameUtils.toBufferedImage(mat);
                 DJLImageUtils.saveImage(templateImg, "perspectiveTransform.png", fileRelativePath);
@@ -109,16 +118,20 @@ public class PerspectiveRecogition {
         }
 
         // 内容识别区 - 计算中心点坐标，用于距离计算
+        // Content recognition area - calculating the center point coordinates for distance calculation
         for (int i = 0; i < contentLabels.size(); i++) {
             List points = contentLabels.get(i).getPoints();
 
             //根据变换矩阵，对所有点坐标进行坐标变换
+            // Transform all point coordinates using the transformation matrix
             if (dstPoints.size() >= 3) {
                 points = PointUtils.transformPoints(manager, warp_mat, points);
             }
             ai.djl.modality.cv.output.Point point = PointUtils.getCenterPoint(points);
 
-            if (dstPoints.size() < 3) { //无坐标变换，则将坐标归一化（坐标变为占整张图片的百分比）
+            if (dstPoints.size() < 3) {
+                //无坐标变换，则将坐标归一化（坐标变为占整张图片的百分比）
+                // No coordinate transformation, normalize the coordinates (i.e., convert them to a percentage of the entire image)
                 double x = point.getX() / templateImg.getHeight();
                 double y = point.getY() / templateImg.getWidth();
                 ai.djl.modality.cv.output.Point djlPoint = new ai.djl.modality.cv.output.Point(x, y);
@@ -133,11 +146,14 @@ public class PerspectiveRecogition {
         }
 
         // 文本检测区 - 中心点坐标根据透视变换矩阵进行坐标变换
+        // Text detection area - center point coordinates are transformed based on the perspective transformation matrix
         for (int i = 0; i < detectedTexts.size(); i++) {
             List points = detectedTexts.get(i).getPoints();
             ai.djl.modality.cv.output.Point point = PointUtils.getCenterPoint(points);
 
-            if (dstPoints.size() < 3) { //无坐标变换，则将坐标归一化（坐标变为占整张图片的百分比）
+            if (dstPoints.size() < 3) {
+                //无坐标变换，则将坐标归一化（坐标变为占整张图片的百分比）
+                // No coordinate transformation, normalize the coordinates (i.e., convert them to a percentage of the entire image)
                 double x = point.getX() / image.getHeight();
                 double y = point.getY() / image.getWidth();
                 ai.djl.modality.cv.output.Point djlPoint = new ai.djl.modality.cv.output.Point(x, y);
@@ -161,6 +177,7 @@ public class PerspectiveRecogition {
 
         if (save) {
             // 保存图
+            // Save image
             DJLImageUtils.saveImage((BufferedImage) image.getWrappedImage(), "points_result.png", fileRelativePath);
         }
 
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableDetectionModel.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableDetectionModel.java
index 86cf3631..cca2fff1 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableDetectionModel.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableDetectionModel.java
@@ -48,6 +48,7 @@ public final class TableDetectionModel {
         List dt_boxes = textDetections.items();
 
         // 获取 Cell 与 文本检测框 的对应关系(1:N)。
+        // Get the correspondence (1:N) between cells and text detection boxes.
         Map> matched = new ConcurrentHashMap<>();
 
         for (int i = 0; i < dt_boxes.size(); i++) {
@@ -55,6 +56,7 @@ public final class TableDetectionModel {
             Rectangle textBounds = item.getBoundingBox().getBounds();
             int[] box_1 = rectXYXY(textBounds, image.getWidth(), image.getHeight());
             // 获取两两cell之间的L1距离和 1- IOU
+            // Get the L1 distance and 1- IOU between each pair of cells.
             List> distances = new ArrayList<>();
             for (BoundingBox cell : cells) {
                 Rectangle cellBounds = cell.getBounds();
@@ -64,9 +66,11 @@ public final class TableDetectionModel {
                 distances.add(Pair.of(distance, iou));
             }
             // 根据距离和IOU挑选最"近"的cell
+            // Select the "closest" cell based on the distance and IOU.
             Pair nearest = sorted(distances);
 
             // 获取最小距离对应的下标id，也等价于cell的下标id  （distances列表是根据遍历cells生成的）
+            // Get the index id of the smallest distance, which is equivalent to the index id of the cell (the distances list is generated by traversing cells).
             int id = 0;
             for (int idx = 0; idx < distances.size(); idx++) {
                 Pair current = distances.get(idx);
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableStructTranslator.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableStructTranslator.java
index 117bf431..117a3a57 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableStructTranslator.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/inference/TableStructTranslator.java
@@ -28,7 +28,12 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class TableStructTranslator implements Translator {
 
   private final int maxLength;
@@ -237,7 +242,6 @@ public class TableStructTranslator implements Translator {
   public void saveImage(Image img, String name, String path) {
     Path outputDir = Paths.get(path);
     Path imagePath = outputDir.resolve(name);
-    // OpenJDK 不能保存 jpg 图片的 alpha channel
     try {
       img.save(Files.newOutputStream(imagePath), "png");
     } catch (IOException e) {
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TableInferServiceImpl.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TableInferServiceImpl.java
index 5ae4aa7d..cd1f9c46 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TableInferServiceImpl.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TableInferServiceImpl.java
@@ -51,9 +51,11 @@ public class TableInferServiceImpl implements TableInferService {
         List boxes = layoutDetections.items();
         for (int i = 0; i < boxes.size(); i++) {
             // TODO 模型需优化, 页面出现多个表不准，但是当前可以用于表单中一个表格自动检测识别
+            // TODO Model needs optimization, multiple tables on the page are not allowed, but currently it can be used to automatically detect and recognize a table in a form
             if (boxes.get(i).getClassName().equals("Table")) {
                 Image subImage = getSubImage(image, boxes.get(i).getBoundingBox());
                 // 表格单元检测
+                // Table cell detection
                 DetectedObjects textDetections = recognitionModel.predict(subImage);
                 String tableHtml = tableDetectionModel.getTableHtml(subImage, textDetections);
                 tableHtmlList.add(tableHtml);
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TemplateServiceImpl.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TemplateServiceImpl.java
index b9f40cda..af2553b5 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TemplateServiceImpl.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/service/impl/TemplateServiceImpl.java
@@ -95,6 +95,7 @@ public class TemplateServiceImpl implements TemplateService {
 
     /**
      * 获取模板
+     * Get Template
      *
      * @param uid
      */
@@ -112,6 +113,7 @@ public class TemplateServiceImpl implements TemplateService {
 
     /**
      * 新增模板
+     * Add Template
      *
      * @param templateBean
      */
@@ -123,15 +125,18 @@ public class TemplateServiceImpl implements TemplateService {
         String json = gson.toJson(templateList);
         FileProperties.ElPath path = properties.getPath();
         // 保存模版列表数据
+        // Save template list data
         String fileRelativePath = path.getPath().replace("\\", "/");
         FileUtils.saveFile(fileRelativePath, TEMPLATE_LIST_FILE, json);
         // 保存模版数据
+        // Save template data
         json = gson.toJson(templateBean);
         FileUtils.saveFile(fileRelativePath + "templates/", templateBean.getUid() + ".json", json);
     }
 
     /**
      * 更新模板
+     * Update Template
      *
      * @param templateBean
      */
@@ -149,15 +154,18 @@ public class TemplateServiceImpl implements TemplateService {
         String json = gson.toJson(templateList);
         FileProperties.ElPath path = properties.getPath();
         // 保存模版列表数据
+        // Save template list data
         String fileRelativePath = path.getPath().replace("\\", "/");
         FileUtils.saveFile(fileRelativePath, TEMPLATE_LIST_FILE, json);
         // 保存模版数据
+        // Save template data
         json = gson.toJson(templateBean);
         FileUtils.saveFile(fileRelativePath + "templates/", templateBean.getUid() + ".json", json);
     }
 
     /**
      * 删除模板
+     * Delete Template
      *
      * @param uid
      */
@@ -174,9 +182,11 @@ public class TemplateServiceImpl implements TemplateService {
         String json = gson.toJson(templateList);
         FileProperties.ElPath path = properties.getPath();
         // 保存模版列表数据
+        // Save template data
         String fileRelativePath = path.getPath().replace("\\", "/");
         FileUtils.saveFile(fileRelativePath, TEMPLATE_LIST_FILE, json);
         // 删除模版数据
+        // Delete template data
         FileUtils.removeFile(fileRelativePath + "templates/", uid + ".json");
     }
 
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/ConvertHtml2Excel.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/ConvertHtml2Excel.java
index eb28fcbc..c21d75ab 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/ConvertHtml2Excel.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/ConvertHtml2Excel.java
@@ -25,8 +25,9 @@ import java.util.List;
 public class ConvertHtml2Excel {
     /**
      * html表格转excel
+     * Convert HTML table to Excel
      *
-     * @param tableHtml 如
+     * @param tableHtml
      *            
      *            ..
      *            

@@ -40,9 +41,10 @@ public class ConvertHtml2Excel {
         try {
             Document data = DocumentHelper.parseText(tableHtml);
             // 生成表头
+            // generate header
             Element thead = data.getRootElement().element("thead");
             HSSFCellStyle titleStyle = getTitleStyle(wb);
-            int ls=0;//列数
+            int ls=0;//列数 //column number
             if (thead != null) {
                 List trLs = thead.elements("tr");
                 for (Element trEle : trLs) {
@@ -54,6 +56,7 @@ public class ConvertHtml2Excel {
                 }
             }
             // 生成表体
+            // generate body
             Element tbody = data.getRootElement().element("tbody");
             HSSFCellStyle contentStyle = getContentStyle(wb);
             if (tbody != null) {
@@ -68,12 +71,15 @@ public class ConvertHtml2Excel {
                 }
             }
             // 合并表头
+            // merge header
             for (CrossRangeCellMeta crcm : crossRowEleMetaLs) {
                 sheet.addMergedRegion(new CellRangeAddress(crcm.getFirstRow(), crcm.getLastRow(), crcm.getFirstCol(), crcm.getLastCol()));
                 setRegionStyle(sheet, new CellRangeAddress(crcm.getFirstRow(), crcm.getLastRow(), crcm.getFirstCol(), crcm.getLastCol()),titleStyle);
             }
             for(int i=0;i tdLs, int rowIndex, HSSFRow row, int startCellIndex, HSSFCellStyle cellStyle,
@@ -107,7 +114,9 @@ public class ConvertHtml2Excel {
         for (int eleIndex = 0; eleIndex < tdLs.size(); i++, eleIndex++) {
             int captureCellSize = getCaptureCellSize(rowIndex, i, crossRowEleMetaLs);
             while (captureCellSize > 0) {
-                for (int j = 0; j < captureCellSize; j++) {// 当前行跨列处理（补单元格）
+                for (int j = 0; j < captureCellSize; j++) {
+                    // 当前行跨列处理（补单元格）
+                    //handle the current row span (fill in cells)
                     row.createCell(i);
                     i++;
                 }
@@ -131,10 +140,14 @@ public class ConvertHtml2Excel {
             int rowSpan = NumberUtils.toInt(thEle.attributeValue("rowspan"), 1);
             int colSpan = NumberUtils.toInt(thEle.attributeValue("colspan"), 1);
             c.setCellStyle(cellStyle);
-            if (rowSpan > 1 || colSpan > 1) { // 存在跨行或跨列
+            if (rowSpan > 1 || colSpan > 1) {
+                // 存在跨行或跨列
+                //exists row and column span
                 crossRowEleMetaLs.add(new CrossRangeCellMeta(rowIndex, i, rowSpan, colSpan));
             }
-            if (colSpan > 1) {// 当前行跨列处理（补单元格）
+            if (colSpan > 1) {
+                // 当前行跨列处理（补单元格）
+                // handle the current row span (fill in cells)
                 for (int j = 1; j < colSpan; j++) {
                     i++;
                     row.createCell(i);
@@ -146,6 +159,7 @@ public class ConvertHtml2Excel {
 
     /**
      * 设置合并单元格的边框样式
+     * Set the border style of the merged cells
      *
      * @param sheet
      * @param region
@@ -163,11 +177,12 @@ public class ConvertHtml2Excel {
 
     /**
      * 获得因rowSpan占据的单元格
+     * Get the cells occupied by rowSpan
      *
-     * @param rowIndex 行号
-     * @param colIndex 列号
-     * @param crossRowEleMetaLs 跨行列元数据
-     * @return 当前行在某列需要占据单元格
+     * @param rowIndex 行号 - row number
+     * @param colIndex 列号 - column number
+     * @param crossRowEleMetaLs 跨行列元数据 - row and column span metadata
+     * @return 当前行在某列需要占据单元格 - the number of cells to be occupied in a column on the current row
      */
     private static int getCaptureCellSize(int rowIndex, int colIndex, List crossRowEleMetaLs) {
         int captureCellSize = 0;
@@ -183,6 +198,7 @@ public class ConvertHtml2Excel {
 
     /**
      * 获得标题样式
+     * Get the title style
      *
      * @param workbook
      * @return
@@ -194,12 +210,12 @@ public class ConvertHtml2Excel {
         HSSFCellStyle style = workbook.createCellStyle();
         style.setVerticalAlignment(VerticalAlignment.CENTER);
         style.setAlignment(HorizontalAlignment.CENTER);
-        style.setBorderBottom(BorderStyle.THIN); //下边框
-        style.setBorderLeft(BorderStyle.THIN);//左边框
-        style.setBorderTop(BorderStyle.THIN);//上边框
-        style.setBorderRight(BorderStyle.THIN);//右边框
+        style.setBorderBottom(BorderStyle.THIN); //下边框 bottom border
+        style.setBorderLeft(BorderStyle.THIN);//左边框 left border
+        style.setBorderTop(BorderStyle.THIN);//上边框 top border
+        style.setBorderRight(BorderStyle.THIN);//右边框 right border
         //style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
-        //style.setFillForegroundColor(titlebackgroundcolor);// 背景色
+        //style.setFillForegroundColor(titlebackgroundcolor);// 背景色 background color
 
         HSSFFont font = workbook.createFont();
         font.setFontName(fontName);
@@ -211,6 +227,7 @@ public class ConvertHtml2Excel {
 
     /**
      * 获得内容样式
+     * Get the content style
      *
      * @param wb
      * @return
@@ -219,16 +236,16 @@ public class ConvertHtml2Excel {
         short fontSize = 12;
         String fontName = "宋体";
         HSSFCellStyle style = wb.createCellStyle();
-        style.setBorderBottom(BorderStyle.THIN); //下边框
-        style.setBorderLeft(BorderStyle.THIN);//左边框
-        style.setBorderTop(BorderStyle.THIN);//上边框
-        style.setBorderRight(BorderStyle.THIN);//右边框
+        style.setBorderBottom(BorderStyle.THIN); //下边框 bottom border
+        style.setBorderLeft(BorderStyle.THIN);//左边框 left border
+        style.setBorderTop(BorderStyle.THIN);//上边框 top border
+        style.setBorderRight(BorderStyle.THIN);//右边框 right border
         HSSFFont font = wb.createFont();
         font.setFontName(fontName);
         font.setFontHeightInPoints(fontSize);
         style.setFont(font);
-        style.setAlignment(HorizontalAlignment.CENTER);//水平居中
-        style.setVerticalAlignment(VerticalAlignment.CENTER);//垂直居中
+        style.setAlignment(HorizontalAlignment.CENTER);//水平居中 horizontal center
+        style.setVerticalAlignment(VerticalAlignment.CENTER);//垂直居中 vertical center
         style.setWrapText(true);
         return style;
     }
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DJLImageUtils.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DJLImageUtils.java
index 3e3b7aff..da8ca445 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DJLImageUtils.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DJLImageUtils.java
@@ -10,7 +10,12 @@ import java.io.IOException;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class DJLImageUtils {
 
   public static Image bufferedImage2DJLImage(BufferedImage img) {
@@ -18,10 +23,9 @@ public class DJLImageUtils {
   }
 
   public static void saveImage(BufferedImage img, String name, String path) {
-    Image djlImg = ImageFactory.getInstance().fromImage(img); // 支持多种图片格式，自动适配
+    Image djlImg = ImageFactory.getInstance().fromImage(img);
     Path outputDir = Paths.get(path);
     Path imagePath = outputDir.resolve(name);
-    // OpenJDK 不能保存 jpg 图片的 alpha channel
     try {
       djlImg.save(Files.newOutputStream(imagePath), "png");
     } catch (IOException e) {
@@ -32,7 +36,6 @@ public class DJLImageUtils {
   public static void saveDJLImage(Image img, String name, String path) {
     Path outputDir = Paths.get(path);
     Path imagePath = outputDir.resolve(name);
-    // OpenJDK 不能保存 jpg 图片的 alpha channel
     try {
       img.save(Files.newOutputStream(imagePath), "png");
     } catch (IOException e) {
@@ -52,11 +55,9 @@ public class DJLImageUtils {
   }
 
   public static void drawImageRect(BufferedImage image, int x, int y, int width, int height) {
-    // 将绘制图像转换为Graphics2D
     Graphics2D g = (Graphics2D) image.getGraphics();
     try {
       g.setColor(new Color(246, 96, 0));
-      // 声明画笔属性 ：粗 细（单位像素）末端无修饰 折线处呈尖角
       BasicStroke bStroke = new BasicStroke(4, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER);
       g.setStroke(bStroke);
       g.drawRect(x, y, width, height);
@@ -68,11 +69,9 @@ public class DJLImageUtils {
 
   public static void drawImageRect(
       BufferedImage image, int x, int y, int width, int height, Color c) {
-    // 将绘制图像转换为Graphics2D
     Graphics2D g = (Graphics2D) image.getGraphics();
     try {
       g.setColor(c);
-      // 声明画笔属性 ：粗 细（单位像素）末端无修饰 折线处呈尖角
       BasicStroke bStroke = new BasicStroke(4, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER);
       g.setStroke(bStroke);
       g.drawRect(x, y, width, height);
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DistanceUtils.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DistanceUtils.java
index 2fc68cc9..c47a6d6b 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DistanceUtils.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/DistanceUtils.java
@@ -7,6 +7,8 @@ import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
 
 /**
+ * Utility class for calculating distances and IoU.
+ *
  * @author Calvin
  * @date Oct 19, 2021
  */
@@ -14,8 +16,8 @@ public class DistanceUtils {
     /**
      * Calculate L2 distance
      *
-     * @param contentLabels 内容识别区
-     * @param detectedTexts 文本检测区
+     * @param contentLabels 内容识别区 - the list of labels for content recognition area
+     * @param detectedTexts 文本检测区 - the list of labels for text detection area
      * @return
      */
     public static Map l2Distance(List contentLabels, List detectedTexts) {
@@ -40,8 +42,8 @@ public class DistanceUtils {
     /**
      * Calculate iou
      *
-     * @param contentLabels 内容识别区
-     * @param detectedTexts 文本检测区
+     * @param contentLabels 内容识别区 - the list of labels for content recognition area
+     * @param detectedTexts 文本检测区 - the list of labels for text detection area
      * @return
      */
     public static Map iou(List contentLabels, List detectedTexts) {
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/FileUtils.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/FileUtils.java
index 0b676072..52faa7da 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/FileUtils.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/FileUtils.java
@@ -14,27 +14,31 @@ import java.util.List;
 
 /**
  * 文件上传工具包
+ * File upload tool package
  */
 public class FileUtils {
     /**
-     * @param file     文件
-     * @param path     文件存放路径
-     * @param fileName 源文件名
+     * @param file     文件 - file
+     * @param path     文件存放路径 - file storage path
+     * @param fileName 源文件名 - source file name
      * @return
      */
     public static boolean upload(MultipartFile file, String path, String fileName) {
         // 生成新的文件名
+        // Generate a new file name
         //String realPath = path + "/" + FileNameUtils.getFileName(fileName);
         Path filePath = Paths.get(path + fileName);
         File dest = filePath.toAbsolutePath().toFile();
 
         //判断文件父目录是否存在
+        // Determine if the parent directory of the file exists
         if (!dest.getParentFile().exists()) {
             dest.getParentFile().mkdir();
         }
 
         try {
             //保存文件
+            // Save the file
             file.transferTo(dest);
             return true;
         } catch (IllegalStateException e) {
@@ -48,6 +52,7 @@ public class FileUtils {
 
     /**
      * 获取文件后缀
+     * Get file suffix
      *
      * @param fileName
      * @return
@@ -58,8 +63,8 @@ public class FileUtils {
 
     /**
      * 生成新的文件名
-     *
-     * @param fileOriginName 源文件名
+     * Generate a new file name
+     * @param fileOriginName 源文件名 - source file name
      * @return
      */
     public static String getFileName(String fileOriginName) {
@@ -68,9 +73,10 @@ public class FileUtils {
 
     /**
      * 读取json文件
+     * Read json file
      *
-     * @param path     文件路径信息
-     * @param fileName 文件名
+     * @param path     文件路径信息 - file path information
+     * @param fileName 文件名 - file name
      * @return
      */
     public static String readFile(String path, String fileName) throws IOException {
@@ -89,10 +95,11 @@ public class FileUtils {
 
     /**
      * 保存json文件
+     * Save json file
      *
-     * @param path     文件路径信息
-     * @param fileName 文件名
-     * @param json     json信息
+     * @param path     文件路径信息 file path information
+     * @param fileName 文件名 file name
+     * @param json     json信息 json information
      * @return
      */
     public static void saveFile(String path, String fileName, String json) throws IOException {
@@ -104,9 +111,10 @@ public class FileUtils {
 
     /**
      * 删除json文件
+     * Delete json file
      *
-     * @param path     文件路径信息
-     * @param fileName 文件名
+     * @param path     文件路径信息 file path information
+     * @param fileName 文件名 file name
      * @return
      */
     public static void removeFile(String path, String fileName) {
@@ -117,7 +125,7 @@ public class FileUtils {
     /**
      * Check & create file path
      *
-     * @param fileRelativePath 文件路径信息
+     * @param fileRelativePath 文件路径信息 - file path information
      * @return
      */
     public static void checkAndCreatePath(String fileRelativePath) {
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/NDArrayUtils.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/NDArrayUtils.java
index 85994f7b..1cbdaf61 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/NDArrayUtils.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/NDArrayUtils.java
@@ -9,7 +9,12 @@ import org.bytedeco.opencv.opencv_core.Mat;
 import org.bytedeco.opencv.opencv_core.Point2f;
 
 import java.util.List;
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class NDArrayUtils {
     // NDArray 转 opencv_core.Mat
     public static Mat toOpenCVMat(NDArray points, int rows, int cols) {
@@ -30,6 +35,7 @@ public class NDArrayUtils {
     }
 
     // NDArray 转 opencv_core.Point2f
+    // NDArray to opencv_core.Point2f
     public static Point2f toOpenCVPoint2f(NDArray points, int rows) {
         double[] doubleArray = points.toDoubleArray();
         Point2f points2f = new Point2f(rows);
@@ -42,6 +48,7 @@ public class NDArrayUtils {
     }
 
     // Double array 转 opencv_core.Point2f
+    // Double array to opencv_core.Point2f
     public static Point2f toOpenCVPoint2f(double[] doubleArray, int rows) {
         Point2f points2f = new Point2f(rows);
 
@@ -53,6 +60,7 @@ public class NDArrayUtils {
     }
 
     // list 转 opencv_core.Point2f
+    // list to opencv_core.Point2f
     public static Point2f toOpenCVPoint2f(List points, int rows) {
         Point2f points2f = new Point2f(points.size());
 
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/OpenCVUtils.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/OpenCVUtils.java
index df0668fb..1c2b5163 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/OpenCVUtils.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/OpenCVUtils.java
@@ -13,7 +13,12 @@ import java.nio.FloatBuffer;
 import static org.bytedeco.opencv.global.opencv_calib3d.findHomography;
 import static org.bytedeco.opencv.global.opencv_core.cvCreateMat;
 
-
+/**
+ *
+ * @author Calvin
+ *
+ * @email 179209347@qq.com
+ **/
 public class OpenCVUtils {
 
   public static Mat affineTransform(
diff --git a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/UUIDUtils.java b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/UUIDUtils.java
index 44292647..861973c6 100644
--- a/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/UUIDUtils.java
+++ b/8_suite_hub/iocr/ocr-demo/src/main/java/me/aias/ocr/utils/UUIDUtils.java
@@ -4,6 +4,7 @@ import java.util.UUID;
 
 /**
  * 生成文件名
+ * Generate file name
  */
 public class UUIDUtils {
 
diff --git a/8_suite_hub/iocr/ocr-ui/src/router/index.js b/8_suite_hub/iocr/ocr-ui/src/router/index.js
index e6262483..9adfe458 100644
--- a/8_suite_hub/iocr/ocr-ui/src/router/index.js
+++ b/8_suite_hub/iocr/ocr-ui/src/router/index.js
@@ -44,7 +44,7 @@ export const constantRoutes = [
         path: '/',
         name: 'list',
         component: () => import('@/views/iocr/list'),
-        meta: { title: '自定义模版', icon: 'el-icon-setting' }
+        meta: { title: 'Custom Template', icon: 'el-icon-setting' }
       }
     ]
   },
@@ -56,14 +56,14 @@ export const constantRoutes = [
         path: 'create',
         component: () => import('@/views/iocr/index'),
         name: 'CreateTemplate',
-        meta: { title: '新增模板', icon: 'el-icon-picture' },
+        meta: { title: 'Create Template', icon: 'el-icon-picture' },
         hidden: true
       },
       {
         path: 'edit',
         component: () => import('@/views/iocr/edit'),
         name: 'EditTemplate',
-        meta: { title: '编辑模板', noCache: true },
+        meta: { title: 'Edit Template', noCache: true },
         hidden: true
       }
     ]
@@ -76,7 +76,7 @@ export const constantRoutes = [
         path: 'index',
         component: () => import('@/views/iocrinfer/index'),
         name: 'inference',
-        meta: { title: '基于模版识别', icon: 'el-icon-document-copy' }
+        meta: { title: 'Template Inference', icon: 'el-icon-document-copy' }
       }
     ]
   },
@@ -88,7 +88,7 @@ export const constantRoutes = [
         path: 'index',
         component: () => import('@/views/general/index'),
         name: 'inference',
-        meta: { title: '通用文本识别', icon: 'el-icon-picture' }
+        meta: { title: 'General Inference', icon: 'el-icon-picture' }
       }
     ]
   },
@@ -100,7 +100,7 @@ export const constantRoutes = [
         path: 'index',
         component: () => import('@/views/table/index'),
         name: 'inference',
-        meta: { title: '表格识别', icon: 'el-icon-s-grid' }
+        meta: { title: 'Table Inference', icon: 'el-icon-s-grid' }
       }
     ]
   },
@@ -112,7 +112,7 @@ export const constantRoutes = [
         path: 'index',
         component: () => import('@/views/autotable/index'),
         name: 'inference',
-        meta: { title: '表格自动检测识别', icon: 'el-icon-s-grid' }
+        meta: { title: 'Auto Table Inference', icon: 'el-icon-s-grid' }
       }
     ]
   },
diff --git a/8_suite_hub/iocr/ocr-ui/src/views/iocr/DrawBoard/components/tool.vue b/8_suite_hub/iocr/ocr-ui/src/views/iocr/DrawBoard/components/tool.vue
index a2134123..0fa78e36 100644
--- a/8_suite_hub/iocr/ocr-ui/src/views/iocr/DrawBoard/components/tool.vue
+++ b/8_suite_hub/iocr/ocr-ui/src/views/iocr/DrawBoard/components/tool.vue
@@ -1,9 +1,9 @@
 
       
-      
+      
         
       
-      
+