jjb-cmd 2.5.5 → 2.5.6-beta.2

package/DEFAULT_README.md

@@ -0,0 +1,203 @@
+# 云组件开发指南
+
+## 🛠 技术栈
+
+| 类别 | 技术选型 |
+|------|----------|
+| **语言** | JavaScript (ES6+) |
+| **框架** | React 18 |
+| **样式** | Less |
+| **UI组件库** | Ant Design |
+| **编译工具** | Babel 7 |
+| **构建工具** | Webpack 5 |
+
+## 📁 目录结构
+
+```
+.
+├── jjb.script/          # Webpack开发与构建配置（不建议修改）
+├── public/              # 本地开发调试HTML
+├── src/                 # 源码目录
+├── jjb.config.json      # 项目基础配置
+├── package.json         # 项目依赖配置
+├── thumbnail.png        # 组件缩略图
+└── webstorm.config.js   # WebStorm路径别名配置（其他编辑器可忽略）
+```
+
+## 🚀 开发说明
+
+### 基本信息配置
+- **组件名称**：修改 `package.json` 中的 `name` 属性（必须唯一）
+- **检索标题**：修改 `package.json` 中的 `description` 属性
+- **描述说明**：修改 `package.json` 中的 `remark` 属性
+- **版本号**：修改 `package.json` 中的 `version` 属性
+- **缩略图**：在根目录添加 `thumbnail.png` 文件
+
+### 入口文件
+- `__dev__.js` - 开发环境入口
+- `__prod__.js` - 生产环境构建入口
+
+## ⚙️ jjb.config.json 配置详解
+
+### 1. environment
+配置云组件的接口服务环境，与 `package.json` 中 scripts 的 `NODE_ENV` 匹配。云组件运行时，接口服务域名会与应用保持一致。
+
+### 2. dependencies
+配置云组件的依赖清单。如果应用中没有提供匹配的依赖项，运行时将报错。
+
+云组件默认从 `window.__coreLib` 获取依赖项，如果应用使用其他变量，需要显式指定：
+
+```javascript
+// 应用入口文件中声明依赖
+// 默认依赖变量
+window.__coreLib = {
+  'react': require('react'),
+  'react-dom': require('react-dom')
+};
+
+// 其他依赖变量
+window.__coreTestLib = {
+  'react': require('react'),
+  'react-dom': require('react-dom')
+};
+```
+
+```jsx
+// 使用组件时指定依赖变量
+function App() {
+  return (
+    <>
+      {/* 使用默认依赖变量 */}
+      <CloudComponent />
+      
+      {/* 使用其他依赖变量 */}
+      <CloudComponent lib="__coreTestLib" />
+    </>
+  );
+}
+```
+
+### 3. server
+
+配置云组件本地开发服务。
+
+### 4. framework
+
+配置UI库主题，可根据业务需求定制颜色和其他样式。
+
+## 💻 本地开发
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 启动开发服务
+
+```bash
+npm run serve:<env>
+```
+
+## 本地联调
+
+### 1. 构建云组件
+   ```bash
+   npm run build:<env>
+   ```
+### 2. 启动代理服务
+   ```bash
+   node jjb.script/proxy.js
+   ```
+### 3. 在应用中使用 
+   访问 http://127.0.0.1:8080/index.js 可查看编译后的代码，将此链接放入应用的云组件中：
+   ```jsx
+   function App() {
+     return (
+       <CloudComponent from="http://127.0.0.1:8080/index.js" />
+     );
+   }
+   ```
+   注意：云组件更新后需要重新执行第一步编译。
+
+## 📤 发布云组件
+
+### 自动发布（推荐）
+1. 安装命令行工具
+   ```bash
+   npm install jjb-cmd -g
+   ```
+2. 账号认证
+   ```bash
+   jjb-cmd auth <用户名> <密码>
+   ```
+   账号密码请联系管理员获取
+3. 发布组件
+   ```bash
+   jjb-cmd publish <版本号 | latest>
+   ```
+   注意：版本号不要加 v 前缀！
+
+### 👀 查看已发布组件
+* 云组件平台：https://jcloud.cqjjb.cn/container/home?pageNum=1&pageSize=10
+* 云组件检索表：https://cdn.cqjjb.cn
+
+
+### 手动发布
+
+1. 构建组件
+   ```bash
+   npm run build:<env>
+   ```
+2. 部署文件 将 dist/index.js 上传到文件服务器，并确保允许跨域访问。
+
+## 📦 在应用中使用
+
+### 安装依赖
+
+```bash
+# 使用 npm
+npm install @cqsjjb/jjb-cloud-component
+
+# 使用 yarn
+yarn add @cqsjjb/jjb-cloud-component
+```
+
+### 基本用法
+
+```jsx
+import React from 'react';
+import { CloudComponent } from '@cqsjjb/jjb-cloud-component';
+
+function App() {
+  return (
+    <CloudComponent
+      // 依赖变量（默认使用 window.__coreLib）
+      lib="__coreLib"
+      
+      // 云组件地址（从云组件平台获取）
+      from="https://your-component-url/index.js"
+      
+      // 缓存策略
+      cache={true}
+      
+      // 组件唯一标识
+      componentKey="your-component-unique-key"
+      
+      // 组件属性
+      componentProps={{}}
+      
+      // 事件回调
+      onLoadStart={() => console.log('开始加载')}
+      onLoadEnd={() => console.log('加载完成')}
+      onMounted={() => console.log('挂载完成')}
+      onUpdated={() => console.log('数据更新')}
+      onDestroy={() => console.log('组件销毁')}
+    />
+  );
+}
+```
+
+---
+
+💡 提示：更多详细配置请参考组件类型定义文件（d.ts）

