tolingcode 1.0.4 → 2026.3.8-1

package/README.md

@@ -1,6 +1,18 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tolingcode/tolingcode/main/docs/logo.png" width="120" alt="TolingCode Logo">
+</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
 
-通过 npm 安装和管理 TolingCode 的 skills 和 apps 。
+**跨境电商私人 AI 助手** - 在个人设备上运行的本地化 AI 自动化工具
+
+为跨境卖家提供订单履约、库存管理、产品刊登、广告管理、数据分析等核心业务能力。
+
+---
 
 ## 安装
 
@@ -9,22 +21,26 @@
 npm install -g tolingcode@latest
 
 # 安装指定版本
-npm install -g tolingcode@2026.02.26
+npm install -g tolingcode@2026.03.09
 ```
 
+**当前版本**: 2026.03.09
+
+---
+
 ## 使用
 
-### 安装 Skill
+### 安装技能 (Skill)
 
 ```bash
-# 安装最新版本
+# 安装技能
 tolingcode install skills weather
 
 # 安装指定版本
-tolingcode install skills weather -v 2026.03.06
+tolingcode install skills weather -v 2026.03.08
 ```
 
-### 安装 App
+### 安装应用 (App)
 
 ```bash
 # 安装到当前目录
@@ -34,73 +50,85 @@ tolingcode install apps myapp
 tolingcode install apps myapp -g
 ```
 
-### 列出可用包
+### 查看和搜索
 
 ```bash
-# 列出所有
+# 列出所有包
 tolingcode list
 
-# 只列出 skills
+# 只列出技能
 tolingcode list skills
 
-# 只列出 apps
-tolingcode list apps
+# 搜索技能
+tolingcode search weather
 ```
 
-### 搜索
+---
 
-```bash
-tolingcode search weather
-```
+## 核心能力
+
+### 电商平台技能
+
+| 功能 | 描述 |
+|------|------|
+| 订单履约 | 自动处理订单发货 |
+| 智能备货 | AI 预测库存 |
+| 产品上架 | 自动发布商品 |
+| 价格管理 | 修改产品价格 |
+| 广告管理 | 自动调整广告 |
+| 数据分析 | 获取平台报告 |
 
-### 发布 (开发者)
+### 海外仓技能
+
+| 功能 | 描述 |
+|------|------|
+| 实时库存 | 获取仓库库存 |
+| 出入库单 | 查询入库/出库 |
+| 创建出库单 | 创建订单出库 |
+| LTL 出运 | 创建 LTL 运输单 |
+| 运费查询 | 获取物流费用 |
+
+### 物流技能
+
+- 物流报价、创建面单、物流跟踪
+- 支持：FedEx、UPS、DHL、Amazon Logistics、ITTRACK
+
+---
+
+## 发布技能 (开发者)
 
 ```bash
-tolingcode publish ./my-skill --type skills --name my-skill --version 2026.03.06
+tolingcode publish ./my-skill \
+  --type skills \
+  --name my-skill \
+  --version 2026.03.09
 ```
 
-## 版本命名
+### 版本规范
 
-推荐使用日期格式：`YYYY.MM.DD`
+使用日期版本号：`YYYY.MM.DD`
 
-- `2026.02.26` - 2026 年 2 月 26 日发布的版本
-- `latest` - 最新版本
+---
 
-## 环境变量
+## 支持平台
 
-```bash
-# 自定义 registry 地址（默认：https://toling.me/api/registry）
-export TOLINGCODE_REGISTRY=https://registry.toling.me/api/registry
+**电商平台**: Amazon、eBay、AliExpress、Wish、Shopee、Lazada、Mercado Libre、Etsy、Wayfair、TikTok Shop 等
 
