tolingcode 2026.3.816 → 2026.3.818

package/README.md

@@ -5,66 +5,158 @@
   <img src="https://raw.githubusercontent.com/tolingcode/tolingcode/main/docs/banner.png"  alt="TolingCode banner">
 </p>
  
-
 ![npm](https://img.shields.io/npm/v/tolingcode)
 ![downloads](https://img.shields.io/npm/dm/tolingcode)
 ![license](https://img.shields.io/badge/license-MIT-green)
 
 # TolingCode CLI
 
-**跨境电商私人 AI 助手** - 在个人设备上运行的本地化 AI 自动化工具 , tolingcode  Skills完全兼容openclaw。
+**跨境电商私人 AI 助手** - 基于 OpenClaw 的本地化 AI 自动化工具
 
-为跨境卖家提供订单履约、库存管理、产品刊登、广告管理、数据分析等核心业务能力。
+TolingCode Skills 完全兼容 OpenClaw，为跨境卖家提供订单履约、库存管理、产品刊登、广告管理、数据分析等核心业务能力。
 
 ---
 
-## 安装
+## 快速开始
+
+### 1. 安装 TolingCode
 
 ```bash
 # 安装最新版本
 npm install -g tolingcode@latest
+```
+
+### 2. 安装 OpenClaw
+
+```bash
+# 通过 tolingcode 安装 OpenClaw（推荐）
+tolingcode install openclaw
 
 # 安装指定版本
-npm install -g tolingcode@2026.03.09
+tolingcode install openclaw -v 2026.3.7
+
+# 强制重新安装
+tolingcode install openclaw --force
+```
+
+### 3. 启动 OpenClaw Gateway
+
+```bash
+openclaw gateway start
 ```
 
-**当前版本**: 2026.03.09
+### 4. 安装技能
+
+```bash
+# 安装大健云仓技能（跨境电商 B2B）
+tolingcode install skills gigacloud-warehouse
+
+# 安装订单履约管理技能
+tolingcode install skills order-fulfillment
+
+# 安装远程 Linux 运维技能
+tolingcode install skills hbj-ai-shell
+```
 
 ---
 
-## 使用
+## 跨平台支持
+
+✅ **完全支持**: Windows / Linux / macOS
+
+### 路径说明
 
-### 安装技能 (Skill)
+| 系统 | OpenClaw 工作目录 | 全局应用目录 |
+|------|------------------|-------------|
+| **Windows** | `C:\Users\<用户名>\.openclaw\workspace` | `%APPDATA%\tolingcode\apps` |
+| **Linux** | `/home/<用户名>/.openclaw/workspace` | `~/.local/tolingcode/apps` |
+| **macOS** | `/Users/<用户名>/.openclaw/workspace` | `~/.local/tolingcode/apps` |
+
+### 自定义工作目录
 
 ```bash
-# 安装技能
-tolingcode install skills weather
+# 通过环境变量自定义 OpenClaw 工作目录
+# Windows
+set OPENCLAW_WORKSPACE=D:\my-workspace
 
-# 安装指定版本
-tolingcode install skills weather -v 2026.03.08
+# Linux/Mac
+export OPENCLAW_WORKSPACE=/path/to/my-workspace
+
+# 然后安装技能
+tolingcode install skills gigacloud-warehouse
 ```
 
-### 安装应用 (App)
+### 系统要求
+
+- **Node.js**: >= 16.0.0
+- **npm**: >= 7.0.0
+- **OpenClaw**: 自动安装（通过 `tolingcode install openclaw`）
+
+---
+
+## 命令参考
+
+### 安装命令
 
 ```bash
-# 安装到当前目录
-tolingcode install apps myapp
+# 安装 OpenClaw
+tolingcode install openclaw
+
+# 安装技能
+tolingcode install skills <skill-name>
 
-# 全局安装
-tolingcode install apps myapp -g
+# 安装应用
+tolingcode install apps <app-name>
+
+# 指定版本安装
+tolingcode install skills <skill-name> -v 2026.3.8
+
+# 全局安装应用
+tolingcode install apps <app-name> -g
+
+# 强制重新安装 OpenClaw
+tolingcode install openclaw --force
 ```
 
 ### 查看和搜索
 
 ```bash
-# 列出所有包
+# 列出所有可用包
 tolingcode list
 
 # 只列出技能
 tolingcode list skills
 
+# 只列出应用
+tolingcode list apps
+
 # 搜索技能
-tolingcode search weather
+tolingcode search 电商
+tolingcode search gigacloud
+tolingcode search order
+```
+
+### 发布技能（开发者）
+
+```bash
+tolingcode publish ./my-skill \
+  --type skills \
+  --name my-skill \
+  --version 2026.3.9
+```
+
+### 其他命令
+
+```bash
+# 查看使用示例
+tolingcode examples
+
+# 查看版本
+tolingcode --version
+
+# 查看帮助
+tolingcode --help
+tolingcode install --help
 ```
 
 ---
@@ -99,30 +191,52 @@ tolingcode search weather
 
 ---
 
-## 发布技能 (开发者)
+## 支持平台
 
-```bash
-tolingcode publish ./my-skill \
-  --type skills \
-  --name my-skill \
-  --version 2026.03.09
-```
+**电商平台**: Amazon、eBay、AliExpress、Wish、Shopee、Lazada、Mercado Libre、Etsy、Wayfair、TikTok Shop 等
 
-### 版本规范
+**独立站**: Shopify、WooCommerce、Magento、BigCommerce
+
+**零售平台**: Walmart、Target、Costco、Best Buy 等
 
-使用日期版本号：`YYYY.MM.DD`
+**海外仓**: 支持 100+ 海外仓系统 (中通国际、Walmart WFS、马士基、RMS 红鼠等)
 
 ---
 
-## 支持平台
+## 版本规范
 
-**电商平台**: Amazon、eBay、AliExpress、Wish、Shopee、Lazada、Mercado Libre、Etsy、Wayfair、TikTok Shop 等
+使用日期版本号：`YYYY.M.D`（无前导零）
 
-**独立站**: Shopify、WooCommerce、Magento、BigCommerce
+示例：
+- ✅ `2026.3.9`
+- ❌ `2026.03.09`
 
-**零售平台**: Walmart、Target、Costco、Best Buy 等
+---
 
-**海外仓**: 支持 100+ 海外仓系统 (中通国际、Walmart WFS、马士基、RMS 红鼠等)
+## 私有 Registry
+
+TolingCode 支持从私有 Registry 安装技能：
+
+```bash
+# 设置私有 Registry 地址
+set TOLINGCODE_REGISTRY=http://your-registry.com/api/registry
+
+# 安装技能
+tolingcode install skills your-skill
+```
+
+### 部署私有 Registry
+
+参考 `server/registry.js` 部署自己的技能注册中心。
+
+---
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `TOLINGCODE_REGISTRY` | `https://toling.me/api/registry` | Registry 服务器地址 |
+| `OPENCLAW_WORKSPACE` | `~/.openclaw/workspace` | OpenClaw 工作目录 |
 
 ---
 
@@ -130,9 +244,42 @@ tolingcode publish ./my-skill \
 
 - **Registry**: https://toling.me
 - **GitHub**: https://github.com/tolingcode/tolingcode
+- **OpenClaw**: https://github.com/openclaw/openclaw
+- **OpenClaw 文档**: https://docs.openclaw.ai
 - **问题反馈**: GitHub Issues
 
 ---
 
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/tolingcode/tolingcode.git
+cd tolingcode
+
+# 安装依赖
+npm install
+
+# 本地测试
+npm link
+
+# 运行命令
+tolingcode --help
+```
+
+---
+
+## 更新日志
+
+### 2026.3.21
+
+- ✨ 新增：支持通过 `tolingcode install openclaw` 安装/更新 OpenClaw
+- ✨ 新增：支持 `--force` 参数强制重装 OpenClaw
+- ✨ 新增：支持 `-v` 参数指定 OpenClaw 版本
+- 🎨 改进：统一命令入口，所有安装通过 `tolingcode` 管理
+- 📝 改进：完善帮助信息和文档
+
+---
+
 **作者**: 韩宝军 (TolingCode)  
 **License**: MIT

package/bin/tolingcode.js

@@ -16,18 +16,152 @@ const REGISTRY_URL = process.env.TOLINGCODE_REGISTRY || 'https://toling.me/api/r
 
 program
   .name('tolingcode')
-  .description('TolingCode CLI - Install skills and apps from toling.me')
-  .version(pkg.version);
+  .description(chalk.hex('#0de900')('TolingCode CLI - 鲸汇跨境电商 AI 助手技能管理工具'))
+  .version(pkg.version, '-v, --version', chalk.hex('#FFFFFF')('显示版本号'))
+  .addHelpText('after', `
+${chalk.hex('#0de900').bold('快速开始:')}
+  ${chalk.hex('#ff6319')('# 安装 OpenClaw')}
+  ${chalk.hex('#0de900')('$ tolingcode install openclaw')}                  ${chalk.white('# 安装/更新 OpenClaw')}
+  ${chalk.hex('#0de900')('$ tolingcode install openclaw -v 2026.3.7')}      ${chalk.white('# 安装指定版本')}
+  
+  ${chalk.hex('#ff6319')('# 安装技能')}
+  ${chalk.hex('#0de900')('$ tolingcode install skills gigacloud-warehouse')}    ${chalk.white('# 大健云仓（跨境电商 B2B）')}
+  ${chalk.hex('#0de900')('$ tolingcode install skills order-fulfillment')}      ${chalk.white('# 订单履约管理')}
+  ${chalk.hex('#0de900')('$ tolingcode install skills hbj-ai-shell')}           ${chalk.white('# 远程 Linux 运维')}
+  
+  ${chalk.hex('#ff6319')('# 列出技能')}
+  ${chalk.hex('#0de900')('$ tolingcode list skills')}
+  
+  ${chalk.hex('#ff6319')('# 搜索技能')}
+  ${chalk.hex('#0de900')('$ tolingcode search 电商')}
+  ${chalk.hex('#0de900')('$ tolingcode search gigacloud')}
+  
+  ${chalk.hex('#ff6319')('# 查看更多示例')}
+  ${chalk.hex('#0de900')('$ tolingcode examples')}
+`);
 
-// install command
+// Override help output colors - all orange
+const originalHelpInformation = program.helpInformation.bind(program);
+program.helpInformation = function() {
+  const help = originalHelpInformation();
+  return help
+    .replace(/^(Options:)/gm, chalk.hex('#0de900').bold('$1'))
+    .replace(/^(Commands:)/gm, chalk.hex('#0de900').bold('$1'))
+    .replace(/^  (-v, --version)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (-h, --help)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (install)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (list)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (search)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (publish)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (examples)/gm, chalk.hex('#0de900')('$1'))
+    .replace(/^  (help)/gm, chalk.hex('#0de900')('$1'));
+};
+
+/**
+ * 安装/更新 OpenClaw
+ */
+async function installOpenClaw(name, version, force) {
+  const versionStr = version === 'latest' ? 'latest' : version;
+  
+  console.log(chalk.blue(`\n📦 准备安装 OpenClaw@${versionStr}...\n`));
+  
+  // 检查当前版本
+  let currentVersion = null;
+  try {
+    currentVersion = execSync('openclaw --version', { encoding: 'utf-8' }).trim();
+    console.log(chalk.gray(`   当前版本：${currentVersion}`));
+  } catch (e) {
+    console.log(chalk.gray(`   当前版本：未安装`));
+  }
+  
+  // 获取最新版本
+  let latestVersion = null;
+  try {
+    latestVersion = execSync('npm view openclaw version', { encoding: 'utf-8' }).trim();
+    console.log(chalk.gray(`   最新版本：${latestVersion}\n`));
+  } catch (e) {
+    // 忽略
+  }
+  
+  // 检查是否需要更新
+  if (!force && currentVersion && latestVersion && currentVersion === latestVersion) {
+    console.log(chalk.green(`\n✅ 已是最新版本：${currentVersion}`));
+    console.log(chalk.gray(`   如需强制重装，使用 --force 参数\n`));
+    return;
+  }
+  
+  // 开始安装
+  const installVersion = version === 'latest' ? '' : `@${version}`;
+  const spinner = ora(`安装 openclaw${installVersion}...`).start();
+  
+  try {
+    execSync(`npm install -g openclaw${installVersion}`, { 
+      encoding: 'utf-8', 
+      stdio: 'pipe' 
+    });
+    
+    spinner.stop();
+    console.log(chalk.green('\n✅ 安装完成！\n'));
+    
+    // 验证安装
+    const newVersion = execSync('openclaw --version', { encoding: 'utf-8' }).trim();
+    console.log(chalk.green(`📦 已安装版本：${newVersion}\n`));
+    
+    // 检查 Gateway 状态
+    console.log(chalk.gray('🔍 检查 Gateway 状态...'));
+    try {
+      const status = execSync('openclaw gateway status', { encoding: 'utf-8' });
+      if (status.includes('Listening')) {
+        console.log(chalk.green('✅ Gateway 运行正常\n'));
+      } else {
+        console.log(chalk.yellow('⚠️  Gateway 未运行\n'));
+        console.log(chalk.gray('   启动命令：openclaw gateway start\n'));
+      }
+    } catch (e) {
+      console.log(chalk.yellow('⚠️  Gateway 未运行\n'));
+      console.log(chalk.gray('   启动命令：openclaw gateway start\n'));
+    }
+    
+    console.log(chalk.cyan('💡 常用命令:'));
+    console.log(chalk.gray('   openclaw --version     查看版本'));
+    console.log(chalk.gray('   openclaw gateway start 启动 Gateway'));
+    console.log(chalk.gray('   tolingcode list skills 查看可用技能\n'));
+    
+  } catch (e) {
+    spinner.stop();
+    console.log(chalk.red(`\n❌ 安装失败：${e.message}\n`));
+    console.log(chalk.gray('请检查:'));
+    console.log(chalk.gray('  1. 网络连接是否正常'));
+    console.log(chalk.gray('  2. npm 是否已安装'));
+    console.log(chalk.gray('  3. 是否有管理员权限\n'));
+    process.exit(1);
+  }
+}
+
+// install command - support both "install openclaw" and "install type name"
 program
-  .command('install <type> <name>')
-  .description('Install a skill or app')
-  .option('-v, --version <version>', 'Specify version (e.g., 2026.02.26 or latest)')
-  .option('-g, --global', 'Install globally (for apps)')
+  .command('install <type> [name]')
+  .description('安装技能、应用或 OpenClaw 本身')
+  .option('-v, --version <version>', '指定版本 (默认：latest)')
+  .option('-g, --global', '全局安装 (仅 apps)')
+  .option('--force', '强制重新安装 (仅 openclaw)')
   .action(async (type, name, options) => {
     const version = options.version || 'latest';
     
+    // 特殊处理：安装 OpenClaw 本身
+    if (type === 'openclaw' || name === 'openclaw') {
+      await installOpenClaw('openclaw', version, options.force || false);
+      return;
+    }
+    
+    // 需要 type 和 name
+    if (!name) {
+      console.log(chalk.red('\n✗ 错误：缺少参数 name'));
+      console.log(chalk.gray('   用法：tolingcode install <type> <name>\n'));
+      program.outputHelp();
+      process.exit(1);
+    }
+    
     console.log(chalk.blue(`\n🔍 Searching for ${type}: ${name}@${version}...`));
     
     try {
@@ -43,14 +177,21 @@ program
       console.log(chalk.gray(`  Description: ${pkg.description}`));
       console.log(chalk.gray(`  Download URL: ${pkg.downloadUrl}`));
       
-      // Determine install path
+      // Determine install path (cross-platform)
       let installPath;
       if (type === 'skills') {
-        const workspace = process.env.OPENCLAW_WORKSPACE || path.join(process.env.HOME || process.env.USERPROFILE, '.openclaw', 'workspace');
+        // OpenClaw workspace path (cross-platform)
+        const homeDir = process.env.HOME || process.env.USERPROFILE || require('os').homedir();
+        const workspace = process.env.OPENCLAW_WORKSPACE || path.join(homeDir, '.openclaw', 'workspace');
         installPath = path.join(workspace, 'skills');
+        console.log(chalk.gray(`   安装路径：${installPath}`));
       } else if (type === 'apps') {
         if (options.global) {
-          installPath = path.join(process.env.APPDATA || path.join(process.env.HOME || '', '.local'), 'tolingcode', 'apps');
+          const homeDir = process.env.HOME || process.env.USERPROFILE || require('os').homedir();
+          // Cross-platform: Windows uses APPDATA, Linux/Mac uses ~/.local
+          installPath = process.env.APPDATA 
+            ? path.join(process.env.APPDATA, 'tolingcode', 'apps')  // Windows
+            : path.join(homeDir, '.local', 'tolingcode', 'apps');  // Linux/Mac
         } else {
           installPath = path.join(process.cwd(), 'tolingcode-apps');
         }
@@ -114,7 +255,7 @@ program
 // list command - list available skills/apps
 program
   .command('list [type]')
-  .description('List available skills or apps')
+  .description('列出可用的技能或应用 (skills | apps | all)')
   .action(async (type) => {
     console.log(chalk.blue('\n📦 Available packages:\n'));
     
@@ -160,7 +301,7 @@ program
 // search command
 program
   .command('search <query>')
-  .description('Search for skills or apps')
+  .description('搜索技能或应用')
   .action(async (query) => {
     console.log(chalk.blue(`\n🔍 Searching for: ${query}\n`));
     
@@ -189,10 +330,10 @@ program
 // publish command - for publishing skills/apps to registry
 program
   .command('publish <path>')
-  .description('Publish a skill or app to the registry')
-  .option('--type <type>', 'Package type (skills or apps)', 'skills')
-  .option('--name <name>', 'Package name')
-  .option('--version <version>', 'Package version')
+  .description('发布技能或应用到 registry')
+  .option('--type <type>', '包类型 (skills 或 apps)', 'skills')
+  .option('--name <name>', '包名称')
+  .option('--version <version>', '包版本号')
   .action(async (pkgPath, options) => {
     const absPath = path.resolve(pkgPath);
     
@@ -228,4 +369,42 @@ program
     console.log(chalk.gray('   See: docs/PUBLISH.md for details'));
   });
 
+// examples command
+program
+  .command('examples')
+  .description('显示使用示例')
+  .action(() => {
+    console.log(`
+${chalk.bold('常用命令示例:')}
+
+${chalk.green('1. 安装技能')}
+  $ tolingcode install skills gigacloud-warehouse
+  $ tolingcode install skills order-fulfillment
+  $ tolingcode install skills weather -v 2026.3.8
+
+${chalk.green('2. 列出技能')}
+  $ tolingcode list skills
+  $ tolingcode list apps
+  $ tolingcode list
+
+${chalk.green('3. 搜索技能')}
+  $ tolingcode search 电商
+  $ tolingcode search gigacloud
+  $ tolingcode search order
+
+${chalk.green('4. 发布技能')}
+  $ tolingcode publish ./skills/gigacloud-warehouse --type skills --name gigacloud-warehouse --version 2026.3.8
+
+${chalk.green('5. 查看帮助')}
+  $ tolingcode --help
+  $ tolingcode install --help
+  $ tolingcode search --help
+
+${chalk.green('6. 查看版本')}
+  $ tolingcode -v
+  $ tolingcode --version
+`);
+  });
+
 program.parse();
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tolingcode",
-  "version": "2026.03.816",
-  "description": "TolingCode CLI - Install skills and apps from toling.me",
+  "version": "2026.3.818",
+  "description": "TolingCode CLI - 跨境电商 AI 助手技能管理工具 (基于 OpenClaw)",
   "main": "bin/tolingcode.js",
   "files": [
     "bin",
@@ -21,10 +21,13 @@
   "author": "TolingCode",
   "license": "MIT",
   "dependencies": {
-    "commander": "^11.0.0",
+    "axios": "^1.6.0",
     "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "cors": "^2.8.6",
+    "express": "^5.2.1",
+    "multer": "^2.1.1",
     "ora": "^5.4.1",
-    "axios": "^1.6.0",
     "tar": "^6.2.0"
   },
   "engines": {