neo-cmp-cli 1.7.7 → 1.7.8

package/README.md

@@ -128,7 +128,7 @@ neo push cmp
 
 ### 方式一：OAuth2 登录授权（推荐）
 
-OAuth2 授权码模式更加安全可靠，且支持 token 自动刷新。
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
 
 #### 使用步骤
 
@@ -139,9 +139,9 @@ OAuth2 授权码模式更加安全可靠，且支持 token 自动刷新。
    
    执行流程：
    - 自动打开浏览器访问授权页面
-   - 在浏览器中输入 NeoCRM 账号密码进行登录
-   - 授权成功后自动跳转回本地
-   - Token 自动保存到项目的 `.neo-cli/token.json` 文件中
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
 
 2. **登出 NeoCRM 平台**
    ```bash
@@ -179,16 +179,8 @@ A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
 **Q2: Token 刷新失败怎么办？**  
 A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
 
-#### OAuth2 模式 vs 密码模式
-
-| 特性 | OAuth2 授权码模式 | 密码模式 |
-|------|------------------|---------|
-| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
-| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
-| 有效期 | 2 小时（可自动刷新） | 2 小时（可自动刷新） |
-| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
-
-> **建议**：优先使用 OAuth2 授权码模式（`neo login`），更加安全便捷。
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
 
 ### 方式二：密码授权配置
 
@@ -225,6 +217,15 @@ module.exports = {
    - 按照文档说明获取 8 位安全令牌
    - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
 
+### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
 ---
 
 ## 📖 开发指南

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neo-cmp-cli",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "description": "前端脚手架：自定义组件开发工具，支持react 和 vue2.0技术栈。",
   "keywords": [
     "neo-cli",

package/src/config/auth.config.js

@@ -1,7 +1,7 @@
 const curConfig = require('../config/index'); // 获取当前项目根目录下的配置文件
 
 const neoConfig = curConfig.neoConfig || {};
-const authConfig = neoConfig.auth || {};
+// const authConfig = neoConfig.auth || {};
 
 // NeoCRM 跨 Pod 授权配置
 module.exports = {
@@ -14,12 +14,14 @@ module.exports = {
   },
   // 获取 授权码 相关配置
   response_type: 'code', // 认证类型；此参数值必须为 code
-  client_id: authConfig.client_id || '04c8b45c4dbe36426a660bf70d3fe3e7', // 客户端 ID，跨 Pod 级链接器【内置】
+  // client_id: authConfig.client_id || '04c8b45c4dbe36426a660bf70d3fe3e7', // 客户端 ID，跨 Pod 级链接器【内置】
+  client_id: '04c8b45c4dbe36426a660bf70d3fe3e7', // 客户端 ID，跨 Pod 级链接器【内置】
   scope: 'all', // 固定值：all
   oauthType: 'standard', // 固定值：standard
   access_type: 'offline', // 此参数值为 online 时，不产生 refresh_token ；此参数值为 offline 时，返回refresh_token
 
   // 获取 令牌 相关配置
-  client_secret: authConfig.client_secret || '370817d1336a3737f95c671eea39a23b', // 客户端秘钥，跨 Pod 级链接器【内置】
+  // client_secret: authConfig.client_secret || '370817d1336a3737f95c671eea39a23b', // 客户端秘钥，跨 Pod 级链接器【内置】
+  client_secret: '370817d1336a3737f95c671eea39a23b', // 客户端秘钥，跨 Pod 级链接器【内置】
   grant_type: 'authorization_code' // 授权类型；此参数值必须为 authorization_code
 };

package/src/neo/neoLogin.js

@@ -144,52 +144,13 @@ class NeoLoginService {
   /**
    * 打开浏览器访问授权 URL
    * @param {string} authUrl 授权 URL
-   * @param {boolean} incognito 是否使用无痕模式，默认为 true
    */
-  async openBrowser(authUrl, incognito = true) {
+  async openBrowser(authUrl) {
     try {
-      const options = {};
-      
-      if (incognito) {
-        const platform = process.platform;
-        
-        // 根据不同平台和浏览器设置无痕模式参数
-        if (platform === 'darwin') {
-          // macOS: 优先使用 Chrome，其次 Safari
-          options.app = {
-            name: 'google chrome',
-            arguments: ['--incognito']
-          };
-        } else if (platform === 'win32') {
-          // Windows: 优先使用 Chrome，其次 Edge
-          options.app = {
-            name: 'chrome',
-            arguments: ['--incognito']
-          };
-        } else {
-          // Linux 或其他平台
-          options.app = {
-            name: 'google-chrome',
-            arguments: ['--incognito']
-          };
-        }
-      }
-      
-      await open(authUrl, options);
+      await open(authUrl);
     } catch (error) {
-      // 如果指定的浏览器打开失败，尝试使用默认浏览器
-      if (incognito && error.message && error.message.includes('spawn')) {
-        try {
-          console.log('无法使用无痕模式打开指定浏览器，尝试使用默认浏览器...');
-          await open(authUrl);
-        } catch (fallbackError) {
-          errorLog(`无法自动打开浏览器: ${fallbackError.message}`);
-          console.log(`\n请手动访问以下 URL 进行授权:\n${authUrl}\n`);
-        }
-      } else {
-        errorLog(`无法自动打开浏览器: ${error.message}`);
-        console.log(`\n请手动访问以下 URL 进行授权:\n${authUrl}\n`);
-      }
+      errorLog(`无法自动打开浏览器: ${error.message}`);
+      console.log(`\n请手动访问以下 URL 进行授权:\n${authUrl}\n`);
     }
   }
 
@@ -271,11 +232,31 @@ class NeoLoginService {
             res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
             res.end(`
               <html>