-# 自定义安装路径
-export OPENCLAW_WORKSPACE=/path/to/workspace
-```
+**独立站**: Shopify、WooCommerce、Magento、BigCommerce
 
-## 开发
+**零售平台**: Walmart、Target、Costco、Best Buy 等
 
-```bash
-# 本地测试
-cd tolingcode
-npm link
-tolingcode --help
-
-# 发布到 npm
-npm version patch  # 或 minor/major
-npm publish
-```
+**海外仓**: 支持 100+ 海外仓系统 (中通国际、Walmart WFS、马士基、RMS 红鼠等)
 
-## 目录结构
+---
 
-```
-tolingcode/
-├── bin/
-│   └── tolingcode.js    # CLI 入口
-├── docs/
-│   └── SERVER.md        # 服务端部署文档
-├── package.json
-└── README.md
-```
+## 相关链接
+
+- **Registry**: https://toling.me
+- **GitHub**: https://github.com/tolingcode/tolingcode
+- **问题反馈**: GitHub Issues
+
+---
 
-## License
-## 韩宝军开发2026年3月6号
-MIT
+**作者**: 韩宝军 (TolingCode)  
+**License**: MIT

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "tolingcode",
-  "version": "1.0.4",
+  "version": "2026.03.08-1",
   "description": "TolingCode CLI - Install skills and apps from toling.me",
   "main": "bin/tolingcode.js",
+  "files": [
+    "bin",
+    "docs",
+    "README.md"
+  ],
   "bin": {
     "tolingcode": "bin/tolingcode.js",
     "tlc": "bin/tolingcode.js"

package/QUICKSTART.md

@@ -1,196 +0,0 @@
-# TolingCode 快速开始指南
-
-## 🎯 目标
-
-创建一个类似 `clawhub` 的 CLI 工具，通过 `toling.me` 托管和分发 skills 和 apps。
-
-## 📦 使用流程
-
-### 1. 用户安装 CLI
-
-```bash
-npm install -g tolingcode@latest
-# 或指定版本
-npm install -g tolingcode@2026.03.06
-```
-
-### 2. 用户安装 Skill
-
-```bash
-tolingcode install skills weather
-tolingcode install skills weather -v 2026.03.06
-```
-
-### 3. 开发者发布 Skill
-
-```bash
-# 方法 1: 使用 publish 命令（需要 API 支持）
-tolingcode publish ./my-skill --type skills --name my-skill --version 2026.03.06
-
-# 方法 2: 手动上传
-tar -czf my-skill-2026.03.06.tar.gz -C ./my-skill .
-scp my-skill-2026.03.06.tar.gz user@toling.me:/var/www/toling.me/packages/skills/
-# 然后更新 registry.json
-```
-
-## 🚀 部署步骤
-
-### 第一步：准备 toling.me 服务器
-
-```bash
-# SSH 登录服务器
-ssh user@toling.me
-
-# 创建目录
-sudo mkdir -p /var/www/toling.me/{packages/skills,packages/apps,api}
-sudo chown -R $USER:$USER /var/www/toling.me
-
-# 安装 Node.js (如果没有)
-curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
-sudo apt-get install -y nodejs
-
-# 安装依赖
-cd /var/www/toling.me/api
-npm init -y
-npm install express multer
-```
-
-### 第二步：部署服务端代码
-
-```bash
-# 上传 registry.js 到服务器
-scp registry.js user@toling.me:/var/www/toling.me/api/
-
-# 创建 systemd 服务
-sudo tee /etc/systemd/system/tolingcode-registry.service > /dev/null <<EOF
-[Unit]
-Description=TolingCode Registry Server
-After=network.target
-
-[Service]
-Type=simple
-User=www-data
-WorkingDirectory=/var/www/toling.me/api
-ExecStart=/usr/bin/node registry.js
-Restart=on-failure
-
-[Install]
-WantedBy=multi-user.target
-EOF
-
-# 启动服务
-sudo systemctl daemon-reload
-sudo systemctl enable tolingcode-registry
-sudo systemctl start tolingcode-registry
-sudo systemctl status tolingcode-registry
-```
-
-### 第三步：配置 Nginx
-
-```bash
-# 编辑 Nginx 配置
-sudo nano /etc/nginx/sites-available/toling.me
-
-# 添加以下内容：
-server {
-    listen 443 ssl;
-    server_name toling.me;
-    
-    ssl_certificate /etc/letsencrypt/live/toling.me/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/toling.me/privkey.pem;
-    
-    root /var/www/toling.me;
-    
-    # API
-    location /api/ {
-        proxy_pass http://localhost:3000;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    }
-    
-    # Packages
-    location /packages/ {
-        alias /var/www/toling.me/packages/;
-        autoindex on;
-        add_header Content-Type application/octet-stream;
-    }
-}
-
-# 测试并重载
-sudo nginx -t
-sudo systemctl reload nginx
-```
-
-### 第四步：发布 CLI 到 npm
-
-```bash
-# 在本地开发机器上
-cd tolingcode
-
-# 登录 npm
-npm login
-
-# 发布
-npm version 1.0.0
-npm publish
-
-# 验证
-npm view tolingcode
-```
-
-### 第五步：发布第一个 Skill
-
-```bash
-# 创建测试 skill
-mkdir -p test-skill
-echo '{"name": "test", "description": "Test skill"}' > test-skill/SKILL.md
-
-# 发布
-cd tolingcode
-node bin/tolingcode.js publish ../test-skill --type skills --name test-skill --version 2026.03.06
-
-# 或者手动上传
-tar -czf test-skill-2026.03.06.tar.gz -C ../test-skill .
-scp test-skill-2026.03.06.tar.gz user@toling.me:/var/www/toling.me/packages/skills/
-
-# 更新 registry.json (SSH 到服务器编辑)
-```
-
-## ✅ 测试
-
-```bash
-# 安装 CLI
-npm install -g tolingcode@latest
-
-# 列出可用技能
-tolingcode list skills
-
-# 安装技能
-tolingcode install skills test-skill
-
-# 验证安装
-ls ~/.openclaw/workspace/skills/
-```
-
-## 📝 注意事项
-
-1. **版本命名**: 使用 `YYYY.MM.DD` 格式，便于追踪发布日期
-2. **认证**: 生产环境需要添加 API 认证（API Key 或 JWT）
-3. **HTTPS**: 确保 toling.me 配置了 SSL 证书
-4. **备份**: 定期备份 registry.json 和 packages 目录
-5. **监控**: 添加日志和监控，跟踪下载量和错误
-
-## 🔧 后续扩展
-
-- [ ] 添加用户认证系统
-- [ ] 支持私有包（需要 token）
-- [ ] 添加下载统计
-- [ ] Web 管理界面
-- [ ] 自动版本递增
-- [ ] 依赖管理
-- [ ] 包签名验证
-
----
-
-有问题？查看 `docs/SERVER.md` 获取详细服务端文档。

package/scripts/publish-skill.ps1

@@ -1,74 +0,0 @@
-#!/usr/bin/env pwsh
-# TolingCode Skill Publish Script (PowerShell)
-# Usage: .\publish-skill.ps1 <skill-name> [version]
-
-param(
-    [Parameter(Mandatory=$true)]
-    [string]$SkillName,
-    
-    [string]$Version = (Get-Date -Format "yyyy.MM.dd"),
-    
-    [string]$ServerHost = "iZwz91qi4kjnj5l58gbhj5Z",
-    [string]$ServerUser = "root",
-    [string]$SkillSource = "C:\Users\Administrator\.openclaw\workspace\skills"
-)
-
-Write-Host "📦 Publishing $SkillName@$Version" -ForegroundColor Blue
-Write-Host ""
-
-# 1. Check source exists
-$sourcePath = Join-Path $SkillSource $SkillName
-if (!(Test-Path $sourcePath)) {
-    Write-Host "❌ Skill not found: $sourcePath" -ForegroundColor Red
-    exit 1
-}
-
-Write-Host "✓ Source: $sourcePath" -ForegroundColor Green
-
-# 2. Create tar.gz
-$tarFile = "$SkillName-$Version.tar.gz"
-Write-Host "📦 Creating $tarFile..." -ForegroundColor Yellow
-tar -czf $tarFile -C $SkillSource $SkillName
-
-if (!(Test-Path $tarFile)) {
-    Write-Host "❌ Failed to create tarball" -ForegroundColor Red
-    exit 1
-}
-
-Write-Host "✓ Created: $tarFile ($(Get-Item $tarFile).Length bytes)" -ForegroundColor Green
-
-# 3. Upload to server
-Write-Host "📤 Uploading to server..." -ForegroundColor Yellow
-scp $tarFile "${ServerUser}@${ServerHost}:/var/www/toling.me/packages/skills/"
-
-if ($LASTEXITCODE -ne 0) {
-    Write-Host "❌ Upload failed" -ForegroundColor Red
-    exit 1
-}
-
-Write-Host "✓ Uploaded to /var/www/toling.me/packages/skills/" -ForegroundColor Green
-Write-Host ""
-Write-Host "📝 Next step: Update registry.json on server" -ForegroundColor Yellow
-Write-Host ""
-Write-Host "SSH to server and run:" -ForegroundColor Gray
-Write-Host @"
-cat >> /var/www/toling.me/registry.json << 'EOF'
-{
-  "skills": {
-    "$SkillName": {
-      "description": "$SkillName skill",
-      "latestVersion": "$Version",
-      "versions": {
-        "$Version": {
-          "publishedAt": "$(Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ")"
-        }
-      }
-    }
-  },
-  "apps": {}
-}
-EOF
-"@
-
-Write-Host ""
-Write-Host "🎉 Done!" -ForegroundColor Green

package/scripts/publish.bat

@@ -1,30 +0,0 @@
-@echo off
-REM TolingCode Publish Script (Windows)
-REM Usage: publish.bat <skill-path> <name> [version]
-
-SET SKILL_PATH=%1
-SET NAME=%2
-SET VERSION=%3
-
-IF "%VERSION%"=="" (
-    REM Use today's date as version
-    FOR /F "tokens=2-4 delims=/ " %%A IN ('date /T') DO (SET VERSION=%%C.%%B.%%A)
-)
-
-ECHO Publishing %NAME%@%VERSION%...
-
-REM Create tarball (requires tar.exe on Windows 10+)
-tar -czf %NAME%-%VERSION%.tar.gz -C %SKILL_PATH% .
-
-ECHO Created: %NAME%-%VERSION%.tar.gz
-ECHO.
-ECHO Next steps:
-ECHO   1. Upload to toling.me: scp %NAME%-%VERSION%.tar.gz user@toling.me:/var/www/toling.me/packages/skills/
-ECHO   2. Update registry.json on server
-ECHO.
-ECHO Or use the API (when implemented):
-ECHO   curl -X POST https://toling.me/api/registry/publish ^
-ECHO     -F "type=skills" ^
-ECHO     -F "name=%NAME%" ^
-ECHO     -F "version=%VERSION%" ^
-ECHO     -F "package=@%NAME%-%VERSION%.tar.gz"

package/server/registry.js

@@ -1,220 +0,0 @@
-// TolingCode Registry Server - Simple Node.js Implementation
-// Deploy this on toling.me
-
-const express = require('express');
-const fs = require('fs');
-const path = require('path');
-const multer = require('multer');
-const crypto = require('crypto');
-
-const app = express();
-const PORT = process.env.PORT || 3000;
-
-// Paths
-const BASE_DIR = process.env.REGISTRY_BASE_DIR || '/var/www/toling.me';
-const REGISTRY_FILE = path.join(BASE_DIR, 'registry.json');
-const PACKAGES_DIR = path.join(BASE_DIR, 'packages');
-
-// Ensure directories exist
-if (!fs.existsSync(PACKAGES_DIR)) {
-  fs.mkdirSync(path.join(PACKAGES_DIR, 'skills'), { recursive: true });
-  fs.mkdirSync(path.join(PACKAGES_DIR, 'apps'), { recursive: true });
-}
-
-// Initialize registry if not exists
-if (!fs.existsSync(REGISTRY_FILE)) {
-  fs.writeFileSync(REGISTRY_FILE, JSON.stringify({ skills: {}, apps: {} }, null, 2));
-}
-
-// Middleware
-app.use(express.json());
-const upload = multer({ dest: path.join(BASE_DIR, 'uploads') });
-
-// Helper: Read registry
-function getRegistry() {
-  return JSON.parse(fs.readFileSync(REGISTRY_FILE, 'utf-8'));
-}
-
-// Helper: Write registry
-function saveRegistry(data) {
-  fs.writeFileSync(REGISTRY_FILE, JSON.stringify(data, null, 2));
-}
-
-// Helper: Calculate file hash
-function hashFile(filePath) {
-  const content = fs.readFileSync(filePath);
-  return crypto.createHash('sha256').update(content).digest('hex');
-}
-
-// GET /api/registry/:type/:name - Get package info
-app.get('/api/registry/:type/:name', (req, res) => {
-  const { type, name } = req.params;
-  const { version = 'latest' } = req.query;
-  
-  if (!['skills', 'apps'].includes(type)) {
-    return res.status(400).json({ error: 'Invalid type. Use "skills" or "apps"' });
-  }
-  
-  const registry = getRegistry();
-  const pkg = registry[type]?.[name];
-  
-  if (!pkg) {
-    return res.status(404).json({ error: `Package ${name} not found` });
-  }
-  
-  const ver = version === 'latest' ? pkg.latestVersion : version;
-  const verInfo = pkg.versions?.[ver];
-  
-  if (!verInfo) {
-    return res.status(404).json({ error: `Version ${ver} not found` });
-  }
-  
-  res.json({
-    name,
-    type,
-    version: ver,
-    description: pkg.description || '',
-    downloadUrl: `https://toling.me/packages/${type}/${name}-${ver}.tar.gz`,
-    latestVersion: pkg.latestVersion,
-    versions: Object.keys(pkg.versions || {}).sort().reverse()
-  });
-});
-
-// GET /api/registry/list - List all packages
-app.get('/api/registry/list', (req, res) => {
-  const { type = 'all' } = req.query;
-  const registry = getRegistry();
-  const result = [];
-  
-  const types = type === 'all' ? ['skills', 'apps'] : [type];
-  
-  types.forEach(t => {
-    if (registry[t]) {
-      Object.entries(registry[t]).forEach(([name, pkg]) => {
-        result.push({
-          name,
-          type: t,
-          version: pkg.latestVersion,
-          description: pkg.description || '',
-          latestVersion: pkg.latestVersion
-        });
-      });
-    }
-  });
-  
-  res.json(result);
-});
-
-// GET /api/registry/search - Search packages
-app.get('/api/registry/search', (req, res) => {
-  const { q } = req.query;
-  if (!q) {
-    return res.status(400).json({ error: 'Query parameter "q" is required' });
-  }
-  
-  const registry = getRegistry();
-  const result = [];
-  const query = q.toLowerCase();
-  
-  ['skills', 'apps'].forEach(type => {
-    if (registry[type]) {
-      Object.entries(registry[type]).forEach(([name, pkg]) => {
-        if (name.toLowerCase().includes(query) ||
-            (pkg.description && pkg.description.toLowerCase().includes(query))) {
-          result.push({
-            name,
-            type,
-            version: pkg.latestVersion,
-            description: pkg.description || ''
-          });
-        }
-      });
-    }
-  });
-  
-  res.json(result);
-});
-
-// POST /api/registry/publish - Publish a package (requires auth)
-app.post('/api/registry/publish', upload.single('package'), (req, res) => {
-  // TODO: Add authentication (API key, JWT, etc.)
-  const { type, name, version } = req.body;
-  
-  if (!type || !name || !version) {
-    return res.status(400).json({ error: 'Missing required fields: type, name, version' });
-  }
-  
-  if (!['skills', 'apps'].includes(type)) {
-    return res.status(400).json({ error: 'Invalid type. Use "skills" or "apps"' });
-  }
-  
-  if (!req.file) {
-    return res.status(400).json({ error: 'No package file uploaded' });
-  }
-  
-  const registry = getRegistry();
-  
-  // Initialize type if not exists
-  if (!registry[type]) {
-    registry[type] = {};
-  }
-  
-  // Initialize package if not exists
-  if (!registry[type][name]) {
-    registry[type][name] = {
-      description: req.body.description || '',
-      latestVersion: version,
-      versions: {}
-    };
-  }
-  
-  // Add version
-  const fileHash = hashFile(req.file.path);
-  registry[type][name].versions[version] = {
-    publishedAt: new Date().toISOString(),
-    hash: `sha256:${fileHash}`,
-    size: req.file.size
-  };
-  
-  // Update latest version
-  registry[type][name].latestVersion = version;
-  
-  // Move file to packages directory
-  const destDir = path.join(PACKAGES_DIR, type);
-  const destFile = path.join(destDir, `${name}-${version}.tar.gz`);
-  
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-  
-  fs.renameSync(req.file.path, destFile);
-  
-  // Save registry
-  saveRegistry(registry);
-  
-  // Cleanup uploads dir
-  try {
-    fs.unlinkSync(req.file.path);
-  } catch (e) {}
-  
-  res.json({
-    success: true,
-    name,
-    type,
-    version,
-    downloadUrl: `https://toling.me/packages/${type}/${name}-${version}.tar.gz`
-  });
-});
-
-// Serve static packages
-app.use('/packages', express.static(path.join(BASE_DIR, 'packages')));
-
-// Health check
-app.get('/health', (req, res) => {
-  res.json({ status: 'ok', timestamp: new Date().toISOString() });
-});
-
-app.listen(PORT, () => {
-  console.log(`TolingCode Registry Server running on port ${PORT}`);
-  console.log(`Base directory: ${BASE_DIR}`);
-});