From c81e8569394a49696a46eb035ef7820aaddd46c1 Mon Sep 17 00:00:00 2001
From: Lei OT <lyt@hainatravel.com>
Date: Fri, 9 Jan 2026 09:14:28 +0800
Subject: [PATCH] docs:

---
 README.MD            | 20 +++++++++++++-------
 src/utils/commons.js |  3 ++-
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/README.MD b/README.MD
index 800b457..4fc695b 100644
--- a/README.MD
+++ b/README.MD
@@ -1,5 +1,4 @@
 
-
 # @haina/npm
 
 可复用的 npm 模块  
@@ -34,31 +33,39 @@ npm run pack
 # 打包整个项目(各模块和root)
 npm run pack:all
 ```
-
+`npm run pack` 包含执行以下:
 1. 生成导出文件 `index.js`
 2. 创建`ESM`和`CommonJS` 版本
 3. 打包
     1. 打包`src`下的子文件夹 --> `hooks-0.1.10.tgz`  `utils-0.1.10.tgz` …
     2. `src/utils`下的模块, 分别单独打包 --> `utils-request-0.1.10.tgz`  `utils-commons-0.1.10.tgz` …
+
+`npm run pack:all` 增加执行:
     3. 打包整个项目(root) --> `haina-npm-0.1.10.tgz`
 
 ### Serve
 
 #### FTP
 
+脚本winscp-upload.bat 需要winscp客户端
+```sh
+cd scripts
+.\winscp-upload.bat
+```
 
 ## Usage
 
 ### 安装整个包
 
 ```sh
-npm install http://xxxx/npm/haina-npm-0.1.0.tgz
+npm install https://research.hainatravel.com/npm/haina-npm-0.1.0.tgz
 ```
 
 ```js
 // 
 import { commons, request, utils, hooks } from '@haina/npm';
-// Import only common utilities
+
+// Import only common utilities from root tarball package
 import { isEmpty } from '@haina/npm/esm/utils/commons.js';
 // Import only request utilities
 import { fetchJSON } from '@haina/npm/esm/utils/request.js';
@@ -67,8 +74,8 @@ import { fetchJSON } from '@haina/npm/esm/utils/request.js';
 ### 安装单个模块
 
 ```sh
-npm install http://xxxx/npm/utils-0.1.0.tgz
-npm install http://xxxx/npm/hooks-0.1.0.tgz
+npm install https://research.hainatravel.com/npm/utils-0.1.0.tgz
+npm install https://research.hainatravel.com/npm/hooks-0.1.0.tgz
 ```
 
 
@@ -79,7 +86,6 @@ import { commons, request } from '@haina/utils';
 ### 安装Utils的子模块
 
 ```sh
-npm install http://xxxx/npm/utils-commons-0.1.0.tgz
 npm install https://research.hainatravel.com/npm/utils-commons-0.1.1.tgz
 ```
 
diff --git a/src/utils/commons.js b/src/utils/commons.js
index 105d27b..e8f987f 100644
--- a/src/utils/commons.js
+++ b/src/utils/commons.js
@@ -31,7 +31,7 @@ if (!Object.fromEntries) {
  * @deprecated
  * 废弃, 请使用 cloneDeep 或者 structuredClone
  * @see cloneDeep
- * @see structuredClone
+ * @see structuredClone https://developer.mozilla.org/docs/Web/API/Window/structuredClone
  */
 export function copy(obj) {
   return JSON.parse(JSON.stringify(obj));
@@ -79,6 +79,7 @@ export function formatPercentToFloat(number) {
 /**
  * @deprecated
  * 废弃, 请使用 fixTo2Decimals
+ * @see fixTo2Decimals
  */
 export function percentToDecimal(number) {
   return parseFloat(number) / 100;