package/bin/command.js

@@ -3,16 +3,18 @@
 const commander = require('commander');
 const path = require('path');
 const fs = require('fs');
+const { checkCmdVersion } = require('../src/utils');
 
-commander.command('v').description('-- 查看版本').action(() => {
+commander.command('v').description('-- 查看版本').action(async () => {
   const package_json_file = JSON.parse(fs.readFileSync(path.join(__dirname, '../package.json')).toString());
   const {
     version
   } = package_json_file;
   console.log(`当前版本: v${version}`);
+  // 版本查看命令不需要检查版本
 });
 
-commander.command('help').description('-- 帮助').action(() => {
+commander.command('help').description('-- 帮助').action(async () => {
   console.log('jjb-cmd <command>');
   console.log('');
   console.log('使用:');
@@ -23,26 +25,43 @@ commander.command('help').description('-- 帮助').action(() => {
   console.log('jjb-cmd publish <version>          发布云组件\n\targ1 <version>             发布版本，可设置为latest');
   console.log('jjb-cmd auth                       登录授权（交互式输入用户名和密码）');
   console.log('jjb-cmd push java                  推送微应用到服务器');
-  console.log('jjb-cmd ai-pull                    拉取 AI 配置文件和规则');
+  console.log('jjb-cmd ai-pull [branch]           拉取 AI 配置文件和规则\n\targ1 <branch>             指定分支/标签，默认为 v_1.0.0');
+  // 帮助命令不需要检查版本
 });
 
 // 命令
 commander.command('auth').description('-- 授权').action(async () => {
+  const isLatest = await checkCmdVersion();
+  if (!isLatest) {
+    process.exit(1);
+  }
   await require('../src/auth.js')([]);
 });
 
 // 优化
 commander.command('opti').description('-- 代码优化').action(async args => {
+  const isLatest = await checkCmdVersion();
+  if (!isLatest) {
+    process.exit(1);
+  }
   await require('../src/code-optimization')();
 });
 
 // 发包
-commander.command('publish [args]').description('-- 发布包').action(args => {
+commander.command('publish [args]').description('-- 发布包').action(async args => {
+  const isLatest = await checkCmdVersion();
+  if (!isLatest) {
+    process.exit(1);
+  }
   require('../src/publish.js')(args);
 });
 
 // publish 命令
-commander.command('push [args]').description('-- 发布包').action(args => {
+commander.command('push [args]').description('-- 发布包').action(async args => {
+  const isLatest = await checkCmdVersion();
+  if (!isLatest) {
+    process.exit(1);
+  }
   if (args) {
     if ([ 'java' ].includes(args)) {
       require('../src/push.js')([]);
@@ -56,14 +75,41 @@ commander.command('push [args]').description('-- 发布包').action(args => {
   }
 });
 
+// npm-publish 命令 - 发布npm包
+commander.command('npm-publish [version]')
+  .description('-- 发布npm包（内部命令）')
+  .option('--tag <tag>', 'npm发布标签（如：beta、alpha等，默认为latest）')
+  .action(async (version, options) => {
+    const isLatest = await checkCmdVersion();
+    if (!isLatest) {
+      process.exit(1);
+    }
+    if (!version) {
+      console.log(`缺少必要参数，请使用:`);
+      console.log(`  yarn npm-publish <version>              发布npm包（latest标签）`);
+      console.log(`  yarn npm-publish <version> --tag <tag>  发布npm包（指定标签）`);
+      process.exit(0);
+    }
+    const tag = options.tag || null;
+    await require('../src/push-npm.js')(version, tag);
+  });
+
 // rm-rf 命令
 commander.command('rm-rf').description('-- 删除全部').action(async () => {
+  const isLatest = await checkCmdVersion();
+  if (!isLatest) {
+    process.exit(1);
+  }
   await require('../src/rm-rf.js')();
 });
 
 // ai-pull 命令
-commander.command('ai-pull').description('-- 拉取 AI 配置文件和规则').action(() => {
-  require('../src/ai-pull.js')();
+commander.command('ai-pull [branch]').description('-- 拉取 AI 配置文件和规则').action(async (branch) => {
+  const isLatest = await checkCmdVersion();
+  if (!isLatest) {
+    process.exit(1);
+  }
+  require('../src/ai-pull.js')(branch);
 });
 
 commander.parse(process.argv);

package/package.json

@@ -1,40 +1,41 @@
-{
-  "name": "jjb-cmd",
-  "use": "no",
-  "env": "prod",
-  "httpMethod": "http",
-  "pushMessage": "yes",
-  "version": "2.5.5",
-  "description": "jjb-cmd命令行工具",
-  "main": "index.js",
-  "scripts": {
-    "test": "node bin/command.js help",
-    "install:package": "npm i",
-    "test:ai-pull": "node bin/command.js ai-pull"
-  },
-  "bin": {
-    "jjb-cmd": "bin/command.js"
-  },
-  "author": "jiaoxiwei",
-  "license": "MIT",
-  "dependencies": {
-    "@babel/core": "^7.19.3",
-    "@babel/generator": "^7.26.0",
-    "@babel/parser": "^7.26.1",
-    "@babel/preset-env": "^7.23.2",
-    "@babel/preset-react": "^7.18.6",
-    "@babel/preset-typescript": "^7.23.2",
-    "@babel/traverse": "^7.25.9",
-    "@cqsjjb/react-code-optimization": "latest",
-    "axios": "^1.1.3",
-    "better-sqlite3": "^12.6.2",
-    "chalk": "2.4.0",
-    "commander": "^1.3.2",
-    "compressing": "^1.5.1",
-    "inquirer": "^8.2.7",
-    "jenkins": "^1.0.2",
-    "prettier": "^3.3.3",
-    "request": "2.88.2",
-    "single-line-log": "1.1.2"
-  }
-}
+{
+  "name": "jjb-cmd",
+  "use": "no",
+  "env": "prod",
+  "httpMethod": "http",
+  "pushMessage": "yes",
+  "version": "2.5.6-beta.2",
+  "description": "jjb-cmd命令行工具",
+  "main": "index.js",
+  "scripts": {
+    "test": "node bin/command.js help",
+    "install:package": "npm i",
+    "test:ai-pull": "node bin/command.js ai-pull",
+    "npm-publish": "node bin/command.js npm-publish"
+  },
+  "bin": {
+    "jjb-cmd": "bin/command.js"
+  },
+  "author": "jiaoxiwei",
+  "license": "MIT",
+  "dependencies": {
+    "@babel/core": "^7.19.3",
+    "@babel/generator": "^7.26.0",
+    "@babel/parser": "^7.26.1",
+    "@babel/preset-env": "^7.23.2",
+    "@babel/preset-react": "^7.18.6",
+    "@babel/preset-typescript": "^7.23.2",
+    "@babel/traverse": "^7.25.9",
+    "@cqsjjb/react-code-optimization": "latest",
+    "axios": "^1.1.3",
+    "better-sqlite3": "^12.6.2",
+    "chalk": "2.4.0",
+    "commander": "^1.3.2",
+    "compressing": "^1.5.1",
+    "inquirer": "^8.2.7",
+    "jenkins": "^1.0.2",
+    "prettier": "^3.3.3",
+    "request": "2.88.2",
+    "single-line-log": "1.1.2"
+  }
+}

package/src/ai-pull.js

@@ -17,8 +17,8 @@ const CURSOR_DB_PATH = path.join(
 
 // Git 仓库地址
 const AI_REPO_URL = 'http://192.168.1.242:10985/root/jjb-ai.git';
-// Git 分支/标签
-const AI_REPO_BRANCH = 'v_1.0.0';
+// Git 分支/标签（默认值）
+const DEFAULT_BRANCH = 'v_1.0.0';
 
 /**
  * 删除目录（回调方式，使用递归删除）
@@ -217,25 +217,29 @@ function copyFileWithRetry(srcPath, tarPath, retries, callback) {
   rs.pipe(ws);
 }
 
-module.exports = () => {
+module.exports = (branch) => {
   const root_path = path.resolve('./');
   const tmpDir = os.tmpdir();
   const cloneDir = path.join(tmpDir, 'jjb-ai-temp');
+  
+  // 使用传入的分支参数，如果没有则使用默认值
+  const targetBranch = branch || DEFAULT_BRANCH;
 
   console.log('【jjb-cmd ai-pull】：开始执行...');
+  console.log(`【分支】：${targetBranch}`);
 
   // 步骤1: 拉取或更新仓库代码
-  console.log('步骤1: 正在拉取 jjb-ai 仓库代码...');
+  console.log(`步骤1: 正在拉取 jjb-ai 仓库代码（分支: ${targetBranch}）...`);
   
   // 如果临时目录已存在，先删除
   deleteDir(cloneDir, () => {
     try {
       // 克隆仓库指定分支/标签
-      child_process.execSync(`git clone -b ${AI_REPO_BRANCH} ${AI_REPO_URL} "${cloneDir}"`, {
+      child_process.execSync(`git clone -b ${targetBranch} ${AI_REPO_URL} "${cloneDir}"`, {
         stdio: 'inherit',
         cwd: tmpDir
       });
-      console.log('✓ 仓库代码拉取成功');
+      console.log(`✓ 仓库代码拉取成功（分支: ${targetBranch}）`);
 
       // 步骤2: 复制 .ai 文件夹到当前项目
       console.log('步骤2: 正在复制 .ai 文件夹...');

package/src/publish.js

@@ -12,10 +12,41 @@ const {
   executeCommand,
   fileExists,
   readFile,
-  writeFile
+  writeFile,
+  getGitBranch,
+  getDeviceInfo,
+  calculateSimilarity
 } = require('./utils');
 const { loadAuth } = require('./crypto-utils');
 
+/**
+ * 格式化版本号
+ * 如果输入的版本号以v开头（包括v_），则去掉v前缀（服务器端会统一添加v前缀）
+ * 如果输入的版本号不以v开头，则保持原样（服务器端会添加v前缀）
+ * 这样可以避免服务器端重复添加前缀导致vv_1.0.0的问题
+ * @param {string} version - 输入的版本号
+ * @returns {string} 格式化后的版本号（去掉v前缀的纯版本号）
+ */
+function formatVersion(version) {
+  if (!version) {
+    return '0';
+  }
+  
+  let formattedVersion = version.trim();
+  
+  // 如果版本号以v_开头，去掉v_前缀（服务器端会添加v前缀）
+  if (formattedVersion.toLowerCase().startsWith('v_')) {
+    formattedVersion = formattedVersion.substring(2);
+  }
+  // 如果版本号以v开头（但不是v_），去掉v前缀（服务器端会添加v前缀）
+  else if (formattedVersion.toLowerCase().startsWith('v')) {
+    formattedVersion = formattedVersion.substring(1);
+  }
+  // 如果版本号不以v开头，保持原样（服务器端会添加v前缀）
+  
+  return formattedVersion;
+}
+
 /**
  * 解析组件配置信息
  * @param {string} distContent - 构建后的文件内容
@@ -198,12 +229,67 @@ module.exports = version => {
         logError(error.message);
         process.exit(1);
       }
+      
+      // 检查README相似度
+      logInfo('正在检查README文档...');
+      try {
+        const defaultReadmePath = path.join(__dirname, '../DEFAULT_README.md');
+        if (fileExists(defaultReadmePath)) {
+          const defaultReadme = readFile(defaultReadmePath);
+          const projectReadme = readFile(filePaths.readmePath);
+          const similarity = calculateSimilarity(defaultReadme, projectReadme);
+          
+          if (similarity >= 90) {
+            logError(`README文档与默认文档相似度过高（${similarity.toFixed(2)}%），请修改README文档后再发布`);
+            logWarning('提示：README文档应该包含组件的具体说明和使用方法，不能使用默认模板');
+            process.exit(1);
+          } else {
+            logSuccess(`README文档检查通过（相似度：${similarity.toFixed(2)}%）`);
+          }
+        } else {
+          logWarning('未找到DEFAULT_README.md文件，跳过README相似度检查');
+        }
+      } catch (error) {
+        logWarning(`README相似度检查失败: ${error.message}，将继续发布流程`);
+      }
 
       // 读取包信息
       logInfo('正在读取包信息...');
       const packageJsonFile = JSON.parse(readFile(path.join(__dirname, '../package.json')));
       const { version: cmdVersion } = packageJsonFile;
 
+      // 格式化版本号
+      const formattedVersion = formatVersion(version);
+      
+      // 读取dist/index.js内容
+      let distContent = readFile(filePaths.distPath);
+      
+      // 获取构建信息
+      const gitBranch = getGitBranch(rootPath);
+      const deviceInfo = getDeviceInfo();
+      const buildTime = new Date().toLocaleString('zh-CN', { 
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false
+      });
+      
+      // 在文件最上方添加构建信息注释
+      const buildInfoComment = `/* 
+ * Build Info:
+ *   Branch: ${gitBranch}
+ *   Device: ${deviceInfo.hostname} (MAC: ${deviceInfo.macAddress}, IP: ${deviceInfo.localIP})
+ *   Build Time: ${buildTime}
+ */
+`;
+      
+      // 如果文件开头已经有注释，需要判断是否已有构建信息注释
+      // 简单处理：直接在最前面添加
+      distContent = buildInfoComment + distContent;
+      
       // 准备发布数据
       logInfo('正在准备发布数据...');
       const pushData = {
@@ -211,8 +297,8 @@ module.exports = version => {
         cmd_version: cmdVersion,
         hostname: os.hostname(),
         platform: os.platform(),
-        package_version: version || 0,
-        package_content: readFile(filePaths.distPath),
+        package_version: formattedVersion || 0,
+        package_content: distContent,
         readme_content: readFile(filePaths.readmePath)
       };
 

package/src/push-npm.js

@@ -0,0 +1,199 @@
+const path = require('path');
+const fs = require('fs');
+const child_process = require('child_process');
+const axios = require('axios');
+const {
+  logInfo,
+  logSuccess,
+  logError,
+  logWarning,
+  readFile,
+  writeFile,
+  executeCommand,
+  fileExists
+} = require('./utils');
+const { getApiHost } = require('./config');
+const { loadAuth } = require('./crypto-utils');
+
+/**
+ * 执行npm发布流程
+ * @param {string} version - 版本号
+ * @param {string} tag - npm tag（可选，默认为latest）
+ */
+module.exports = async (version, tag) => {
+  if (!version) {
+    logError('请提供版本号，例如: jjb-cmd push 2.5.7 或 jjb-cmd push 2.5.7 --tag beta');
+    process.exit(1);
+  }
+  
+  // 如果没有指定tag，默认为latest
+  const npmTag = tag || 'latest';
+
+  const rootPath = path.resolve(__dirname, '..');
+  const packageJsonPath = path.join(rootPath, 'package.json');
+
+  // 读取当前package.json
+  let packageJson;
+  try {
+    const packageJsonContent = readFile(packageJsonPath);
+    packageJson = JSON.parse(packageJsonContent);
+  } catch (error) {
+    logError(`读取package.json失败: ${error.message}`);
+    process.exit(1);
+  }
+
+  const currentVersion = packageJson.version;
+  logInfo(`当前版本: ${currentVersion}`);
+  logInfo(`目标版本: ${version}`);
+
+  // 更新package.json中的版本号
+  try {
+    packageJson.version = version;
+    writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+    logSuccess(`已更新package.json版本号为: ${version}`);
+  } catch (error) {
+    logError(`更新package.json失败: ${error.message}`);
+    process.exit(1);
+  }
+
+  // 保存原始npm registry配置
+  let originalRegistry = 'https://registry.npmmirror.com/';
+  try {
+    const registryResult = child_process.execSync('npm config get registry', { encoding: 'utf8', cwd: rootPath });
+    originalRegistry = registryResult.trim() || 'https://registry.npmmirror.com/';
+  } catch (error) {
+    logWarning('无法获取当前npm registry配置，将使用默认值');
+  }
+
+  try {
+    // 1. 切换npm源到官方源
+    logInfo('正在切换npm源到官方源...');
+    executeCommand('npm config set registry https://registry.npmjs.org/', rootPath);
+    logSuccess('npm源已切换到官方源');
+    
+    // 检查是否已登录npm（针对官方源）
+    logInfo('正在检查npm登录状态...');
+    try {
+      const whoamiResult = child_process.execSync('npm whoami --registry=https://registry.npmjs.org/', { encoding: 'utf8', cwd: rootPath, stdio: 'pipe' });
+      const npmUser = whoamiResult.trim();
+      if (npmUser) {
+        logSuccess(`已登录npm账号: ${npmUser}`);
+      } else {
+        logError('未登录npm官方源，请先执行: npm login --registry=https://registry.npmjs.org/');
+        throw new Error('需要先登录npm官方源才能发布');
+      }
+    } catch (error) {
+      if (error.message.includes('需要先登录')) {
+        throw error;
+      }
+      logError('未登录npm官方源，请先执行: npm login --registry=https://registry.npmjs.org/');
+      logError('或者执行: npm adduser --registry=https://registry.npmjs.org/');
+      throw new Error('需要先登录npm官方源才能发布');
+    }
+
+    // 2. 发布到npm
+    // 注意：npm publish 不需要在命令中指定版本号，版本号已经从package.json中读取
+    // 但需要明确指定registry，确保使用官方源
+    logInfo(`正在发布版本 ${version} 到npm（tag: ${npmTag}）...`);
+    logInfo(`执行命令: npm publish --tag ${npmTag} --registry=https://registry.npmjs.org/（版本号 ${version} 已从package.json读取）`);
+    try {
+      const publishCommand = npmTag === 'latest' 
+        ? 'npm publish --registry=https://registry.npmjs.org/' 
+        : `npm publish --tag ${npmTag} --registry=https://registry.npmjs.org/`;
+      executeCommand(publishCommand, rootPath);
+      logSuccess(`版本 ${version} 发布成功（tag: ${npmTag}）！`);
+    } catch (error) {
+      // 如果发布失败，恢复package.json版本号
+      packageJson.version = currentVersion;
+      writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+      logError(`npm发布失败: ${error.message}`);
+      throw error;
+    }
+
+    // 3. 切回镜像源
+    logInfo('正在切回npm镜像源...');
+    executeCommand('npm config set registry https://registry.npmmirror.com/', rootPath);
+    logSuccess('npm源已切回镜像源');
+
+    // 4. 更新数据库中的版本号
+    logInfo('正在更新服务器端版本号...');
+    try {
+      const authPath = path.join(rootPath, '.auth');
+      let username, password;
+
+      // 尝试从认证文件读取
+      if (fileExists(authPath)) {
+        try {
+          const authData = loadAuth(authPath);
+          username = authData.username;
+          password = authData.password;
+        } catch (error) {
+          logWarning(`读取认证信息失败: ${error.message}`);
+          logWarning('跳过服务器端版本号更新，请手动执行 jjb-cmd update-server-version');
+          logSuccess('npm发布完成！');
+          process.exit(0);
+        }
+      } else {
+        logWarning('未找到认证信息，跳过服务器端版本号更新');
+        logWarning('请手动执行 jjb-cmd update-server-version 来更新服务器端版本号');
+        logSuccess('npm发布完成！');
+        process.exit(0);
+      }
+
+      // 调用服务器接口更新版本号
+      const apiHost = getApiHost();
+      const response = await axios.post(`${apiHost}/api/cmd/update-version`, {
+        username,
+        password
+      }, {
+        timeout: 15000
+      });
+
+      if (response.data && response.data.status) {
+        const { version: updatedVersion, previousVersion } = response.data.data;
+        logSuccess('服务器端版本号更新成功！');
+        if (previousVersion) {
+          logInfo(`  旧版本: ${previousVersion}`);
+        }
+        logInfo(`  新版本: ${updatedVersion}`);
+      } else {
+        logWarning(`服务器端版本号更新失败: ${response.data.message || '未知错误'}`);
+        logWarning('请手动执行 jjb-cmd update-server-version 来更新服务器端版本号');
+      }
+    } catch (error) {
+      if (error && error.response) {
+        const status = error.response.status;
+        const serverMsg = (error.response.data && (error.response.data.message || error.response.data.msg)) || '';
+        logWarning(`服务器端版本号更新失败 (${status}): ${serverMsg || error.message}`);
+      } else if (error && error.request) {
+        logWarning('网络连接失败: 无法连接到服务器');
+      } else {
+        logWarning(`服务器端版本号更新失败: ${error.message || '未知错误'}`);
+      }
+      logWarning('请手动执行 jjb-cmd update-server-version 来更新服务器端版本号');
+    }
+
+    logSuccess('所有操作完成！');
+    process.exit(0);
+  } catch (error) {
+    // 发生错误时，尝试恢复npm源
+    try {
+      logInfo('正在恢复npm源...');
+      executeCommand(`npm config set registry ${originalRegistry}`, rootPath);
+      logInfo('npm源已恢复');
+    } catch (restoreError) {
+      logError(`恢复npm源失败: ${restoreError.message}`);
+    }
+
+    // 恢复package.json版本号
+    try {
+      packageJson.version = currentVersion;
+      writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+      logInfo('已恢复package.json版本号');
+    } catch (restoreError) {
+      logError(`恢复package.json失败: ${restoreError.message}`);
+    }
+
+    process.exit(1);
+  }
+};

package/src/utils.js

@@ -2,6 +2,8 @@ const fs = require('fs');
 const path = require('path');
 const child_process = require('child_process');
 const chalk = require('chalk');
+const axios = require('axios');
+const { getApiHost } = require('./config');
 
 // 常量定义
 const CONSTANTS = {
@@ -207,6 +209,230 @@ function CopyFolder(srcDir, tarDir, cb) {
 }
 
 
+/**
+ * 获取Git当前分支名
+ * @param {string} rootPath - 项目根路径
+ * @returns {string} 分支名，如果获取失败返回'unknown'
+ */
+function getGitBranch(rootPath) {
+  try {
+    const result = executeCommand('git rev-parse --abbrev-ref HEAD', rootPath, { encoding: 'utf8' });
+    return result.toString().trim() || 'unknown';
+  } catch (error) {
+    return 'unknown';
+  }
+}
+
+/**
+ * 获取MAC地址
+ * @returns {string} MAC地址
+ */
+function getMacAddress() {
+  const os = require('os');
+  const networkInterfaces = os.networkInterfaces();
+  
+  for (const interfaceName in networkInterfaces) {
+    const interfaces = networkInterfaces[interfaceName];
+    for (const iface of interfaces) {
+      // 跳过内部（即127.0.0.1）和非IPv4地址
+      if (!iface.internal && iface.family === 'IPv4') {
+        return iface.mac || 'unknown';
+      }
+    }
+  }
+  return 'unknown';
+}
+
+/**
+ * 获取内网IP地址
+ * @returns {string} 内网IP地址
+ */
+function getLocalIP() {
+  const os = require('os');
+  const networkInterfaces = os.networkInterfaces();
+  
+  for (const interfaceName in networkInterfaces) {
+    const interfaces = networkInterfaces[interfaceName];
+    for (const iface of interfaces) {
+      // 跳过内部（即127.0.0.1）和非IPv4地址
+      if (!iface.internal && iface.family === 'IPv4') {
+        return iface.address || 'unknown';
+      }
+    }
+  }
+  return 'unknown';
+}
+
+/**
+ * 获取设备信息
+ * @returns {Object} 设备信息对象
+ */
+function getDeviceInfo() {
+  const os = require('os');
+  return {
+    hostname: os.hostname(),
+    macAddress: getMacAddress(),
+    localIP: getLocalIP()
+  };
+}
+
+/**
+ * 标准化文本（去除空白字符、换行符等）
+ * @param {string} text - 原始文本
+ * @returns {string} 标准化后的文本
+ */
+function normalizeText(text) {
+  if (!text) return '';
+  return text
+    .replace(/\s+/g, ' ') // 将所有空白字符（包括换行、制表符等）替换为单个空格
+    .replace(/\n/g, ' ') // 替换换行符
+    .replace(/\r/g, '') // 替换回车符
+    .replace(/\t/g, ' ') // 替换制表符
+    .trim(); // 去除首尾空格
+}
+
+/**
+ * 计算两个文本的相似度（基于字符匹配）
+ * @param {string} text1 - 文本1
+ * @param {string} text2 - 文本2
+ * @returns {number} 相似度百分比（0-100）
+ */
+function calculateSimilarity(text1, text2) {
+  if (!text1 || !text2) {
+    return 0;
+  }
+  
+  // 标准化文本
+  const normalized1 = normalizeText(text1);
+  const normalized2 = normalizeText(text2);
+  
+  if (normalized1 === normalized2) {
+    return 100;
+  }
+  
+  // 使用简单的字符匹配算法
+  // 计算相同字符的数量
+  const len1 = normalized1.length;
+  const len2 = normalized2.length;
+  
+  if (len1 === 0 && len2 === 0) {
+    return 100;
+  }
+  
+  if (len1 === 0 || len2 === 0) {
+    return 0;
+  }
+  
+  // 使用最长公共子序列（LCS）的简化版本
+  // 这里使用更简单的字符匹配算法
+  let matches = 0;
+  const minLen = Math.min(len1, len2);
+  const maxLen = Math.max(len1, len2);
+  
+  // 计算相同位置的相同字符数
+  for (let i = 0; i < minLen; i++) {
+    if (normalized1[i] === normalized2[i]) {
+      matches++;
+    }
+  }
+  
+  // 计算相似度百分比
+  const similarity = (matches / maxLen) * 100;
+  
+  // 如果相似度很高，使用更精确的算法
+  if (similarity > 80) {
+    // 使用编辑距离算法（Levenshtein距离）的简化版本
+    return calculateLevenshteinSimilarity(normalized1, normalized2);
+  }
+  
+  return similarity;
+}
+
+/**
+ * 使用Levenshtein距离计算相似度
+ * @param {string} str1 - 字符串1
+ * @param {string} str2 - 字符串2
+ * @returns {number} 相似度百分比（0-100）
+ */
+function calculateLevenshteinSimilarity(str1, str2) {
+  const len1 = str1.length;
+  const len2 = str2.length;
+  
+  if (len1 === 0) return len2 === 0 ? 100 : 0;
+  if (len2 === 0) return 0;
+  
+  // 创建矩阵
+  const matrix = [];
+  for (let i = 0; i <= len1; i++) {
+    matrix[i] = [i];
+  }
+  for (let j = 0; j <= len2; j++) {
+    matrix[0][j] = j;
+  }
+  
+  // 填充矩阵
+  for (let i = 1; i <= len1; i++) {
+    for (let j = 1; j <= len2; j++) {
+      if (str1[i - 1] === str2[j - 1]) {
+        matrix[i][j] = matrix[i - 1][j - 1];
+      } else {
+        matrix[i][j] = Math.min(
+          matrix[i - 1][j - 1] + 1, // 替换
+          matrix[i][j - 1] + 1, // 插入
+          matrix[i - 1][j] + 1 // 删除
+        );
+      }
+    }
+  }
+  
+  // 计算相似度
+  const distance = matrix[len1][len2];
+  const maxLen = Math.max(len1, len2);
+  const similarity = ((maxLen - distance) / maxLen) * 100;
+  
+  return Math.max(0, Math.min(100, similarity));
+}
+
+/**
+ * 检查jjb-cmd版本是否为最新版本
+ * @returns {Promise<boolean>} 是否为最新版本
+ */
+async function checkCmdVersion() {
+  try {
+    const packageJsonPath = path.join(__dirname, '../package.json');
+    const packageJson = JSON.parse(readFile(packageJsonPath));
+    const currentVersion = packageJson.version;
+
+    const apiHost = getApiHost();
+    const response = await axios.get(`${apiHost}/api/cmd/version`, {
+      timeout: 5000
+    });
+
+    if (response.data && response.data.status && response.data.data) {
+      const latestVersion = response.data.data.version;
+      
+      // 版本号比较：将版本号转换为数字进行比较
+      const currentVersionNum = parseInt(currentVersion.replace(/[.]/g, ''));
+      const latestVersionNum = parseInt(latestVersion.replace(/[.]/g, ''));
+      
+      if (currentVersionNum < latestVersionNum) {
+        logError(`当前版本 v${currentVersion} 不是最新版本，最新版本为 v${latestVersion}`);
+        logInfo('请执行以下命令更新到最新版本：');
+        logInfo('npm install jjb-cmd -g');
+        return false;
+      }
+      return true;
+    }
+    // 如果API返回异常，允许继续执行（避免因网络问题阻塞）
+    logWarning('无法获取服务器最新版本信息，将继续执行命令');
+    return true;
+  } catch (error) {
+    // 网络错误或其他错误时，允许继续执行
+    logWarning('版本检查失败，将继续执行命令');
+    return true;
+  }
+}
+
 module.exports = {
   CONSTANTS,
   logInfo,
@@ -224,5 +450,9 @@ module.exports = {
   validateEnvironment,
   DeleteDirAllFile,
   CopyFile,
-  CopyFolder
+  CopyFolder,
+  checkCmdVersion,
+  getGitBranch,
+  getDeviceInfo,
+  calculateSimilarity
 };