tolingcode 2026.3.10 → 2026.3.12

package/bin/tolingcode.js

@@ -16,61 +16,32 @@ const REGISTRY_URL = process.env.TOLINGCODE_REGISTRY || 'https://toling.me/api/r
 
 program
   .name('tolingcode')
-  .description(`TolingCode CLI - 跨境电商 AI 助手技能管理工具
-
-${chalk.bold('功能特性:')}
-  • 安装/更新技能 - 从 toling.me registry 安装技能
-  • 搜索技能 - 查找可用的技能包
-  • 列出技能 - 查看已安装或可用的技能
-  • 发布技能 - 发布自定义技能到 registry
-
-${chalk.bold('适用场景:')}
-  • 跨境电商订单处理
-  • 海外仓库存管理
-  • 物流跟踪
-  • AI 产品优化
-  • 自动化运维
-
+  .description('TolingCode CLI - 跨境电商 AI 助手技能管理工具')
+  .version(pkg.version, '-v, --version', '显示版本号')
+  .addHelpText('after', `
 ${chalk.bold('快速开始:')}
-  $ tolingcode install skills gigacloud-warehouse  # 安装大健云仓技能
-  $ tolingcode install skills order-fulfillment    # 安装订单履约技能
-  $ tolingcode search 电商                         # 搜索电商相关技能`)
-  .version(pkg.version, '-v, --version', '显示版本号');
-
-// install command
-program
-  .command('install <type> <name>')
-  .description(`安装技能或应用
-
-${chalk.bold('参数:')}
-  type     类型：skills | apps
-  name     技能/应用名称
-
-${chalk.bold('选项:')}
-  -v, --version   指定版本 (默认：latest)
-  -g, --global    全局安装 (仅 apps)
-
-${chalk.bold('示例:')}
-  ${chalk.gray('# 安装大健云仓技能（跨境电商 B2B 分销）')}
-  $ tolingcode install skills gigacloud-warehouse
-  
-  ${chalk.gray('# 安装订单履约技能')}
-  $ tolingcode install skills order-fulfillment
+  ${chalk.gray('# 安装技能')}
+  $ tolingcode install skills gigacloud-warehouse    # 大健云仓（跨境电商 B2B）
+  $ tolingcode install skills order-fulfillment      # 订单履约管理
+  $ tolingcode install skills hbj-ai-shell           # 远程 Linux 运维
   
-  ${chalk.gray('# 安装指定版本的技能')}
-  $ tolingcode install skills weather -v 2026.3.8
+  ${chalk.gray('# 列出技能')}
+  $ tolingcode list skills
   
-  ${chalk.gray('# 全局安装应用')}
-  $ tolingcode install apps myapp -g
+  ${chalk.gray('# 搜索技能')}
+  $ tolingcode search 电商
+  $ tolingcode search gigacloud
   
-  ${chalk.gray('# 安装到当前目录')}
-  $ tolingcode install apps myapp
+  ${chalk.gray('# 查看更多示例')}
+  $ tolingcode examples
+`);
 
-${chalk.bold('安装后:')}
-  重启 OpenClaw Gateway 以加载新技能
-  $ openclaw gateway restart`)
-  .option('-v, --version <version>', '指定版本 (例如：2026.3.8 或 latest)')
-  .option('-g, --global', '全局安装 (仅用于 apps)')
+// install command
+program
+  .command('install <type> <name>')
+  .description('安装技能或应用')
+  .option('-v, --version <version>', '指定版本 (默认：latest)')
+  .option('-g, --global', '全局安装 (仅 apps)')
   .action(async (type, name, options) => {
     const version = options.version || 'latest';
     
@@ -160,28 +131,7 @@ ${chalk.bold('安装后:')}
 // list command - list available skills/apps
 program
   .command('list [type]')
-  .description(`列出可用的技能或应用
-
-${chalk.bold('参数:')}
-  type     类型：skills | apps | all (可选)
-
-${chalk.bold('示例:')}
-  ${chalk.gray('# 列出所有技能')}
-  $ tolingcode list skills
-  
-  ${chalk.gray('# 列出所有应用')}
-  $ tolingcode list apps
-  
-  ${chalk.gray('# 列出所有包')}
-  $ tolingcode list
-  $ tolingcode list all
-
-${chalk.bold('可用技能:')}
-  • gigacloud-warehouse - 大健云仓（跨境电商 B2B 分销）
-  • order-fulfillment - 订单履约管理
-  • hbj-ai-shell - 远程 Linux 运维
-  • imap-smtp-email - 邮件收发
-  • weather - 天气查询`)
+  .description('列出可用的技能或应用 (skills | apps | all)')
   .action(async (type) => {
     console.log(chalk.blue('\n📦 Available packages:\n'));
     
@@ -227,31 +177,7 @@ ${chalk.bold('可用技能:')}
 // search command
 program
   .command('search <query>')
-  .description(`搜索技能或应用
-
-${chalk.bold('参数:')}
-  query    搜索关键词（支持中文）
-
-${chalk.bold('示例:')}
-  ${chalk.gray('# 搜索电商相关技能')}
-  $ tolingcode search 电商
-  
-  ${chalk.gray('# 搜索物流相关技能')}
-  $ tolingcode search 物流
-  
-  ${chalk.gray('# 搜索大健云仓')}
-  $ tolingcode search gigacloud
-  
-  ${chalk.gray('# 搜索订单处理')}
-  $ tolingcode search order
-  
-  ${chalk.gray('# 搜索 AI 相关')}
-  $ tolingcode search AI
-
-${chalk.bold('搜索范围:')}
-  • 技能名称
-  • 技能描述
-  • 关键词标签`)
+  .description('搜索技能或应用')
   .action(async (query) => {
     console.log(chalk.blue(`\n🔍 Searching for: ${query}\n`));
     
@@ -280,46 +206,7 @@ ${chalk.bold('搜索范围:')}
 // publish command - for publishing skills/apps to registry
 program
   .command('publish <path>')
-  .description(`发布技能或应用到 registry
-
-${chalk.bold('参数:')}
-  path     技能/应用目录路径
-
-${chalk.bold('选项:')}
-  --type     类型：skills | apps (默认：skills)
-  --name     包名称（默认：从 package.json 读取）
-  --version  版本号（默认：从 package.json 读取）
-
-${chalk.bold('示例:')}
-  ${chalk.gray('# 发布大健云仓技能')}
-  $ tolingcode publish ./skills/gigacloud-warehouse \\
-    --type skills \\
-    --name gigacloud-warehouse \\
-    --version 2026.3.8
-  
-  ${chalk.gray('# 发布订单履约技能')}
-  $ tolingcode publish ./skills/order-fulfillment \\
-    --type skills \\
-    --name order-fulfillment
-  
-  ${chalk.gray('# 发布应用')}
-  $ tolingcode publish ./apps/myapp --type apps
-  
-  ${chalk.gray('# 使用 PowerShell 发布')}
-  PS> tolingcode publish .\\skills\\gigacloud-warehouse --type skills --name gigacloud-warehouse --version 2026.3.8
-
-${chalk.bold('发布流程:')}
-  1. 打包技能目录为 .tar.gz
-  2. 上传到 toling.me registry 服务器
-  3. 更新 registry.json 索引
-  4. 其他用户可以安装
-
-${chalk.bold('技能结构要求:')}
-  skill-name/
-  ├── SKILL.md        # 必需，含 YAML 头
-  ├── package.json    # 必需
-  ├── index.js        # 推荐
-  └── ...`)
+  .description('发布技能或应用到 registry')
   .option('--type <type>', '包类型 (skills 或 apps)', 'skills')
   .option('--name <name>', '包名称')
   .option('--version <version>', '包版本号')
@@ -358,4 +245,41 @@ ${chalk.bold('技能结构要求:')}
     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,6 +1,6 @@
 {
   "name": "tolingcode",
-  "version": "2026.3.10",
+  "version": "2026.3.12",
   "description": "TolingCode CLI - Install skills and apps from toling.me",
   "main": "bin/tolingcode.js",
   "files": [