-                <head><title>授权失败</title></head>
+                <head>
+                <title>授权失败</title>
+                <style>
+                  .container {
+                    margin: 30px auto;
+                    padding-top: 30px;
+                    text-align: center;
+
+                    .error-title {
+                      color: red;
+                    }
+
+                    h1, p {
+                      text-align: center;
+                      margin-top: 10px;
+                    }
+                  }
+                </style>
+                </head>
                 <body>
-                  <h1>授权失败</h1>
-                  <p>错误信息: ${error}</p>
-                  <p>您可以关闭此窗口</p>
+                  <div class="container">
+                    <h1 class="error-title">授权失败</h1>
+                    <img src="https://custom-widgets.bj.bcebos.com/neocrmlogin.png" alt="授权失败" />
+                    <p>错误信息: ${error}</p>
+                  </div>
                 </body>
               </html>
             `);
@@ -291,7 +272,7 @@ class NeoLoginService {
                 <head>
                 <title>授权成功</title>
                 <style>
-                  container {
+                  .container {
                     margin: 30px auto;
                     padding-top: 30px;
                     text-align: center;

package/src/template/antd-custom-cmp-template/README.md

@@ -43,12 +43,75 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
-##### 需自行添加 NeoCRM 授权配置
+### 🔐 授权配置
+
+使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
+
+#### 方式一：OAuth2 登录授权（推荐）
+
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
+
+##### 使用步骤
+
+1. **登录 NeoCRM 平台**
+   ```bash
+   neo login
+   ```
+   
+   执行流程：
+   - 自动打开浏览器访问授权页面
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
+
+2. **登出 NeoCRM 平台**
+   ```bash
+   neo logout
+   ```
+   
+   功能：清除本地保存的 token 文件，下次使用需要重新登录。
+
+##### 配置示例
+
+```javascript
+// neo.config.js
+module.exports = {
+  neoConfig: {
+    neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
+    // 登录授权 URL（用于获取 code）
+    loginURL: 'https://login-cd.xiaoshouyi.com/auc/oauth2/auth',
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
+  },
+}
+```
+
+##### Token 有效期
+
+- **access_token**：默认有效期 2 小时
+- **refresh_token**：默认有效期 30 天
+- 系统会在 access_token 过期前 5 分钟自动刷新
+- 如果 refresh_token 也过期，需要重新执行 `neo login`
+
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
+#### 方式二：密码授权配置
+
+在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
+
 ```javascript
 module.exports = {
   neoConfig: {
     neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址（默认：https://login.xiaoshouyi.com/auc/oauth2/token）
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
     // NeoCRM 授权配置
     auth: {
       client_id: 'xx', // 客户端 ID，从创建连接器的客户端信息中获取（Client_Id）
@@ -63,9 +126,28 @@ module.exports = {
   },
 }
 ```
-1、客户端 ID 和 客户端秘钥 需通过 创建连接器 获取，获取方式见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / 创建连接器；
-2、如何获取 安全令牌 见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌；
-3、发布成功后即可在 NeoCRM 对应租户环境的页面设计器和表单设计器中使用此自定义组件。
+
+##### 授权配置获取方式
+
+1. **客户端 ID 和客户端秘钥**：需通过创建连接器获取
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / 创建连接器
+   - 创建连接器后，从客户端信息中获取 `Client_Id` 和 `Client_Secret`
+
+2. **安全令牌**：如何获取安全令牌
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌
+   - 按照文档说明获取 8 位安全令牌
+   - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
+
+#### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+---
 
 ### 配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)

package/src/template/echarts-custom-cmp-template/README.md

@@ -87,12 +87,76 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
-##### 需自行添加 NeoCRM 授权配置
+
+### 🔐 授权配置
+
+使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
+
+#### 方式一：OAuth2 登录授权（推荐）
+
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
+
+##### 使用步骤
+
+1. **登录 NeoCRM 平台**
+   ```bash
+   neo login
+   ```
+   
+   执行流程：
+   - 自动打开浏览器访问授权页面
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
+
+2. **登出 NeoCRM 平台**
+   ```bash
+   neo logout
+   ```
+   
+   功能：清除本地保存的 token 文件，下次使用需要重新登录。
+
+##### 配置示例
+
 ```javascript
+// neo.config.js
 module.exports = {
   neoConfig: {
     neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址（默认：https://login.xiaoshouyi.com/auc/oauth2/token）
+    // 登录授权 URL（用于获取 code）
+    loginURL: 'https://login-cd.xiaoshouyi.com/auc/oauth2/auth',
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
+  },
+}
+```
+
+##### Token 有效期
+
+- **access_token**：默认有效期 2 小时
+- **refresh_token**：默认有效期 30 天
+- 系统会在 access_token 过期前 5 分钟自动刷新
+- 如果 refresh_token 也过期，需要重新执行 `neo login`
+
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
+#### 方式二：密码授权配置
+
+在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
+
+```javascript
+module.exports = {
+  neoConfig: {
+    neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
     // NeoCRM 授权配置
     auth: {
       client_id: 'xx', // 客户端 ID，从创建连接器的客户端信息中获取（Client_Id）
@@ -107,9 +171,28 @@ module.exports = {
   },
 }
 ```
-1、客户端 ID 和 客户端秘钥 需通过 创建连接器 获取，获取方式见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / 创建连接器；
-2、如何获取 安全令牌 见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌；
-3、发布成功后即可在 NeoCRM 对应租户环境的页面设计器和表单设计器中使用此自定义组件。
+
+##### 授权配置获取方式
+
+1. **客户端 ID 和客户端秘钥**：需通过创建连接器获取
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / 创建连接器
+   - 创建连接器后，从客户端信息中获取 `Client_Id` 和 `Client_Secret`
+
+2. **安全令牌**：如何获取安全令牌
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌
+   - 按照文档说明获取 8 位安全令牌
+   - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
+
+#### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+---
 
 ### 配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)

package/src/template/empty-custom-cmp-template/README.md

@@ -43,12 +43,76 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
-##### 需自行添加 NeoCRM 授权配置
+
+### 🔐 授权配置
+
+使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
+
+#### 方式一：OAuth2 登录授权（推荐）
+
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
+
+##### 使用步骤
+
+1. **登录 NeoCRM 平台**
+   ```bash
+   neo login
+   ```
+   
+   执行流程：
+   - 自动打开浏览器访问授权页面
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
+
+2. **登出 NeoCRM 平台**
+   ```bash
+   neo logout
+   ```
+   
+   功能：清除本地保存的 token 文件，下次使用需要重新登录。
+
+##### 配置示例
+
 ```javascript
+// neo.config.js
 module.exports = {
   neoConfig: {
     neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址（默认：https://login.xiaoshouyi.com/auc/oauth2/token）
+    // 登录授权 URL（用于获取 code）
+    loginURL: 'https://login-cd.xiaoshouyi.com/auc/oauth2/auth',
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
+  },
+}
+```
+
+##### Token 有效期
+
+- **access_token**：默认有效期 2 小时
+- **refresh_token**：默认有效期 30 天
+- 系统会在 access_token 过期前 5 分钟自动刷新
+- 如果 refresh_token 也过期，需要重新执行 `neo login`
+
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
+#### 方式二：密码授权配置
+
+在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
+
+```javascript
+module.exports = {
+  neoConfig: {
+    neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
     // NeoCRM 授权配置
     auth: {
       client_id: 'xx', // 客户端 ID，从创建连接器的客户端信息中获取（Client_Id）
@@ -63,9 +127,28 @@ module.exports = {
   },
 }
 ```
-1、客户端 ID 和 客户端秘钥 需通过 创建连接器 获取，获取方式见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / 创建连接器；
-2、如何获取 安全令牌 见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌；
-3、发布成功后即可在 NeoCRM 对应租户环境的页面设计器和表单设计器中使用此自定义组件。
+
+##### 授权配置获取方式
+
+1. **客户端 ID 和客户端秘钥**：需通过创建连接器获取
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / 创建连接器
+   - 创建连接器后，从客户端信息中获取 `Client_Id` 和 `Client_Secret`
+
+2. **安全令牌**：如何获取安全令牌
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌
+   - 按照文档说明获取 8 位安全令牌
+   - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
+
+#### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+---
 
 ### 配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)

package/src/template/neo-custom-cmp-template/README.md

@@ -44,12 +44,76 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
-##### 需自行添加 NeoCRM 授权配置
+
+### 🔐 授权配置
+
+使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
+
+#### 方式一：OAuth2 登录授权（推荐）
+
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
+
+##### 使用步骤
+
+1. **登录 NeoCRM 平台**
+   ```bash
+   neo login
+   ```
+   
+   执行流程：
+   - 自动打开浏览器访问授权页面
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
+
+2. **登出 NeoCRM 平台**
+   ```bash
+   neo logout
+   ```
+   
+   功能：清除本地保存的 token 文件，下次使用需要重新登录。
+
+##### 配置示例
+
 ```javascript
+// neo.config.js
 module.exports = {
   neoConfig: {
     neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址（默认：https://login.xiaoshouyi.com/auc/oauth2/token）
+    // 登录授权 URL（用于获取 code）
+    loginURL: 'https://login-cd.xiaoshouyi.com/auc/oauth2/auth',
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
+  },
+}
+```
+
+##### Token 有效期
+
+- **access_token**：默认有效期 2 小时
+- **refresh_token**：默认有效期 30 天
+- 系统会在 access_token 过期前 5 分钟自动刷新
+- 如果 refresh_token 也过期，需要重新执行 `neo login`
+
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
+#### 方式二：密码授权配置
+
+在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
+
+```javascript
+module.exports = {
+  neoConfig: {
+    neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
     // NeoCRM 授权配置
     auth: {
       client_id: 'xx', // 客户端 ID，从创建连接器的客户端信息中获取（Client_Id）
@@ -64,9 +128,28 @@ module.exports = {
   },
 }
 ```
-1、客户端 ID 和 客户端秘钥 需通过 创建连接器 获取，获取方式见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / 创建连接器；
-2、如何获取 安全令牌 见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌；
-3、发布成功后即可在 NeoCRM 对应租户环境的页面设计器和表单设计器中使用此自定义组件。
 
-### 前端工程配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+##### 授权配置获取方式
+
+1. **客户端 ID 和客户端秘钥**：需通过创建连接器获取
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / 创建连接器
+   - 创建连接器后，从客户端信息中获取 `Client_Id` 和 `Client_Secret`
+
+2. **安全令牌**：如何获取安全令牌
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌
+   - 按照文档说明获取 8 位安全令牌
+   - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
+
+#### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+---
+
+### 配置项说明（neo-cmp-cli）
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)

package/src/template/react-custom-cmp-template/README.md

@@ -43,12 +43,76 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
-##### 需自行添加 NeoCRM 授权配置
+
+### 🔐 授权配置
+
+使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
+
+#### 方式一：OAuth2 登录授权（推荐）
+
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
+
+##### 使用步骤
+
+1. **登录 NeoCRM 平台**
+   ```bash
+   neo login
+   ```
+   
+   执行流程：
+   - 自动打开浏览器访问授权页面
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
+
+2. **登出 NeoCRM 平台**
+   ```bash
+   neo logout
+   ```
+   
+   功能：清除本地保存的 token 文件，下次使用需要重新登录。
+
+##### 配置示例
+
 ```javascript
+// neo.config.js
 module.exports = {
   neoConfig: {
     neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址（默认：https://login.xiaoshouyi.com/auc/oauth2/token）
+    // 登录授权 URL（用于获取 code）
+    loginURL: 'https://login-cd.xiaoshouyi.com/auc/oauth2/auth',
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
+  },
+}
+```
+
+##### Token 有效期
+
+- **access_token**：默认有效期 2 小时
+- **refresh_token**：默认有效期 30 天
+- 系统会在 access_token 过期前 5 分钟自动刷新
+- 如果 refresh_token 也过期，需要重新执行 `neo login`
+
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
+#### 方式二：密码授权配置
+
+在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
+
+```javascript
+module.exports = {
+  neoConfig: {
+    neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
     // NeoCRM 授权配置
     auth: {
       client_id: 'xx', // 客户端 ID，从创建连接器的客户端信息中获取（Client_Id）
@@ -63,9 +127,28 @@ module.exports = {
   },
 }
 ```
-1、客户端 ID 和 客户端秘钥 需通过 创建连接器 获取，获取方式见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / 创建连接器；
-2、如何获取 安全令牌 见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌；
-3、发布成功后即可在 NeoCRM 对应租户环境的页面设计器和表单设计器中使用此自定义组件。
+
+##### 授权配置获取方式
+
+1. **客户端 ID 和客户端秘钥**：需通过创建连接器获取
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / 创建连接器
+   - 创建连接器后，从客户端信息中获取 `Client_Id` 和 `Client_Secret`
+
+2. **安全令牌**：如何获取安全令牌
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌
+   - 按照文档说明获取 8 位安全令牌
+   - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
+
+#### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+---
 
 ### 配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)

package/src/template/react-ts-custom-cmp-template/README.md

@@ -43,12 +43,76 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
-##### 需自行添加 NeoCRM 授权配置
+
+### 🔐 授权配置
+
+使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
+
+#### 方式一：OAuth2 登录授权（推荐）
+
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
+
+##### 使用步骤
+
+1. **登录 NeoCRM 平台**
+   ```bash
+   neo login
+   ```
+   
+   执行流程：
+   - 自动打开浏览器访问授权页面
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
+
+2. **登出 NeoCRM 平台**
+   ```bash
+   neo logout
+   ```
+   
+   功能：清除本地保存的 token 文件，下次使用需要重新登录。
+
+##### 配置示例
+
 ```javascript
+// neo.config.js
 module.exports = {
   neoConfig: {
     neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址（默认：https://login.xiaoshouyi.com/auc/oauth2/token）
+    // 登录授权 URL（用于获取 code）
+    loginURL: 'https://login-cd.xiaoshouyi.com/auc/oauth2/auth',
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
+  },
+}
+```
+
+##### Token 有效期
+
+- **access_token**：默认有效期 2 小时
+- **refresh_token**：默认有效期 30 天
+- 系统会在 access_token 过期前 5 分钟自动刷新
+- 如果 refresh_token 也过期，需要重新执行 `neo login`
+
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
+#### 方式二：密码授权配置
+
+在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
+
+```javascript
+module.exports = {
+  neoConfig: {
+    neoBaseURL: 'https://crm-cd.xiaoshouyi.com', // 平台根地址（默认：https://crm.xiaoshouyi.com）
+    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token', // Token 获取接口地址
     // NeoCRM 授权配置
     auth: {
       client_id: 'xx', // 客户端 ID，从创建连接器的客户端信息中获取（Client_Id）
@@ -63,9 +127,28 @@ module.exports = {
   },
 }
 ```
-1、客户端 ID 和 客户端秘钥 需通过 创建连接器 获取，获取方式见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / 创建连接器；
-2、如何获取 安全令牌 见：[https://doc.xiaoshouyi.com](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌；
-3、发布成功后即可在 NeoCRM 对应租户环境的页面设计器和表单设计器中使用此自定义组件。
+
+##### 授权配置获取方式
+
+1. **客户端 ID 和客户端秘钥**：需通过创建连接器获取
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / 创建连接器
+   - 创建连接器后，从客户端信息中获取 `Client_Id` 和 `Client_Secret`
+
+2. **安全令牌**：如何获取安全令牌
+   - 访问 [销售易文档中心](https://doc.xiaoshouyi.com) / OAuth安全认证 / 密码模式 / 获取令牌
+   - 按照文档说明获取 8 位安全令牌
+   - `password` 字段 = 用户账户密码 + 8 位安全令牌（直接拼接，无空格或分隔符）
+
+#### OAuth2 模式 vs 密码模式
+
+| 特性 | OAuth2 授权码模式 | 密码模式 |
+|------|------------------|---------|
+| 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
+| Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
+| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+---
 
 ### 配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)

package/src/template/vue2-custom-cmp-template/README.md

@@ -43,13 +43,14 @@ $ npm run linkDebug
 $ npm run pushCmp
 ```
 
+
 ### 🔐 授权配置
 
 使用 `neo push cmp`、`neo pull cmp`、`neo delete cmp` 等命令与 NeoCRM 平台交互时，需要配置授权信息。
 
 #### 方式一：OAuth2 登录授权（推荐）
 
-OAuth2 授权码模式更加安全可靠，且支持 token 自动刷新。
+OAuth2 授权码模式更加安全可靠，无需用户配置账户名和密码。
 
 ##### 使用步骤
 
@@ -60,9 +61,9 @@ OAuth2 授权码模式更加安全可靠，且支持 token 自动刷新。
    
    执行流程：
    - 自动打开浏览器访问授权页面
-   - 在浏览器中输入 NeoCRM 账号密码进行登录
-   - 授权成功后自动跳转回本地
-   - Token 自动保存到项目的 `.neo-cli/token.json` 文件中
+   - 在浏览器中输入 NeoCRM 账号密码进行登录（需选择对应的租户）
+   - 授权成功后自动跳转回本地（附带 code）
+   - cli 端 通过 code 获取 Token，并自动保存到项目的 `.neo-cli/token.json` 文件中
 
 2. **登出 NeoCRM 平台**
    ```bash
@@ -92,6 +93,17 @@ module.exports = {
 - 系统会在 access_token 过期前 5 分钟自动刷新
 - 如果 refresh_token 也过期，需要重新执行 `neo login`
 
+##### 常见问题
+
+**Q1: 浏览器无法自动打开怎么办？**  
+A: 命令行会输出授权 URL，手动复制到浏览器中打开即可。
+
+**Q2: Token 刷新失败怎么办？**  
+A: 如果 refresh_token 也过期（默认 30 天），需要重新执行 `neo login`。同时检查网络连接是否正常。
+
+**Q3: 授权登录后没有正常跳回 redirect_uri**  
+A: 可能被浏览器安装的插件影响，目前已知会影响授权登录的浏览器插件有：Neo UI Extension，请关闭插件后重试。
+
 #### 方式二：密码授权配置
 
 在项目根目录的 `neo.config.js` 文件中添加 NeoCRM 平台授权配置：
@@ -133,13 +145,10 @@ module.exports = {
 |------|------------------|---------|
 | 安全性 | ✅ 高（无需在配置文件中存储密码） | ⚠️ 较低（需要配置密码和安全令牌） |
 | Token 刷新 | ✅ 自动刷新 | ✅ 自动刷新 |
-| 有效期 | 2 小时（可自动刷新） | 2 小时（可自动刷新） |
+| 有效期 | 2 小时（可自动刷新） | 永不过期 |
 | 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
 
-> **建议**：优先使用 OAuth2 授权码模式（`neo login`），更加安全便捷。
-
 ---
 
-
 ### 配置项说明（neo-cmp-cli）
-[请查看neo-cmp-cli](https://github.com/wibetter/neo-cmp-cli)
+[请查看neo-cmp-cli](https://www.npmjs.com/package/neo-cmp-cli)